Lines Matching +full:traces +full:- +full:db
6 but they can sometimes be useful for debugging end-user issues.
9 ---------------------------
42 - using a VK driver which has no WSI implementation for your display server
43 - profiling the DRI frontend against your VK driver's WSI implementation
50 - running xrdp
51 - using a VK driver which doesn't support modifiers
54 -------------------------------
69 following comma-separated list of named flags, which adds extra
99 ``GL_EXT_foo -GL_EXT_bar`` will enable the ``GL_EXT_foo`` extension
107 or before year X will be reported. This is to work-around a bug in
108 some games where the extension string is copied into a fixed-size
110 buffer overrun can cause the game to crash. This is a work-around for
118 - The format should be ``MAJOR.MINOR[FC|COMPAT]``
119 - ``FC`` is an optional suffix that indicates a forward compatible
121 - ``COMPAT`` is an optional suffix that indicates a compatibility
124 - GL versions <= 3.0 are set to a compatibility (non-Core) profile
125 - GL versions = 3.1, depending on the driver, it may or may not have
127 - GL versions >= 3.2 are set to a Core profile
128 - Examples:
131 select a compatibility (non-Core) profile with GL version 2.1.
133 select a compatibility (non-Core) profile with GL version 3.0.
151 - Mesa may not really implement all the features of the given
159 - The format should be ``MAJOR.MINOR``
160 - Examples: ``2.0``, ``3.0``, ``3.1``
161 - Mesa may not really implement all the features of the given
180 if set to ``true``, disables the on-disk shader cache. If set to
181 ``false``, enables the on-disk shader cache when it is disabled by
183 if on-disk shader cache is disabled.
187 if set, determines the maximum size of the on-disk cache of compiled
202 if set, determines the directory to be used for the on-disk cache of
215 if set to 1, enables the single file Fossilize DB on-disk shader
216 cache implementation instead of the default Mesa-DB cache
229 if set to 1, enables the multi file on-disk shader cache implementation
230 instead of the default Mesa-DB cache implementation.
240 a string of comma separated file paths to read only Fossilize DB
243 referencing both the cache DB and its index file. E.g.
250 specifies number of mesa-db cache parts, default is 50.
254 Mesa-DB cache eviction algorithm calculates weighted score for the
262 a text file that contains a new-line separated list of read only
263 Fossilize DB shader caches to load. The list file is modifiable at
275 if set to 1, enables simultaneous use of :abbr:`RW (read-write)` and
276 :abbr:`RW (read-write)` Fossilize DB caches. At first, data will be
305 - The format should be ``MAJOR.MINOR[.PATCH]``
306 - This will not let you force a version higher than the driver's
308 - This can be very useful for debugging but some features may not be
332 not they ever see a wait-before-signal condition.
336 print debug info about device selection decision-making
340 A comma-separated list of trace types used for offline analysis. The
341 option names are equal to the file extension. Traces are dumped into ``/tmp``.
346 .. list-table::
347 :header-rows: 1
349 * - File extension
350 - Offline analysis tool
351 - Supported drivers
352 * - ``rmv``
353 - Radeon Memory Visualizer
354 - ``RADV``
355 * - ``rgp``
356 - Radeon GPU Profiler
357 - ``RADV``
358 * - ``rra``
359 - Radeon Raytracing Analyzer
360 - ``RADV``
361 * - ``ctxroll``
362 - Context rolls
363 - ``RADV``
365 - Creating RMV captures requires the ``scripts/setup.sh`` script in the
383 print debug info about device selection decision-making
392 - ``DRI_PRIME=N``: selects the Nth non-default GPU (N > 0).
393 - ``DRI_PRIME=pci-0000_02_00_0``: selects the GPU connected to this PCIe bus
394 - ``DRI_PRIME=vendor_id:device_id``: selects the first GPU matching these ids.
401 ``lspci -nn | grep VGA`` can be used to know the PCIe bus or ids to use.
405 If set, overrides the global search-directories used when searching for
406 drirc config files. The user-local one will still be used. Mostly useful for
410 --------------------------------
418 a comma-separated list of debug options to apply to NIR
423 a comma-separated list of optimization/lowering passes to skip.
426 --------------------------------------
457 -------------------------------------
470 automated test-runs.
473 ----------------------------------------------------
483 a comma-separated list of named flags, which do various things:
499 ``capture-all``
535 suppress generation of 16-wide fragment shaders. useful for
538 suppress generation of 32-wide fragment shaders. useful for
540 ``no-oaconfig``
542 related to i915-perf (useful when running on simulation)
546 suppress generation of dual-object geometry shader code
560 ``perf-symbol-names``
571 ``shader-print``
572 allow developer print traces added by `brw_nir_printf` to be
592 ``swsb-stall``
599 force usage of 8-patches tessellation control shaders (only
600 for gfx 9-11)
611 ``cl-quiet``
612 quiets the OpenCL warnings recommending use of Intel compute-runtime
616 a comma-separated list of enable/disable flags configuring the
618 ``INTEL_DECODE=+color,-floats``) :
641 A comma-separated list of device probe override values. The basic
642 format is ``<pci-id>[,<pci-id>,...]``. The wildcard value of ``*``
693 To capture frames 15-37, stopping before frame 38:
707 ``$ echo -1 > path/to/control.fifo``
763 The SHA-1 of a shader assembly is printed when assembly is dumped via
771 overrode shader with sha1 <SHA-1>" in stderr replacing the original
779 The SHA-1 of a shader assembly is printed when assembly is dumped via
787 overrode shader with sha1 <SHA-1>" in stderr replacing the original
805 a comma-separated list of named flags, which control simd dispatch widths:
832 allow generation of SIMD8 ray-tracing shader
834 allow generation of SIMD16 ray-tracing shader
836 allow generation of SIMD32 ray-tracing shader
842 ---------------------------------------
870 effect on hardware that doesn't support soft-pinning (Ivybridge,
899 -------------------------
907 -----------------------------------------------------
925 -------------------------
931 -----------------------------
950 control background opacity as an integer percentage (1-100), defaults to 66%.
959 ``kill -10 <pid>`` to toggle the HUD as desired.
987 specifies an alternate search directory for pipe-loader which overrides
988 the compile-time path based on the install location.
992 if non-zero, print all the Gallium environment variables which are
1017 if non-zero, print information about the CPU on start-up
1026 Enable fetch-shade-emit middle-end even though its not correct (e.g.
1031 Disable fetch-shade-emit middle-end even when it is correct
1056 ----------------------------
1103 .. _rusticl-env-var:
1111 -----------------------------
1125 a comma-separated list of drivers to enable CL on. An optional list of
1126 comma-separated integers can be passed per driver to specify which devices
1129 - ``RUSTICL_ENABLE=iris`` (enables all iris devices)
1130 - ``RUSTICL_ENABLE=iris:1,radeonsi:0,2`` (enables second iris and first
1144 a comma-separated list of features to enable. Those are disabled by default
1147 - ``fp16`` enables OpenCL half support
1148 - ``fp64`` enables OpenCL double support
1152 a comma-separated list of debug channels to enable.
1154 - ``allow_invalid_spirv`` disables validation of any input SPIR-V
1155 - ``clc`` dumps all OpenCL C source being compiled
1156 - ``nir`` dumps nirs in various compilation stages. Might print nothing if shader caching is
1158 - ``no_reuse_context`` pipe_contexts are not recycled
1159 - ``no_variants`` disable kernel variants (e.g. specialized binaries for offsets == 0)
1160 - ``perf`` prints a warning when hitting slow paths once
1161 - ``perfspam`` same as perf, but doesn't skip same warnings
1162 - ``program`` dumps compilation logs to stderr
1163 - ``sync`` waits on the GPU to complete after every event
1164 - ``validate`` validates any internally generated SPIR-Vs, e.g. through compiling OpenCL C code
1168 Limits the amount of threads per dimension in a work-group. Useful for splitting up long running
1171 .. _clc-env-var:
1174 -----------------------------
1178 a comma-separated list of debug channels to enable.
1180 - ``dump_llvm`` Dumps all generated LLVM IRs
1181 - ``dump_spirv`` Dumps all compiled, linked and specialized SPIR-Vs
1182 - ``verbose`` Enable debug logging of clc code
1185 -----------------------------------
1193 a comma-separated list of named flags that do debugging things.
1202 a comma-separated list of named flags, which do alternate shader handling.
1207 a comma-separated list of named flags that do various things.
1211 -------------------------------------
1215 a comma-separated list of named flags, which do various things:
1232 -------------------------------------
1236 if set LLVMpipe will no-op rasterization
1240 a comma-separated list of debug options is accepted. See the source
1245 a comma-separated list of options to selectively no-op various parts
1255 ----------------------------------------
1281 See the driver code for other, lesser-used variables.
1284 -------------------------
1293 VA-API environment variables
1294 ----------------------------
1298 enable MPEG4 for VA-API, disabled by default.
1301 --------------------------------
1305 a comma-separated list of named flags, which do various things. Use
1309 -------------------------------------
1313 a comma-separated list of debug options. Use ``V3D_DEBUG=help`` to
1317 .. _radv env-vars:
1320 ---------------------------------
1324 a comma-separated list of named flags, which do various things:
1345 show GPU-related information
1347 Mark geometry-affecting outputs as invariant. This works around a common
1370 disable FMASK compression on MSAA images (GFX6-GFX10.3)
1376 disable directly recording command buffers in GPU-visible memory
1389 disable TC-compat CMASK for MSAA surfaces
1406 dump SPIR-V
1408 split application-provided fused multiply-add in geometry stages
1422 allow to force per-pipeline vertex VRS rates on GFX10.3+. This is only
1433 a comma-separated list of named flags, which do various things:
1442 upload shaders to invisible VRAM (might be useful for non-resizable BAR systems)
1444 forces ray-tracing to be emulated in software on GFX10_3+ and enables
1453 cache per-stage NIR for graphics pipelines
1461 enable wave64 for ray tracing shaders (GFX10-10.3)
1497 set the ray history buffer size when capturing RRA traces (default value is 100MiB,
1498 small buffers may result in incomplete traces)
1503 RRA traces. This allows for dumping every Nth invocation along each dispatch dimension.
1521 a comma-separated list of named flags, which do various things:
1530 ``force-waitcnt``
1532 ``force-waitdeps``
1539 disable pre-RA, ILP and VOPD instruction scheduling
1540 ``nosched-ilp``
1542 ``nosched-vopd``
1550 -------------------------------------
1566 a comma-separated list of named flags, which do various things:
1587 Disable Hyper-Z
1633 Use old-style monolithic shaders compiled on demand
1651 Program WD/IA to switch on end-of-packet.
1653 Disable out-of-order rasterization
1660 ---------------------------------
1664 a comma-separated list of named flags, which do various things:
1733 Disable Hyper-Z
1741 Program WD/IA to switch on end-of-packet.
1755 if set to ``true``, various compute-related debug information will
1769 a comma-separated list of named flags, which do various things:
1780 Log shader info (non-zero values)
1799 ---------------------------------
1803 a comma-separated list of named flags, which do various things:
1814 Log SWTCL-specific info
1855 ----------------------------------
1859 a comma-separated list of named flags, which do various things:
1864 with caution. The traces are written to ``agxdecode.dump``,
1867 Disable 16-bit floating point support. This may workaround application
1870 possible) or added in the Mesa-wide driconf (if closed source).
1874 Disable write-combining (force all allocations to be write-through). This
1876 buffers may still be write-combined.
1880 a comma-separated list of named flags, which do various things:
1898 .. _imagination env-vars:
1901 ------------------------------------------------
1905 A comma-separated list of debug options. Use ``PVR_DEBUG=help`` to
1910 a comma-separated list of named flags for the Rogue compiler,
1935 ---------------------------------
1950 --------------------------------------
1956 ----
1963 -----------------------------------
1966 <https://github.com/KhronosGroup/Vulkan-Loader>`__, *not by Mesa*, but they
1979 A comma-delimited list of globs to search for in known layers and used to
1995 …tps://github.com/KhronosGroup/Vulkan-Loader/blob/main/docs/LoaderInterfaceArchitecture.md#table-of…
1996 …https://github.com/KhronosGroup/Vulkan-Loader/blob/main/docs/LoaderInterfaceArchitecture.md#deprec…