[mirror_qemu.git] / docs / qemu-option-trace.rst.inc


Specify tracing options.

``[enable=]PATTERN``

  Immediately enable events matching *PATTERN*
  (either event name or a globbing pattern).  This option is only
  available if QEMU has been compiled with the ``simple``, ``log``
  or ``ftrace`` tracing backend.  To specify multiple events or patterns,
  specify the :option:`-trace` option multiple times.

  Use :option:`-trace help` to print a list of names of trace points.

``events=FILE``

  Immediately enable events listed in *FILE*.
  The file must contain one event name (as listed in the ``trace-events-all``
  file) per line; globbing patterns are accepted too.  This option is only
  available if QEMU has been compiled with the ``simple``, ``log`` or
  ``ftrace`` tracing backend.

``file=FILE``

  Log output traces to *FILE*.
  This option is only available if QEMU has been compiled with
  the ``simple`` tracing backend.
Commit	Line	Data
87c0868f PM	1
	2	Specify tracing options.
	3
5a4b0d41	4	``[enable=]PATTERN``
87c0868f PM	5
	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
5a4b0d41	14	``events=FILE``
87c0868f PM	15
	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
5a4b0d41	22	``file=FILE``
87c0868f PM	23
	24	Log output traces to FILE.
	25	This option is only available if QEMU has been compiled with
	26	the ``simple`` tracing backend.