blob: d7acbe67f737a0f86aad06a732b6edca2735b8e3 [file] [log] [blame]
Peter Maydell87c08682020-01-23 15:22:39 +00001
2Specify tracing options.
3
Peter Maydell5a4b0d42020-11-02 16:52:18 +00004``[enable=]PATTERN``
Peter Maydell87c08682020-01-23 15:22:39 +00005
6 Immediately enable events matching *PATTERN*
7 (either event name or a globbing pattern). This option is only
8 available if QEMU has been compiled with the ``simple``, ``log``
9 or ``ftrace`` tracing backend. To specify multiple events or patterns,
10 specify the :option:`-trace` option multiple times.
11
12 Use :option:`-trace help` to print a list of names of trace points.
13
Peter Maydell5a4b0d42020-11-02 16:52:18 +000014``events=FILE``
Peter Maydell87c08682020-01-23 15:22:39 +000015
16 Immediately enable events listed in *FILE*.
17 The file must contain one event name (as listed in the ``trace-events-all``
18 file) per line; globbing patterns are accepted too. This option is only
19 available if QEMU has been compiled with the ``simple``, ``log`` or
20 ``ftrace`` tracing backend.
21
Peter Maydell5a4b0d42020-11-02 16:52:18 +000022``file=FILE``
Peter Maydell87c08682020-01-23 15:22:39 +000023
24 Log output traces to *FILE*.
25 This option is only available if QEMU has been compiled with
26 the ``simple`` tracing backend.