aboutsummaryrefslogtreecommitdiff
path: root/docs/devel
diff options
context:
space:
mode:
authorChristoph Muellner <cmuellner@linux.com>2022-03-16 19:14:12 +0100
committerAlex Bennée <alex.bennee@linaro.org>2022-03-23 10:38:09 +0000
commit0f37cf2f71f764c5649e149c774172df7ab187c7 (patch)
tree6d8e866bb92a345424707d15b415fd5296f654af /docs/devel
parentf503b7e327301e789b4d19a4bd554d02934608aa (diff)
downloadqemu-0f37cf2f71f764c5649e149c774172df7ab187c7.zip
qemu-0f37cf2f71f764c5649e149c774172df7ab187c7.tar.gz
qemu-0f37cf2f71f764c5649e149c774172df7ab187c7.tar.bz2
docs/tcg-plugins: document QEMU_PLUGIN behaviour
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>
Diffstat (limited to 'docs/devel')
-rw-r--r--docs/devel/tcg-plugins.rst9
1 files changed, 7 insertions, 2 deletions
diff --git a/docs/devel/tcg-plugins.rst b/docs/devel/tcg-plugins.rst
index f93ef4f..a7cc44a 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
---------------