Merge remote-tracking branch 'remotes/rth-gitlab/tags/pull-tcg-20210526' into staging
[qemu.git] / docs / qemu-option-trace.rst.inc
blobd7acbe67f737a0f86aad06a732b6edca2735b8e3
2 Specify tracing options.
4 ``[enable=]PATTERN``
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.
12   Use :option:`-trace help` to print a list of names of trace points.
14 ``events=FILE``
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.
22 ``file=FILE``
24   Log output traces to *FILE*.
25   This option is only available if QEMU has been compiled with
26   the ``simple`` tracing backend.