[libvirt] [PATCH] docs: document dxml argument to migrate2
Eric Blake
eblake at redhat.com
Fri Jul 15 23:43:15 UTC 2011
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 at redhat.com +1-801-349-2682
Libvirt virtualization library http://libvirt.org
More information about the libvir-list
mailing list