Lines Matching +full:- +full:- +full:disable +full:- +full:file
6 but they can sometimes be useful for debugging end-user issues.
9 ---------------------------
18 colon-separated list of paths to search for DRI drivers
35 disable DRI2 if set to ``true``.
39 disable DRI3 if set to ``true``.
42 -------------------------------
57 following comma-separated list of named flags, which adds extra
81 specifies a file name for logging all errors, warnings, etc., rather
86 can be used to enable/disable extensions. A value such as
87 ``GL_EXT_foo -GL_EXT_bar`` will enable the ``GL_EXT_foo`` extension
88 and disable the ``GL_EXT_bar`` extension. Note that this will override
95 or before year X will be reported. This is to work-around a bug in
96 some games where the extension string is copied into a fixed-size
98 buffer overrun can cause the game to crash. This is a work-around for
106 - The format should be ``MAJOR.MINOR[FC|COMPAT]``
107 - ``FC`` is an optional suffix that indicates a forward compatible
109 - ``COMPAT`` is an optional suffix that indicates a compatibility
112 - GL versions <= 3.0 are set to a compatibility (non-Core) profile
113 - GL versions = 3.1, depending on the driver, it may or may not have
115 - GL versions >= 3.2 are set to a Core profile
116 - Examples:
119 select a compatibility (non-Core) profile with GL version 2.1.
121 select a compatibility (non-Core) profile with GL version 3.0.
139 - Mesa may not really implement all the features of the given
147 - The format should be ``MAJOR.MINOR``
148 - Examples: ``2.0``, ``3.0``, ``3.1``
149 - Mesa may not really implement all the features of the given
168 if set to ``true``, disables the on-disk shader cache. If set to
169 ``false``, enables the on-disk shader cache when it is disabled by
171 if on-disk shader cache is disabled.
175 if set, determines the maximum size of the on-disk cache of compiled
190 if set, determines the directory to be used for the on-disk cache of
203 if set to 1, enables the single file Fossilize DB on-disk shader
204 cache implementation instead of the default multi-file cache
219 a string of comma separated file paths to read only Fossilize DB
220 shader caches for loading at initialization. The file paths are
222 referencing both the cache DB and its index file. E.g.
229 if set to 1, enables the Mesa-DB single file on-disk shader cache
230 implementation instead of the default multi-file cache implementation.
231 Like :envvar:`MESA_DISK_CACHE_SINGLE_FILE`, Mesa-DB reduces overall
232 disk usage but Mesa-DB supports cache size limits via
241 specifies number of mesa-db cache parts, default is 50.
245 Mesa-DB cache eviction algorithm calculates weighted score for the
253 a text file that contains a new-line separated list of read only
254 Fossilize DB shader caches to load. The list file is modifiable at
257 takes an absolute path to the list file. The list file must exist at
266 if set to 1, enables simultaneous use of :abbr:`RW (read-write)` and
267 :abbr:`RW (read-write)` Fossilize DB caches. At first, data will be
296 - The format should be ``MAJOR.MINOR[.PATCH]``
297 - This will not let you force a version higher than the driver's
299 - This can be very useful for debugging but some features may not be
323 not they ever see a wait-before-signal condition.
327 print debug info about device selection decision-making
331 A comma-separated list of trace types used for offline analysis. The
332 option names are equal to the file extension. Traces are dumped into ``/tmp``.
337 .. list-table::
338 :header-rows: 1
340 * - File extension
341 - Offline analysis tool
342 - Supported drivers
343 * - ``rmv``
344 - Radeon Memory Visualizer
345 - ``RADV``
346 * - ``rgp``
347 - Radeon GPU Profiler
348 - ``RADV``
349 * - ``rra``
350 - Radeon Raytracing Analyzer
351 - ``RADV``
352 * - ``ctxroll``
353 - Context rolls
354 - ``RADV``
356 - Creating RMV captures requires the ``scripts/setup.sh`` script in the
365 Specifies a trigger file. Creating the file triggers the capture. (e.g.
374 print debug info about device selection decision-making
383 - ``DRI_PRIME=N``: selects the Nth non-default GPU (N > 0).
384 - ``DRI_PRIME=pci-0000_02_00_0``: selects the GPU connected to this PCIe bus
385 - ``DRI_PRIME=vendor_id:device_id``: selects the first GPU matching these ids.
392 ``lspci -nn | grep VGA`` can be used to know the PCIe bus or ids to use.
396 If set, overrides the global search-directories used when searching for
397 drirc config files. The user-local one will still be used. Mostly useful for
401 --------------------------------
409 a comma-separated list of debug options to apply to NIR
414 a comma-separated list of optimization/lowering passes to skip.
417 --------------------------------------
448 -------------------------------------
461 automated test-runs.
464 ----------------------------------------------------
493 a comma-separated list of named flags, which do various things:
509 ``capture-all``
545 suppress generation of 16-wide fragment shaders. useful for
548 suppress generation of 32-wide fragment shaders. useful for
550 ``no-oaconfig``
551 disable HW performance metric configuration, and anything
552 related to i915-perf (useful when running on simulation)
554 disable instruction compaction
556 suppress generation of dual-object geometry shader code
558 disable fast clears
560 disable lossless color compression
570 ``perf-symbol-names``
599 ``swsb-stall``
606 force usage of 8-patches tessellation control shaders (only
607 for gfx 9-11)
621 a comma-separated list of enable/disable flags configuring the
623 ``INTEL_DECODE=+color,-floats``) :
650 to a file:
652 ``INTEL_MEASURE=file=/tmp/measure.csv {workload}``
656 ``INTEL_MEASURE=file=/tmp/measure.csv,start=15 {workload}``
662 To capture frames 15-37, stopping before frame 38:
666 Designate an asynchronous control file with:
676 ``$ echo -1 > path/to/control.fifo``
678 and disable with:
732 The SHA-1 of a shader assembly is printed when assembly is dumped via
740 overrode shader with sha1 <SHA-1>" in stderr replacing the original
748 The SHA-1 of a shader assembly is printed when assembly is dumped via
756 overrode shader with sha1 <SHA-1>" in stderr replacing the original
774 a comma-separated list of named flags, which control simd dispatch widths:
801 allow generation of SIMD8 ray-tracing shader
803 allow generation of SIMD16 ray-tracing shader
805 allow generation of SIMD32 ray-tracing shader
811 -------------------------
815 disable MSAA for GLX/EGL MSAA visuals
819 -----------------------------------------------------
837 -------------------------
843 -----------------------------
862 control background opacity as an integer percentage (1-100), defaults to 66%.
867 toggle HUD at specific points of application and disable for
871 ``kill -10 <pid>`` to toggle the HUD as desired.
894 specifies a file for logging all errors, warnings, etc. rather than
899 specifies an alternate search directory for pipe-loader which overrides
900 the compile-time path based on the install location.
904 if non-zero, print all the Gallium environment variables which are
910 specified file. Paths may be relative or absolute; relative paths are relative
912 the trace to be written to a file of the same name in the working directory.
923 Once the file exists (e.g., from the user running 'touch /path/to/file'), a single
929 if non-zero, print information about the CPU on start-up
938 Enable fetch-shade-emit middle-end even though its not correct (e.g.
943 Disable fetch-shade-emit middle-end even when it is correct
954 :file:`src/mesa/state_tracker/st_debug.c` for other options.
968 ----------------------------
1015 .. _rusticl-env-var:
1023 -----------------------------
1037 a comma-separated list of drivers to enable CL on. An optional list of
1038 comma-separated integers can be passed per driver to specify which devices
1041 - ``RUSTICL_ENABLE=iris`` (enables all iris devices)
1042 - ``RUSTICL_ENABLE=iris:1,radeonsi:0,2`` (enables second iris and first
1056 a comma-separated list of features to enable. Those are disabled by default
1059 - ``fp16`` enables OpenCL half support
1060 - ``fp64`` enables OpenCL double support
1064 a comma-separated list of debug channels to enable.
1066 - ``allow_invalid_spirv`` disables validation of any input SPIR-V
1067 - ``clc`` dumps all OpenCL C source being compiled
1068 - ``program`` dumps compilation logs to stderr
1069 - ``sync`` waits on the GPU to complete after every event
1070 - ``validate`` validates any internally generated SPIR-Vs, e.g. through compiling OpenCL C code
1072 .. _clc-env-var:
1075 -----------------------------
1079 a comma-separated list of debug channels to enable.
1081 - ``dump_llvm`` Dumps all generated LLVM IRs
1082 - ``dump_spirv`` Dumps all compiled, linked and specialized SPIR-Vs
1083 - ``verbose`` Enable debug logging of clc code
1086 -----------------------------------
1094 a comma-separated list of named flags that do debugging things.
1103 a comma-separated list of named flags, which do alternate shader handling.
1108 a comma-separated list of named flags that do various things.
1112 -------------------------------------
1116 a comma-separated list of named flags, which do various things:
1133 -------------------------------------
1137 if set LLVMpipe will no-op rasterization
1141 a comma-separated list of debug options is accepted. See the source
1146 a comma-separated list of options to selectively no-op various parts
1156 ----------------------------------------
1173 if set, enables extra logging to the ``vmware.log`` file, such as the
1178 if set, disables logging to the ``vmware.log`` file. This is useful
1182 See the driver code for other, lesser-used variables.
1185 -------------------------
1194 VA-API environment variables
1195 ----------------------------
1199 enable MPEG4 for VA-API, disabled by default.
1202 --------------------------------
1206 a comma-separated list of named flags, which do various things. Use
1210 -------------------------------------
1214 a comma-separated list of debug options. Use ``V3D_DEBUG=help`` to
1218 .. _radv env-vars:
1221 ---------------------------------
1225 a comma-separated list of named flags, which do various things:
1246 show GPU-related information
1248 Mark geometry-affecting outputs as invariant. This works around a common
1253 disable dithering for alpha to coverage
1255 disable primitive binning
1257 disable shaders cache
1259 disable compute queue
1261 disable Delta Color Compression (DCC) on images
1263 disable Delta Color Compression (DCC) on displayable images
1267 disable fast color/depthstencil clears
1269 disable FMASK compression on MSAA images (GFX6-GFX10.3)
1271 disable VK_EXT_graphics_pipeline_library
1273 disable GS_FAST_LAUNCH=2 for Mesh shaders (GFX11 only)
1275 disable HIZ for depthstencil images
1277 disable directly recording command buffers in GPU-visible memory
1279 disable memory shaders cache
1281 disable mesh shader support on GFX10.3+
1283 disable NGG for GFX10 and GFX10.3
1285 disable NGG culling on GPUs where it's enabled by default (GFX10.3 only).
1287 disable NGG GS for GFX10 and GFX10.3
1292 disable TC-compat CMASK for MSAA surfaces
1294 disable UMR dumps during GPU hang detection (only with
1297 disable VRS for flat shading (only on GFX10.3+)
1309 dump SPIR-V
1311 split application-provided fused multiply-add in geometry stages
1325 allow to force per-pipeline vertex VRS rates on GFX10.3+. This is only
1331 similar to ``RADV_FORCE_VRS`` but allow to configure from a file. If present,
1336 a comma-separated list of named flags, which do various things:
1345 upload shaders to invisible VRAM (might be useful for non-resizable BAR systems)
1347 forces ray-tracing to be emulated in software on GFX10_3+ and enables
1356 cache per-stage NIR for graphics pipelines
1358 disable optimizations that get enabled when all VRAM is CPU visible.
1364 enable wave64 for ray tracing shaders (GFX10-10.3)
1368 enable experimental implementation of VK_EXT_shader_object (GFX6-8 and
1386 enable/disable SQTT/RGP cache counters on GFX10+ (enabled by default)
1390 enable/disable SQTT/RGP instruction timing (enabled by default)
1394 enable/disable SQTT/RGP queue events (enabled by default)
1413 a comma-separated list of named flags, which do various things:
1419 disable ACO IR validation in debug/debugoptimized builds
1424 ``force-waitcnt``
1426 ``force-waitdeps``
1429 disable value numbering
1431 disable various optimizations
1433 disable instructions scheduling
1440 -------------------------------------
1456 a comma-separated list of named flags, which do various things:
1459 Disable DCC.
1461 Disable DCC fast clear
1463 disable Delta Color Compression (DCC) on displayable images
1465 Disable DCC for MSAA
1467 Disable DPBB. Overrules the dpbb enable option.
1469 Disable hardware based encoder colour format conversion
1471 Disable tiling
1473 Disable MSAA compression
1475 Disable Hyper-Z
1477 Disable 2D tiling
1521 Use old-style monolithic shaders compiled on demand
1523 Disable compiling optimized shader variants.
1527 Disable GTT write combining
1533 Disable NGG and use the legacy pipeline.
1537 Disable NGG culling.
1539 Program WD/IA to switch on end-of-packet.
1541 Disable out-of-order rasterization
1548 ---------------------------------
1552 a comma-separated list of named flags, which do various things:
1555 Disable CP DMA
1557 Disable sb backend for graphics shaders
1571 Disable unsafe math optimizations
1609 Disable compiling optimized shader variants.
1619 Disable asynchronous DMA
1621 Disable Hyper-Z
1623 Disable handling of INVALIDATE_RANGE map flags
1625 Disable 2D tiling
1627 Disable tiling
1629 Program WD/IA to switch on end-of-packet.
1635 Disable GTT write combining
1643 if set to ``true``, various compute-related debug information will
1657 a comma-separated list of named flags, which do various things:
1668 Log shader info (non-zero values)
1687 ---------------------------------
1691 a comma-separated list of named flags, which do various things:
1702 Log SWTCL-specific info
1726 Disable tiling
1728 Disable immediate mode
1730 Disable shader optimizations
1732 Disable fast color clear
1734 Disable zbuffer compression
1736 Disable hierarchical zbuffer
1738 Disable AA compression and fast AA clear
1740 Disable hardware accelerated Transform/Clip/Lighting
1743 ----------------------------------
1747 a comma-separated list of named flags, which do various things:
1755 Disable 16-bit floating point support. This may workaround application
1758 possible) or added in the Mesa-wide driconf (if closed source).
1760 In debug builds only: disable dirty tracking optimizations.
1762 Disable write-combining (force all allocations to be write-through). This
1764 buffers may still be write-combined.
1768 a comma-separated list of named flags, which do various things:
1784 Disable various backend optimizations.
1786 .. _imagination env-vars:
1789 ------------------------------------------------
1793 A comma-separated list of debug options. Use `PVR_DEBUG=help` to
1798 a comma-separated list of named flags for the Rogue compiler,
1823 ---------------------------------
1838 --------------------------------------
1844 ----