1.. 2 The contents of this file must be kept in sync with qemu-option-trace.texi 3 until all the users of the texi file have been converted to rst and 4 the texi file can be removed. 5 6Specify tracing options. 7 8.. option:: [enable=]PATTERN 9 10 Immediately enable events matching *PATTERN* 11 (either event name or a globbing pattern). This option is only 12 available if QEMU has been compiled with the ``simple``, ``log`` 13 or ``ftrace`` tracing backend. To specify multiple events or patterns, 14 specify the :option:`-trace` option multiple times. 15 16 Use :option:`-trace help` to print a list of names of trace points. 17 18.. option:: events=FILE 19 20 Immediately enable events listed in *FILE*. 21 The file must contain one event name (as listed in the ``trace-events-all`` 22 file) per line; globbing patterns are accepted too. This option is only 23 available if QEMU has been compiled with the ``simple``, ``log`` or 24 ``ftrace`` tracing backend. 25 26.. option:: file=FILE 27 28 Log output traces to *FILE*. 29 This option is only available if QEMU has been compiled with 30 the ``simple`` tracing backend. 31