From 09e496d6c0f46b50b4f069bb0b72f35fdd271dc4 Mon Sep 17 00:00:00 2001 From: Emma Anholt Date: Fri, 10 Oct 2025 13:34:11 -0700 Subject: docs/perfetto: Be helpful and opinionated about config selection. system.cfg should be your go-to, regardless of driver. Part-of: --- docs/perfetto.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) (limited to 'docs') diff --git a/docs/perfetto.rst b/docs/perfetto.rst index a0570397283..fbfd4bfb95e 100644 --- a/docs/perfetto.rst +++ b/docs/perfetto.rst @@ -61,9 +61,10 @@ To capture a trace with Perfetto you need to take the following steps: 1. Build Perfetto from sources available at ``subprojects/perfetto`` following `this guide `__. -2. Create a `trace config `__, which is - a json formatted text file with extension ``.cfg``, or use one of the config - files under the ``src/tool/pps/cfg`` directory. More examples of config files +2. Select a `trace config `__, likely + ``src/tool/pps/cfg/system.cfg`` which does whole-system including GPU + profiling for any supported GPUs). Other configs are available in that + directory for CPU-only or GPU-only tracing, and more examples of config files can be found in ``subprojects/perfetto/test/configs``. 3. Change directory to ``subprojects/perfetto`` and run a @@ -106,7 +107,7 @@ the steps above : perfetto $ ./tools/ninja -C out/linux # Start perfetto - perfetto $ CONFIG=../../src/tool/pps/cfg/gpu.cfg OUT=out/linux/ ./tools/tmux -n + perfetto $ CONFIG=../../src/tool/pps/cfg/system.cfg OUT=out/linux/ ./tools/tmux -n # In parallel from the Mesa repo, start the PPS producer mesa $ ./build/src/tool/pps/pps-producer -- cgit v1.2.3