From: Peter Krempa <pkrempa@redhat.com>
Date: Mon, 21 Nov 2022 12:46:29 +0000 (+0100)
Subject: docs: drvqemu: Give example how to query device properties for overriding
X-Git-Tag: v9.0.0-rc1~222
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f28232d1a4658edc844cd84c54c0913b02d49b75;p=thirdparty%2Flibvirt.git

docs: drvqemu: Give example how to query device properties for overriding

Add an example of invoking qemu with '-device TYPE,?' to query
properties of a given type.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Ján Tomko <jtomko@redhat.com>
---

diff --git a/docs/drvqemu.rst b/docs/drvqemu.rst
index 7bfb28ea9c..b31b1785db 100644
--- a/docs/drvqemu.rst
+++ b/docs/drvqemu.rst
@@ -722,6 +722,11 @@ attribute are:
 The overrides are applied only to initial device configuration passed to QEMU
 via the commandline. Later hotplug operations will not apply any modifications.
 
+The properties of a device can be queried directly in qemu (e.g. for the
+``virtio-blk-pci`` device) via ::
+
+  # qemu-system-x86_64 -device virtio-blk-pci,?
+
 Configuring override for a device alias which is not used or attempting to
 remove a device property which is not formatted by libvirt will cause failure
 to startup the VM.