summary refs log tree commit diff stats
path: root/docs/system/qemu-option-trace.texi
diff options
context:
space:
mode:
authorPaolo Bonzini <pbonzini@redhat.com>2020-02-28 15:35:57 +0000
committerPeter Maydell <peter.maydell@linaro.org>2020-03-06 10:04:57 +0000
commitabcd92db6a7b725e16826ee2e3fcb13cfe3a96c2 (patch)
treebd4895fac48e1c1f0e20330f4ce556d85fa62e8a /docs/system/qemu-option-trace.texi
parent2147106172266c3f38b167ead97bd17eeaab85a0 (diff)
downloadfocaccia-qemu-abcd92db6a7b725e16826ee2e3fcb13cfe3a96c2.tar.gz
focaccia-qemu-abcd92db6a7b725e16826ee2e3fcb13cfe3a96c2.zip
qemu-doc: move included files to docs/system
Since qemu-doc.texi is mostly including files from docs/system,
move the existing include files there for consistency.

Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Alex Bennée <alex.bennee@linaro.org>
Tested-by: Alex Bennée <alex.bennee@linaro.org>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Message-id: 20200228153619.9906-12-peter.maydell@linaro.org
Message-id: 20200226113034.6741-12-pbonzini@redhat.com
[PMM: update MAINTAINERS line for qemu-option-trace.texi]
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Diffstat (limited to 'docs/system/qemu-option-trace.texi')
-rw-r--r--docs/system/qemu-option-trace.texi28
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/system/qemu-option-trace.texi b/docs/system/qemu-option-trace.texi
new file mode 100644
index 0000000000..162f1528d2
--- /dev/null
+++ b/docs/system/qemu-option-trace.texi
@@ -0,0 +1,28 @@
+@c The contents of this file must be kept in sync with qemu-option-trace.rst.inc
+@c until all the users of the texi file have been converted to rst and
+@c the texi file can be removed.
+
+Specify tracing options.
+
+@table @option
+@item [enable=]@var{pattern}
+Immediately enable events matching @var{pattern}
+(either event name or a globbing pattern).  This option is only
+available if QEMU has been compiled with the @var{simple}, @var{log}
+or @var{ftrace} tracing backend.  To specify multiple events or patterns,
+specify the @option{-trace} option multiple times.
+
+Use @code{-trace help} to print a list of names of trace points.
+
+@item events=@var{file}
+Immediately enable events listed in @var{file}.
+The file must contain one event name (as listed in the @file{trace-events-all}
+file) per line; globbing patterns are accepted too.  This option is only
+available if QEMU has been compiled with the @var{simple}, @var{log} or
+@var{ftrace} tracing backend.
+
+@item file=@var{file}
+Log output traces to @var{file}.
+This option is only available if QEMU has been compiled with
+the @var{simple} tracing backend.
+@end table