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>
This commit is contained in:
Danylo Piliaiev 2022-05-31 14:04:27 +03:00 committed by Marge Bot
parent bfd3c43aa9
commit a841300384
1 changed files with 19 additions and 0 deletions

View File

@ -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``