doc: improve the documentation of desturi

Signed-off-by: Wen Congyang <wency@cn.fujitsu.com>

diff --git a/tools/virsh.c b/tools/virsh.c
index 55e2a688ea04cf7e71697e93326a197fde02ebcf..018e363794df58e43398f5a840b6e543b59a9c01 100644 (file)
--- a/tools/virsh.c
+++ b/tools/virsh.c
@@ -3375,7 +3375,7 @@ static const vshCmdOptDef opts_migrate[] = {
     {"copy-storage-all", VSH_OT_BOOL, 0, N_("migration with non-shared storage with full disk copy")},
     {"copy-storage-inc", VSH_OT_BOOL, 0, N_("migration with non-shared storage with incremental copy (same base image shared between source and destination)")},
     {"domain", VSH_OT_DATA, VSH_OFLAG_REQ, N_("domain name, id or uuid")},
-    {"desturi", VSH_OT_DATA, VSH_OFLAG_REQ, N_("connection URI of the destination host")},
+    {"desturi", VSH_OT_DATA, VSH_OFLAG_REQ, N_("connection URI of the destination host as seen from the client(normal migration) or source(p2p migration)")},
     {"migrateuri", VSH_OT_DATA, 0, N_("migration URI, usually can be omitted")},
     {"dname", VSH_OT_DATA, 0, N_("rename to new name during migration (if supported)")},
     {NULL, 0, 0, NULL}

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 9c45a6119932cede76449536b77d7914fc3458a5..0e03d680e65062a44c612a1dc7646dcb86f88478 100644 (file)
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -505,6 +505,19 @@ 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 omitted.
 
+B<Note>: The I<desturi> parameter for normal migration and peer2peer migration
+has different semantics:
+
+=over 4
+
+=item * normal migration: the I<desturi> is an address of the target host as
+seen from the client machine.
+
+=item * peer2peer migration: the I<desturi> is an address of the target host as
+seen from the source machine.
+
+=back
+
 =item B<migrate-setmaxdowntime> I<domain-id> I<downtime>
 
 Set maximum tolerable downtime for a domain which is being live-migrated to