Mesa (master): docs/envvars: document ACO_DEBUG

[GitLab Mirror]

Module: Mesa
Branch: master
Commit: 5c6afd0f349b17aaa0b2e06ccee44fa709d6285c
URL:    http://cgit.freedesktop.org/mesa/mesa/commit/?id=5c6afd0f349b17aaa0b2e06ccee44fa709d6285c

Author: Rhys Perry <pendingchaos02 at gmail.com>
Date:   Tue May  5 17:31:26 2020 +0100

docs/envvars: document ACO_DEBUG

Signed-off-by: Rhys Perry <pendingchaos02 at gmail.com>
Reviewed-by: Erik Faye-Lund <erik.faye-lund at collabora.com>
Reviewed-by: Samuel Pitoiset <samuel.pitoiset at gmail.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/4907>

---

 docs/envvars.html | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/envvars.html b/docs/envvars.html
index 4a90185e297..9c38bbb495e 100644
--- 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>
+<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>