Re: [PATCH] docs: document dxml argument to migrate2

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 07/15/2011 02:14 AM, Daniel Veillard wrote:
On Thu, Jul 14, 2011 at 11:10:56AM -0600, Eric Blake wrote:
Commit 135554166 introduced a nice feature without documenting it.

* src/libvirt.c (virDomainMigrate2): Add paragraph.
---
  src/libvirt.c |    9 +++++++++
  1 files changed, 9 insertions(+), 0 deletions(-)

diff --git a/src/libvirt.c b/src/libvirt.c
index fc17f2b..13da214 100644
--- a/src/libvirt.c
+++ b/src/libvirt.c
@@ -4297,6 +4297,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).

   Looks fine, ACK, but danpb should probably verify :-)

I went ahead and pushed this.

--
Eric Blake   eblake@xxxxxxxxxx    +1-801-349-2682
Libvirt virtualization library http://libvirt.org

--
libvir-list mailing list
libvir-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/libvir-list


[Index of Archives]     [Virt Tools]     [Libvirt Users]     [Lib OS Info]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Big List of Linux Books]     [Yosemite News]     [KDE Users]     [Fedora Tools]