tracing: only allow -trace to override -D if set
[qemu/ar7.git] / qemu-option-trace.texi
blob162f1528d219912eadb889d0a90e914bd9977609
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.
5 Specify tracing options.
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.
15 Use @code{-trace help} to print a list of names of trace points.
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.
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