Peter Maydell | 87c0868 | 2020-01-23 15:22:39 +0000 | [diff] [blame] | 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. |
| 4 | |
Denis V. Lunev | eeb2b8f | 2016-06-17 17:44:09 +0300 | [diff] [blame] | 5 | Specify tracing options. |
| 6 | |
| 7 | @table @option |
| 8 | @item [enable=]@var{pattern} |
Michael Tokarev | 0b816e9 | 2018-05-20 08:28:33 +0300 | [diff] [blame] | 9 | Immediately enable events matching @var{pattern} |
| 10 | (either event name or a globbing pattern). This option is only |
Philipp Gesang | 20f8a13 | 2017-02-02 12:41:01 +0100 | [diff] [blame] | 11 | available if QEMU has been compiled with the @var{simple}, @var{log} |
Denis V. Lunev | eeb2b8f | 2016-06-17 17:44:09 +0300 | [diff] [blame] | 12 | or @var{ftrace} tracing backend. To specify multiple events or patterns, |
| 13 | specify the @option{-trace} option multiple times. |
| 14 | |
| 15 | Use @code{-trace help} to print a list of names of trace points. |
| 16 | |
| 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 |
Philipp Gesang | 20f8a13 | 2017-02-02 12:41:01 +0100 | [diff] [blame] | 21 | available if QEMU has been compiled with the @var{simple}, @var{log} or |
Denis V. Lunev | eeb2b8f | 2016-06-17 17:44:09 +0300 | [diff] [blame] | 22 | @var{ftrace} tracing backend. |
| 23 | |
| 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 |