Skip to content

Commit 3e8ed13

Browse files
authored
[SPIRV][DOC] Add SPV_INTEL_optnone extension spec (#3198)
1 parent 0b8cff4 commit 3e8ed13

File tree

1 file changed

+115
-0
lines changed

1 file changed

+115
-0
lines changed
Lines changed: 115 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,115 @@
1+
SPV_INTEL_optnone
2+
=================
3+
4+
Name Strings
5+
------------
6+
7+
SPV_INTEL_optnone
8+
9+
Contact
10+
-------
11+
12+
To report problems with this extension, please open a new issue at:
13+
14+
https://github.com/intel/llvm
15+
16+
Contributors
17+
------------
18+
19+
- Mariya Podchishchaeva, Intel
20+
- Ben Ashbaugh, Intel
21+
- Alexey Sotkin, Intel
22+
23+
Notice
24+
------
25+
26+
Copyright (c) 2020 Intel Corporation. All rights reserved.
27+
28+
Status
29+
------
30+
First draft
31+
32+
Version
33+
-------
34+
35+
[width="40%",cols="25,25"]
36+
|========================================
37+
| Last Modified Date | 2020-12-17
38+
| Revision | 2
39+
|========================================
40+
41+
Dependencies
42+
------------
43+
44+
This extension is written against the SPIR-V Specification,
45+
Version 1.5 Revision 4, Unified
46+
47+
This extension requires SPIR-V 1.0.
48+
49+
Overview
50+
--------
51+
52+
This extension adds new possible value for Function Control mask - *OptNoneINTEL*,
53+
which represents a strong request to not optimize the function.
54+
55+
Extension Name
56+
--------------
57+
58+
To use this extension within a SPIR-V module, the following
59+
*OpExtension* must be present in the module:
60+
61+
----
62+
OpExtension "SPV_INTEL_optnone*
63+
----
64+
65+
Modifications to the SPIR-V Specification, Version 1.5, Revision 4, Unified
66+
---------------------------------------------------------------------------
67+
Capabilities
68+
~~~~~~~~~~~~
69+
70+
Modify Section 3.31, "Capability", adding these rows to the Capability table:
71+
72+
--
73+
[options="header"]
74+
|====
75+
2+^| Capability ^| Implicitly Declares
76+
| 6094 | *CapabilityOptNoneINTEL* +
77+
Allow to use *OptNoneINTEL* Function Control mask value |
78+
|====
79+
--
80+
81+
82+
Function Control
83+
~~~~~~~~~~~~~~~~
84+
85+
In section 3.24 "Function Control" add the following row to the Function Control
86+
table:
87+
[cols="1,4,4",options="header",width="100%"]
88+
|====
89+
2+| Function Control | <<Capability,Enabling Capabilities>> |
90+
0x10000 | *OptNoneINTEL* +
91+
Strong request, to the extent possible, to not optimize the function.
92+
| *CapabilityOptNoneINTEL*
93+
|====
94+
95+
96+
Issues
97+
------
98+
99+
100+
Discussion:
101+
102+
...
103+
104+
105+
Revision History
106+
----------------
107+
108+
[cols="5,15,15,70"]
109+
[grid="rows"]
110+
[options="header"]
111+
|========================================
112+
|Rev|Date|Author|Changes
113+
|1|2020-12-15|Mariya Podchishchaeva|Initial revision
114+
|2|2020-12-17|Mariya Podchishchaeva|Do not require DontInline for OptNone
115+
|========================================

0 commit comments

Comments
 (0)