diff options
author | Samuel Pitoiset <samuel.pitoiset@gmail.com> | 2024-04-23 09:06:32 +0200 |
---|---|---|
committer | Marge Bot <emma+marge@anholt.net> | 2024-04-25 10:10:22 +0000 |
commit | 9a43987780a17e763ab47844ba6989552d1c8198 (patch) | |
tree | 62e69d82c5fd59966cb6972438493c8f9adfd809 | |
parent | bb719640b5514c2148293d6e288a44e2cfda7436 (diff) |
docs: Add an alternative way to debug GPU hangs with RADV
Signed-off-by: Samuel Pitoiset <samuel.pitoiset@gmail.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/28849>
-rw-r--r-- | docs/drivers/amd/hang-debugging.rst | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/drivers/amd/hang-debugging.rst b/docs/drivers/amd/hang-debugging.rst index 297d9e7e7d5..a5fd2f8a98a 100644 --- a/docs/drivers/amd/hang-debugging.rst +++ b/docs/drivers/amd/hang-debugging.rst @@ -65,3 +65,15 @@ Under **Properties** -> **Installed Files**, click **Browse**, open at the top of the file. Hang debugging can be enabled by selecting the faulting game and adding ``RADV_DEBUG=hang %command%`` under **Properties** -> **General** -> **LAUNCH OPTIONS**. + +Debugging hangs without RADV_DEBUG=hang +--------------------------------------- + +In some situations, ``RADV_DEBUG=hang`` wouldn't be able to generate a GPU hang +report, like for synchronization issues (because it enables +``RADV_DEBUG=syncshaders`` behind the scene). An alternative solution is to +disable GPU recovery by adding ``amdgpu.gpu_recovery=0`` to your kernel command +line options. And then invoke UMR manually with +``umr --by-pci <pci_id> -O bits,halt_waves -go 0 -wa <ring> -go 1 2>&1`` for +dumping the waves and ``umr --by-pci <pci_id> -RS <ring> 2>&1`` for dumping the +rings once the GPU hang occured. |