From bbe97c3871404c87f5ad20b8efdfd06eabd2e7aa Mon Sep 17 00:00:00 2001 From: Lionel Landwerlin Date: Mon, 31 Jan 2022 10:50:39 +0200 Subject: [PATCH] docs: update INTEL_DEBUG environment variable documentation Signed-off-by: Lionel Landwerlin Closes: https://gitlab.freedesktop.org/mesa/mesa/-/issues/5929 Acked-by: Caio Oliveira Part-of: --- docs/envvars.rst | 29 +++++++++++++++++++++++++---- 1 file changed, 25 insertions(+), 4 deletions(-) diff --git a/docs/envvars.rst b/docs/envvars.rst index bc4a9786523..32f9c26b990 100644 --- a/docs/envvars.rst +++ b/docs/envvars.rst @@ -238,8 +238,6 @@ Intel driver environment variables ``ann`` annotate IR in assembly dumps - ``aub`` - dump batches into an AUB trace for use with simulation tools ``bat`` emit batch information ``blit`` @@ -248,6 +246,8 @@ Intel driver environment variables emit messages about the blorp operations (blits & clears) ``buf`` emit messages about buffer objects + ``bt`` + emit messages binding tables ``clip`` emit messages about the clip unit (for old gens, includes the CLIP program) @@ -258,6 +258,8 @@ Intel driver environment variables ``do32`` generate compute shader SIMD32 programs even if workgroup size doesn't exceed the SIMD16 limit + ``fall`` + emit messages about performance issues (same as ``perf``) ``fs`` dump shader assembly for fragment shaders ``gs`` @@ -266,11 +268,19 @@ Intel driver environment variables print instruction hex dump with the disassembly ``l3`` emit messages about the new L3 state during transitions + ``mesh`` + dump shader assembly for mesh shaders ``no8`` don't generate SIMD8 fragment shader ``no16`` suppress generation of 16-wide fragment shaders. useful for debugging broken shaders + ``no32`` + suppress generation of 32-wide fragment shaders. useful for + debugging broken shaders + ``no-oaconfig`` + disable HW performance metric configuration, and anything + related to i915-perf (useful when running on simulation) ``nocompact`` disable instruction compaction ``nodualobj`` @@ -282,17 +292,21 @@ Intel driver environment variables ``optimizer`` dump shader assembly to files at each optimization pass and iteration that make progress + ``pc`` + emit messages about PIPE_CONTROL instruction usage ``perf`` emit messages about performance issues ``perfmon`` emit messages about ``AMD_performance_monitor`` ``reemit`` mark all state dirty on each draw call + ``rt`` + dump shader assembly for ray tracing shaders ``sf`` emit messages about the strips & fans unit (for old gens, includes the SF program) - ``shader_time`` - record how much GPU time is spent in each shader + ``soft64`` + enable implementation of software 64bit floating point support ``spill_fs`` force spilling of all registers in the scalar backend (useful to debug spilling code) @@ -304,8 +318,13 @@ Intel driver environment variables ``sync`` after sending each batch, emit a message and wait for that batch to finish rendering + ``task`` + dump shader assembly for task shaders ``tcs`` dump shader assembly for tessellation control shaders + ``tcs8`` + force usage of 8-patches tessellation control shaders (only + for gfx 9-11) ``tes`` dump shader assembly for tessellation evaluation shaders ``tex`` @@ -314,6 +333,8 @@ Intel driver environment variables emit messages about URB setup ``vs`` dump shader assembly for vertex shaders + ``wm`` + dump shader assembly for fragment shaders (same as ``fs``) :envvar:`INTEL_MEASURE` Collects GPU timestamps over common intervals, and generates a CSV report