[libvirt] [PATCH 1/1] Clarify the purpose of domxml-from-native
dallan at redhat.com
Mon Feb 6 21:45:41 UTC 2012
Someone mentioned to me that they interpreted this section of the KVM
driver page as suggesting that new guests should be created by
creating a qemu commandline and converting it to XML with
domxml-from-native. I don't think that's the intent of
domxml-from-native, so I added that clarification.
docs/drvqemu.html.in | 12 +++++++++---
1 files changed, 9 insertions(+), 3 deletions(-)
diff --git a/docs/drvqemu.html.in b/docs/drvqemu.html.in
index fa5496c..09c4f95 100644
@@ -432,9 +432,15 @@ mount -t cgroup none /dev/cgroup -o devices
<h3><a name="xmlimport">Converting from QEMU args to domain XML</a></h3>
- The <code>virsh domxml-from-native</code> provides a way to convert an
- existing set of QEMU args into a guest description using libvirt Domain XML
- that can then be used by libvirt.
+ The <code>virsh domxml-from-native</code> provides a way to
+ convert an existing set of QEMU args into a guest description
+ using libvirt Domain XML that can then be used by libvirt.
+ Please note that this command is intended to be used to convert
+ existing qemu guests previously started from the command line to
+ be managed through libvirt. It should not be used a method of
+ creating new guests from scratch. New guests should be created
+ using an application calling the libvirt APIs or by manually
+ crafting XML to pass to virsh.
<pre>$ cat > demo.args <<EOF
More information about the libvir-list