[libvirt] [PATCH] doc: Add doc for missed options of migrate

* tools/virsh.pod (add doc for options like "--p2p", "--direct", "--copy-storage-all", "dname", etc.) --- tools/virsh.pod | 23 ++++++++++++++++------- 1 files changed, 16 insertions(+), 7 deletions(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index c4a5803..036848d 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -456,13 +456,22 @@ Provide the maximum number of virtual CPUs supported for a guest VM on this connection. If provided, the I<type> parameter must be a valid type attribute for the <domain> element of XML. -=item B<migrate> optional I<--live> I<--suspend> I<domain-id> I<desturi> -I<migrateuri> - -Migrate domain to another host. Add --live for live migration; --suspend -leaves the domain paused on the destination host. The I<desturi> is the -connection URI of the destination host, and I<migrateuri> is the -migration URI, which usually can be omitted. +=item B<migrate> optional I<--live> I<--p2p> I<--direct> I<--tunnelled> +I<--persistent> I<--undefinesource> I<--suspend> I<--copy-storage-all> +I<--copy-storage-inc> I<domain-id> I<desturi> I<migrateuri> I<dname> + +Migrate domain to another host. Add I<--live> for live migration; I<--p2p> +for peer-2-peer migration; I<--direct> for direct migration; I<--tunnelled> +for tunnelled migration; I<--persistent> leaves the domain persistent on +destination host, I<--undefinesource> undefine the domain on source host, +I<--suspend> leaves the domain paused on the destination host. +I<--copy-storage-all> indicates migration with non-shared storage with full +disk copy, I<--copy-storage-inc> indicates migration with non-shared storage +with incremental copy (same base image shared between source and destination). +The I<desturi> is the connection URI of the destination host, and +I<migrateuri> is the migration URI, which usually can be omitted. +I<dname> is used for renaming the domain to new name during migration, which +also usually can be ommited. =item B<migrate-setmaxdowntime> I<domain-id> I<downtime> -- 1.7.3.2

On 11/18/2010 01:21 AM, Osier Yang wrote:
* tools/virsh.pod (add doc for options like "--p2p", "--direct", "--copy-storage-all", "dname", etc.) --- tools/virsh.pod | 23 ++++++++++++++++------- 1 files changed, 16 insertions(+), 7 deletions(-)
ACK to the general fix; I made these grammar tweaks, then pushed: diff --git i/tools/virsh.pod w/tools/virsh.pod index 036848d..bc1e8e5 100644 --- i/tools/virsh.pod +++ w/tools/virsh.pod @@ -461,17 +461,18 @@ I<--persistent> I<--undefinesource> I<--suspend> I<--copy-storage-all> I<--copy-storage-inc> I<domain-id> I<desturi> I<migrateuri> I<dname> Migrate domain to another host. Add I<--live> for live migration; I<--p2p> -for peer-2-peer migration; I<--direct> for direct migration; I<--tunnelled> -for tunnelled migration; I<--persistent> leaves the domain persistent on -destination host, I<--undefinesource> undefine the domain on source host, -I<--suspend> leaves the domain paused on the destination host. +for peer-2-peer migration; I<--direct> for direct migration; or I<--tunnelled> +for tunnelled migration. I<--persistent> leaves the domain persistent on +destination host, I<--undefinesource> undefines the domain on the source host, +and I<--suspend> leaves the domain paused on the destination host. I<--copy-storage-all> indicates migration with non-shared storage with full disk copy, I<--copy-storage-inc> indicates migration with non-shared storage with incremental copy (same base image shared between source and destination). + The I<desturi> is the connection URI of the destination host, and I<migrateuri> is the migration URI, which usually can be omitted. I<dname> is used for renaming the domain to new name during migration, which -also usually can be ommited. +also usually can be omitted. =item B<migrate-setmaxdowntime> I<domain-id> I<downtime> -- Eric Blake eblake@redhat.com +1-801-349-2682 Libvirt virtualization library http://libvirt.org

于 2010年11月19日 02:30, Eric Blake 写道:
On 11/18/2010 01:21 AM, Osier Yang wrote:
* tools/virsh.pod (add doc for options like "--p2p", "--direct", "--copy-storage-all", "dname", etc.) --- tools/virsh.pod | 23 ++++++++++++++++------- 1 files changed, 16 insertions(+), 7 deletions(-)
ACK to the general fix; I made these grammar tweaks, then pushed:
Thanks. :-) - Osier
diff --git i/tools/virsh.pod w/tools/virsh.pod index 036848d..bc1e8e5 100644 --- i/tools/virsh.pod +++ w/tools/virsh.pod @@ -461,17 +461,18 @@ I<--persistent> I<--undefinesource> I<--suspend> I<--copy-storage-all> I<--copy-storage-inc> I<domain-id> I<desturi> I<migrateuri> I<dname>
Migrate domain to another host. Add I<--live> for live migration; I<--p2p> -for peer-2-peer migration; I<--direct> for direct migration; I<--tunnelled> -for tunnelled migration; I<--persistent> leaves the domain persistent on -destination host, I<--undefinesource> undefine the domain on source host, -I<--suspend> leaves the domain paused on the destination host. +for peer-2-peer migration; I<--direct> for direct migration; or I<--tunnelled> +for tunnelled migration. I<--persistent> leaves the domain persistent on +destination host, I<--undefinesource> undefines the domain on the source host, +and I<--suspend> leaves the domain paused on the destination host. I<--copy-storage-all> indicates migration with non-shared storage with full disk copy, I<--copy-storage-inc> indicates migration with non-shared storage with incremental copy (same base image shared between source and destination). + The I<desturi> is the connection URI of the destination host, and I<migrateuri> is the migration URI, which usually can be omitted. I<dname> is used for renaming the domain to new name during migration, which -also usually can be ommited. +also usually can be omitted.
=item B<migrate-setmaxdowntime> I<domain-id> I<downtime>
participants (2)
-
Eric Blake
-
Osier Yang