diff options
| author | Zan Dobersek <zdobersek@igalia.com> | 2025-09-20 18:23:03 +0200 |
|---|---|---|
| committer | Marge Bot <marge-bot@fdo.invalid> | 2025-10-06 12:07:55 +0000 |
| commit | 27c16c46fd1f31cf9308d27397fd35f387f38dca (patch) | |
| tree | 34089f4d9718c8567d69424c1a59264017d421fa /docs | |
| parent | 19b323740825eafddf8fb0c0e75fa069233c3759 (diff) | |
fd: allow limiting RD dumps to specific frames and submits
RD dump generation can be expensive and can only be desired for some
specific part of execution. Trigger file mechanism helps with this to a
certain degree but is still somewhat inexact.
FD_RD_DUMP_SUBMITS environment variable can be used to specify ranges of
submit indices for which RD dumps of command streams should be generated.
FD_RD_DUMP_FRAMES environment variable can similarly be used to specify
ranges of frames under which RD dumps for submitted command streams should
be generated. Frame ranges only really work with Turnip since the frame
count data is available there.
Signed-off-by: Zan Dobersek <zdobersek@igalia.com>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/37499>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/drivers/freedreno.rst | 5 |
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/drivers/freedreno.rst b/docs/drivers/freedreno.rst index 52a7472427e..fb3e30909a5 100644 --- a/docs/drivers/freedreno.rst +++ b/docs/drivers/freedreno.rst @@ -409,6 +409,11 @@ Output dump files and trigger file (when enabled) are hard-coded to be placed under ``/tmp``, or ``/data/local/tmp`` under Android. `FD_RD_DUMP_TESTNAME` can be used to specify a more descriptive prefix for the output or trigger files. +Dumping can be limited to specific ranges of frames or submits. For example, +``FD_RD_DUMP_SUBMITS=120-140,160,165`` will dump command streams only for the +specified submits. Similarly, ``FD_RD_DUMP_FRAMES`` can be set to specify for +which frames any submitted command stream should be dumped. + Functionality is generic to any Freedreno-based backend, but is currently only integrated in the MSM backend of Turnip. Using the existing ``TU_DEBUG=rd`` option will translate to ``FD_RD_DUMP=enable``. |