summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorStefan Hajnoczi2021-01-12 17:58:58 +0100
committerStefan Hajnoczi2021-02-01 12:23:04 +0100
commit3faf22ef4465d064617dee524c97afa8d4400d9c (patch)
tree007fda2a052761e1e434ebb19bba6e6b2d440a2e
parentsimpletrace: build() missing 2 required positional arguments (diff)
downloadqemu-3faf22ef4465d064617dee524c97afa8d4400d9c.tar.gz
qemu-3faf22ef4465d064617dee524c97afa8d4400d9c.tar.xz
qemu-3faf22ef4465d064617dee524c97afa8d4400d9c.zip
trace: document how to specify multiple --trace patterns
It is possible to repeat the --trace option to specify multiple patterns. This may be preferrable to users who do not want to create a file with a list of patterns. Suggested-by: BALATON Zoltan <balaton@eik.bme.hu> Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com> Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com> Message-id: 20210112165859.225534-2-stefanha@redhat.com Signed-off-by: Stefan Hajnoczi <stefanha@redhat.com>
-rw-r--r--docs/devel/tracing.rst9
1 files changed, 7 insertions, 2 deletions
diff --git a/docs/devel/tracing.rst b/docs/devel/tracing.rst
index af395e957d..e8f9b82c5e 100644
--- a/docs/devel/tracing.rst
+++ b/docs/devel/tracing.rst
@@ -22,10 +22,15 @@ events::
This output comes from the "log" trace backend that is enabled by default when
``./configure --enable-trace-backends=BACKENDS`` was not explicitly specified.
-More than one trace event pattern can be specified by providing a file
-instead::
+Multiple patterns can be specified by repeating the ``--trace`` option::
+
+ $ qemu --trace "kvm_*" --trace "virtio_*" ...
+
+When patterns are used frequently it is more convenient to store them in a
+file to avoid long command-line options::
$ echo "memory_region_ops_*" >/tmp/events
+ $ echo "kvm_*" >>/tmp/events
$ qemu --trace events=/tmp/events ...
Trace events