qemu-option-trace.texi

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