summaryrefslogtreecommitdiff
path: root/docs/u_trace.rst
diff options
context:
space:
mode:
authorDanylo Piliaiev <dpiliaiev@igalia.com>2022-05-31 14:04:27 +0300
committerMarge Bot <emma+marge@anholt.net>2022-07-12 22:24:19 +0000
commita841300384cab760bcc3a53ae563764e4049946b (patch)
treea07f14209523765dc154ce93ec7d857fef5979fb /docs/u_trace.rst
parentbfd3c43aa99b29546c7b6e2d5e11ce7b7215eb98 (diff)
downloadmesa-a841300384cab760bcc3a53ae563764e4049946b.tar.gz
docs/u_trace: Add documentation for *_GPU_TRACEPOINT envvars
Signed-off-by: Danylo Piliaiev <dpiliaiev@igalia.com> Reviewed-by: Emma Anholt <emma@anholt.net> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/16781>
Diffstat (limited to 'docs/u_trace.rst')
-rw-r--r--docs/u_trace.rst19
1 files changed, 19 insertions, 0 deletions
diff --git a/docs/u_trace.rst b/docs/u_trace.rst
index 088bd10b654..0b66ca3bf30 100644
--- a/docs/u_trace.rst
+++ b/docs/u_trace.rst
@@ -41,3 +41,22 @@ u_trace is controlled by environment variables:
:envvar:`GPU_TRACE_INSTRUMENT`
Meaningful only for Perfetto tracing. If set to ``1`` enables
instrumentation of GPU commands before the tracing is enabled.
+
+:envvar:`*_GPU_TRACEPOINT`
+ tracepoints can be enabled or disabled using driver specific environment
+ variable. Most tracepoints are enabled by default. For instance
+ ``TU_GPU_TRACEPOINT=-blit,+render_pass`` will disable the
+ ``blit`` tracepoints and enable the ``render_pass`` tracepoints.
+
+.. list-table::
+ :header-rows: 1
+
+ * - Driver
+ - Environment Variable
+ - Tracepoint Definitions
+ * - Freedreno
+ - :envvar:`FD_GPU_TRACEPOINT`
+ - ``src/gallium/drivers/freedreno/freedreno_tracepoints.py``
+ * - Turnip
+ - :envvar:`TU_GPU_TRACEPOINT`
+ - ``src/freedreno/vulkan/tu_tracepoints.py``