OS Manuals

/usr/bin/spirv-dis

Collection of tools, libraries, and tests for Vulkan shader compilation

From shaderc 2026.4-r0 (os), captured 2026-11-05 by running spirv-dis --help (exit 0). permalink

Also provided by 1 other package version
/usr/bin/spirv-dis - Disassemble a SPIR-V binary module

Usage: /usr/bin/spirv-dis [options] [<filename>]

The SPIR-V binary is read from <filename>. If no file is specified,
or if the filename is "-", then the binary is read from standard input.

A text-based hex stream is also accepted as binary input, which should either
consist of 32-bit words or 8-bit bytes.  The 0x or x prefix is optional, but
should be consistently present in the stream.

Options:

  -h, --help        Print this help.
  --version         Display disassembler version information.

  -o <filename>     Set the output filename.
                    Output goes to standard output if this option is
                    not specified, or if the filename is "-".

  --color           Force color output.  The default when printing to a terminal.
                    Overrides a previous --no-color option.
  --no-color        Don't print in color.  Overrides a previous --color option.
                    The default when output goes to something other than a
                    terminal (e.g. a file, a pipe, or a shell redirection).

  --no-indent       Don't indent instructions.

  --no-header       Don't output the header as leading comments.

  --raw-id          Show raw Id values instead of friendly names.

  --nested-indent   Indentation is adjusted to indicate nesting in structured
                    control flow.

  --reorder-blocks  Reorder blocks to match the structured control flow of SPIR-V.
                    With this option, the order of instructions will no longer
                    match the input binary, but the result will be more readable.

  --offsets         Show byte offsets for each instruction.

  --comment         Add comments to make reading easier

  --handle-unknown-opcodes
                    Emit unknown opcodes and unknown extended instruction
                    numbers as OpUnknown with raw integer operands instead of
                    failing. The output can be re-assembled with spirv-as.
                    Note: the ID bound in the reassembled module may be
                    incorrect if any unknown instruction defines a result ID.
Options (13)
OptionDescriptionSource
-h, --helpPrint this help.help
--versionDisplay disassembler version information.help
-o filenameSet the output filename.help
--colorForce color output.help
--no-colorDon't print in color.help
--no-indentDon't indent instructions.help
--no-headerDon't output the header as leading comments.help
--raw-idShow raw Id values instead of friendly names.help
--nested-indentIndentation is adjusted to indicate nesting in structured control flow.help
--reorder-blocksReorder blocks to match the structured control flow of SPIR-V.help
--offsetsShow byte offsets for each instruction.help
--commentAdd comments to make reading easierhelp
--handle-unknown-opcodesEmit unknown opcodes and unknown extended instruction numbers as OpUnknown with raw integer operands instead of failing.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.