docs: drvqemu: Decrease expectations about command line from 'virsh domxml-to-native'

In the qemu driver certain configs such as disk throttling or CPU
hotplug is configured by interacting with the monitor at the startup
phase of the hypervisor and thus is not part of the "native config".

Add a paragraph into the documentation outlining that the native
configuration might not be completely usable.

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Pavel Hrdina <phrdina@redhat.com>

diff --git a/docs/drvqemu.rst b/docs/drvqemu.rst
index 6368a91fb9593eb259c29ba7fa2196533a1e5a18..e08a60c7058100bdb8e54f518e533f409c51d391 100644 (file)
--- a/docs/drvqemu.rst
+++ b/docs/drvqemu.rst
@@ -443,10 +443,16 @@ Converting from domain XML to QEMU args
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The ``virsh domxml-to-native`` provides a way to convert a guest description
-using libvirt Domain XML, into a set of QEMU args that can be run manually. Note
-that currently the command line formatted by libvirt is no longer suited for
-manually running qemu as the configuration expects various resources and open
-file descriptors passed to the process which are usually prepared by libvirtd.
+using libvirt Domain XML, into a set of QEMU args that would be used by libvirt
+to start the qemu process.
+
+Note that currently the command line formatted by libvirt is no longer suited
+for manually running qemu as the configuration expects various resources and
+open file descriptors passed to the process which are usually prepared by
+libvirtd as well as certain features being configured via the monitor.
+
+The qemu arguments as returned by ``virsh domxml-to-native`` thus are not
+trivially usable outside of libvirt.
 
 Pass-through of arbitrary qemu commands
 ---------------------------------------