1
<?xml version="1.0" encoding="UTF-8"?>
4
Copyright (c) 2015 The Khronos Group Inc.
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:
14
The above copyright notice and this permission notice shall be included
15
in all copies or substantial portions of the Materials.
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.
26
This file, spir-v.xml, is the SPIR-V Tool ID and Opcode registry. The
27
canonical version of the registry, together with related schema and
28
documentation, can be found in the Khronos Registry at
29
http://www.khronos.org/registry/spir-v/
32
<!-- SECTION: SPIR-V Tool ID Definitions -->
34
<!-- A SPIR-V Generator Magic Number is a 32 bit word: The high order 16
35
bits are a tool ID, which should be unique across all SPIR-V
36
generators. The low order 16 bits are reserved for use as a tool
37
version number, or any other purpose the tool supplier chooses.
38
Only the tool IDs are reserved with Khronos.
40
Add new tool ID reservations contiguously with the first available
41
number (the "start" attribute of the <unused> tag below), and
42
modify that <unused> tag accordingly. Please add a vendor/tool
43
supplier name in a 'vendor="name"' attribute; a tool name in a
44
'tool="name"' attribute; and a contact person/address in a
45
'comment' attribute. Remember that this value is the high 16 bits
48
Note: a single vendor/tool supplier may have multiple tool IDs
49
reserved for different SPIR-V generators -->
51
<ids type="vendor" start="0" end="0xFFFF" comment="SPIR-V Tool IDs">
52
<id value="0" vendor="Khronos" comment="Reserved by Khronos"/>
53
<id value="1" vendor="LunarG" comment="Contact TBD"/>
54
<id value="2" vendor="Valve" comment="Contact TBD"/>
55
<id value="3" vendor="Codeplay" comment="Contact Victor Lomuller, victor@codeplay.com"/>
56
<id value="4" vendor="NVIDIA" comment="Contact Kerch Holt, kholt@nvidia.com"/>
57
<id value="5" vendor="ARM" comment="Contact Alexander Galazin, alexander.galazin@arm.com"/>
58
<id value="6" vendor="Khronos" tool="LLVM/SPIR-V Translator" comment="Contact Yaxun (Sam) Liu, yaxun.liu@amd.com"/>
59
<id value="7" vendor="Khronos" tool="SPIR-V Tools Assembler" comment="Contact David Neto, dneto@google.com"/>
60
<id value="8" vendor="Khronos" tool="Glslang Reference Front End" comment="Contact John Kessenich, johnkessenich@google.com"/>
61
<id value="9" vendor="Qualcomm" comment="Contact weifengz@qti.qualcomm.com"/>
62
<id value="10" vendor="AMD" comment="Contact Daniel Rakos, daniel.rakos@amd.com"/>
63
<id value="11" vendor="Intel" comment="Contact Alexey, alexey.bader@intel.com"/>
64
<id value="12" vendor="Imagination" comment="Contact James Jones"/>
65
<id value="13" vendor="Google" tool="Shaderc over Glslang" comment="Contact David Neto, dneto@google.com"/>
66
<id value="14" vendor="Google" tool="spiregg" comment="Contact Lei Zhang, antiagainst@google.com"/>
67
<id value="15" vendor="Google" tool="rspirv" comment="Contact Lei Zhang, antiagainst@gmail.com"/>
68
<id value="16" vendor="X-LEGEND" tool="Mesa-IR/SPIR-V Translator" comment="Contact Metora Wang, github:metora/MesaGLSLCompiler"/>
69
<id value="17" vendor="Khronos" tool="SPIR-V Tools Linker" comment="Contact David Neto, dneto@google.com"/>
70
<id value="18" vendor="Wine" tool="VKD3D Shader Compiler" comment="Contact wine-devel@winehq.org"/>
71
<id value="19" vendor="Clay" tool="Clay Shader Compiler" comment="Contact info@clayengine.com"/>
72
<id value="20" vendor="W3C WebGPU Group" tool="WHLSL Shader Translator" comment="https://github.com/gpuweb/WHLSL"/>
73
<id value="21" vendor="Google" tool="Clspv" comment="Contact David Neto, dneto@google.com"/>
74
<id value="22" vendor="Google" tool="MLIR SPIR-V Serializer" comment="Contact Lei Zhang, antiagainst@google.com"/>
75
<unused start="23" end="0xFFFF" comment="Tool ID range reservable for future use by vendors"/>
78
<!-- SECTION: SPIR-V Opcodes and Enumerants -->
79
<!-- Reserve new ranges for vendors in contiguous blocks of 64
80
preceding the "Future use" block below, and modify that block
83
Each vendor determines the use of values in their own ranges.
84
Vendors are not required to disclose those uses. If the use of a
85
value is included in an extension that is adopted by a Khronos
86
extension or specification, then that value's use may be permanently
87
fixed as if originally reserved in a Khronos range.
89
The SPIR Working Group strongly recommends:
90
- Each value is used for only one purpose.
91
- All values in a range should be used before allocating a new range.
92
For example, to avoid unused gaps in ranges, it is customary for
93
several extensions to use values from the same range.
95
The Id type "enum" is a synonym for "opcode".
97
Note that SPIR-V restricts opcode values to 16 bits.
100
<!-- Reserved opcode & enumerant blocks -->
101
<ids type="opcode" start="0" end="4095" vendor="Khronos" comment="Reserved opcodes, not available to vendors - see the SPIR-V Specification"/>
102
<ids type="opcode" start="4096" end="4159" vendor="Mesa" comment="Contact TBD"/>
103
<ids type="opcode" start="4160" end="4415" vendor="ARM"/>
104
<ids type="opcode" start="4416" end="4479" vendor="Khronos" comment="SPV_ARB_shader_ballot - contact Neil Henning, neil.henning@amd.com"/>
105
<ids type="opcode" start="4480" end="4991" vendor="Qualcomm" comment="Contact weifengz@qti.qualcomm.com"/>
106
<ids type="opcode" start="4992" end="5247" vendor="AMD"/>
107
<ids type="opcode" start="5248" end="5503" vendor="NVIDIA"/>
108
<ids type="opcode" start="5504" end="5567" vendor="Imagination"/>
109
<ids type="opcode" start="5568" end="5631" vendor="Intel" comment="Contact ben.ashbaugh@intel.com"/>
110
<ids type="opcode" start="5632" end="5695" vendor="Google" comment="Contact dneto@google.com"/>
111
<ids type="opcode" start="5696" end="5823" vendor="Intel" comment="Contact ben.ashbaugh@intel.com"/>
112
<ids type="opcode" start="5824" end="5951" vendor="Intel" comment="Contact michael.kinsner@intel.com"/>
113
<ids type="opcode" start="5952" end="6015" vendor="Codeplay" comment="Contact victor@codeplay.com"/>
114
<!-- Opcodes & enumerants reservable for future use. To get a block, allocate
115
multiples of 64 starting at the lowest available point in this
116
block and add a corresponding <ids> tag immediately above. Make
117
sure to fill in the vendor attribute, and preferably add a contact
118
person/address in a comment attribute. -->
120
<!-- Example new block: <ids type="opcode" start="XXXX" end="XXXX+64n-1" vendor="Add vendor" comment="Contact TBD"/> -->
122
<ids type="opcode" start="6016" end="4294967295" comment="Opcode range reservable for future use by vendors"/>
125
<!-- SECTION: SPIR-V Loop Control Bit Reservations -->
126
<!-- Reserve ranges of bits in the loop control bitfield.
128
Each vendor determines the use of values in their own ranges.
129
Vendors are not required to disclose those uses. If the use of a
130
value is included in an extension that is adopted by a Khronos
131
extension or specification, then that value's use may be permanently
132
fixed as if originally reserved in a Khronos range.
134
The SPIR Working Group strongly recommends:
135
- Each value is used for only one purpose.
136
- All values in a range should be used before allocating a new range.
139
<!-- Reserved loop control bits -->
140
<ids type="LoopControl" start="0" end="15" vendor="Khronos" comment="Reserved LoopControl bits, not available to vendors - see the SPIR-V Specification"/>
141
<ids type="LoopControl" start="16" end="19" vendor="Intel" comment="Contact michael.kinsner@intel.com"/>
142
<ids type="LoopControl" start="20" end="30" comment="Unreserved bits reservable for use by vendors"/>
143
<ids type="LoopControl" start="31" end="31" vendor="Khronos" comment="Reserved LoopControl bit, not available to vendors"/>