blob: 23cfcb48537d0dddf36ffaf0f6ce9289fc34e6f8 [file] [log] [blame]
..
The contents of this file must be kept in sync with qemu-option-trace.texi
until all the users of the texi file have been converted to rst and
the texi file can be removed.
Specify tracing options.
.. option:: [enable=]PATTERN
Immediately enable events matching *PATTERN*
(either event name or a globbing pattern). This option is only
available if QEMU has been compiled with the ``simple``, ``log``
or ``ftrace`` tracing backend. To specify multiple events or patterns,
specify the :option:`-trace` option multiple times.
Use :option:`-trace help` to print a list of names of trace points.
.. option:: events=FILE
Immediately enable events listed in *FILE*.
The file must contain one event name (as listed in the ``trace-events-all``
file) per line; globbing patterns are accepted too. This option is only
available if QEMU has been compiled with the ``simple``, ``log`` or
``ftrace`` tracing backend.
.. option:: file=FILE
Log output traces to *FILE*.
This option is only available if QEMU has been compiled with
the ``simple`` tracing backend.