docs/qemu-option-trace.rst.inc

   1 ..
   2   The contents of this file must be kept in sync with qemu-option-trace.texi
   3   until all the users of the texi file have been converted to rst and
   4   the texi file can be removed.
   5
   6 Specify tracing options.
   7
   8 .. option:: [enable=]PATTERN
   9
  10   Immediately enable events matching *PATTERN*
  11   (either event name or a globbing pattern).  This option is only
  12   available if QEMU has been compiled with the ``simple``, ``log``
  13   or ``ftrace`` tracing backend.  To specify multiple events or patterns,
  14   specify the :option:`-trace` option multiple times.
  15
  16   Use :option:`-trace help` to print a list of names of trace points.
  17
  18 .. option:: events=FILE
  19
  20   Immediately enable events listed in *FILE*.
  21   The file must contain one event name (as listed in the ``trace-events-all``
  22   file) per line; globbing patterns are accepted too.  This option is only
  23   available if QEMU has been compiled with the ``simple``, ``log`` or
  24   ``ftrace`` tracing backend.
  25
  26 .. option:: file=FILE
  27
  28   Log output traces to *FILE*.
  29   This option is only available if QEMU has been compiled with
  30   the ``simple`` tracing backend.