Merge remote-tracking branch 'remotes/stefanha/tags/block-pull-request' into staging
[qemu.git] / qemu-option-trace.texi
1 Specify tracing options.
2
3 @table @option
4 @item [enable=]@var{pattern}
5 Immediately enable events matching @var{pattern}
6 (either event name or a globbing pattern).  This option is only
7 available if QEMU has been compiled with the @var{simple}, @var{log}
8 or @var{ftrace} tracing backend.  To specify multiple events or patterns,
9 specify the @option{-trace} option multiple times.
10
11 Use @code{-trace help} to print a list of names of trace points.
12
13 @item events=@var{file}
14 Immediately enable events listed in @var{file}.
15 The file must contain one event name (as listed in the @file{trace-events-all}
16 file) per line; globbing patterns are accepted too.  This option is only
17 available if QEMU has been compiled with the @var{simple}, @var{log} or
18 @var{ftrace} tracing backend.
19
20 @item file=@var{file}
21 Log output traces to @var{file}.
22 This option is only available if QEMU has been compiled with
23 the @var{simple} tracing backend.
24 @end table