Change log for April 3, 2026 Vulkan 1.4.348 spec update:

Github Issues

  * Use links to github instead of internal Khronos gitlab in proposal
    documents (public PR 2703).
  * Add explicit dependency on VkSurfaceTransformFlagsKHR to VK_KHR_surface
    (public issue 2706).
  * Use promoted type names in XML struct member declarations instead of
    older extension type names (public PR 2708).

Internal Issues

  * Define when <<interfaces-fragmentoutput, color attachments have
    undefined values>> (issue 4206).
  * Clarify <<shaders-interpolation-decorations, single sampled
    interpolation with VK_EXT_sample_locations>> (issue 4617)
  * Update incorrect limit types for renderPassStripeGranularity and
    tileGranularity in XML (issue 4657).
  * Add VkComputePipelineCreateInfo VU, and common ray tracing pipeline
    create info VU for VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT (issue
    4697).
  * Split up confusing VkImageViewCreateInfo VU 01762 (issue 4715).
  * Add VK_DESCRIPTOR_TYPE_PARTITIONED_ACCELERATION_STRUCTURE_NV to
    descriptions of <<descriptors-partitionedaccelerationstructure,
    descriptor type enums>> (issue 4740).
  * Mark VkMemoryBarrierAccessFlags3KHR as extending
    VkMemoryRangeBarriersInfoKHR in XML (issue 4756).
  * Add parent and extending fields to Vulkan object (MR 7876).
  * Fixes and improvements to VK_EXT_present_timing for consistency with the
    proposal document (MR 8052).
  * Add CI check for internal links in published documents (MR 8148).
  * Fix typo in VkImageViewCreateInfo attachmentFragmentShadingRate VU 12386
    (MR 8150).
  * Improve description of vkCmdDispatchIndirect2KHR (MR 8151).
  * Add `noautovalidity` attribute on
    VkDeviceImageMemoryRequirements::planeAspect in XML and a corresponding
    explicit VU statement (MR 8158).
  * Fix Roadmap 2022 maxPerStageDescriptorStorageImages from 144 -> 16 in
    the Required Limits table (MR 8159).
  * Add missing `len` attribute in VkTensorDependencyInfoARM (MR 8163).
  * Add a note to the `optionalPointer` name in Vulkan object (MR 8167).
  * Add VK_EXT_fragment_density `<require>` dependency around
    VkPhysicalDeviceDescriptorBufferDensityMapPropertiesEXT in
    VK_EXT_descriptor_buffer XML (MR 8174).

New Extensions

  * VK_ARM_graph_instruction_set_tosa
  * VK_ARM_scheduling_controls (revision 2)
  * VK_EXT_primitive_restart_index
  * VK_QCOM_queue_perf_hint

Author: oddhack

.github/workflows/CI.yml

@@ -179,10 +179,10 @@ jobs:
       - name: Run the Vulkan-specific tests (from scripts/check_build_sanity.py) # codespell:allow sanity
         run: |
           cd VK-GL-CTS
-          python3 external/vulkancts/scripts/gen_framework.py
-          python3 external/vulkancts/scripts/gen_framework_c.py
-          python3 external/vulkancts/scripts/gen_framework.py --api SC
-          python3 external/vulkancts/scripts/gen_framework_c.py --api SC
+          python3 external/vulkancts/scripts/gen_framework.py --api vulkan
+          python3 external/vulkancts/scripts/gen_framework_c.py --api vulkan
+          python3 external/vulkancts/scripts/gen_framework.py --api vulkansc
+          python3 external/vulkancts/scripts/gen_framework_c.py --api vulkansc
 
   h-compile:
     name: Compile a simple test program that uses vulkan.h

.gitignore

@@ -50,6 +50,10 @@ __pycache__
 /gen/
 /gencore/
 /genrat/
