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