blob: 7ad7b661c22d9813c84e9475afc057bb5b4852d3 [file] [log] [blame]
David Neto91668542016-04-21 20:50:11 -04001Revision history for SPIRV-Tools
2
Diego Novillo84546642020-12-02 13:42:21 -05003v2020.6-dev 2020-12-02
4 - General
5 CMake: Add SPIRV_TOOLS_BUILD_STATIC flag (#3910)
6 - Disassembler
7 Add some context comments to disassembly. (#3847)
8 - Optimizer
Diego Novilloc9c1f542020-12-02 18:49:00 -05009 - Do run DCE if SPV_KHR_ray_query is used. (#4047)
Diego Novillo84546642020-12-02 13:42:21 -050010 - Handle 8-bit index in elim dead member (#4043)
11 - Add texel buffer out-of-bounds checking instrumentation (#4038)
12 - Update MeshShadingNV dependencies (and land Ray tracing updates) (#4028)
13 - Fix buffer oob instrumentation for matrix refs (#4025)
14 - Fix SSA re-writing in the presence of variable pointers. (#4010)
15 - Add support to prevent functions from being inlined if they have
16 DontInline flag (#3858)
17 - Add SPV_EXT_shader_image_int64 (#3852)
18 - Support SPV_KHR_fragment_shading_rate (#3943)
19 - Fix use-after-move in val/validate.cpp (#3848)
20 - Debug Info
21 - properly preserve DebugValue indexes operand (#4022)
22 - Add DebugValue for invisible store in single_store_elim (#4002)
23 - Propagate OpLine to all applied instructions in spirv-opt (#3951)
24 - Add DebugValue for DebugDecl invisible to value assignment (#3973)
25 - Add DebugValue for function param regardless of scope (#3923)
26 - Debug info preservation in convert-local-access-chains pass (#3835)
27 - Debug info preservation in redundancy-elimination pass (#3839)
28 - Debug info preservation in if-conversion pass (#3861)
29 - Validator
30 - Add validation support for the ray tracing built-in variables (#4041)
31 - Use less stack space when validating Vulkan builtins (#4019)
32 - Fix SPV_KHR_fragment_shading_rate VUID label (#4014)
33 - Label Layer and ViewportIndex VUIDs (#4013)
34 - Allow the ViewportIndex and Layer built-ins on SPIR-V 1.5 (#3986)
35 - Fix validation of OpPhi instructions (#3919)
36 - Fuzz
37 - Fix facts arising from CompositeConstruct (#4034)
38 - Do not flatten conditionals that create synonyms (#4030)
39 - Add support for reining in rogue fuzzer passes (#3987)
40 - Fix assertion failure in FuzzerPassAddCompositeExtract (#3995)
41 - Fix invalid equation facts (#4009)
42 - Fix bugs in TransformationFlattenConditionalBranch (#4006)
43 - Fix bug related to transformation applicability (#3990)
44 - Add expand vector reduction transformation (#3869)
45 - Add FuzzerPassAddCompositeExtract (#3904)
46 - Fix mismatch with shrinker step limit (#3985)
47 - Fix off-by-one error in replayer (#3982)
48 - Get order right for OpSelect arguments (#3974)
49 - Do not add synonym-creating loops in dead blocks (#3975)
50 - Skip OpTypeSampledImage when propagating up (#3976)
51 - Pass OpUndef in function call if needed (#3978)
52 - Fix off-by-one in TransformationCompositeConstruct (#3979)
53 - Tolerate absent ids in data synonym fact management (#3966)
54 - Fix to id availability (#3971)
55 - Fix operand types (#3962)
56 - Don't flatten conditional if condition is irrelevant (#3944)
57 - Do not produce OpPhis of type OpTypeSampledImage (#3964)
58 - Restrict fuzzer pass to reachable blocks (#3970)
59 - Handle more types when extending OpPhi instructions (#3969)
60 - Skip early terminator wrappers when merging returns (#3968)
61 - Avoid irrelevant constants in synonym-creating loops (#3967)
62 - Skip dead blocks in FuzzerPassAddOpPhiSynonyms (#3965)
63 - Avoid the type manager when looking for struct types (#3963)
64 - Fix to TransformationDuplicateRegionWithSelection (#3941)
65 - Skip OpFunction when replacing irrelevant ids (#3932)
66 - Use component-wise selectors when flattening conditional branches (#3921)
67 - Avoid void struct member when outlining functions (#3936)
68 - Do not allow Block-decorated structs when adding parameters (#3931)
69 - Fix to operand id type (#3937)
70 - Handle dead blocks in TransformationEquationInstruction (#3933)
71 - Do not allow sampled image load when flattening conditionals (#3930)
72 - Take care of OpPhi instructions when inlining (#3939)
73 - Fix to TransformationInlineFunction (#3913)
74 - Wrap early terminators before merging returns (#3925)
75 - Lower probability of adding bit instruction synonyms (#3917)
76 - Fix handling of OpPhi in FlattenConditionalBranch (#3916)
77 - Avoid creating blocks without parents (#3908)
78 - Do not allow creation of constants of block-decorated structs (#3903)
79 - Fixes related to irrelevant ids (#3901)
80 - Fix to transformation that adds a synonym via a loop (#3898)
81 - Fix to duplicate region with selection (#3896)
82 - Do not expose synonym facts for non-existent ids (#3891)
83 - Do not add synonyms involving irrelevant ids (#3890)
84 - Do not replace irrelevant ids that are not in blocks (#3892)
85 - Wrap OpKill and similar in function calls (#3884)
86 - Integrate spirv-reduce with shrinker (#3849)
87 - Report fresh ids in transformations (#3856)
88 - Support OpNot bit instruction case (#3841)
89 - Return IR and transformation context after replay (#3846)
Ehsan Nasiri50dacda2020-09-24 10:58:53 -040090
Ehsan Nasirib27e0392020-09-24 10:53:49 -040091v2020.5 2020-09-22
Steven Perron0a1fb582020-09-22 09:23:45 -040092 - General
93 - Enable building with BUILD_SHARED_LIBS=1 (#3490)
94 - Avoid using /MP4 for clang on windows. (#3662)
Ehsan Nasiria5903a92020-09-24 10:52:17 -040095 - Fix compiler error on macOS with XCode12. (#3836)
Steven Perron0a1fb582020-09-22 09:23:45 -040096 - Optimizer
97 - Preserve OpenCL.DebugInfo.100 through private-to-local pass (#3571)
98 - Preserve debug info in scalar replacement pass (#3461)
99 - Debug info preservation in loop-unroll pass (#3548)
100 - Preserve debug info in dead-insert-elim pass (#3652)
101 - Improve non-semantic instruction handling in the optimizer (#3693)
102 - Let ADCE pass check DebugScope (#3703)
103 - Add undef for inlined void function (#3720)
104 - Fix SSA-rewrite to remove DebugDeclare for variables without loads (#3719)
105 - Handle DebugScope in compact-ids pass (#3724)
106 - Add buffer oob check to bindless instrumentation (#3800)
107 - Validator
108 - Update OpenCL capabilities validation (#3149)
109 - Validator support for non-semantic clspv reflection (#3618)
110 - OpenCL.DebugInfo.100 DebugTypeArray with variable size (#3549)
111 - Only validation locations for appropriate execution models (#3656)
112 - Validate more OpenCL.DebugInfo.100 instructions (#3684)
113 - Allow DebugTypeTemplate for Type operand (#3702)
114 - spirv-val: Add Vulkan VUID labels to BuiltIn (#3756)
115 - Allow SPV_KHR_8bit_storage extension. (#3780)
Ehsan Nasiria5903a92020-09-24 10:52:17 -0400116 - Validate SPIRV Version number when parsing binary header (#3834)
Steven Perron0a1fb582020-09-22 09:23:45 -0400117 - Reduce
118 - Support reducing a specific function (#3774)
119 - Fuzz
120 - adds TransformationReplaceCopyObjectWithStoreLoad (#3567)
121 - adds TransformationReplaceCopyMemoryWithLoadStore (#3575)
122 - adds TransformationReplaceLoadStoreWithCopyMemory (#3586)
123 - Implement the OpOuterProduct linear algebra case (#3617)
124 - Pass to replace int operands with ints of opposite signedness (#3612)
125 - TransformationMoveInstructionDown (#3477)
126 - Add TransformationMakeVectorOperationDynamic (#3597)
127 - TransformationReplaceAddSubMulWithCarryingExtended (#3598)
128 - FuzzerPassPropagateInstructionsUp (#3478)
129 - add FuzzerPassAddCompositeInserts (#3606)
130 - Add inline function transformation (#3517)
131 - Transformation to replace the use of an irrelevant id (#3697)
132 - Add SPIRV_FUZZ_PROTOC_COMMAND (#3789)
133 - Add TransformationDuplicateRegionWithSelection (#3773)
134 - Transformation to flatten conditional branch (#3667)
Ehsan Nasiria5903a92020-09-24 10:52:17 -0400135 - Handle OpPhis in TransformationInlineFunction (#3833)
136 - Create synonym of int constant using a loop (#3790)
137 - Support dead blocks in TransformationAddSynonym (#3832)
Steven Perron0a1fb582020-09-22 09:23:45 -0400138 - Linker
Steven Perron0b847272020-07-22 14:27:35 -0400139
Steven Perron895927b2020-07-22 14:26:04 -0400140v2020.4 2020-07-22
Steven Perrona0d8dc22020-07-22 13:29:56 -0400141 - General
142 - Changed variable names to be more descriptive (#3433)
143 - Add support to GPU-AV instrumentation for Task and Mesh shaders (#3512)
144 - Permit Simple and GLSL450 memory model in WEBGPU_0 (#3463)
145 - Support SPV_KHR_terminate_invocation (#3568)
146 - Optimizer
147 - Preserving debug information in optimizations
148 (#3389,#3420,#3425,#3356,#3459,#3444,#3492,#3451,#3497i,#3498,#3542)
149 - Eliminate branches with condition of OpConstantNull (#3438)
150 - Use structured order to unroll loops. (#3443)
151 - Updated desc_sroa to support flattening structures (#3448)
152 - Support OpCompositeExtract pattern in desc_sroa (#3456)
153 - Fix ADCE pass bug for mulitple entries (#3470)
154 - Sink pointer instructions in merge return (#3569)
155 - Validator
156 - Validate location assignments (#3308)
157 - Fix reachability in the validator (#3541)
158 - Reduce
159 - Fuzz
160 - Add support for OpSpecConstant* (#3373)
161 - Add replace linear algebra instruction transformation (#3402)
162 - Implement vector shuffle fuzzer pass (#3412)
163 - Swap operands in OpBranchConditional (#3423)
164 - Permute OpPhi instruction operands (#3421)
165 - Add FuzzerPassAddCopyMemoryInstructions (#3391)
166 - TransformationInvertComparisonOperator (#3475)
167 - Add variables with workgroup storage class (#3485)
168 - Add image sample unused components transformation (#3439)
169 - TransformationReplaceParameterWithGlobal (#3434)
170 - Support adding dead break from back-edge block (#3519)
171 - Fuzzer pass to interchange zero-like constants (#3524)
172 - Linker
Steven Perron20e7fc52020-05-27 13:45:36 -0400173
Steven Perrone128ab02020-05-27 13:43:54 -0400174v2020.3 2020-05-27
Steven Perron9b8a6a12020-05-27 10:30:52 -0400175 - General
dan sinclaira1ea15c2020-07-29 13:50:58 -0400176 - Prevent Effcee from installing things when building spirv-tools with testing enabled (#3256)
Steven Perron9b8a6a12020-05-27 10:30:52 -0400177 - Update acorn version (#3294)
178 - If SPIRV-Headers is in our tree, include it as subproject (#3299)
179 - allow cross compiling for Windows Store, UWP, etc. (#3330)
180 - Optimizer
181 - Remove deprecated interfaces from instrument passes (#3361)
182 - Preserve debug info in inline pass (#3349)
183 - Handle more cases in dead member elim (#3289)
184 - Preserve debug info in eliminate-dead-functions (#3251)
185 - Fix Struct CFG analysis for single block loop (#3293)
186 - Add tests for recently added command line option (#3297)
187 - Consider sampled images as read-only storage (#3295)
188 - Allow various validation options to be passed to spirv-opt (#3314)
189 - Add debug information analysis (#3305)
190 - Preserve debug info for wrap-opkill (#3331)
191 - refactor inlining pass (#3328)
192 - Add unrolling to performance passes (#3082)
193 - Validator
194 - Add validation support for ImageGatherBiasLodAMD (#3363)
195 - Validate ShaderCallKHR memory scope (#3332)
196 - Validate Buffer and BufferBlock apply only to struct types (#3259)
197 - Reduce
198 - increase default step limit (#3327)
199 - Remove unused uniforms and similar (#3321)
200 - Fuzz
201 - Add support for StorageBuffer (#3348)
202 - Add validator options (#3254)
203 - Limit adding of new variables to 'basic' types (#3257)
204 - Transformation to add OpConstantNull (#3273)
205 - Handling of more fuzzing opportunities (#3277, #3280, #3281, #3290, #3292)
206 - Respect rules for OpSampledImage (#3287)
207 - Do not outline regions that produce pointer outputs (#3291)
208 - Linker
Steven Perronfd773eb2020-03-26 02:04:07 -0400209
Steven Perronfd8e1302020-03-26 02:02:59 -0400210v2020.2 2020-03-26
Steven Perron3ef8fe92020-03-26 02:01:43 -0400211 - General:
212 - Support extended instructions in the vscode language server
213 - Make spvOpcodeString part of the public API (#3174)
214 - Added guide to writing a spirv-fuzz fuzzer pass (#3190)
215 - Add support for KHR_ray_{query,tracing} extensions (#3235)
216 - Optimizer
217 - Debug Printf support (#3215)
218 - Add data structure for DebugScope, DebugDeclare in spirv-opt (#3183)
219 - Fix identification of Vulkan images and buffers (#3253)
220 - Validator
221 - Add support for SPV_AMD_shader_image_load_store_lod (#3186)
222 - Add validation rules for OpenCL.DebugInfo.100 extension (#3133)
223 - Adding WebGPU specific Workgroup scope rule (#3204)
224 - Disallow phis of images, samplers and sampled images (#3246)
225 - Reduce
226 - Fuzz
227 - Fuzzer passes to add local and global variables (#3175)
228 - Add fuzzer passes to add loads/stores (#3176)
229 - Fuzzer pass to add function calls (#3178)
230 - Fuzzer pass that adds access chains (#3182)
231 - Fuzzer pass to add equation instructions (#3202)
232 - Add swap commutable operands transformation (#3205)
233 - Add fuzzer pass to permute function parameters (#3212)
234 - Allow OpPhi operand to be replaced with a composite synonym (#3221)
235 - Linker
Steven Perronda5457f2020-02-04 09:36:21 -0500236
Steven Perron8dd17482020-02-04 09:35:13 -0500237v2020.1 2020-02-03
Steven Perronddcc1172020-02-03 09:47:28 -0500238 - General:
239 - Add support for SPV_KHR_non_semantic_info (#3110)
240 - Support OpenCL.DebugInfo.100 extended instruction set (#3080)
241 - Added support for Vulkan 1.2
242 - Add API function to better handle getting the necessary environment (#3142)
243 - Clarify mapping of target env to SPIR-V version (#3150)
244 - Implement constant folding for many transcendentals (#3166)
245 - Optimizer
246 - Change default version for CreatInstBindlessCheckPass to 2 (#3096, #3119)
247 - Better handling of OpLine on merge blocks (#3130)
dan sinclaira1ea15c2020-07-29 13:50:58 -0400248 - Use placeholder switch instead of placeholder loop in MergeReturn pass. (#3151)
Steven Perron76616ba2020-02-04 09:33:50 -0500249 - Handle TimeAMD in AmdExtensionToKhrPass. (#3168)
Steven Perronddcc1172020-02-03 09:47:28 -0500250 - Validator
251 - Fix structured exit validation (#3141)
252 - Reduce
253 - Fuzz
254 - Fuzzer pass to merge blocks (#3097)
255 - Transformation to add a new function to a module (#3114)
256 - Add fuzzer pass to perform module donation (#3117)
257 - Fuzzer passes to create and branch to new dead blocks (#3135)
Steven Perron76616ba2020-02-04 09:33:50 -0500258 - Fuzzer pass to add composite types (#3171)
Steven Perronddcc1172020-02-03 09:47:28 -0500259 - Linker:
260 - Remove names and decorations of imported symbols (#3081)
Steven Perron5c019b52019-12-11 14:53:48 -0500261
Steven Perronc413b982019-12-11 14:52:28 -0500262v2019.5 2019-12-11
Steven Perron9b3cc3e2019-09-03 15:51:46 -0400263 - General:
Steven Perronc3ca0472019-10-09 09:43:01 -0400264 - Export SPIRV-Tools targets on installation
265 - SPIRV-Tools support for SPIR-V 1.5 (#2865)
266 - Add WebGPU SPIR-V Assembler in JavaScript. (#2876)
267 - Add Bazel build configuration. (#2891)
Steven Perron615918c2019-10-21 14:15:36 -0400268 - Add support for building with emscripten (#2948)
269 - Update SPIR-V binary header test for SPIR-V 1.5 (#2967)
270 - Add fuzzer for spirv-as call path (#2976)
271 - Improved CMake install step. (#2963)
272 - Add fuzzer for spirv-dis call path (#2977)
273 - Ensure timestamp does not vary with timezone. (#2982)
Steven Perron2afbe902019-12-11 13:04:18 -0500274 - Add a vscode extension for SPIR-V disassembly files (#2987)
275 - Add iOS as a supported platform (#3001)
276 - utils/vscode: Add SPIR-V language server support
277 - Respect CMAKE_INSTALL_LIBDIR in installed CMake files (#3054)
278 - Permit the debug instructions in WebGPU SPIR-V (#3063)
279 - Add support for Fuchsia. (#3062)
Steven Perron9b3cc3e2019-09-03 15:51:46 -0400280 - Optimizer
281 - Add descriptor array scalar replacement (#2742)
282 - Add pass to wrap OpKill in a function call (#2790)
283 - Fold FMix during constant folding. (#2818)
284 - Add pass to replace AMD shader ballot extension (#2811)
285 - Add pass to make Float32 operation relax precision (#2808)
286 - Add pass to make relax precision operation Float16 (#2808)
Steven Perronc3ca0472019-10-09 09:43:01 -0400287 - Add pass to replace uses of 3 AMD extensions (#2814)
288 - Fold Min, Max, and Clamp instructions. (#2836)
289 - Better handling of OpKill in continues (#2842,#2922,#2933)
290 - Enable OpTypeCooperativeMatrix specialization (#2927)
Steven Perron615918c2019-10-21 14:15:36 -0400291 - Support constant-folding UConvert and SConvert (#2960)
Steven Perron2afbe902019-12-11 13:04:18 -0500292 - Update Offset to ConstOffset bitmask if operand is constant. (#3024)
293 - Improve RegisterSizePasses (#3059)
294 - Folding: perform add and sub on mismatched integer types (#3084)
295 - Graphics robust access: use signed clamp (#3073)
Steven Perron9b3cc3e2019-09-03 15:51:46 -0400296 Fixes:
Steven Perronc3ca0472019-10-09 09:43:01 -0400297 - Instrument: Fix version 2 output record write for tess eval shaders. (#2782)
298 - Instrument: Add support for Buffer Device Address extension (#2792)
299 - Fix check for changed binary in API call. (#2798)
300 - For WebGPU<->Vulkan optimization, set correct execution environment (#2834)
301 - Handle OpConstantNull in copy-prop-arrays. (#2870)
302 - Use OpReturn* in wrap-opkill (#2886)
Steven Perron9b3cc3e2019-09-03 15:51:46 -0400303 - Validator
Steven Perronc3ca0472019-10-09 09:43:01 -0400304 - Add generic builtin validation of target (#2843)
305 - Extra resource interface validation (#2864)
306 - Adding valilidation checks for OpEntryPoint duplicate names and execution mode (#2862)
307 - Relaxed bitcast with pointers (#2878)
308 - Validate physical storage buffer restrictions (#2930)
Steven Perron2afbe902019-12-11 13:04:18 -0500309 - Add SPV_KHR_shader_clock validation (#2879, #3013)
Steven Perron615918c2019-10-21 14:15:36 -0400310 - Validate that selections are structured (#2962)
311 - Disallow use of OpCompositeExtract/OpCompositeInsert with no indices (#2980)
312 - Check that derivatives operate on 32-bit values (#2983)
Steven Perron2afbe902019-12-11 13:04:18 -0500313 - Validate array stride does not cause overlap (#3028)
314 - Validate nested constructs (#3068)
Steven Perron9b3cc3e2019-09-03 15:51:46 -0400315 Fixes:
Steven Perronc3ca0472019-10-09 09:43:01 -0400316 - Fix validation of constant matrices (#2794)
317 - Update "remquor" validation
318 - Only allow previously declared forward refs in structs (#2920)
Steven Perron9b3cc3e2019-09-03 15:51:46 -0400319 - Reduce
320 - Remove relaxed precision decorations (#2797)
Steven Perronc3ca0472019-10-09 09:43:01 -0400321 - Reduce/fuzz: improve command line args (#2932)
322 - Improve remove unref instr pass (#2945)
Steven Perron9b3cc3e2019-09-03 15:51:46 -0400323 Fixes:
Steven Perronc3ca0472019-10-09 09:43:01 -0400324 - Fuzz
325 - Fix add-dead-break and add-dead-continue passes to respect dominance (#2838)
326 - Add fuzzer pass to copy objects (#2853)
327 - Add fuzzer pass to replace ids with synonyms (#2857)
328 - Allow validation during spirv-fuzz replay (#2873)
329 - Employ the "swarm testing" idea in spirv-fuzz (#2890)
330 - reduce/fuzz: improve command line args (#2932)
331 - option to convert shader into a form that renders red (#2934)
332 - Add fuzzer pass to change selection controls (#2944)
333 - add transformation and pass to construct composites (#2941)
Steven Perron615918c2019-10-21 14:15:36 -0400334 - Add fuzzer pass to change loop controls (#2949)
335 - Add fuzzer pass to change function controls (#2951)
336 - Add fuzzer pass to add NoContraction decorations (#2950)
Steven Perron2afbe902019-12-11 13:04:18 -0500337 - Add missing functionality for matrix composites (#2974)
338 - Fuzzer pass to adjust memory access operands (#2968)
339 - Transformation to extract from a composite object (#2991)
340 - Vector shuffle transformation (#3015)
341 - Improve debugging facilities (#3074)
342 - Function outlining fuzzer pass (#3078)
Steven Perronc3ca0472019-10-09 09:43:01 -0400343
Steven Perron22ce39c2019-08-08 10:57:18 -0400344
Steven Perrond65513e2019-08-08 10:55:48 -0400345v2019.4 2019-08-08
Steven Perronc26c2612019-08-08 10:52:01 -0400346 - General:
347 - Memory model support for SPIR-V 1.4
348 - Add new spirv-fuzz tool
349 - Add option for base branch in check_code_format.sh
350 - Removed MarkV and Stats code. (#2576)
351 - Instrument: Add version 2 of record formats (#2630)
352 - Linker: Better type comparison for OpTypeArray and OpTypeForwardPointer (#2580)
353 - Optimizer
354 - Bindless Validation: Instrument descriptor-based loads and stores (#2583)
355 - Better folding for OpSpecConstantOp (#2585, #2614)
356 - Add in individual flags for Vulkan <-> WebGPU passes (#2615)
357 - Handle nested breaks from switches. (#2624)
358 - Optimizer: Handle array type with OpSpecConstantOp length (#2652)
359 - Perform merge return with single return in loop. (#2714)
Jaebaek Seodac92102019-08-15 08:46:59 -0400360 - Add --preserve-bindings and --preserve-spec-constants (#2693)
Steven Perronc26c2612019-08-08 10:52:01 -0400361 - Remove Common Uniform Elimination Pass (#2731)
362 - Allow ray tracing shaders in inst bindle check pass. (#2733)
363 - Add pass to inject code for robust-buffer-access semantics (#2771)
364 - Treat access chain indexes as signed in SROA (#2776)
365 - Handle RelaxedPrecision in SROA (#2788)
Steven Perrond65513e2019-08-08 10:55:48 -0400366 - Add descriptor array scalar replacement (#2742)
Steven Perronc26c2612019-08-08 10:52:01 -0400367 Fixes:
368 - Handle decorations better in some optimizations (#2716)
369 - Change the order branches are simplified in dead branch elim (#2728)
370 - Fix bug in merge return (#2734)
371 - SSA rewriter: Don't use trivial phis (#2757)
372 - Record correct dominators in merge return (#2760)
373 - Process OpDecorateId in ADCE (#2761)
374 - Fix check for unreachable blocks in merge-return (#2762)
375 - Handle out-of-bounds scalar replacements. (#2767)
376 - Don't move debug or decorations when folding (#2772)
377 - Protect against out-of-bounds references when folding OpCompositeExtract (#2774)
378 - Validator
379 - Validate loop merge (#2579)
380 - Validate construct exits (#2459)
381 - Validate OpenCL memory and addressing model environment rules (#2589)
382 - Validate OpenCL environment rules for OpTypeImage (#2606)
383 - Allow breaks to switch merge from nested construct (#2604)
384 - Validate OpenCL environment rules for OpImageWrite (#2619)
385 - Allow arrays of out per-primitive builtins for mesh shaders (#2617)
386 - Validate OpenCL rules for ImageRead and OpImageSampleExplicitLod (#2643)
387 - Add validation for SPV_EXT_fragment_shader_interlock (#2650)
388 - Add builtin validation for SPV_NV_shader_sm_builtins (#2656)
389 - Add validation for Subgroup builtins (#2637)
390 - Validate variable initializer type (#2668)
391 - Disallow stores to UBOs (#2651)A
392 - Validate Volatile memory semantics bit (#2672)
393 - Basic validation for Component decorations (#2679)
394 - Validate that in OpenGL env block variables have Binding (#2685)
395 - Validate usage of 8- and 16-bit types with only storage capabilities (#2704)
396 - Add validation for SPV_EXT_demote_to_helper_invocation (#2707)
397 - Extra small storage validation (#2732)
398 - For Vulkan, disallow structures containing opaque types (#2546)
399 - Validate storage class OpenCL environment rules for atomics (#2750)
400 - Update OpControlBarriers rules for WebGPU (#2769)
401 - Update OpMemoryBarriers rules for WebGPU (#2775)
402 - Update WebGPU validation rules of OpAtomic*s (#2777)
403 Fixes:
404 - Disallow merge targeting block with OpLoopMerge (#2610)
405 - Update vloadn and vstoren validation to match the OpenCL Extended
406 Instruction Set Specification (#2599)
407 - Update memory scope rules for WebGPU (#2725)
408 - Allow LOD ops in compute shaders with derivative group execution modes (#2752)
409 - Reduce
410 Fixes:
Steven Perron84aa4942019-05-15 15:10:21 -0400411
Steven Perronce19e212019-05-15 15:08:51 -0400412v2019.3 2019-05-14
Steven Perron26c1b882019-04-03 13:22:54 -0400413 - General:
Steven Perronf815e6f2019-05-14 10:03:45 -0400414 - Require Python 3 since Python 2 will out of service soon.
Steven Perron26c1b882019-04-03 13:22:54 -0400415 - Add a continuous test that does memory checks using the address sanitizer.
Steven Perronf815e6f2019-05-14 10:03:45 -0400416 - Fix the build files so the SPIRV_USE_SANITIZER=address build works.
417 - Packaging top of tree build artifacts again.
418 - Added support for SPIR-V 1.4. (#2550)
Steven Perron26c1b882019-04-03 13:22:54 -0400419 - Optimizer
420 - Remove duplicates from list of interface IDs in OpEntryPoint instruction (#2449)
421 - Bindless Validation: Descriptor Initialization Check (#2419)
422 - Add option to validate after each pass (#2462)
Steven Perronf815e6f2019-05-14 10:03:45 -0400423 - Add legalization pass to fix mismatched pointer (#2430, #2535)
424 - Add error messages when the input contains unknown instructions. (#2487)
425 - Add pass to convert from WebGPU Spir-V to Vulkan Spir-V and back. (#2495)
Steven Perron26c1b882019-04-03 13:22:54 -0400426 Fixes:
427 - #2412: Dead memeber elimination should not change input and output variables.
428 - #2405: Fix OpDot folding of half float vectors.
429 - #2391: Dead branch elim should not fold away back edges.
430 - #2441: Removing decorations when doing constant propagation.
431 - #2455: Maintain inst to block mapping in merge return.
432 - #2453: Fix merge return in the face of breaks.
433 - #2456: Handle dead infinite loops in DCE.
434 - #2458: Handle variable pointer in some optimizations.
435 - #2452: Fix dead branch elimination to handle unreachable blocks better.
Steven Perronf815e6f2019-05-14 10:03:45 -0400436 - #2528: Fix undefined bit shift in sroa.
437 - #2539: Change implementation of post order CFG traversal.
Steven Perron26c1b882019-04-03 13:22:54 -0400438 - Validator
439 - Add validation of storage classes for WebGPU (#2446)
440 - Add validation for ExecutionMode in WebGPU (#2443)
441 - Implement WebGPU specific CFG validation (#2386)
442 - Allow NonWritable to target struct members. (#2420)
443 - Allow storage type mismatch for parameter in relaxed addressing mode.
444 - Allow non memory objects as parameter in relaxed addressing mode.
445 - Disallow nested Blocks and buffer blocks (#2410).
446 - Add validation for SPV_NV_cooperative_matrix (#2404)
447 - Add --strip-atomic-counter-memory (#2413)
448 - Check OpSampledImage is only passed into valid instructions (#2467)
449 - Handle function decls in Structured CFG analysis (#2474)
450 - Validate that OpUnreacahble is not statically reachable (#2473)
451 - Add pass to generate needed initializers for WebGPU (#2481)
Steven Perronf815e6f2019-05-14 10:03:45 -0400452 - Allow images without format for OpenCL. (#2470)
453 - Remove unreachable block validation (#2525)
454 - Reduce runtime of array layout checks (#2534)
455 - Add validation specific to OpExecutionModeId (#2536)
456 - Validate sign of int types. (#2549)
457 - VK_KHR_uniform_buffer_standard_layout validation (#2562)
Steven Perron26c1b882019-04-03 13:22:54 -0400458 Fixes:
459 - #2439: Add missing DepthGreater case to Fragment only check.
460 - #2168: Disallow BufferBlock on StorageBuffer variables for Vulkan.
461 - #2408: Restrict and Aliased decorations cannot be applied to the same id.
462 - #2447: Improve function call parameter check.
463 - Reduce
464 - Add Pass to remove unreferenced blocks. (#2398)
465 - Allows passing options to the validator. (#2401)
466 - Improve reducer algorithm and other changes (#2472)
467 - Add Pass to remove selections (#2485)
Steven Perronf815e6f2019-05-14 10:03:45 -0400468 - Add passes to simplify branches (#2507)
Steven Perron26c1b882019-04-03 13:22:54 -0400469 Fixes:
470 - #2478: fix loop to selection pass for loops with combined header/continue block
Steven Perron5994ae22019-02-20 11:05:57 -0500471
Steven Perron61dfd842019-02-20 11:04:41 -0500472v2019.2 2019-02-20
Steven Perron80496f42019-02-19 12:54:42 -0500473 - General:
474 - Support SPV_EXT_physical_storage_buffer
475 - A number of memory leak have been fixed.
476 - Removed use of deprecated Google test macro:
477 - Changed the BUILD.gn to only build tests in Chromium.
478 - Optimizer
479 - Upgrade memory model improvments for modf and frexp.
480 - Add a new pass to move loads closer to their uses: code sinking.
481 - Invalidating the type manager now invalidates the constnat manager.
482 - Expand instrumentation pass for bindless bounds checking to runtime-sized descriptor arrays.
483 - Add a new pass that removes members from structs that are not used: dead member elimination.
484 Fixes:
485 - #2292: Remove undefined behaviour when folding bit shifts.
486 - #2294: Fixes for instrumentation code.
487 - #2293: Fix overflow when folding -INT_MIN.
488 - #2374: Don't merge unreachable blocks when merging blocks.
489 - Validator
490 - Support SPV_KHR_no_integer_wrap and related decorations.
491 - Validate Vulkan rules for OpTypeRuntimeArray.
492 - Validate NonWritable decoration.
493 - Many WebGPU specific validation rules were added.
494 - Validate variable pointer related function call rules.
495 - Better error messages.
496 Fixes:
497 - #2307: Check forwards references in OpTypeArray.
498 - #2315, #2303: Fixed the layout check for relaxed layout.
499 - #1628: Emit an error when an OpSwitch target is not an OpLabel.
500 - Reduce
501 - Added more documentation for spirv-reduce.
502 - Add ability to remove OpPhi instructions.
503 - Add ability to merge two basic blocks.
504 - Add ability to remove unused functions and unused basic blocks.
505 Fixes:
Steven Perronee95ab12019-01-07 15:51:06 -0500506
Steven Perron2297d4a2019-01-07 15:48:55 -0500507v2019.1 2019-01-07
Steven Perron248debf2018-12-10 14:33:14 -0500508 - General:
509 - Created a new tool called spirv-reduce.
510 - Add cmake option to turn off SPIRV_TIMER_ENABLED (#2103)
511 - New optimization pass to update the memory model from GLSL450 to VulkanKHR.
Steven Perron04cc2b12019-01-07 10:12:14 -0500512 - Recognize OpTypeAccelerationStructureNV as a type instruction and ray tracing storage classes.
513 - Fix GCC8 build.
514 - Add --target-env flag to spirv-opt.
515 - Add --webgpu-mode flag to run optimizations for webgpu.
516 - The output disassembled line number stead of byte offset in validation errors. (#2091)
Steven Perron248debf2018-12-10 14:33:14 -0500517 - Optimizer
518 - Added the instrumentation passes for bindless validation.
519 - Added passes to help preserve OpLine information (#2027)
520 - Add basic support for EXT_fragment_invocation_density (#2100)
521 - Fix invalid OpPhi generated by merge-return. (#2172)
Steven Perron04cc2b12019-01-07 10:12:14 -0500522 - Constant and type manager have been turned into analysies. (#2251)
Steven Perron248debf2018-12-10 14:33:14 -0500523 Fixes:
524 - #2018: Don't inline functions with a return in a structured CFG contstruct.
525 - #2047: Fix bug in folding when volatile stores are present.
526 - #2053: Fix check for when folding floating pointer values is allowed.
527 - #2130: Don't inline recursive functions.
Steven Perron04cc2b12019-01-07 10:12:14 -0500528 - #2202: Handle multiple edges between two basic blocks in SSA-rewriter.
529 - #2205: Don't unswitch a latch condition during loop unswitch.
530 - #2245: Don't fold branch in loop unswitch. Run dead branch elimination to fold them.
531 - #2204: Fix eliminate common uniform to place OpPhi instructions correctly.
532 - #2247: Fix type mismatches caused by scalar replacement.
533 - #2248: Fix missing OpPhi after merge return.
534 - #2211: After merge return, fix invalid continue target.
535 - #2210: Fix loop invariant code motion to not place code between merge instruction and branch.
536 - #2258: Handle CompositeInsert with no indices in VDCE.
537 - #2261: Have replace load size handle extact with no index.
Steven Perron248debf2018-12-10 14:33:14 -0500538 - Validator
539 - Changed the naming convention of outputing ids with names in diagnostic messages.
540 - Added validation rules for UniformConstant variables in Vulkan.
541 - #1949: Validate uniform variable type in Vulkan
542 - Ensure for OpVariable that result type and storage class operand agree (#2052)
543 - Validator: Support VK_EXT_scalar_block_layout
544 - Added Vulkan memory model semantics validation
545 - Added validation checkes spefic to WebGPU environment.
546 - Add support for VK_EXT_Transform_feedback capabilities (#2088)
547 - Add validation for OpArrayLength. (#2117)
548 - Ensure that function parameter's type is not void (#2118)
549 - Validate pointer variables (#2111)
550 - Add check for QueueFamilyKHMR memory scope (#2144)
551 - Validate PushConstants annotation and type (#2140)
552 - Allow Float16/Int8 for Vulkan 1.0 (#2153)
553 - Check binding annotations in resource variables (#2151, #2167)
554 - Validate OpForwardPointer (#2156)
Steven Perron04cc2b12019-01-07 10:12:14 -0500555 - Validate operation for OpSpecConstantOp (#2260)
Steven Perron248debf2018-12-10 14:33:14 -0500556 Fixes:
557 - #2049: Allow InstanceId for NV ray tracing
558 - Reduce
559 - Initial commit wit a few passes to reduce test cases.
Steven Perron04cc2b12019-01-07 10:12:14 -0500560 - Validation is run after each reduction step.
Steven Perron248debf2018-12-10 14:33:14 -0500561 Fixes:
Steven Perron04cc2b12019-01-07 10:12:14 -0500562
Steven Perrone121da82018-11-07 09:40:35 -0500563
Steven Perron9d699f62018-11-07 09:39:51 -0500564v2018.6 2018-11-07
Steven Perrond3738be2018-09-27 10:06:44 -0400565 - General:
Steven Perrone8f22d12018-11-07 09:20:50 -0500566 - Added support for the Nvidia Turing and ray tracing extensions.
Steven Perrond3738be2018-09-27 10:06:44 -0400567 - Make C++11 the CXX standard in CMakeLists.txt.
Steven Perron2a88bcb2018-10-02 11:28:17 -0400568 - Enabled a parallel build for MSVC.
Steven Perron07d0f9d2018-10-22 15:10:53 -0400569 - Enable pre-compiled headers for MSVC.
570 - Added a code of conduct.
571 - EFFCEE and RE2 are now required when build the tests.
Steven Perrond3738be2018-09-27 10:06:44 -0400572 - Optimizer
573 - Unrolling loops marked for unrolling in the legalization passes.
574 - Improved the compile time of loop unrolling.
dan sinclaira1ea15c2020-07-29 13:50:58 -0400575 - Changee merge-return to create a placeholder loop around the function.
Steven Perrond3738be2018-09-27 10:06:44 -0400576 - Small improvement to merge-blocks to allow it to merge more often.
577 - Enforce an upper bound for the ids, and add option to set it.
Steven Perron07d0f9d2018-10-22 15:10:53 -0400578 - #1966: Report error if there are unreachable block before running merge return
Steven Perrond3738be2018-09-27 10:06:44 -0400579 Fixes:
580 - #1917: Allow 0 (meaning unlimited) as a parameter to --scalar-replacement
581 - #1915: Improve handling of group decorations.
Steven Perron2a88bcb2018-10-02 11:28:17 -0400582 - #1942: Fix incorrect uses of the constant manager. Avoids type mismatches in generated code.
Steven Perron07d0f9d2018-10-22 15:10:53 -0400583 - #1997: Fix dead branch elimination when there is a loop in folded selection.
584 - #1991: Fixes legality check in if-conversion.
585 - #1987: Add nullptr check to array copy propagation.
586 - #1984: Better handling of OpUnreachable in ADCE.
587 - #1983: Run merge return on reachable functions only.
588 - #1956: Handled atomic operations in ADCE.
589 - #1963: Fold integer divisions by 0 to 0.
Steven Perrone8f22d12018-11-07 09:20:50 -0500590 - #2019: Handle MemberDecorateStringGOOGLE in ADCE and strip reflect.
Steven Perrond3738be2018-09-27 10:06:44 -0400591 - Validator
592 - Added validation for OpGroupNonUniformBallotBitCount.
593 - Added validation for the Vulkan memory model.
594 - Added support for VK_KHR_shader_atddomic_int64.
Steven Perron2a88bcb2018-10-02 11:28:17 -0400595 - Added validation for execution modes.
Steven Perron07d0f9d2018-10-22 15:10:53 -0400596 - Added validation for runtime array layouts.
597 - Added validation for 8-bit storage.
598 - Added validation of OpPhi instructions with pointer result type.
599 - Added checks for the Vulkan memory model.
600 - Validate MakeTexelAvailableKHR and MakeTexelVisibleKHR
601 - Allow atomic function pointer for OpenCL.
602 - FPRounding mode checks were implemented.
Steven Perrone8f22d12018-11-07 09:20:50 -0500603 - Added validation for the id bound with an option to set the max id bound.
Steven Perrond3738be2018-09-27 10:06:44 -0400604 Fixes:
605 - #1882: Improve the validation of decorations to reduce memory usage.
606 - #1891: Fix an potential infinite loop in dead-branch-elimination.
607 - #1405: Validate the storage class of boolean objects.
608 - #1880: Identify arrays of type void as invalid.
609 - #487: Validate OpImageTexelPointer.
Steven Perron2a88bcb2018-10-02 11:28:17 -0400610 - #1922: Validate OpPhi instructions are at the start of a block correctly.
Steven Perron07d0f9d2018-10-22 15:10:53 -0400611 - #1923: Validate function scope variable are at the start of the entry block.
David Neto3e38c992018-09-07 11:42:12 -0400612
David Netob4cb01c2018-09-07 11:40:56 -0400613v2018.5 2018-09-07
David Neto4470ff42018-07-11 13:51:01 -0400614 - General:
David Neto03896b02018-09-07 11:37:54 -0400615 - Support SPV_KHR_vulkan_memory_model
616 - Update Dim capabilities, to match SPIR-V 1.3 Rev 4
617 - Automated build bots no run tests for the VS2013 case
David Neto0d8156a2018-08-01 10:29:43 -0400618 - Support Chromium GN build
619 - Use Kokoro bots:
620 - Disable Travis-CI bots
621 - Disable AppVeyor VisualStudio Release builds. Keep VS 2017 Debug build
622 - Don't check export symbols on OSX (Darwin): some installations don't have 'objdump'
David Neto4470ff42018-07-11 13:51:01 -0400623 - Reorganize source files and namespaces
624 - Fixes for ClangTidy, and whitespace (passes 'git cl presumit --all -uf')
625 - Fix unused param compile warnings/errors when Effcee not present
David Neto0d8156a2018-08-01 10:29:43 -0400626 - Avoid including time headers when timer functionality is disabled
David Neto03896b02018-09-07 11:37:54 -0400627 - Avoid too-stringent warnings flags for Clang on Windows
628 - Internal refactoring
629 - Add hooks for automated fuzzing
630 - Add testing of command line executables
David Neto4470ff42018-07-11 13:51:01 -0400631 - #1688: Use binary mode on stdin; fixes "spirv-dis <foo.spv" on Windows
David Neto85d37152018-07-18 10:58:22 -0400632 - Optimizer
David Neto03896b02018-09-07 11:37:54 -0400633 - The optimizer validates the module before it begins
David Neto0d8156a2018-08-01 10:29:43 -0400634 - Add API to register passes by string name
David Neto85d37152018-07-18 10:58:22 -0400635 - Fold a vector shuffle feeding a vector shuffle
David Neto0d8156a2018-08-01 10:29:43 -0400636 - Add -combine-access-chains transform
David Neto85d37152018-07-18 10:58:22 -0400637 - Refactor how IRContext is handled by passes
David Neto0d8156a2018-08-01 10:29:43 -0400638 - Improve bookkeeping for instruction result type and result id
David Neto03896b02018-09-07 11:37:54 -0400639 - Fix over-duplication of decorations
640 - Fix handling of exits from selections in dead-branch elimination, and dead code
641 elimination.
642 - Fix handling of certain kinds of flow control in merge-return
643 Fixes:
David Neto85d37152018-07-18 10:58:22 -0400644 - #1721: Fix size bug when folding vector shuffles
645 - #1722: Fix size infinite loop when folding vector shuffles
646 - #1724: Fix finding a constant of a specific type
David Neto0d8156a2018-08-01 10:29:43 -0400647 - #1727: Dead branch elim: Reorder blocks if needed to satisfy dominance rule
648 - #1729: Handle VariablePointers cases in various optimizations
649 - #1731: Fix vector shuffle with literal id indicating undef value
David Neto03896b02018-09-07 11:37:54 -0400650 - #1736: Fix handling of decorations and phis in merge-return
651 - #1787: Fix handling of decorations related to access chains
652 - #1865: Avoid leaking memory for SPIR-V constant values
David Neto4470ff42018-07-11 13:51:01 -0400653 - Validator
David Neto0d8156a2018-08-01 10:29:43 -0400654 - Improve error messages
David Neto03896b02018-09-07 11:37:54 -0400655 - Avoid platform-dependent traversal ordering, to ensure consistent messages
David Neto4470ff42018-07-11 13:51:01 -0400656 - Use libspirv::Instruction where possible
David Neto85d37152018-07-18 10:58:22 -0400657 - Add option to skip all block layout checks
David Neto03896b02018-09-07 11:37:54 -0400658 - Validate all type IDs
659 - Validate uses of OpFunction
660 - Validate uses of OpTypeFunction
661 - Disallow a struct containing its own type https://crbug.com/874372
David Neto4470ff42018-07-11 13:51:01 -0400662 - #1685: Vulkan permits non-monotonic offsets for block members
663 - #1697: Enforce block layout rules even when using relaxed block layout option
David Neto85d37152018-07-18 10:58:22 -0400664 - #1719: Fix line number for vector shuffle valiation error
David Neto03896b02018-09-07 11:37:54 -0400665 - #1789: Avoid assertion failure when validating some functions
666 - #1800: Fix validation of OpCopyMemorySized
667 - #1822: Stop enforcing struct member offset montonicity
668 - #1831: Disallow void members in structs
David Neto50312ca2018-07-08 12:53:46 -0400669
David Netof5088962018-07-08 12:50:46 -0400670v2018.4 2018-07-08
David Neto035afb82018-06-11 11:08:52 -0400671 - General:
David Neto9de00c92018-07-08 12:49:51 -0400672 - Support SPV_KHR_8bit_storage
673 - Add gclient and presubmit configurations
674 - Enable Kokoro build bots (#1625)
675 - Group tests into fewer executables, reduces load on CI
676 - Port test script to Python 3
677 - Symbol export tests respect SPIRV_SKIP_TESTS
678 - #1596: Operand lookup succeeds if enabled by a capability
679 - #1624: Instruction lookup succeeds if enabled by a capability
680 - Refactoring namespaces:
681 - #1678: Change libspirv to spvtools
682 - Code in source/utils moved into spvtools::utils
683 - Code in source/comp moved into spvtools::comp
David Neto035afb82018-06-11 11:08:52 -0400684 - Optimizer:
685 - Remove insert-extract-elim pass. Use simplification pass instead.
686 - Preserve instruction-to-block mapping in most passes, to reduce runtime.
David Neto9de00c92018-07-08 12:49:51 -0400687 - Small vector optimization for operands
688 - Add pass to move Private variables to Function. Increase opportunity to optimize.
David Neto035afb82018-06-11 11:08:52 -0400689 - Fixes:
David Neto9de00c92018-07-08 12:49:51 -0400690 #1120: Check static uses of entry point interfaces
691 #1372: Avoid merging some structs, to preserve names for reflection
692 #1577: Scalar replacement uses only undecorated types.
David Neto035afb82018-06-11 11:08:52 -0400693 #1578: Fix handling of forward-pointer types, and types embedding pointers
694 to themselves.
David Neto035afb82018-06-11 11:08:52 -0400695 #1591: Inliner: Callee variable with initializer should have a store at the call site.
David Neto9de00c92018-07-08 12:49:51 -0400696 #1634: Fix crash: Use type id in vector type lookup
697 #1649: Fix assert in compact-ids pass
698 Fix constant folder: ensure it uses the right type
699 #1659: Folding rules added to IRContext. Avoids leak.
David Neto035afb82018-06-11 11:08:52 -0400700 - Validator
David Neto9de00c92018-07-08 12:49:51 -0400701 - Add work-in-progress WebGPU environment. Disallows OpUndef
702 - #670, #1581: Improve error messages; disassemble instruction
703 - #491: Check structured switches
704 - #937: Check layout rules for Block and BufferBlock in Uniform, StorageBuffer, PushConstant
705 - #1281: Check invalid branches into structured constructs
706 - #1522: Disallow array-of-arrays with DescriptorSets
David Neto035afb82018-06-11 11:08:52 -0400707 - #1577: Allow duplicate pointer types.
708 - #1581: Better messages: output ID names along with numbers in more cases.
David Neto9de00c92018-07-08 12:49:51 -0400709 - #1597: Check Vulkan 1.1 capabilities
710 - #1618: Check invalid exit from structured case construct
711 - #1622: Run IdPass before DataRulesPass
712 - #1632: Reduce test time by artificially lowering limits in limit test
713 - #1638: Block-decorated structs member order must respect offset order
714 - #1657: Improve CFG validation diagnostics
715 - Khronos SPIR-V #337: GLSL.std.450 Refract instruction Eta param can be any float scalar.
716 - #1606: PushConstant Blocks follow storage-buffer layout rules
717 - #1664: Check layout of StorageBuffer variables with Block decoration, using storage buffer
718 rules
719 - #1666: Layout validation should permit {vec3; float} packing
720 - #1637, #1668: Layout validation uses RowMajor, ArrayStride, MatrixStride properly
721 - Linker
722 - Avoid buffer overrun when creating OpModuleProcessed
David Neto6b836432018-05-25 22:14:30 -0400723
David Neto545d6ca2018-05-25 22:12:25 -0400724v2018.3 2018-05-25
David Neto5f53c422018-04-06 16:42:56 -0400725 - General:
726 - Support SPV_EXT_descriptor_indexing
727 - Support SPV_GOOGLE_decorate_string
728 - Support SPV_GOOGLE_hlsl_functionality1
729 - Support SPV_NV_shader_subgroup_partitioned
730 - Use "unified1" grammar from SPIRV-Headers
731 - Simplify support for new extensions. Assembler, disassembler, and simple validation
732 support is automatic if new tokens are introduced with appropriate extension
733 attributes in the "unified1" SPIR-V core grammar.
734 - Disassembler: Emit more digits on floating point, to reliably reproduce all
735 significand bits. (Use std::max_digits10 instead of std::digits10)
David Neto6a986d02018-05-25 21:58:26 -0400736 - Fix compilation for old XCode versions: Explicit construction required for std::set.
David Neto5f53c422018-04-06 16:42:56 -0400737 - Optimizer:
738 - Add --strip-reflect
739 - Add --time-report
David Neto6a986d02018-05-25 21:58:26 -0400740 - Add --loop-fission
741 - Add lop fusion.
742 - Add loop peeling pass and internal utility.
743 - Improve optimizer runtime.
David Neto5f53c422018-04-06 16:42:56 -0400744 - Merge-return now works with structured control flow.
745 - New (faster) SSA rewriter to convert local loads and stores to SSA IDs and phis.
746 Can replace load/store elimination passes.
747 - Fix instruction folding case: insertion that feeds and extract, when the extract
748 remains.
David Neto6a986d02018-05-25 21:58:26 -0400749 - Fold OpDot.
750 - Fold OpFNegate.
751 - Fold multply and divide of same value.
752 - Fold FClamp feeding a compare.
753 - Fold OpLoad feeding an extract, to reduce excessive copying. (#1547)
754 - Fold Fmix feeding an extract.
755 - Use simplification pass instead of insert-extract elimination.
756 - Constant fold OpVectorTimesScalar.
David Neto5f53c422018-04-06 16:42:56 -0400757 - Copy propagate arrays, in simple cases.
David Neto6a986d02018-05-25 21:58:26 -0400758 - Aggressive dead code elimination: Can remove more instructions, e.g. derivatives.
759 - Aggressive dead code elimination: Remove Workgroup variables that are written but not read.
David Neto5f53c422018-04-06 16:42:56 -0400760 - Better handling of OpImageTexelPointer
David Neto5f53c422018-04-06 16:42:56 -0400761 - Initial utilities for scalar evolution.
David Neto6a986d02018-05-25 21:58:26 -0400762 - Add Vector dead code elimination.
763 - Each pass can only run once.
764 - Allow code hosting in if-conversion.
765 - Add external interface for adding a PassToken, so external code can make their own
766 passes.
767 - Fixes:
768 #1404: Don't optimize away the compute compute workgroup size constant.
769 #1407: Remove a bad assertion
770 #1456: Fix bug in SSA rewriter related to variables updated in loops.
771 #1487: Fix long runtime in Dead insertion elimination: Don't revist select phi nodes.
772 #1492: Aggressive dead code elimination can remove OpDecorateStringGOOGLE.
773 #1527: Fix inlining of functions having OpKill and OpUnreachable.
774 #1559: Fix assert failure in reduce-load-size pass.
775 #1556: Aggressive dead code elimination: Fix handling of OpCopyMemory.
David Neto5f53c422018-04-06 16:42:56 -0400776 - Validator:
777 - Check Vulkan built-in variables
778 - Check Vulkan-specific atomic result type rule.
779 - Relax control barrier check for SPIR-V 1.3. Fixes #1427
780 - Check OpPhi.
David Neto6a986d02018-05-25 21:58:26 -0400781 - Check OpMemoryModel.
David Neto5f53c422018-04-06 16:42:56 -0400782 - Stop checking sizes derived from spec-constants.
783 - Re-enable checks for OpUConvert.
David Neto6a986d02018-05-25 21:58:26 -0400784 - Vulkan: Fix check for PrimitiveId: Permit as Input in fragment shader.
785 - Validate binary version for the given target environment.
786 - Add tests for OpBranch checks.
787 - Vulkan 1.1: Check scope for non-uniform subgroup operations.
788 - Fix checks for SPV_AMD_gpu_shader_int16.
789 - Fix logical layout check for OpDecorateId.
790 - Fix checks for ViewportIndex & Layer for Vulkan and SPV_EXT_shader_viewport_index_layer.
791 - Fixes:
792 #1470: Vulkan: Don't restrict WorkgroupSize to Input storage class.
793 #1469: Vulkan: Permit Subgroup memory scope for Vulkan 1.1.
794 #1472: Per-vertex variable validation fixes.
795 #1483: Valdiate barrier execution scopes for Vulkan 1.1.
David Neto5f53c422018-04-06 16:42:56 -0400796 - Fixes:
797 #898: Linker properly removes FuncParamAttr from imported symbols.
798 #924, #1174: Fix handling of decoration groups in optimizer, linker.
David Netoac434662018-03-07 17:13:18 -0500799
David Neto8d8a7122018-03-07 17:11:50 -0500800v2018.2 2018-03-07
David Netoa0da44e2018-03-07 17:10:13 -0500801 - General:
David Neto8d8a7122018-03-07 17:11:50 -0500802 - Support SPIR-V 1.3 and Vulkan 1.1.
803 - Default target environment is now SPIR-V 1.3. For command-line tools,
804 use the --target-env option to override the default. Examples:
805 # Generate a SPIR-V 1.0 binary instead of SPIR-V 1.3
806 spirv-as --target-env spv1.0 a.spvasm -o a.spv
807 spirv-as --target-env vulkan1.0 a.spvasm -o a.spv
808 # Validate as Vulkan 1.0
809 spirv-val --target-env vulkan1.0 a.spv
David Netoa0da44e2018-03-07 17:10:13 -0500810 - Support SPV_GOOGLE_decorate_string and SPV_GOOGLE_hlsl_functionality1
811 - Fixes:
812 - Fix Android.mk build. Compilation was failing due to missing definitions of
813 SpvCapabilityFloat16ImageAMD and other enumerated values.
814 - Optimizer: Avoid generating duplicate names when merging types.
815 - #1375: Validator: SPV_AMD_gpu_shaer_half_float implicitly allows declaration
816 of the 16-bit floating point type.
817 - #1376: Optimizer: Avoid folding half-precision float.
David Netofe219212018-03-02 14:11:58 -0500818
David Neto6432a122018-03-02 14:10:43 -0500819v2018.1 2018-03-02
David Netoc452bfd2018-02-06 11:47:44 -0500820 - General:
821 - Support Visual Studio 2013 again. (Continue support for VS 2015 and VS 2017.)
David Netob08b94e2018-02-27 11:48:40 -0500822 - Support building SPIRV-Tools as a shared library.
823 - Improve the HLSL legalization optimization recipe. #1311
David Netoc452bfd2018-02-06 11:47:44 -0500824 - Optimizer:
David Netob08b94e2018-02-27 11:48:40 -0500825 - General speedups.
David Netoa7cec782018-03-02 14:01:28 -0500826 - Remove generic dead code elimination functionality from transforms:
827 --eliminate-local-single-block
828 --eliminate-local-single-store
829 --eliminate-local-multi-store
830 To recover the previous behaviour, a recipe using those transforms should now
831 also invoke the --eliminate-dead-code-aggressive transform.
832 - Improve folding, including coverage for floating point, OpSelect, and arithmetic
833 with non-trivial constant operands.
David Netob08b94e2018-02-27 11:48:40 -0500834 - Add loop-invariant code motion pass.
835 - Add loop-unrolling pass, for honouring unroll hits.
836 - Add loop-unswitch pass.
837 - Add instruction simplification pass.
David Netoc452bfd2018-02-06 11:47:44 -0500838 - Aggressive dead code elimination: Understands capability hierarchy when finding
839 instructions it can eliminate (combinators). (PR #1268)
David Netob08b94e2018-02-27 11:48:40 -0500840 - CCP can now fold floating point arithmetic. #1311
David Netoc452bfd2018-02-06 11:47:44 -0500841 - Validator:
842 - Validate barrier instructions.
David Netob08b94e2018-02-27 11:48:40 -0500843 - Check Vulkan-specific rules for atomics.
David Netoa7cec782018-03-02 14:01:28 -0500844 - Check Vulkan prohibition of Location or Component decorations on BuiltIn variables.
845 - Linker:
846 - Add --verify-ids option
847 - Add option to allow a resulting module to be partially linked.
848 - Handle OpModuleProcessed (instructions in SPIR-V layout section 7c)
David Netoc452bfd2018-02-06 11:47:44 -0500849 - Fixes:
850 - #1265: Optimizer: Fix use-after free bug in if-conversion. (Fix object lifecycle bug
851 in type manager.)
David Netob08b94e2018-02-27 11:48:40 -0500852 - #1282: Fix new warnings found by GCC 8.0.1.
853 - #1285: Optimizer: Fix random failures during inlining. (Dangling references in DefUseManager)
854 - #1295: Optimizer: Fix incorrect handling of Phi nodes in CCP.
855 - #1300: Fix CCP: avoid bad CCP transitions and unsettled values.
856 - #1304: Avoid static-duration variables of class type (with constructors).
857 - #1323: Fix folding of an insert composite feeding a composite extract.
858 - #1339: Fix CCP: Handle OpConstantNull boolean values as conditions.
859 - #1341: DCEInst: Keep atomic instructions (and some others with side effects).
David Netoa7cec782018-03-02 14:01:28 -0500860 - #1354: Don't fold integer division.
861 - #1357: Support OpConstantNull in folding.
862 - #1361: CCP: Fix handling of non-constant module-scope values
David Neto1c0056c2018-02-02 11:27:07 -0500863
David Netoc430a412018-02-02 11:25:58 -0500864v2018.0 2018-02-02
David Netobcd4f232018-02-02 11:23:33 -0500865 - General
866 - VisualStudio 2013 is no longer supported. VisualStudio 2015 is supported.
867 - Use "include/unified1" directory from SPIRV-Headers. Requires recent SPIRV-Headers source.
David Neto38f297c2018-01-30 17:47:00 -0500868 - Disassembler: spirv-dis adds --color option to force color disassembly.
Alan Baker80b743a2018-01-15 13:25:45 -0500869 - Optimizer:
David Neto38f297c2018-01-30 17:47:00 -0500870 - Add pass to eliminate dead insertions.
871 - Aggressive dead code elimination now removes OpSwitch constructs.
872 - Block merging occurs in more cases.
873 - Add driver workaround transform: replace OpUnreachable with harmless branch to merge.
874 - Improve instruction folding framework.
David Netobcd4f232018-02-02 11:23:33 -0500875 - Add loop analysis.
876 - Add scalar replacement of aggregates to size-optimization recipe.
877 - Add pass to replace instructions invalid for a shader stage, with a harmless value.
878 This changes the semantics of the program! Not for general use!
879 - Rearragne and add passes to performance-optimization recipe, to produce better results.
David Neto38f297c2018-01-30 17:47:00 -0500880 - Validator:
David Netobcd4f232018-02-02 11:23:33 -0500881 - Validate OpenCL extended instructions.
David Neto38f297c2018-01-30 17:47:00 -0500882 - Shaders can't perform atomics on floats.
David Netobcd4f232018-02-02 11:23:33 -0500883 - Validate memory semantics values in atomics.
884 - Validate instruction-adjacency constraints, e.g. OpPhi predecessors, merge instructions
885 immediately precede branches.
David Netoba017f72018-01-12 18:52:42 -0500886 - Fixes:
887 - PR 1198: Optimizer: Fix CCP in presence of matrix constants.
David Netoae6daee2018-01-16 22:52:39 -0500888 - #1199: Optimizer: Fix CCP: don't propagate spec constants.
889 - #1203: Optimizer: Fix common uniform elim bug introduced by refactoring.
David Neto38f297c2018-01-30 17:47:00 -0500890 - #1210: Optimizer: Aggressive dead code elimination: Fix 'break' identification.
891 - #1212: Optimizer: Aggressive dead code elimination: Was skipping too many instructions.
892 - #1214: Optimizer: Aggressive dead code elimination: Fix infinite loop.
893 - #1228: Optimizer: Fix CCP: Handling of varying Phi nodes; was resulting in infinite loop.
894 - #1245: Optimizer: Dead branch elimination: Avoid a null pointer dereference.
895 - #1250: Optimizer: Dead branch elimination: Avoid spuriously reporting a change.
David Neto86dec642018-01-12 13:33:43 -0500896
David Neto902ed462018-01-12 13:32:04 -0500897v2017.3 2018-01-12
David Neto2e5672d2017-12-19 17:50:01 -0500898 - General:
David Neto902ed462018-01-12 13:32:04 -0500899 - Support DebugInfo extended instruction set, targeted at OpenCL environments.
900 See the SPIR-V Registry.
901 - Generate a SPIRV-Tools.pc file for pkg-config.
David Neto2e5672d2017-12-19 17:50:01 -0500902 - Optimizer:
David Neto902ed462018-01-12 13:32:04 -0500903 - Progress for legalization of code generated from HLSL (issue #1118):
904 - Add --legalize-hlsl option to run transforms used to transform intermediate
905 code generated by HLSL to SPIR-V for Vulkan compilers. Those compilers
906 normally run these transforms automatically. This option is used for developing
907 those transforms.
908 - Add Private-to-Function variable conversion for modules with logical
909 addressing.
910 - Add --ccp: SSA Conditional Constant Propagation (CCP)
911 - Add --print-all to show disassembly for each optimization pass.
912 - Internal: Add loop descriptors and post-order tree iterator.
913 - Generalized dead branch elimination
914 - Aggressive dead code elimination (ADCE) now removes dead functions and
915 module-scope variables.
916 - Vector extract/insert elimination now optimizes through some cases of
917 VectorShuffle, and GLSL.std.450 Mix extended instruction.
David Neto2e5672d2017-12-19 17:50:01 -0500918 - Validator:
David Neto902ed462018-01-12 13:32:04 -0500919 - Add validation for GLSL.std.450 extended instruction set.
920 - Check out of bounds composite accesses, where that's statically computable.
921 Fixes #1112.
David Neto2e5672d2017-12-19 17:50:01 -0500922 - Check upper bits of literal numbers that aren't a multiple of 32-bits wide.
923 - More validation of primitive instructions
David Neto902ed462018-01-12 13:32:04 -0500924 - Add optional "relaxed" checking logical addressing mode to permit some
925 cases of pointer-to-pointer. Contributes to HLSL legalization (issue #1118).
David Neto2e5672d2017-12-19 17:50:01 -0500926 - Fixes:
927 #1100: Validator: Image operand Sample can be used with OpImageSparseFetch,
David Neto902ed462018-01-12 13:32:04 -0500928 OpImageSparseRead.
David Neto2e5672d2017-12-19 17:50:01 -0500929 #1108: Remove duplicates transform was incorrectly removing non-duplicate
930 decorations.
David Neto902ed462018-01-12 13:32:04 -0500931 #1111: Optimizer's type manager could reference deleted memory.
932 #1112: Fix decoration equality check, e.g. it is now symmetric.
933 #1129: Validator now disallows Dim=SupbassData for OpImageSparseRead.
934 #1143: Fix CCP: Was generating incorrect code for loops.
935 #1153: Fix CCP crash.
936 #1154: Optimizer's internal instruction-to-block mappings were sometimes
937 inconsistent.
938 #1159: Fix CCP infinite loop.
939 #1168: Fix dead branch elimination intermittently generating incorrect code.
940 Fixes https://github.com/KhronosGroup/glslang/issues/1205
941 #1186: Fix validation of PackDouble2x32 and UnpackDouble2x32
David Neto73610342017-12-15 18:24:41 -0500942
David Neto1ccfb582017-12-15 18:21:55 -0500943v2017.2 2017-12-15
944 - General:
945 - Support OpenCL 1.2, 2.0 target environments, including embedded profiles
946 - Add CONTRIBUTING.md
947 - Fix exit status code for spirv-link
948 - Disassember: Enable emitting ANSI colour codes to a string
949 - Library avoids polluting global namespace. The libraries can export C and C++
950 symbols starting with "spv", or in a C++ namespace. Add a test for this.
951 - Linux release builds include debug information, for easier profiling
952 - Build bots no longer test VisualStudio 2013
953 - Testing dependency RE2 requires VisualStudio 2015 or later
954 - Build bots check code formatting
Stephen McGroarty8ba68fa2017-11-27 21:21:26 +0000955 - Optimizer:
David Neto1ccfb582017-12-15 18:21:55 -0500956 - Add --skip-validation to spirv-opt
957 - Add dominance tree analysis
958 - Add generic value propagation engine
959 - Add global redundancy elimination within a function
960 - Add scalar replacement of function-scope variables of composite type
961 - Aggressive dead code elimination: Remove empty loops
962 - Killing an instruction notifies the IRContext
963 - IRContext::KillInst deletes the instruction
964 - Move CFG analysis to IRContext
965 - Add constant manager
966 - Fix: Don't consider derivative instructions as combinators.
967 - Fix: Don't delete an instruction twice in local dead-code-elimination
968 - Fix: Don't consider derivative instructions as combinators.
969 - Validator:
970 - Finish checking of image instructions (Section 3.32.10)
971 - Check sparse image instructions
972 - Check OpTypeImage, OpTypeSampleImage
973 - Check composite instructions (Section 3.32.12)
974 - Check atomic instructions (Section 3.32.18)
975 - Check OpEmitStreamVertex, OpEndStreamPrimitive instructions
976 - Re-enable validation of OpCopyObject
977 - OpKill, image ImplicitLod and QueryLod instructions can only be used in Fragment
978 shaders.
979 - Fixes for image instruction validation:
980 - Lod image operand only usable with ExplicitLod and OpImageFetch
981 - ExplicitLod Lod image operand must be float scalar
982 - OpImageFectch Lod image operand must be int scalar
983 - OpImageGather component operand must be 32-bits (integer scalar)
984 - OpImageQuerySizeLod Lod must be integer scalar
Alan Baker0cae89e2017-11-23 23:08:58 -0500985 - Fixes:
David Neto1ccfb582017-12-15 18:21:55 -0500986 #622: Remove names and decorations when inlining
987 #989: Aggressive dead code elim: Don't optimize away live breaks from a loop
988 #991: Fix validation of SPV_AMD_shader_ballot
Alan Baker0cae89e2017-11-23 23:08:58 -0500989 #1004: Use after free of an instruction, in remove-duplicates transform
David Netoe1a6f8d2017-11-24 10:17:13 -0500990 #1007: OpImageRead not required to return 4-component vector
991 #1009: OpImageRead can return scalar int/float types
David Neto1ccfb582017-12-15 18:21:55 -0500992 #1011: OpImageWrite should allow scalar int/float texel types
993 #1012: Fix validat Dref type check
994 #1017: Load-store elimination considers variable initializations
995 #1034: Fix Windows debug build: operator< should be a weak ordering
996 #1083: Inlining: Set parent (function) for each inlined basic block.
997 #1075: Aggressive dead code elimination: Was leaving dangling references to
998 removed blocks.
David Netob0a70372017-11-23 18:16:41 -0500999
David Neto493c0882017-11-23 18:12:23 -05001000v2017.1 2017-11-23
David Neto1affe5a2017-10-04 17:02:39 -04001001 - Update README with details on the public_spirv_tools_dev@khronos.org mailing list.
David Netod84df942017-09-26 11:30:57 -04001002 - General:
David Neto493c0882017-11-23 18:12:23 -05001003 - Automatically deploy built artifacts to GitHub Releases
1004 - Add a Linker (module combiner). Under development.
1005 - Add Android.mk for Android NDK builds.
David Neto76555bd2017-11-08 00:23:42 -05001006 - Add the 'effcee' library as an optional dependency for use in tests.
1007 Eventually it will be a required dependency, once downstream projects have
David Neto493c0882017-11-23 18:12:23 -05001008 a chance to adjust. Requires 're2' library.
David Netod84df942017-09-26 11:30:57 -04001009 - Avoid static-duration variables of class type (with constructors).
David Neto493c0882017-11-23 18:12:23 -05001010 - Hack around bugs in gcc-4.8.1 template handling
1011 - Faster opcode lookup
Andrey Tuganov82df4bb2017-08-30 10:13:10 -04001012 - Validator:
David Netoa91cecf2017-09-14 10:35:22 -04001013 - Recognize extensions listed on SPIR-V registry,
1014 through #25 SPV_AMD_shader_fragment_mask
David Neto493c0882017-11-23 18:12:23 -05001015 - Validator issues an info message when it sees an unrecognized extension.
1016 - Type check basic arithmetic operations
1017 - Type check carry/extended arithmetic operations
1018 - Type check vector arithmetic operations
1019 - Type check Relational and Logical instructions
1020 - Type check Bit instructions
1021 - Check type uniqueness rules
1022 - Check conversion instructions
1023 - Check image instructions
1024 - Check derivative instructions
1025 - Check OpVectorShuffle
1026 - Check OpBranchConditional
1027 - OpModuleProcessed is only allowed after debug names section and before annotations
1028 section.
1029 - Checks the right kind of return is called for each function (void or non-void).
1030 - Add option to relax type check when storing structs (--relax-store-struct)
David Netod84df942017-09-26 11:30:57 -04001031 - Optimizer:
David Neto493c0882017-11-23 18:12:23 -05001032 - Refactoring internal representation of the module, including:
1033 - IRContext: owns a module and manages analyses
1034 - Instructions are owned by intrusive lists, and have unique IDs
1035 - BasicBlock owns its instruction list.
1036 - DefUseManager: change representation of uses, for faster processing
1037 on large modules.
1038 - Add high level recipes: -O, -Os, and -Oconfig
1039 Recipes for -O and -Os are under development.
1040 - Add eliminate-dead-function transform
David Netod84df942017-09-26 11:30:57 -04001041 - Add strength reduction transform: For now, convert multiply by power of 2
1042 to a bit shift.
David Neto493c0882017-11-23 18:12:23 -05001043 - Add CFG cleanup transform
1044 - Add removal of dead module-scope variables
1045 - Add merge-return transform for modules without structured control flow
1046 - Add redundancy elimination within a basic block (local value numbering)
1047 - Extract-insert elimination:
1048 - Recognize the case where the first instruction in the sequence is an
1049 OpCompositeConstruct or OpConstantComposite
1050 - Handle some cases of nested structs
1051 - Dead branch elimination now can eliminate entire selection constructs
1052 when all arms are dead.
1053 - Compressing codec:
1054 - Updated algorithm to 1.01, 1.02, 1.03
1055 - Not built by default. Use -DSPIRV_BUILD_COMPRESSION=ON to build.
1056 - Codec can be parameterized by a customized model.
David Neto25ddfec2017-09-02 19:01:03 -04001057 - Fixes:
David Neto493c0882017-11-23 18:12:23 -05001058 #728: Fix decoration of inlined functions
David Neto40e9c602017-09-01 18:12:15 -04001059 #798: spirv-as should fail when given unrecognized long option
David Neto25ddfec2017-09-02 19:01:03 -04001060 #800: Inliner: Fix inlining function into header of multi-block loop
David Netod84df942017-09-26 11:30:57 -04001061 #824: Eliminate-local-multi-store: Fix a crash
1062 #826: Elimiante-local-multi-store: Fix a crash
David Neto6eaaf7b2017-09-27 10:03:20 -04001063 #827: Fix crash when compact-ids transform runs before another transform.
Andrey Tuganovc25b5be2017-09-25 12:45:48 -04001064 #834: Add Cmake option to build the compressing codec. Off by default.
David Neto493c0882017-11-23 18:12:23 -05001065 #911: Fix classification of Line and NoLine instructions
David Neto7e2d26c2017-09-01 16:28:22 -04001066
David Netod16403a2017-09-01 16:24:27 -04001067v2017.0 2017-09-01
1068 - Update README to describe that assembler, disassembler, and binary parser support
1069 are based on grammar files from the SPIRV-Headers repository.
1070
David Netoa0977e82017-09-01 16:14:25 -04001071v2016.7 2017-09-01
David Netodbc20492017-03-14 12:43:41 -04001072 - Add SPIR-V 1.2
1073 - OpenCL 2.2 support is now based on SPIR-V 1.2
David Neto0b0454c2017-06-22 10:22:55 -04001074 - Support AMD extensions in assembler, disassembler:
1075 SPV_AMD_gcn_shader
1076 SPV_AMD_shader_ballot
1077 SPV_AMD_shader_explicit_vertex_parameter
1078 SPV_AMD_shader_trinary_minmax
1079 SPV_AMD_gpu_shader_half_float
1080 SPV_AMD_texture_gather_bias_lod
1081 SPV_AMD_gpu_shader_int16
1082 - Optimizer: Add support for:
1083 - Inline all function calls in entry points.
David Neto15612fe2017-08-01 15:33:15 -04001084 - Flatten decoration groups. Fixes #602
David Neto0b0454c2017-06-22 10:22:55 -04001085 - Id compaction (minimize Id bound). Fixes #624
1086 - Eliminate redundant composite insert followed by extract
1087 - Simplify access chains to local variables
1088 - Eliminate local variables with a single store, if possible
David Neto15612fe2017-08-01 15:33:15 -04001089 - Eliminate local variables with a several stores, if possible
David Neto0b0454c2017-06-22 10:22:55 -04001090 - Eliminate loads and stores in same block to local variables
David Neto15612fe2017-08-01 15:33:15 -04001091 - Eliminate redundant insert/extract to composite values
1092 - Aggressive dead instruction elimination
1093 - Eliminate dead branches
1094 - Merge blocks when the second can only be preceded by the first
David Neto95a600c2017-08-04 17:48:22 -04001095 - Eliminate ommon uniform loads
David Neto1d8efb02017-04-20 15:54:10 -04001096 - Assembler: Add option to preserve numeric ids. Fixes #625
David Netof8cc3972016-12-16 15:32:56 -05001097 - Add build target spirv-tools-vimsyntax to generate spvasm.vim, a SPIR-V
1098 assembly syntax file for Vim.
David Neto699943d2017-01-17 15:41:23 -05001099 - Version string: Allow overriding of wall clock timestamp with contents
1100 of environment variable SOURCE_DATE_EPOCH.
David Netoe3632a22017-02-28 11:53:05 -05001101 - Validator implements relaxed rules for SPV_KHR_16bit_storage.
David Neto826d9682017-07-04 12:27:31 -04001102 - CMake installation rules use GNUInstallDirs. For example, libraries
1103 will be installed into a lib64 directory if that's the norm for the
1104 current system.
David Neto37422e92016-12-19 13:26:42 -05001105 - Fixes:
Ehsan Nasirida4ae052017-02-15 13:29:33 -05001106 #500: Parameterize validator limit checks
David Neto37422e92016-12-19 13:26:42 -05001107 #508: Support compilation under CYGWIN
Ehsan Nasiri109ce222017-01-05 12:53:02 -05001108 #517: Fix validation when continue (or case) contstruct is also the head of a
1109 nested control construct.
David Netodadd5162017-02-09 14:23:52 -05001110 #551: If a merge block is reachable, it must be *strictly* dominated by its
1111 header.
Adam Van Ymerenc0949702017-02-15 13:31:07 -05001112 #548: Validator: Error when the reserved OpImageSparseSampleProj* opcodes
1113 are used.
David Netoafc60bb2017-04-02 02:17:41 -04001114 #611: spvtools::Optimizer was failing to save the module to the output
1115 binary vector when all passes succeded without changes.
David Neto51b67782017-05-12 17:35:18 -04001116 #629: The inline-entry-points-all optimization could generate invalidly
1117 structured code when the inlined function had early returns.
David Neto35a06952017-07-04 16:24:46 -04001118 #697: Optimizer's Instruction::ForEachInId method was skipping semantics-id
1119 and scope-id.
David Neto720869b2017-08-10 13:13:33 -04001120 #755: Inliner: Fix inlining of callee with single Return appearing before
1121 the end of the function.
David Netofc60d1e2017-08-30 14:25:23 -04001122 #776: Fix dead branch elimination in presence of complex but dead control
1123 flow.
David Netod843cae2017-09-01 10:15:42 -04001124 #781: SPV_KHR_variable_pointers allows duplicate pointer types
David Neto9090da52017-08-29 23:22:07 -04001125 #782: Inliner: Fix remapping of non-label forward references in callee
David Netof2413742017-09-01 16:13:12 -04001126 #787: Inliner: Fix remapping of inlined entry block when called from
1127 single block loop.
1128 #790: Inliner: Fix remapping of inlined entry block when callee has
1129 multiple returns.
David Neto68c5f042016-12-13 11:49:50 -05001130
David Neto5f5fa3a2016-12-13 11:49:09 -05001131v2016.6 2016-12-13
Lei Zhang620f05e2016-09-16 16:12:04 -04001132 - Published the C++ interface for assembling, disassembling, validation, and
1133 optimization.
David Netoee6c8772016-10-12 10:47:28 -04001134 - Support SPV_KHR_shader_draw_parameters in assembler, disassembler, parser.
David Neto5f5fa3a2016-12-13 11:49:09 -05001135 - Validator:
1136 - Add validator API accepting raw binary words
1137 - Increased coverage:
1138 - Checks "Data rules" in Universal Validation Rules, section 2.16.1
1139 - WIP: Universal Limits.
1140 - The minimum mandated upper bounds are checked.
1141 - TODO: Parameterize the validator to allow larger limits accepted by
1142 a more than minimally capable implementation.
1143 - OpSampledImage checks
1144 - OpConstantComposite checks
1145 - Id bound check
1146 - Disasssembler:
1147 - Generates friendly GLSL-based names for more builtin variables
1148 - Generates friendly names for numeric OpConstant values
1149 - Vendor tool info extracted from SPIR-V XML registry file.
Umar Arshada6ef1ea2016-09-22 10:23:08 -04001150 - Fixes issues:
1151 #429: Validator: Allow OpTypeForwardPointer and OpTypeStruct to reference
1152 undefined IDs
David Neto5f5fa3a2016-12-13 11:49:09 -05001153 #482: Validator: OpVariable initializer can be an ID of a module-scope variable
David Neto6519fce2016-09-16 16:40:00 -04001154
David Netof9763ac2016-09-16 16:39:40 -04001155v2016.5 2016-09-16
David Neto93820352016-09-16 14:40:02 -04001156 - Support SPV_KHR_shader_ballot in assembler, disassembler, parser.
David Netoe0dd0332016-09-13 12:38:42 -04001157 - Disassembler: Generate friendly names for built-in variables.
David Neto26b51ef2016-09-12 16:48:05 -04001158 - Partial fixes:
1159 #359: Add Emacs helper for automatically diassembling/assembling a SPIR-V
1160 binary on file load/save.
David Neto5c9080e2016-09-14 11:04:19 -04001161 - Fixes:
David Neto247e0242016-09-14 15:22:47 -04001162 #414: Validator: Allow OpUndef for composite constants
David Neto5c9080e2016-09-14 11:04:19 -04001163 #415: Validator: Phi can use its own value in some cases.
David Netoe70a9572016-09-01 15:38:53 -04001164
David Neto9fc86582016-09-01 15:33:59 -04001165v2016.4 2016-09-01
1166 - Relicensed under Apache 2.0
qining380f36e2016-08-04 13:24:08 -04001167 - Add optimization passes (in API and spirv-opt command)
1168 - Fold spec constants defined with OpSpecConstantOp and
1169 OpSpecConstantComposite to normal constants with fixed value(s).
David Neto9fc86582016-09-01 15:33:59 -04001170 - Fixes issues:
1171 #318: Relicensed under Apache 2.0
David Neto0d4b73c2016-08-24 11:18:16 -04001172
David Netoa7a84bd2016-08-24 11:17:07 -04001173v2016.3 2016-08-24
David Netoc2967012016-08-05 18:19:30 -04001174 - Add target environment enums for OpenCL 2.1, OpenCL 2.2,
1175 OpenGL 4.0, OpenGL 4.1, OpenGL 4.2, OpenGL 4.3, OpenGL 4.5.
David Neto996a8142016-08-03 11:55:14 -04001176 - Add spirv-cfg, an experimental tool to dump the control flow graph
1177 as a GraphiViz "dot" graph
1178 - Add optimization pass: Eliminate dead constants.
David Neto3c35b632016-08-22 11:38:18 -04001179 - Add spirv-lesspipe.sh filter utility
qining23266c92016-08-10 16:02:18 -04001180 - Fixes issues:
David Neto77848292016-08-10 10:40:59 -04001181 #288: Check def-use dominance rules for OpPhi (variable,parent) operands
David Netoa7a84bd2016-08-24 11:17:07 -04001182 #339: Allow OpUndef in types-constants-global-vars section, as required
1183 by SPIR-V 1.0 Rev7, 1.1 Rev 3.
David Neto033b7d02016-08-12 14:19:17 -04001184 #340: Avoid race on mkdir during build
David Neto97d06a32016-08-24 09:47:49 -04001185 #365: Relax PointSize, ClipDistance, CullDistance capability check in all
1186 environments not just Vulkan 1.0.
David Netoaa303122016-08-05 17:10:36 -04001187
David Neto8e3ac3c2016-08-05 17:07:34 -04001188v2016.2 2016-08-05
Umar Arshadefc782d2016-07-13 18:57:52 -04001189 - Validator is incomplete
1190 - Checks ID use block is dominated by definition block
David Netoc978b722016-07-27 17:02:22 -04001191 - Add optimization passes (in API and spirv-opt command)
qininga2450622016-07-26 12:11:03 -04001192 - Strip debug info instructions
1193 - Freeze spec constant to their default values
David Neto8e3ac3c2016-08-05 17:07:34 -04001194 - Allow INotEqual as operation for OpSpecConstantOp
David Netoc978b722016-07-27 17:02:22 -04001195 - Fixes bugs:
1196 #270: validator: crash when continue construct is unreachable
1197 #279: validator: infinite loop when analyzing some degenerate control
1198 flow graphs
David Neto8e3ac3c2016-08-05 17:07:34 -04001199 #286: validator: don't incorrectly generate def-use error for
1200 (variable,parent) parameters to OpPhi
David Neto9acc0f12016-08-02 11:59:10 -04001201 #290: disassembler: never generate bare % for an identifier
David Neto621fa392016-08-04 14:57:09 -04001202 #295: validator: def-use dominance check should ignore unreachable uses
David Neto8e3ac3c2016-08-05 17:07:34 -04001203 #276: validator: allow unreachable continue constructs
1204 #297: validator: allow an unreachable block to branch to a reachable
1205 merge block
Lei Zhang45af1dd2016-07-19 15:04:43 -04001206
Lei Zhang1e7c5cb2016-07-19 15:03:52 -04001207v2016.1 2016-07-19
David Neto06581f52016-07-07 17:03:22 -04001208 - Fix https://github.com/KhronosGroup/SPIRV-Tools/issues/261
1209 Turn off ClipDistance and CullDistance capability checks for Vulkan.
David Neto0bdcc232016-07-08 14:29:52 -04001210 - The disassembler can emit friendly names based on debug info (OpName
1211 instructions), and will infer somewhat friendly names for most types.
1212 This is turned on by default for the spirv-dis command line tool.
Lei Zhang1e7c5cb2016-07-19 15:03:52 -04001213 - Updated to support SPIR-V 1.1 rev 2
1214 - Input StorageClass, Sampled1D capability, and SampledBuffer capability
1215 do not require Shader capability anymore.
David Netoce7ced12016-07-04 15:13:08 -04001216
David Neto84058932016-06-02 15:29:13 -04001217v2016.0 2016-07-04
David Neto91668542016-04-21 20:50:11 -04001218
1219 - Adds v<year>.<index> versioning, with "-dev" indicating
1220 work in progress. The intent is to more easly report
1221 and summarize functionality when SPIRV-Tools is incorporated
1222 in downstream projects.
1223
1224 - Summary of functionality (See the README.md for more):
1225 - Supports SPIR-V 1.1 Rev 1
1226 - Supports SPIR-V 1.0 Rev 5
1227 - Supports GLSL std450 extended instructions 1.0 Rev 3
1228 - Supports OpenCL extended instructions 1.0 Rev 2
1229 - Assembler, disassembler are complete
1230 - Supports floating point widths of 16, 32, 64 bits
1231 - Supports integer widths up to 64 bits
1232 - Validator is incomplete
David Neto84058932016-06-02 15:29:13 -04001233 - Checks capability requirements in most cases
1234 - Checks module layout constraints
1235 - Checks ID use-definition ordering constraints,
1236 ignoring control flow
1237 - Checks some control flow graph rules
1238 - Optimizer is introduced, with few available transforms.
David Neto91668542016-04-21 20:50:11 -04001239 - Supported on Linux, OSX, Android, Windows
David Neto37e46002016-06-14 11:45:35 -04001240
1241 - Fixes bugs:
1242 - #143: OpenCL pow and pown arguments