docs/envvars: document ACO_DEBUG

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>

diff --git a/docs/envvars.html b/docs/envvars.html
index 4a90185e2971a6235f64234ef3d1966df76a3f0d..9c38bbb495e716bb43e56ce40d7e1694cf303c32 100644 (file)
--- a/docs/envvars.html
+++ b/docs/envvars.html
@@ -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>
 <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>
 </dl>
 
 <h3>radeonsi driver environment variables</h3>