All of lore.kernel.org
 help / color / mirror / Atom feed
From: "Alex Bennée" <alex.bennee@linaro.org>
To: peter.maydell@linaro.org
Cc: "Christoph Muellner" <cmuellner@linux.com>,
	"Mahmoud Mandour" <ma.mandourr@gmail.com>,
	"Alex Bennée" <alex.bennee@linaro.org>,
	qemu-devel@nongnu.org, "Alexandre Iooss" <erdnaxe@crans.org>
Subject: [PULL 8/8] docs/tcg-plugins: document QEMU_PLUGIN behaviour
Date: Wed, 23 Mar 2022 11:27:11 +0000	[thread overview]
Message-ID: <20220323112711.440376-9-alex.bennee@linaro.org> (raw)
In-Reply-To: <20220323112711.440376-1-alex.bennee@linaro.org>

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



  parent reply	other threads:[~2022-03-23 12:13 UTC|newest]

Thread overview: 13+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-03-23 11:27 [PULL for 7.0 0/8] i386, docs, gitlab fixes Alex Bennée
2022-03-23 11:27 ` [PULL 1/8] tests/Makefile.include: Let "make clean" remove the TCG tests, too Alex Bennée
2022-03-23 11:27 ` [PULL 2/8] target/i386: force maximum rounding precision for fildl[l] Alex Bennée
2022-03-23 11:27 ` [PULL 3/8] mailmap/gitdm: more fixes for bad tags and authors Alex Bennée
2022-03-23 11:27 ` [PULL 4/8] docs/devel: try and impose some organisation Alex Bennée
2022-03-23 11:27 ` [PULL 5/8] semihosting: clean up handling of expanded argv Alex Bennée
2022-03-23 11:27 ` [PULL 6/8] gitlab: include new aarch32 job in custom-runners Alex Bennée
2022-03-23 11:27 ` [PULL 7/8] docs: remove qemu_logo.pdf Alex Bennée
2022-03-23 11:27 ` Alex Bennée [this message]
2022-03-23 18:05 ` [PULL for 7.0 0/8] i386, docs, gitlab fixes Peter Maydell
2022-03-23 19:04   ` Alex Bennée
2022-03-24 11:00     ` Peter Maydell
2022-03-24 16:32 ` Peter Maydell

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20220323112711.440376-9-alex.bennee@linaro.org \
    --to=alex.bennee@linaro.org \
    --cc=cmuellner@linux.com \
    --cc=erdnaxe@crans.org \
    --cc=ma.mandourr@gmail.com \
    --cc=peter.maydell@linaro.org \
    --cc=qemu-devel@nongnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.