blob: 7d1b7f05c542748d4fc703d92a27193ac01fabf0 [file] [log] [blame]
Denis V. Luneveeb2b8f2016-06-17 17:44:09 +03001Specify tracing options.
2
3@table @option
4@item [enable=]@var{pattern}
Michael Tokarev0b816e92018-05-20 08:28:33 +03005Immediately enable events matching @var{pattern}
6(either event name or a globbing pattern). This option is only
Philipp Gesang20f8a132017-02-02 12:41:01 +01007available if QEMU has been compiled with the @var{simple}, @var{log}
Denis V. Luneveeb2b8f2016-06-17 17:44:09 +03008or @var{ftrace} tracing backend. To specify multiple events or patterns,
9specify the @option{-trace} option multiple times.
10
11Use @code{-trace help} to print a list of names of trace points.
12
13@item events=@var{file}
14Immediately enable events listed in @var{file}.
15The file must contain one event name (as listed in the @file{trace-events-all}
16file) per line; globbing patterns are accepted too. This option is only
Philipp Gesang20f8a132017-02-02 12:41:01 +010017available if QEMU has been compiled with the @var{simple}, @var{log} or
Denis V. Luneveeb2b8f2016-06-17 17:44:09 +030018@var{ftrace} tracing backend.
19
20@item file=@var{file}
21Log output traces to @var{file}.
22This option is only available if QEMU has been compiled with
23the @var{simple} tracing backend.
24@end table