+/genvkb/
+/genvkc/
+/genvkg/
+/genvksc/
 
 # Output files and directories
 gen/out/**

.gitlab-ci.yml

@@ -37,14 +37,17 @@ consistency-check:
     - make CHECK_XREFS= allchecks
   allow_failure: false
 
-# Check (only in main branch) for PROPOSED or UNRESOLVED issues in
-# appendices
-proposed-check:
+# Check (only in main branch) for references to material that should not
+# appear in the public repository or published specifications:
+# - PROPOSED or UNRESOLVED issues in appendices
+# - Internal gitlab links in document markup
+internal-phrasing-check:
   stage: build
   script:
-    - make check-proposed
+    - make check-internal-phrasing
   rules:
-    - if: $CI_COMMIT_BRANCH =~ /main/
+    - if: $CI_COMMIT_BRANCH == "main"
+    - if: $CI_COMMIT_BRANCH == "4755-links"
 
 # Consistency check for extension development branches
 # First verify that SPEC_VERSION >= 1 (-test argument)
@@ -204,10 +207,10 @@ cts-framework-tests:
     - mkdir external/vulkan-docs
     - ln -s `cd .. ; pwd` external/vulkan-docs/src
     # Run the Vulkan-specific tests (from scripts/check_build_sanity.py) # codespell:allow sanity
-    - python3 external/vulkancts/scripts/gen_framework.py
-    - python3 external/vulkancts/scripts/gen_framework_c.py
-    - python3 external/vulkancts/scripts/gen_framework.py --api SC
-    - python3 external/vulkancts/scripts/gen_framework_c.py --api SC
+    - python3 external/vulkancts/scripts/gen_framework.py --api vulkan
+    - python3 external/vulkancts/scripts/gen_framework_c.py --api vulkan
+    - python3 external/vulkancts/scripts/gen_framework.py --api vulkansc
+    - python3 external/vulkancts/scripts/gen_framework_c.py --api vulkansc
   allow_failure: true
 
 # Compile a simple test program that uses vulkan.h

ChangeLog.adoc

@@ -14,6 +14,61 @@ appears frequently in the change log.
 
 '''
 
+Change log for April 3, 2026 Vulkan 1.4.348 spec update:
+
+Github Issues
+
+  * Use links to github instead of internal Khronos gitlab in proposal
+    documents (public PR 2703).
+  * Add explicit dependency on VkSurfaceTransformFlagsKHR to VK_KHR_surface
+    (public issue 2706).
+  * Use promoted type names in XML struct member declarations instead of
+    older extension type names (public PR 2708).
+
+Internal Issues
+
+  * Define when <<interfaces-fragmentoutput, color attachments have
+    undefined values>> (issue 4206).
+  * Clarify <<shaders-interpolation-decorations, single sampled
+    interpolation with VK_EXT_sample_locations>> (issue 4617)
+  * Update incorrect limit types for renderPassStripeGranularity and
+    tileGranularity in XML (issue 4657).
+  * Add VkComputePipelineCreateInfo VU, and common ray tracing pipeline
+    create info VU for VK_PIPELINE_LAYOUT_CREATE_INDEPENDENT_SETS_BIT (issue
+    4697).
+  * Split up confusing VkImageViewCreateInfo VU 01762 (issue 4715).
+  * Add VK_DESCRIPTOR_TYPE_PARTITIONED_ACCELERATION_STRUCTURE_NV to
+    descriptions of <<descriptors-partitionedaccelerationstructure,
+    descriptor type enums>> (issue 4740).
+  * Mark VkMemoryBarrierAccessFlags3KHR as extending
+    VkMemoryRangeBarriersInfoKHR in XML (issue 4756).
+  * Add parent and extending fields to Vulkan object (MR 7876).
+  * Fixes and improvements to VK_EXT_present_timing for consistency with the
+    proposal document (MR 8052).
+  * Add CI check for internal links in published documents (MR 8148).
+  * Fix typo in VkImageViewCreateInfo attachmentFragmentShadingRate VU 12386
+    (MR 8150).
+  * Improve description of vkCmdDispatchIndirect2KHR (MR 8151).
+  * Add `noautovalidity` attribute on
+    VkDeviceImageMemoryRequirements::planeAspect in XML and a corresponding
+    explicit VU statement (MR 8158).
+  * Fix Roadmap 2022 maxPerStageDescriptorStorageImages from 144 -> 16 in
+    the Required Limits table (MR 8159).
+  * Add missing `len` attribute in VkTensorDependencyInfoARM (MR 8163).
+  * Add a note to the `optionalPointer` name in Vulkan object (MR 8167).
+  * Add VK_EXT_fragment_density `<require>` dependency around
+    VkPhysicalDeviceDescriptorBufferDensityMapPropertiesEXT in
+    VK_EXT_descriptor_buffer XML (MR 8174).
+
+New Extensions
+
+  * VK_ARM_graph_instruction_set_tosa
+  * VK_ARM_scheduling_controls (revision 2)
+  * VK_EXT_primitive_restart_index
+  * VK_QCOM_queue_perf_hint
+
+'''
+
 Change log for March 20, 2026 Vulkan 1.4.347 spec update:
 
 Github Issues
@@ -94,8 +149,8 @@ Internal Issues
   * Move VK_SAMPLER_ADDRESS_MODE_MIRROR_CLAMP_TO_EDGE to
     VK_COMPUTE_VERSION_1_2 XML feature from VK_BASE_VERSION_1_0 (internal MR
     8123).
- * Remove duplicate VUs from vkCmdCopyAccelerationStructureKHR (internal MR
-   8125).
+  * Remove duplicate VUs from vkCmdCopyAccelerationStructureKHR (internal MR
+    8125).
 
 New Extensions
 
@@ -15459,10 +15514,9 @@ GitHub Issues:
   * Add missing error return code for
     flink:vkEnumerateInstanceExtensionProperties and
     flink:vkEnumerateDeviceExtensionProperties (public issue 285)
-  * Fix several cases of stext::VkStructName.memberName markup to
-    stext::VkStructName::pname:memberName, to match other usage in the
-    spec, and describe this markup in the style guide (public issue
-    286).
+  * Fix several cases of stext{wj}::VkStructName.memberName markup to
+    stext{wj}::VkStructName::pname:memberName, to match other usage in the
+    spec, and describe this markup in the style guide (public issue 286).
   * Modified validity language generation script to avoid redundant
     common ancestor language if covered by generic parent language, and
     used `Both' instead of `Each' when appropriate (public issue 288).

Makefile

@@ -151,7 +151,7 @@ VERBOSE =
 # ADOCOPTS options for asciidoc->HTML5 output
 
 NOTEOPTS     = -a editing-notes -a implementation-guide
-PATCHVERSION = 347
+PATCHVERSION = 348
 BASEOPTS     =
 
 ifneq (,$(findstring VKSC_VERSION_1_0,$(VERSIONS)))
@@ -463,8 +463,11 @@ reflow:
 # Automated markup and consistency checks, invoked by 'allchecks' and
 # 'ci-allchecks' targets or individually.
 
-# Sources of spec-type markup - spec, registry schema document, and style guide
-MARKUP_SPEC_SOURCES = $(SPECDIR)/[a-z]*.adoc $(SPECDIR)/chapters $(SPECDIR)/appendices $(SPECDIR)/style
+# Sources of spec-type markup - spec, registry schema document, and
+# style guide.
+# This is a mix of paths and filenames, and relies on 'git grep' to
+# expand paths to files.
+MARKUP_SPEC_SOURCES = $(SPECDIR)/[a-z]*.adoc $(SPECDIR)/chapters $(SPECDIR)/appendices $(SPECDIR)/config/*.adoc $(SPECDIR)/style
 
 # Look for disallowed contractions
 CHECK_CONTRACTIONS = git grep -n -i -F -f $(ROOTDIR)/config/CI/contractions | grep -v -E -f $(ROOTDIR)/config/CI/contractions-allowed
@@ -597,17 +600,29 @@ check-txtfiles:
 check-xrefs: $(HTMLDIR)/vkspec.html
 	$(PYTHON) $(SCRIPTS)/check_html_xrefs.py $(HTMLDIR)/vkspec.html
 
+# Check for stuff that should not be published.
+# This is not part of 'allchecks' since it would fail in most new
+# extension branches, and runs only on main branch in CI.
+check-internal-phrasing: check-proposed check-gitlab
+
 # Check for UNRESOLVED or PROPOSED issues in extension appendices
-# This is not run as part of 'allchecks' since it would fail in most new
-# extension branches, but instead triggered only in main branch by CI
-CHECK_PROPOSED = git grep -n -E 'PROPOSED|UNRESOLVED' $(SPECDIR)/appendices/VK_*.adoc
+CHECK_PROPOSED = git grep -n -E 'PROPOSED|UNRESOLVED' $(SPECDIR)/appendices/
 check-proposed:
 	if test `$(CHECK_PROPOSED) | wc -l` != 0 ; then \
-	    echo "PROPOSED or UNRESOLVED issues should not be present in published extension appendices:" ; \
+	    echo "PROPOSED or UNRESOLVED issues should not be published in extension appendices:" ; \
 	    $(CHECK_PROPOSED) ; \
 	    exit 1 ; \
 	fi
 
+# Check for internal gitlab links anywhere in markup sources
+CHECK_GITLAB = git grep -n 'gitlab.khronos.org' $(MARKUP_SPEC_SOURCES) proposals/
+check-gitlab:
+	if test `$(CHECK_GITLAB) | wc -l` != 0 ; then \
+	    echo "Internal gitlab.khronos.org links should not be published, use corresponding github links instead:" ; \
+	    $(CHECK_GITLAB) ; \
+	    exit 1 ; \
+	fi
+
 # Generated refpage sources. For now, always build all refpages.
 MANSOURCES   = $(wildcard $(REFPATH)/*.adoc)
 

antora/.gitignore

@@ -7,4 +7,8 @@
 **/partials
 **/pages/proposals
 **/pages/gen
