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