From 90312de551dc3d4a14e9e4c084d99d5bdae6f599 Mon Sep 17 00:00:00 2001 From: Pierre-Eric Pelloux-Prayer Date: Tue, 21 Jan 2020 18:56:03 +0100 Subject: [PATCH] docs: document AMD_DEBUG variable MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit See https://gitlab.freedesktop.org/mesa/mesa/issues/2022 Reviewed-by: Marek Olšák Tested-by: Marge Bot Part-of: --- docs/envvars.html | 122 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 122 insertions(+) diff --git a/docs/envvars.html b/docs/envvars.html index a9c2ddb3ed6..124f42714cc 100644 --- a/docs/envvars.html +++ b/docs/envvars.html @@ -646,6 +646,128 @@ Mesa EGL supports different sets of environment variables. See the
generate cmdbuffer tracefiles when a GPU hang is detected
+

radeonsi driver environment variables

+
+
AMD_DEBUG
+
a comma-separated list of named flags, which do various things:
+
+
+

Disable features / workaround flags (useful to diagnose an issue):

+
nodma
+
Disable SDMA
+
nodmaclear
+
Disable SDMA clears
+
nodmacopyimage
+
Disable SDMA image copies
+
zerovram
+
Clear VRAM allocations.
+
nodcc
+
Disable DCC.
+
nodccclear
+
Disable DCC fast clear.
+
nodccfb
+
Disable separate DCC on the main framebuffer
+
nodccmsaa
+
Disable DCC for MSAA
+
nodpbb
+
Disable DPBB.
+
nodfsm
+
Disable DFSM.
+
notiling
+
Disable tiling
+
nofmask
+
Disable MSAA compression
+
nohyperz
+
Disable Hyper-Z
+
norbplus
+
Disable RB+.
+
no2d
+
Disable 2D tiling
+

Info flags:

+
info
+
Print driver information
+
tex
+
Print texture info
+
compute
+
Print compute info
+
vm
+
Print virtual addresses when creating resources
+

Print shaders flags:

+
vs
+
Print vertex shaders
+
ps
+
Print pixel shaders
+
gs
+
Print geometry shaders
+
tcs
+
Print tessellation control shaders
+
tes
+
Print tessellation evaluation shaders
+
cs
+
Print compute shaders
+
noir
+
Don't print the LLVM IR
+
nonir
+
Don't print NIR when printing shaders
+
noasm
+
Don't print disassembled shaders
+
preoptir
+
Print the LLVM IR before initial optimizations
+

Shader compilation tuning flags:

+
sisched
+
Enable LLVM SI Machine Instruction Scheduler.
+
gisel
+
Enable LLVM global instruction selector.
+
w32ge
+
Use Wave32 for vertex, tessellation, and geometry shaders.
+
w32ps
+
Use Wave32 for pixel shaders.
+
w32cs
+
Use Wave32 for computes shaders.
+
w64ge
+
Use Wave64 for vertex, tessellation, and geometry shaders.
+
w64ps
+
Use Wave64 for pixel shaders.
+
w64cs
+
Use Wave64 for computes shaders.
+
checkir
+
Enable additional sanity checks on shader IR
+
mono
+
Use old-style monolithic shaders compiled on demand
+
nooptvariant
+
Disable compiling optimized shader variants.
+

Advanced usage flags:

+
forcedma
+
Use SDMA for all operations when possible.
+
nowc
+
Disable GTT write combining
+
check_vm
+
Check VM faults and dump debug info.
+
reserve_vmid
+
Force VMID reservation per context.
+
nogfx
+
Disable graphics. Only multimedia compute paths can be used.
+
nongg
+
Disable NGG and use the legacy pipeline.
+
nggc
+
Always use NGG culling even when it can hurt.
+
nonggc
+
Disable NGG culling.
+
alwayspd
+
Always enable the primitive discard compute shader.
+
pd
+
Enable the primitive discard compute shader for large draw calls.
+
nopd
+
Disable the primitive discard compute shader.
+
switch_on_eop
+
Program WD/IA to switch on end-of-packet.
+
nooutoforder
+
Disable out-of-order rasterization
+
dpbb
+
Enable DPBB.
+
dfsm
+
Enable DFSM.
+

Other Gallium drivers have their own environment variables. These may change -- 2.30.2