[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL 8/8] docs/tools/qemu-trace-stap.rst: Do not hard-code the QEMU bin
|
From: |
Thomas Huth |
|
Subject: |
[PULL 8/8] docs/tools/qemu-trace-stap.rst: Do not hard-code the QEMU binary name |
|
Date: |
Wed, 5 Jan 2022 13:36:12 +0100 |
In downstream, we want to use a different name for the QEMU binary,
and some people might also use the docs for non-x86 binaries, that's
why we already created the |qemu_system| placeholder in the past.
Use it now in the stap trace doc, too.
Message-Id: <20220104103319.179870-1-thuth@redhat.com>
Reviewed-by: Philippe Mathieu-Daudé <f4bug@amsat.org>
Signed-off-by: Thomas Huth <thuth@redhat.com>
---
docs/tools/qemu-trace-stap.rst | 24 ++++++++++++------------
1 file changed, 12 insertions(+), 12 deletions(-)
diff --git a/docs/tools/qemu-trace-stap.rst b/docs/tools/qemu-trace-stap.rst
index d53073b52b..2169ce5d17 100644
--- a/docs/tools/qemu-trace-stap.rst
+++ b/docs/tools/qemu-trace-stap.rst
@@ -46,19 +46,19 @@ The following commands are valid:
any of the listed names. If no *PATTERN* is given, the all possible
probes will be listed.
- For example, to list all probes available in the ``qemu-system-x86_64``
+ For example, to list all probes available in the |qemu_system|
binary:
- ::
+ .. parsed-literal::
- $ qemu-trace-stap list qemu-system-x86_64
+ $ qemu-trace-stap list |qemu_system|
To filter the list to only cover probes related to QEMU's cryptographic
subsystem, in a binary outside ``$PATH``
- ::
+ .. parsed-literal::
- $ qemu-trace-stap list /opt/qemu/4.0.0/bin/qemu-system-x86_64 'qcrypto*'
+ $ qemu-trace-stap list /opt/qemu/|version|/bin/|qemu_system| 'qcrypto*'
.. option:: run OPTIONS BINARY PATTERN...
@@ -90,26 +90,26 @@ The following commands are valid:
Restrict the tracing session so that it only triggers for the process
identified by *PID*.
- For example, to monitor all processes executing ``qemu-system-x86_64``
+ For example, to monitor all processes executing |qemu_system|
as found on ``$PATH``, displaying all I/O related probes:
- ::
+ .. parsed-literal::
- $ qemu-trace-stap run qemu-system-x86_64 'qio*'
+ $ qemu-trace-stap run |qemu_system| 'qio*'
To monitor only the QEMU process with PID 1732
- ::
+ .. parsed-literal::
- $ qemu-trace-stap run --pid=1732 qemu-system-x86_64 'qio*'
+ $ qemu-trace-stap run --pid=1732 |qemu_system| 'qio*'
To monitor QEMU processes running an alternative binary outside of
``$PATH``, displaying verbose information about setup of the
tracing environment:
- ::
+ .. parsed-literal::
- $ qemu-trace-stap -v run /opt/qemu/4.0.0/qemu-system-x86_64 'qio*'
+ $ qemu-trace-stap -v run /opt/qemu/|version|/bin/|qemu_system| 'qio*'
See also
--------
--
2.27.0
- [PULL 0/8] Misc patches (tests, docs, compat machines), Thomas Huth, 2022/01/05
- [PULL 1/8] hw: Add compat machines for 7.0, Thomas Huth, 2022/01/05
- [PULL 2/8] tests/qtest/test-x86-cpuid-compat: Check for machines before using them, Thomas Huth, 2022/01/05
- [PULL 3/8] tests/qtest/hd-geo-test: Check for the lsi53c895a controller before using it, Thomas Huth, 2022/01/05
- [PULL 4/8] tests/unit/test-util-sockets: Use g_file_open_tmp() to create temp file, Thomas Huth, 2022/01/05
- [PULL 5/8] qemu-options: Remove the deprecated -no-quit option, Thomas Huth, 2022/01/05
- [PULL 7/8] gitlab-ci: Enable docs in the centos job, Thomas Huth, 2022/01/05
- [PULL 6/8] docs/sphinx: fix compatibility with sphinx < 1.8, Thomas Huth, 2022/01/05
- [PULL 8/8] docs/tools/qemu-trace-stap.rst: Do not hard-code the QEMU binary name,
Thomas Huth <=
- Re: [PULL 0/8] Misc patches (tests, docs, compat machines), Richard Henderson, 2022/01/05