+**/pages/genvkb
+**/pages/genvkc
+**/pages/genvkg
+**/pages/genvksc
 spec/modules/ROOT/nav.adoc

appendices/VK_ARM_data_graph_instruction_set_tosa.adoc

@@ -0,0 +1,40 @@
+// Copyright (c) 2022-2026 Arm Ltd.
+//
+// SPDX-License-Identifier: CC-BY-4.0
+
+include::{generated}/meta/{refprefix}VK_ARM_data_graph_instruction_set_tosa.adoc[]
+
+=== Other Extension Metadata
+
+*Last Modified Date*::
+    2026-03-30
+*Interactions and External Dependencies*::
+  - This extension requires {spirvregistry}/extended/TOSA.001000.1.html[the
+    TOSA SPIR-V 001000.1 extended instruction set]
+*IP Status*::
+    No known IP claims.
+*Contributors*::
+  - Kévin Petit, Arm Ltd.
+
+=== Description
+
+This extensions adds support for the `TOSA.001000.1` extended instruction
+set for use in data graphs as defined by apiext:VK_ARM_data_graph.
+It also adds detailed queries to report the TOSA profiles, levels, and
+extensions that are supported along with the quality of the implementation
+(e.g. accelerated, experimental, deprecated, etc).
+
+include::{generated}/interfaces/VK_ARM_data_graph_instruction_set_tosa.adoc[]
+
+=== New SPIR-V Capabilities
+
+None.
+
+=== Issues
+
+None.
+
+=== Version History
+
+  * Revision 1, 2026-03-30 (Kévin Petit)
+  ** Initial revision

