[libvirt] [PATCH 1/1] Clarify the purpose of domxml-from-native

[Eric Blake]

On 02/06/2012 02:45 PM, Dave Allan wrote:
> 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
> --- a/docs/drvqemu.html.in
> +++ b/docs/drvqemu.html.in
> @@ -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>
> 
>      <p>
> -      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.

Looks reasonable.  Should we also be mentioning other tools in the virt
stack, such as virt-install or virt-manager or Oz, which can also be
used to ease the creation of new guests?  Should we also be putting
disclaimers like this in 'man virsh' under domxml-from-native?

-- 
Eric Blake   eblake at redhat.com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 620 bytes
Desc: OpenPGP digital signature
URL: <http://listman.redhat.com/archives/libvir-list/attachments/20120206/3a4c3b15/attachment-0001.sig>