Skip to content

[LLVM][Docs][SPIRV] Correct -spirv-ext option name, reorder #150423

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 1, 2025
Merged

[LLVM][Docs][SPIRV] Correct -spirv-ext option name, reorder #150423

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
5370bae
[LLVM][Docs][SPIRV] Correct `-spirv-ext` option name, reorder
Maetveis Jul 24, 2025
1b10bdf
Add an example on how to enable khronos extensions
Maetveis Aug 1, 2025
427ef0a
Add blank line to correctly format.
Maetveis Aug 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 17 additions & 13 deletions llvm/docs/SPIRVUsage.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -131,9 +131,23 @@ Extensions

The SPIR-V backend supports a variety of `extensions <https://github.com/KhronosGroup/SPIRV-Registry/tree/main/extensions>`_
that enable or enhance features beyond the core SPIR-V specification.
These extensions can be enabled using the ``-spirv-extensions`` option
followed by the name of the extension(s) you wish to enable. Below is a
list of supported SPIR-V extensions, sorted alphabetically by their extension names:
The enabled extensions can be controlled using the ``-spirv-ext`` option followed by a list of
extensions to enable or disable, each prefixed with ``+`` or ``-``, respectively.

To enable multiple extensions, list them separated by comma. For example, to enable support for atomic operations on floating-point numbers and arbitrary precision integers, use:

``-spirv-ext=+SPV_EXT_shader_atomic_float_add,+SPV_INTEL_arbitrary_precision_integers``

To enable all extensions, use the following option:
``-spirv-ext=all``

To enable all KHR extensions, use the following option:
``-spirv-ext=khr``

To enable all extensions except specified, specify ``all`` followed by a list of disallowed extensions. For example:
``-spirv-ext=all,-SPV_INTEL_arbitrary_precision_integers``

Below is a list of supported SPIR-V extensions, sorted alphabetically by their extension names:

.. list-table:: Supported SPIR-V Extensions
:widths: 50 150
Expand Down Expand Up @@ -220,16 +234,6 @@ list of supported SPIR-V extensions, sorted alphabetically by their extension na
* - ``SPV_KHR_float_controls2``
- Adds ability to specify the floating-point environment in shaders. It can be used on whole modules and individual instructions.

To enable multiple extensions, list them separated by comma. For example, to enable support for atomic operations on floating-point numbers and arbitrary precision integers, use:

``-spirv-ext=+SPV_EXT_shader_atomic_float_add,+SPV_INTEL_arbitrary_precision_integers``

To enable all extensions, use the following option:
``-spirv-ext=all``

To enable all extensions except specified, specify ``all`` followed by a list of disallowed extensions. For example:
``-spirv-ext=all,-SPV_INTEL_arbitrary_precision_integers``

SPIR-V representation in LLVM IR
================================

Expand Down
Loading