docs/envvars: document ACO_DEBUG
authorRhys Perry <pendingchaos02@gmail.com>
Tue, 5 May 2020 16:31:26 +0000 (17:31 +0100)
committerMarge Bot <eric+marge@anholt.net>
Thu, 7 May 2020 11:32:06 +0000 (11:32 +0000)
Signed-off-by: Rhys Perry <pendingchaos02@gmail.com>
Reviewed-by: Erik Faye-Lund <erik.faye-lund@collabora.com>
Reviewed-by: Samuel Pitoiset <samuel.pitoiset@gmail.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4907>

docs/envvars.html

index 4a90185e2971a6235f64234ef3d1966df76a3f0d..9c38bbb495e716bb43e56ce40d7e1694cf303c32 100644 (file)
@@ -642,6 +642,17 @@ Mesa EGL supports different sets of environment variables.  See the
 <dd>force anisotropy filter (up to 16)</dd>
 <dt><code>RADV_TRACE_FILE</code></dt>
 <dd>generate cmdbuffer tracefiles when a GPU hang is detected</dd>
+<dt><code>ACO_DEBUG</code></dt>
+<dd>a comma-separated list of named flags, which do various things:
+<dl>
+   <dt><code>validateir</code></dt>
+   <dd>validate the ACO IR at various points of compilation (enabled by default for debug/debugoptimized builds)</dd>
+   <dt><code>validatera</code></dt>
+   <dd>validate register assignment of ACO IR and catches many RA bugs</dd>
+   <dt><code>perfwarn</code></dt>
+   <dd>abort on some suboptimal code generation</dd>
+</dl>
+</dd>
 </dl>
 
 <h3>radeonsi driver environment variables</h3>