xref: /qemu/docs/qemu-option-trace.rst.inc (revision 92eecfff)
1
2Specify 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.
27