From aea883abc9ab9f360096d017b501d16f8261950e Mon Sep 17 00:00:00 2001 From: Eric Blake Date: Thu, 14 Jul 2011 11:09:03 -0600 Subject: [PATCH] docs: document dxml argument to migrate2 Commit 135554166 introduced a nice feature without documenting it. * src/libvirt.c (virDomainMigrate2): Add paragraph. --- src/libvirt.c | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/src/libvirt.c b/src/libvirt.c index 7c68bd8240..001c38dd75 100644 --- a/src/libvirt.c +++ b/src/libvirt.c @@ -4293,6 +4293,15 @@ error: * different processors even with the same architecture, or between * different types of hypervisor. * + * If the hypervisor supports it, @dxml can be used to alter + * host-specific portions of the domain XML that will be used on + * the destination. For example, it is possible to alter the + * backing filename that is associated with a disk device, in order + * to account for naming differences between source and destination + * in accessing the underlying storage. The migration will fail + * if @dxml would cause any guest-visible changes. Pass NULL + * if no changes are needed to the XML between source and destination. + * * Returns the new domain object if the migration was successful, * or NULL in case of error. Note that the new domain object * exists in the scope of the destination connection (dconn).