appendices/VK_ARM_scheduling_controls.adoc

@@ -1,4 +1,4 @@
-// Copyright (c) 2023 Arm Ltd.
+// Copyright (c) 2023-2025 Arm Ltd.
 //
 // SPDX-License-Identifier: CC-BY-4.0
 
@@ -7,7 +7,7 @@ include::{generated}/meta/{refprefix}VK_ARM_scheduling_controls.adoc[]
 === Other Extension Metadata
 
 *Last Modified Date*::
-    2023-08-23
+    2025-09-05
 *Interactions and External Dependencies*::
     None
 *IP Status*::
@@ -34,5 +34,12 @@ None.
 
 === Version History
 
+  * Revision 2, 2025-09-05 (Kévin Petit)
+  ** Add dispatch parameters controls
+  *** ename:VK_PHYSICAL_DEVICE_SCHEDULING_CONTROLS_DISPATCH_PARAMETERS_ARM
+  *** flink:vkCmdSetDispatchParametersARM
+  *** slink:VkDispatchParametersARM
+  *** slink:VkPhysicalDeviceSchedulingControlsDispatchParametersPropertiesARM
+
   * Revision 1, 2023-08-23 (Kévin Petit)
   ** Initial revision

appendices/VK_EXT_primitive_restart_index.adoc

@@ -0,0 +1,29 @@
+// Copyright 2026 The Khronos Group Inc.
+//
+// SPDX-License-Identifier: CC-BY-4.0
+
+include::{generated}/meta/{refprefix}VK_EXT_primitive_restart_index.adoc[]
+
+=== Other Extension Metadata
+
+*Last Modified Date*::
+    2026-03-10
+*IP Status*::
+    No known IP claims.
+*Contributors*::
+  - Mike Blumenkrantz, Valve
+  - Spencer Fricke, LunarG
+  - Ricardo Garcia, Igalia
+  - Piers Daniell, NVIDIA
+
+=== Description
+
+This extension allows setting a custom primitive restart index.
+It is primarily intended to support GL emulation.
+
+include::{generated}/interfaces/VK_EXT_primitive_restart_index.adoc[]
+
+=== Version History
+
+  * Revision 1, 2026-03-10 (Mike Blumenkrantz)
+  ** Internal revisions

appendices/VK_QCOM_queue_perf_hint.adoc

@@ -0,0 +1,36 @@
+// Copyright 2025-2026 The Khronos Group Inc.
+//
+// SPDX-License-Identifier: CC-BY-4.0
+
+include::{generated}/meta/{refprefix}VK_QCOM_queue_perf_hint.adoc[]
+
+=== Other Extension Metadata
+
+*Last Modified Date*::
+    2026-02-26
+*IP Status*::
+    No known IP claims.
+*Interactions and External Dependencies*::
+  - Interacts with `apiext:VK_KHR_internally_synchronized_queues`
+*Contributors*::
+  - Matthew Netsch, Qualcomm Technologies, Inc
+
+=== Description
+
+This extension exposes power constraints to the application, allowing it to
+provide hints for influencing the device's clock frequency.
+
+These hints are sname:VkQueue state and are persistent across the life of
+the queue until the app updates or removes the constraint.
+The kernel combines the constraints across the active queues from all
+processes to determine the actual clock frequency levels.
+
+include::{generated}/interfaces/VK_QCOM_queue_perf_hint.adoc[]
+
+=== Issues
+
+None.
+
+=== Version History
+
+  * Revision 1, 2026-02-26 (Matthew Netsch)