trace: document 'trace wipe'
authorJerome Forissier <jerome.forissier@linaro.org>
Fri, 13 Dec 2024 12:45:38 +0000 (13:45 +0100)
committerTom Rini <trini@konsulko.com>
Wed, 1 Jan 2025 01:00:46 +0000 (19:00 -0600)
Add documentation for the 'trace wipe' command.

Signed-off-by: Jerome Forissier <jerome.forissier@linaro.org>
Acked-by: Ilias Apalodimas <ilias.apalodimas@linaro.org>
doc/develop/trace.rst

index 5468620..d3c8628 100644 (file)
@@ -163,6 +163,17 @@ you will see the time taken by each function shown against its exit record.
               u-boot-1     [000]     3.116466: funcgraph_entry:        0.063 us   |        memset();
               u-boot-1     [000]     3.116539: funcgraph_exit:         0.143 us   |        }
 
+The `trace wipe` command may be used to clear the trace buffer. It leaves
+tracing in its current enable state. This command is convenient when tracing a
+single command, for example:
+
+.. code-block:: console
+
+   => trace pause; trace wipe
+   => trace resume; dhcp; trace pause
+   => trace stats
+   ...
+
 Flame graph
 -----------