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

..
  The contents of this file must be kept in sync with qemu-option-trace.texi
  until all the users of the texi file have been converted to rst and
  the texi file can be removed.

Specify tracing options.

.. option:: [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.

.. option:: 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.

.. option:: 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	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
	6	Specify 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.