Merge remote-tracking branch 'remotes/jsnow-gitlab/tags/python-pull-request' into...
[qemu.git] / docs / qemu-option-trace.rst.inc
1
2 Specify tracing options.
3
4 ``[enable=]PATTERN``
5
6   Immediately enable events matching *PATTERN*
7   (either event name or a globbing pattern).  This option is only
8   available if QEMU has been compiled with the ``simple``, ``log``
9   or ``ftrace`` tracing backend.  To specify multiple events or patterns,
10   specify the :option:`-trace` option multiple times.
11
12   Use :option:`-trace help` to print a list of names of trace points.
13
14 ``events=FILE``
15
16   Immediately enable events listed in *FILE*.
17   The file must contain one event name (as listed in the ``trace-events-all``
18   file) per line; globbing patterns are accepted too.  This option is only
19   available if QEMU has been compiled with the ``simple``, ``log`` or
20   ``ftrace`` tracing backend.
21
22 ``file=FILE``
23
24   Log output traces to *FILE*.
25   This option is only available if QEMU has been compiled with
26   the ``simple`` tracing backend.