blob: 162f1528d219912eadb889d0a90e914bd9977609 [file] [log] [blame]
Peter Maydell87c08682020-01-23 15:22:39 +00001@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
Denis V. Luneveeb2b8f2016-06-17 17:44:09 +03005Specify tracing options.
6
7@table @option
8@item [enable=]@var{pattern}
Michael Tokarev0b816e92018-05-20 08:28:33 +03009Immediately enable events matching @var{pattern}
10(either event name or a globbing pattern). This option is only
Philipp Gesang20f8a132017-02-02 12:41:01 +010011available if QEMU has been compiled with the @var{simple}, @var{log}
Denis V. Luneveeb2b8f2016-06-17 17:44:09 +030012or @var{ftrace} tracing backend. To specify multiple events or patterns,
13specify the @option{-trace} option multiple times.
14
15Use @code{-trace help} to print a list of names of trace points.
16
17@item events=@var{file}
18Immediately enable events listed in @var{file}.
19The file must contain one event name (as listed in the @file{trace-events-all}
20file) per line; globbing patterns are accepted too. This option is only
Philipp Gesang20f8a132017-02-02 12:41:01 +010021available if QEMU has been compiled with the @var{simple}, @var{log} or
Denis V. Luneveeb2b8f2016-06-17 17:44:09 +030022@var{ftrace} tracing backend.
23
24@item file=@var{file}
25Log output traces to @var{file}.
26This option is only available if QEMU has been compiled with
27the @var{simple} tracing backend.
28@end table