[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL 8/8] docs/tcg-plugins: document QEMU_PLUGIN behaviour
From: |
Alex Bennée |
Subject: |
[PULL 8/8] docs/tcg-plugins: document QEMU_PLUGIN behaviour |
Date: |
Wed, 23 Mar 2022 11:27:11 +0000 |
From: Christoph Muellner <cmuellner@linux.com>
QEMU plugins can be loaded via command line arguments or via
the QEMU_PLUGIN environment variable. Currently, only the first method
is documented. Let's document QEMU_PLUGIN.
As drive-by cleanup, this patch fixes the path to the plugins
in the same section of the documentation.
Signed-off-by: Christoph Muellner <cmuellner@linux.com>
Message-Id: <20220316181412.1550044-1-cmuellner@linux.com>
[AJB: fixed some minor typos]
Signed-off-by: Alex Bennée <alex.bennee@linaro.org>
diff --git a/docs/devel/tcg-plugins.rst b/docs/devel/tcg-plugins.rst
index f93ef4fe52..a7cc44aa20 100644
--- a/docs/devel/tcg-plugins.rst
+++ b/docs/devel/tcg-plugins.rst
@@ -27,13 +27,18 @@ Once built a program can be run with multiple plugins
loaded each with
their own arguments::
$QEMU $OTHER_QEMU_ARGS \
- -plugin tests/plugin/libhowvec.so,inline=on,count=hint \
- -plugin tests/plugin/libhotblocks.so
+ -plugin contrib/plugin/libhowvec.so,inline=on,count=hint \
+ -plugin contrib/plugin/libhotblocks.so
Arguments are plugin specific and can be used to modify their
behaviour. In this case the howvec plugin is being asked to use inline
ops to count and break down the hint instructions by type.
+Linux user-mode emulation also evaluates the environment variable
+``QEMU_PLUGIN``::
+
+ QEMU_PLUGIN="file=contrib/plugins/libhowvec.so,inline=on,count=hint" $QEMU
+
Writing plugins
---------------
--
2.30.2
- [PULL for 7.0 0/8] i386, docs, gitlab fixes, Alex Bennée, 2022/03/23
- [PULL 1/8] tests/Makefile.include: Let "make clean" remove the TCG tests, too, Alex Bennée, 2022/03/23
- [PULL 3/8] mailmap/gitdm: more fixes for bad tags and authors, Alex Bennée, 2022/03/23
- [PULL 2/8] target/i386: force maximum rounding precision for fildl[l], Alex Bennée, 2022/03/23
- [PULL 5/8] semihosting: clean up handling of expanded argv, Alex Bennée, 2022/03/23
- [PULL 4/8] docs/devel: try and impose some organisation, Alex Bennée, 2022/03/23
- [PULL 6/8] gitlab: include new aarch32 job in custom-runners, Alex Bennée, 2022/03/23
- [PULL 8/8] docs/tcg-plugins: document QEMU_PLUGIN behaviour,
Alex Bennée <=
- [PULL 7/8] docs: remove qemu_logo.pdf, Alex Bennée, 2022/03/23
- Re: [PULL for 7.0 0/8] i386, docs, gitlab fixes, Peter Maydell, 2022/03/23
- Re: [PULL for 7.0 0/8] i386, docs, gitlab fixes, Peter Maydell, 2022/03/24