| 1 |
<?xml version="1.0" encoding="UTF-8"?> |
| 2 |
<registry> |
| 3 |
<!-- |
| 4 |
Copyright (c) 2015 The Khronos Group Inc. |
| 5 |
|
| 6 |
Permission is hereby granted, free of charge, to any person obtaining a |
| 7 |
copy of this software and/or associated documentation files (the |
| 8 |
"Materials"), to deal in the Materials without restriction, including |
| 9 |
without limitation the rights to use, copy, modify, merge, publish, |
| 10 |
distribute, sublicense, and/or sell copies of the Materials, and to |
| 11 |
permit persons to whom the Materials are furnished to do so, subject to |
| 12 |
the following conditions: |
| 13 |
|
| 14 |
The above copyright notice and this permission notice shall be included |
| 15 |
in all copies or substantial portions of the Materials. |
| 16 |
|
| 17 |
THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, |
| 18 |
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF |
| 19 |
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. |
| 20 |
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY |
| 21 |
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, |
| 22 |
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE |
| 23 |
MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS. |
| 24 |
--> |
| 25 |
<!-- |
| 26 |
This file, spir-v.xml, is the SPIR-V Tool ID, opcode and enumerant registry. |
| 27 |
The canonical version of the registry, together with related schema and |
| 28 |
documentation, can be found in the Khronos Registry at |
| 29 |
include/spirv/spir-v.xml in the master branch at |
| 30 |
https://github.com/KhronosGroup/SPIRV-Headers |
| 31 |
--> |
| 32 |
|
| 33 |
<!-- SECTION: SPIR-V Tool ID Definitions --> |
| 34 |
|
| 35 |
<!-- A SPIR-V Generator Magic Number is a 32 bit word: The high order 16 |
| 36 |
bits are a tool ID, which should be unique across all SPIR-V |
| 37 |
generators. The low order 16 bits are reserved for use as a tool |
| 38 |
version number, or any other purpose the tool supplier chooses. |
| 39 |
Only the tool IDs are reserved with Khronos. |
| 40 |
|
| 41 |
Add new tool ID reservations contiguously with the first available |
| 42 |
number (the "start" attribute of the <unused> tag below), and |
| 43 |
modify that <unused> tag accordingly. Please add a vendor/tool |
| 44 |
supplier name in a 'vendor="name"' attribute; a tool name in a |
| 45 |
'tool="name"' attribute; and a contact person/address in a |
| 46 |
'comment' attribute. Remember that this value is the high 16 bits |
| 47 |
of a 32-bit word. |
| 48 |
|
| 49 |
Note: a single vendor/tool supplier may have multiple tool IDs |
| 50 |
reserved for different SPIR-V generators --> |
| 51 |
|
| 52 |
<ids type="vendor" start="0" end="0xFFFF" comment="SPIR-V Tool IDs"> |
| 53 |
<id value="0" vendor="Khronos" comment="Reserved by Khronos"/> |
| 54 |
<id value="1" vendor="LunarG" comment="Contact TBD"/> |
| 55 |
<id value="2" vendor="Valve" comment="Contact TBD"/> |
| 56 |
<id value="3" vendor="Codeplay" comment="Contact Victor Lomuller, [email protected]"/> |
| 57 |
<id value="4" vendor="NVIDIA" comment="Contact Kerch Holt, [email protected]"/> |
| 58 |
<id value="5" vendor="ARM" comment="Contact Alexander Galazin, [email protected]"/> |
| 59 |
<id value="6" vendor="Khronos" tool="LLVM/SPIR-V Translator" comment="Contact Yaxun (Sam) Liu, [email protected]"/> |
| 60 |
<id value="7" vendor="Khronos" tool="SPIR-V Tools Assembler" comment="Contact David Neto, [email protected]"/> |
| 61 |
<id value="8" vendor="Khronos" tool="Glslang Reference Front End" comment="Contact John Kessenich, [email protected]"/> |
| 62 |
<id value="9" vendor="Qualcomm" comment="Contact [email protected]"/> |
| 63 |
<id value="10" vendor="AMD" comment="Contact Daniel Rakos, [email protected]"/> |
| 64 |
<id value="11" vendor="Intel" comment="Contact Alexey, [email protected]"/> |
| 65 |
<id value="12" vendor="Imagination" comment="Contact James Jones"/> |
| 66 |
<id value="13" vendor="Google" tool="Shaderc over Glslang" comment="Contact David Neto, [email protected]"/> |
| 67 |
<id value="14" vendor="Google" tool="spiregg" comment="Contact Lei Zhang, [email protected]"/> |
| 68 |
<id value="15" vendor="Google" tool="rspirv" comment="Contact Lei Zhang, [email protected]"/> |
| 69 |
<id value="16" vendor="X-LEGEND" tool="Mesa-IR/SPIR-V Translator" comment="Contact Metora Wang, github:metora/MesaGLSLCompiler"/> |
| 70 |
<id value="17" vendor="Khronos" tool="SPIR-V Tools Linker" comment="Contact David Neto, [email protected]"/> |
| 71 |
<id value="18" vendor="Wine" tool="VKD3D Shader Compiler" comment="Contact [email protected]"/> |
| 72 |
<id value="19" vendor="Clay" tool="Clay Shader Compiler" comment="Contact [email protected]"/> |
| 73 |
<id value="20" vendor="W3C WebGPU Group" tool="WHLSL Shader Translator" comment="https://github.com/gpuweb/WHLSL"/> |
| 74 |
<id value="21" vendor="Google" tool="Clspv" comment="Contact David Neto, [email protected]"/> |
| 75 |
<id value="22" vendor="Google" tool="MLIR SPIR-V Serializer" comment="Contact Lei Zhang, [email protected]"/> |
| 76 |
<id value="23" vendor="Google" tool="Tint Compiler" comment="Contact David Neto, [email protected]"/> |
| 77 |
<id value="24" vendor="Google" tool="ANGLE Shader Compiler" comment="Contact Shahbaz Youssefi, [email protected]"/> |
| 78 |
<id value="25" vendor="Netease Games" tool="Messiah Shader Compiler" comment="Contact Yuwen Wu, [email protected]"/> |
| 79 |
<id value="26" vendor="Xenia" tool="Xenia Emulator Microcode Translator" comment="Contact Vitaliy Kuzmin, [email protected], https://github.com/xenia-project/xenia"/> |
| 80 |
<id value="27" vendor="Embark Studios" tool="Rust GPU Compiler Backend" comment="https://github.com/embarkstudios/rust-gpu"/> |
| 81 |
<unused start="28" end="0xFFFF" comment="Tool ID range reservable for future use by vendors"/> |
| 82 |
</ids> |
| 83 |
|
| 84 |
<!-- SECTION: SPIR-V Opcodes and Enumerants --> |
| 85 |
|
| 86 |
<!-- Vendors reserve new ranges of: |
| 87 |
- opcode enumerants in the "opcode" list below, and |
| 88 |
- non-opcode enumerants in the non-opcodes "enumerant" list below. |
| 89 |
Both are reserved by contiguous blocks of 64, preceding the given |
| 90 |
"Future use" blocks. |
| 91 |
|
| 92 |
SPIR-V background: |
| 93 |
- SPIR-V currently has well over 30 enums, including the opcode enum |
| 94 |
- each enum has its own name space, allowing reuse of enumerants |
| 95 |
- SPIR-V restricts opcode enumerants to 16 bits |
| 96 |
- all other enums use 32-bit enumerants |
| 97 |
|
| 98 |
Reservation rules: |
| 99 |
- opcode reservations ("opcode") are only valid for opcodes |
| 100 |
- non-opcode reservations ("enumerant") are not valid for opcodes |
| 101 |
- reservations in the enumerant list are valid for all non-opcode enums |
| 102 |
- it is simpler to use each non-opcode enumerant for only one purpose |
| 103 |
but this is left to the discretion of the vendor |
| 104 |
- all enumerants in a range should be used before allocating a new range |
| 105 |
(several extensions can use enumerants from the same range) |
| 106 |
|
| 107 |
Each vendor determines the use of enumerants in the ranges they |
| 108 |
reserve. Vendors are not required to disclose those uses. If the use |
| 109 |
of an enumerant is included in an extension that is adopted by a Khronos |
| 110 |
extension or specification, then that enumerant's use may be permanently |
| 111 |
fixed as if originally reserved in a Khronos range. |
| 112 |
|
| 113 |
--> |
| 114 |
|
| 115 |
<!-- Begin reservations of opcode enumerants --> |
| 116 |
<ids type="opcode" start="0" end="4095" vendor="Khronos" comment="Reserved opcodes, not available to vendors - see the SPIR-V Specification"/> |
| 117 |
<ids type="opcode" start="4096" end="4159" vendor="Mesa" comment="Contact TBD"/> |
| 118 |
<ids type="opcode" start="4160" end="4415" vendor="ARM"/> |
| 119 |
<ids type="opcode" start="4416" end="4479" vendor="Khronos" comment="SPV_ARB_shader_ballot - contact Neil Henning, [email protected]"/> |
| 120 |
<ids type="opcode" start="4480" end="4991" vendor="Qualcomm" comment="Contact [email protected]"/> |
| 121 |
<ids type="opcode" start="4992" end="5247" vendor="AMD"/> |
| 122 |
<ids type="opcode" start="5248" end="5503" vendor="NVIDIA"/> |
| 123 |
<ids type="opcode" start="5504" end="5567" vendor="Imagination"/> |
| 124 |
<ids type="opcode" start="5568" end="5631" vendor="Intel" comment="Contact [email protected]"/> |
| 125 |
<ids type="opcode" start="5632" end="5695" vendor="Google" comment="Contact [email protected]"/> |
| 126 |
<ids type="opcode" start="5696" end="5823" vendor="Intel" comment="Contact [email protected]"/> |
| 127 |
<ids type="opcode" start="5824" end="5951" vendor="Intel" comment="Contact [email protected]"/> |
| 128 |
<ids type="opcode" start="5952" end="6015" vendor="Codeplay" comment="Contact [email protected]"/> |
| 129 |
<ids type="opcode" start="6016" end="6079" vendor="Khronos" comment="Contact @tobski"/> |
| 130 |
<ids type="opcode" start="6080" end="6143" vendor="Intel" comment="Contact [email protected]"/> |
| 131 |
<!-- Opcode enumerants to reserve for future use. To get a block, allocate |
| 132 |
multiples of 64 starting at the lowest available point in this |
| 133 |
block and add a corresponding <ids> tag immediately above. Make |
| 134 |
sure to fill in the vendor attribute, and preferably add a contact |
| 135 |
person/address in a comment attribute. --> |
| 136 |
<!-- Example new block: <ids type="opcode" start="XXXX" end="XXXX+64n-1" vendor="Add vendor" comment="Contact TBD"/> --> |
| 137 |
<ids type="opcode" start="6144" end="65535" comment="Opcode range reservable for future use by vendors"/> |
| 138 |
<!-- End reservations of opcodes --> |
| 139 |
|
| 140 |
|
| 141 |
<!-- Begin reservations of non-opcode enumerants --> |
| 142 |
<ids type="enumerant" start="0" end="4095" vendor="Khronos" comment="Reserved enumerants, not available to vendors - see the SPIR-V Specification"/> |
| 143 |
<ids type="enumerant" start="4096" end="4159" vendor="Mesa" comment="Contact TBD"/> |
| 144 |
<ids type="enumerant" start="4160" end="4415" vendor="ARM"/> |
| 145 |
<ids type="enumerant" start="4416" end="4479" vendor="Khronos" comment="SPV_ARB_shader_ballot - contact Neil Henning, [email protected]"/> |
| 146 |
<ids type="enumerant" start="4480" end="4991" vendor="Qualcomm" comment="Contact [email protected]"/> |
| 147 |
<ids type="enumerant" start="4992" end="5247" vendor="AMD"/> |
| 148 |
<ids type="enumerant" start="5248" end="5503" vendor="NVIDIA"/> |
| 149 |
<ids type="enumerant" start="5504" end="5567" vendor="Imagination"/> |
| 150 |
<ids type="enumerant" start="5568" end="5631" vendor="Intel" comment="Contact [email protected]"/> |
| 151 |
<ids type="enumerant" start="5632" end="5695" vendor="Google" comment="Contact [email protected]"/> |
| 152 |
<ids type="enumerant" start="5696" end="5823" vendor="Intel" comment="Contact [email protected]"/> |
| 153 |
<ids type="enumerant" start="5824" end="5951" vendor="Intel" comment="Contact [email protected]"/> |
| 154 |
<ids type="enumerant" start="5952" end="6015" vendor="Codeplay" comment="Contact [email protected]"/> |
| 155 |
<ids type="enumerant" start="6016" end="6079" vendor="Khronos" comment="Contact @tobski"/> |
| 156 |
<ids type="enumerant" start="6080" end="6143" vendor="Intel" comment="Contact [email protected]"/> |
| 157 |
<!-- Enumerants to reserve for future use. To get a block, allocate |
| 158 |
multiples of 64 starting at the lowest available point in this |
| 159 |
block and add a corresponding <ids> tag immediately above. Make |
| 160 |
sure to fill in the vendor attribute, and preferably add a contact |
| 161 |
person/address in a comment attribute. --> |
| 162 |
<!-- Example new block: <ids type="enumerant" start="XXXX" end="XXXX+64n-1" vendor="Add vendor" comment="Contact TBD"/> --> |
| 163 |
<ids type="enumerant" start="6144" end="4294967295" comment="Enumerant range reservable for future use by vendors"/> |
| 164 |
<!-- End reservations of enumerants --> |
| 165 |
|
| 166 |
|
| 167 |
<!-- SECTION: SPIR-V Loop Control Bit Reservations --> |
| 168 |
<!-- Reserve ranges of bits in the loop control bitfield. |
| 169 |
|
| 170 |
Each vendor determines the use of values in their own ranges. |
| 171 |
Vendors are not required to disclose those uses. If the use of a |
| 172 |
value is included in an extension that is adopted by a Khronos |
| 173 |
extension or specification, then that value's use may be permanently |
| 174 |
fixed as if originally reserved in a Khronos range. |
| 175 |
|
| 176 |
The SPIR Working Group strongly recommends: |
| 177 |
- Each value is used for only one purpose. |
| 178 |
- All values in a range should be used before allocating a new range. |
| 179 |
--> |
| 180 |
|
| 181 |
<!-- Reserved loop control bits --> |
| 182 |
<ids type="LoopControl" start="0" end="15" vendor="Khronos" comment="Reserved LoopControl bits, not available to vendors - see the SPIR-V Specification"/> |
| 183 |
<ids type="LoopControl" start="16" end="23" vendor="Intel" comment="Contact [email protected]"/> |
| 184 |
<ids type="LoopControl" start="24" end="30" comment="Unreserved bits reservable for use by vendors"/> |
| 185 |
<ids type="LoopControl" start="31" end="31" vendor="Khronos" comment="Reserved LoopControl bit, not available to vendors"/> |
| 186 |
|
| 187 |
|
| 188 |
<!-- SECTION: SPIR-V FP Fast Math Mode Bit Reservations --> |
| 189 |
<!-- Reserve ranges of bits in the "FP Fast Math Mode" bitfield. |
| 190 |
Each vendor determines the use of values in their own ranges. |
| 191 |
Vendors are not required to disclose those uses. If the use of a |
| 192 |
value is included in an extension that is adopted by a Khronos |
| 193 |
extension or specification, then that value's use may be permanently |
| 194 |
fixed as if originally reserved in a Khronos range. |
| 195 |
The SPIR Working Group strongly recommends: |
| 196 |
- Each value is used for only one purpose. |
| 197 |
- All values in a range should be used before allocating a new range. |
| 198 |
--> |
| 199 |
|
| 200 |
<!-- Reserved FP fast math mode bits --> |
| 201 |
<ids type="FPFastMathMode" start="0" end="15" vendor="Khronos" comment="Reserved FPFastMathMode bits, not available to vendors - see the SPIR-V Specification"/> |
| 202 |
<ids type="FPFastMathMode" start="16" end="17" vendor="Intel" comment="Contact [email protected]"/> |
| 203 |
<ids type="FPFastMathMode" start="18" end="31" comment="Unreserved bits reservable for use by vendors"/> |
| 204 |
|
| 205 |
</registry> |