.. envvar:: D3D12_DEBUG <flags> ("")
-``verbose``
- Enable verbose output to stdout
-``blit``
- Trace blit and copy resource calls
-``experimental``
- Enable experimental shader models feature
-``dxil``
- Dump DXIL during program compile
-``disass``
- Dump disassambly of created DXIL shader
-``res``
- Debug resources
-``debuglayer``
- Enable `debug layer`_
-``gpuvalidator``
- Enable `GPU validator`_
+ ``verbose``
+ Enable verbose output to stdout
+ ``blit``
+ Trace blit and copy resource calls
+ ``experimental``
+ Enable experimental shader models feature
+ ``dxil``
+ Dump DXIL during program compile
+ ``disass``
+ Dump disassambly of created DXIL shader
+ ``res``
+ Debug resources
+ ``debuglayer``
+ Enable `debug layer`_
+ ``gpuvalidator``
+ Enable `GPU validator`_
.. envvar:: DXIL_DEBUG <flags> ("")
-``verbose``
- Enable verbose output to stdout
-``dump_blob``
- Write shader blobs
-``trace``
- Trace instruction conversion
-``dump_module``
- dump module tree to stderr
+ ``verbose``
+ Enable verbose output to stdout
+ ``dump_blob``
+ Write shader blobs
+ ``trace``
+ Trace instruction conversion
+ ``dump_module``
+ dump module tree to stderr
.. _debug layer: https://learn.microsoft.com/en-us/windows/win32/direct3d12/understanding-the-d3d12-debug-layer
.. _GPU validator: https://learn.microsoft.com/en-us/windows/win32/direct3d12/using-d3d12-debug-layer-gpu-based-validation
.. envvar:: MESA_D3D12_DEFAULT_ADAPTER_NAME <string> ("")
-Specifies a substring to search for when choosing a default adapter to
-run on. The first adapter matching the substring is chosen. The substring
-is not case sensitive.
+ Specifies a substring to search for when choosing a default adapter to
+ run on. The first adapter matching the substring is chosen. The substring
+ is not case sensitive.
.. envvar:: LIMA_DEBUG <flags> ("")
-accepts the following comma-separated list of flags:
+ accepts the following comma-separated list of flags:
``bocache``
print debug info for BO cache
.. envvar:: LIMA_CTX_NUM_PLB <int> (None)
-set number of PLB per context (used for development purposes)
+ set number of PLB per context (used for development purposes)
.. envvar:: LIMA_PLB_MAX_BLK <int> (None)
-set PLB max block (used for development purposes)
+ set PLB max block (used for development purposes)
.. envvar:: LIMA_PPIR_FORCE_SPILLING <int> (None)
-force spilling of variables in PPIR (used for development purposes)
+ force spilling of variables in PPIR (used for development purposes)
.. envvar:: LIMA_PLB_PP_STREAM_CACHE_SIZE <int> (None)
-set PP stream cache size (used for development purposes)
+ set PP stream cache size (used for development purposes)
Known hardware limitations
--------------------------
.. envvar:: ZINK_DEBUG <flags> ("")
-``nir``
- Print the NIR form of all shaders to stderr.
-``spirv``
- Write the binary SPIR-V form of all compiled shaders to a file in the
- current directory, and print a message with the filename to stderr.
-``tgsi``
- Print the TGSI form of TGSI shaders to stderr.
-``validation``
- Dump Validation layer output.
-``sync``
- Emit full synchronization barriers before every draw and dispatch.
-``compact``
- Use a maximum of 4 descriptor sets
-``noreorder``
- Do not reorder or optimize GL command streams
-``gpl``
- Force using Graphics Pipeline Library for all shaders
+ ``nir``
+ Print the NIR form of all shaders to stderr.
+ ``spirv``
+ Write the binary SPIR-V form of all compiled shaders to a file in the
+ current directory, and print a message with the filename to stderr.
+ ``tgsi``
+ Print the TGSI form of TGSI shaders to stderr.
+ ``validation``
+ Dump Validation layer output.
+ ``sync``
+ Emit full synchronization barriers before every draw and dispatch.
+ ``compact``
+ Use a maximum of 4 descriptor sets
+ ``noreorder``
+ Do not reorder or optimize GL command streams
+ ``gpl``
+ Force using Graphics Pipeline Library for all shaders
Vulkan Validation Layers
^^^^^^^^^^^^^^^^^^^^^^^^
.. envvar:: GALLIUM_PRINT_OPTIONS <bool> (false)
-This option controls if the debug variables should be printed to stderr. This
-is probably the most useful variable, since it allows you to find which
-variables a driver uses.
+ This option controls if the debug variables should be printed to stderr. This
+ is probably the most useful variable, since it allows you to find which
+ variables a driver uses.
.. envvar:: GALLIUM_TRACE <string> ("")
-If set, this variable will cause the :ref:`trace` output to be written to the
-specified file. Paths may be relative or absolute; relative paths are relative
-to the working directory. For example, setting it to "trace.xml" will cause
-the trace to be written to a file of the same name in the working directory.
+ If set, this variable will cause the :ref:`trace` output to be written to the
+ specified file. Paths may be relative or absolute; relative paths are relative
+ to the working directory. For example, setting it to "trace.xml" will cause
+ the trace to be written to a file of the same name in the working directory.
.. envvar:: GALLIUM_TRACE_TC <bool> (false)
-If enabled while :ref:`trace` is active, this variable specifies that the threaded context
-should be traced for drivers which implement it. By default, the driver thread is traced,
-which will include any reordering of the command stream from threaded context.
+ If enabled while :ref:`trace` is active, this variable specifies that the threaded context
+ should be traced for drivers which implement it. By default, the driver thread is traced,
+ which will include any reordering of the command stream from threaded context.
.. envvar:: GALLIUM_TRACE_TRIGGER <string> ("")
-If set while :ref:`trace` is active, this variable specifies a filename to monitor.
-Once the file exists (e.g., from the user running 'touch /path/to/file'), a single
-frame will be recorded into the trace output.
-Paths may be relative or absolute; relative paths are relative to the working directory.
+ If set while :ref:`trace` is active, this variable specifies a filename to monitor.
+ Once the file exists (e.g., from the user running 'touch /path/to/file'), a single
+ frame will be recorded into the trace output.
+ Paths may be relative or absolute; relative paths are relative to the working directory.
.. envvar:: GALLIUM_DUMP_CPU <bool> (false)
-Dump information about the current CPU that the driver is running on.
+ Dump information about the current CPU that the driver is running on.
.. envvar:: TGSI_PRINT_SANITY <bool> (false)
-Gallium has a built-in shader sanity checker. This option controls whether
-the shader sanity checker prints its warnings and errors to stderr.
+ Gallium has a built-in shader sanity checker. This option controls whether
+ the shader sanity checker prints its warnings and errors to stderr.
.. envvar:: DRAW_USE_LLVM <bool> (false)
-Whether the :ref:`Draw` module will attempt to use LLVM for vertex and geometry shaders.
+ Whether the :ref:`Draw` module will attempt to use LLVM for vertex and geometry shaders.
GL State tracker-specific
.. envvar:: ST_DEBUG <flags> (0x0)
-Debug :ref:`flags` for the GL state tracker.
+ Debug :ref:`flags` for the GL state tracker.
Driver-specific
.. envvar:: I915_DEBUG <flags> (0x0)
-Debug :ref:`flags` for the i915 driver.
+ Debug :ref:`flags` for the i915 driver.
.. envvar:: I915_NO_HW <bool> (false)
-Stop the i915 driver from submitting commands to the hardware.
+ Stop the i915 driver from submitting commands to the hardware.
.. envvar:: I915_DUMP_CMD <bool> (false)
-Dump all commands going to the hardware.
+ Dump all commands going to the hardware.
.. envvar:: LP_DEBUG <flags> (0x0)
-Debug :ref:`flags` for the LLVMpipe driver.
+ Debug :ref:`flags` for the LLVMpipe driver.
.. envvar:: LP_NUM_THREADS <int> (number of CPUs)
-Number of threads that the LLVMpipe driver should use.
+ Number of threads that the LLVMpipe driver should use.
.. envvar:: FD_MESA_DEBUG <flags> (0x0)
-Debug :ref:`flags` for the Freedreno driver.
+ Debug :ref:`flags` for the Freedreno driver.
.. _flags: