From e6cdffa0fcba7289ce2b51f783318a913c80eb91 Mon Sep 17 00:00:00 2001 From: Alyssa Rosenzweig Date: Mon, 5 Sep 2022 12:20:56 -0400 Subject: [PATCH] docs/envvars: Document Asahi variables There aren't too many. Signed-off-by: Alyssa Rosenzweig Reviewed-by: Eric Engestrom Part-of: --- docs/envvars.rst | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/docs/envvars.rst b/docs/envvars.rst index 6b3ff0aec02..0a6aa46d4f5 100644 --- a/docs/envvars.rst +++ b/docs/envvars.rst @@ -1140,5 +1140,43 @@ r300 driver environment variables ``notcl`` Disable hardware accelerated Transform/Clip/Lighting +Asahi driver environment variables +---------------------------------- + +:envvar:`ASAHI_MESA_DEBUG` + a comma-separated list of named flags, which do various things: + + ``trace`` + Trace work submitted to the GPU to files, using the agxdecode + infrastructure. This produces a large volume of data, so should be used + with caution. The traces are written to ``agxdecode.dump``, + but this can be overridden using ``AGXDECODE_DUMP_FILE``. + ``no16`` + Disable 16-bit floating point support. This may workaround application + bugs in certain OpenGL ES applications originally written for desktops. If + such applications are found in the wild, they should be fixed upstream (if + possible) or added in the Mesa-wide driconf (if closed source). + ``dirty`` + In debug builds only: disable dirty tracking optimizations. + +:envvar:`AGX_MESA_DEBUG` + a comma-separated list of named flags, which do various things: + + ``shaders`` + Print shaders being compiled at various stages in the pipeline. + ``shaderdb`` + Print statistics about compiled shaders. + ``verbose`` + Disassemble in verbose mode, including additional information that may be + useful for debugging. + ``internal`` + Include even internal shaders (as produced for clears, blits, and such) + when printing shaders. Without this flag, internal shaders are ignored by + the shaders and shaderdb flags. + ``novalidate`` + In debug builds only: skip internal intermediate representation validation. + ``noopt`` + Disable various backend optimizations. + Other Gallium drivers have their own environment variables. These may change frequently so the source code should be consulted for details.