diff options
author | Mark Collins <mark@igalia.com> | 2022-10-20 18:26:47 +0000 |
---|---|---|
committer | Marge Bot <emma+marge@anholt.net> | 2022-11-11 13:50:57 +0000 |
commit | ac5a55ef115525d5b8fcade9158fedccea24174a (patch) | |
tree | 66221bde4f071e88ea87f4ac70b70c6911a0c4d1 /docs/u_trace.rst | |
parent | 8370a0d6bfcaaf84fd7ddb58b51eb11bb416652f (diff) | |
download | mesa-ac5a55ef115525d5b8fcade9158fedccea24174a.tar.gz |
common/utrace: Add CS logging support
Viewing CS traces retrieved from the driver is common practice to
determine driver bugs but there is no way to determine what
function a certain part of the CS was emitted by. This is crucial
information to determine what function is responsible for emitting
broken CS packets and to help with navigation of the CS trace.
Signed-off-by: Mark Collins <mark@igalia.com>
Reviewed-by: Danylo Piliaiev <dpiliaiev@igalia.com>
Reviewed-by: Yonggang Luo <luoyonggang@gmail.com>
Ack-by: Chia-I Wu <olvaffe@gmail.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/18271>
Diffstat (limited to 'docs/u_trace.rst')
-rw-r--r-- | docs/u_trace.rst | 3 |
1 files changed, 3 insertions, 0 deletions
diff --git a/docs/u_trace.rst b/docs/u_trace.rst index e7dafc07001..f055e44397c 100644 --- a/docs/u_trace.rst +++ b/docs/u_trace.rst @@ -37,6 +37,9 @@ u_trace is controlled by environment variables: enables perfetto instrumentation prior to connecting, perfetto traces can be collected without setting this but it may miss some events prior to the tracing session being started. + ``markers`` + enables marker instrumentation, will print utrace markers into + the CS which can then be viewed by dumping the CS from the driver. :envvar:`MESA_GPU_TRACEFILE` specifies a file where to write the output instead of ``stdout`` |