Red Hat Bugzilla – Bug 1135955
The usage for migrate's option --auto-converge missed in virsh man page
Last modified: 2015-03-05 02:43:39 EST
Description of problem: The usage for migrate's option --auto-converge exists in virsh help page, but missed in virsh man page. Version-Release number of selected component (if applicable): libvirt-1.2.7-2.el7.x86_64 How reproducible: 100% Steps to Reproduce: 1. Here is usage for migrate's option --auto-converge in virsh help page: virsh migrate --help | grep auto-converge migrate [--live] [--offline] [--p2p] [--direct] [--tunnelled] [--persistent] [--undefinesource] [--suspend] [--copy-storage-all] [--copy-storage-inc] [--change-protection] [--unsafe] [--verbose] [--compressed] [--auto-converge] [--abort-on-error] <domain> <desturi> [<migrateuri>] [<graphicsuri>] [<listen-address>] [<dname>] [--timeout <number>] [--xml <string>] --auto-converge force convergence during live migration 2. Here is virsh man page to find "auto-converge" : # man virsh | grep auto-converge # echo $? 1 Actual results: 1. The usage for migrate's option --auto-converge missed in virsh man page Expected results: 1. The man page should be consistent with help page, which should include the usage for option --auto-converge.
Fixed upstream by v1.2.7-158-g338ae9e: commit 338ae9e2d4a2a847900839d8d47079617a0939be Author: Pradipta Kr. Banerjee <pradipta.banerjee@gmail.com> Date: Tue Aug 19 18:26:11 2014 +0530 man: virsh: add missing auto-converge option for 'migrate' * tools/virsh.pod (migrate): Add --auto-converge flag Signed-off-by: Pradipta Kr. Banerjee <bpradip@in.ibm.com> Signed-off-by: Ján Tomko <jtomko@redhat.com>
[root@localhost libvirt]# rpm -q libvirt libvirt-1.2.8-10.el7.x86_64 [root@localhost libvirt]# virsh migrate --help | grep auto-converge migrate [--live] [--offline] [--p2p] [--direct] [--tunnelled] [--persistent] [--undefinesource] [--suspend] [--copy-storage-all] [--copy-storage-inc] [--change-protection] [--unsafe] [--verbose] [--compressed] [--auto-converge] [--rdma-pin-all] [--abort-on-error] <domain> <desturi> [<migrateuri>] [<graphicsuri>] [<listen-address>] [<dname>] [--timeout <number>] [--xml <string>] --auto-converge force convergence during live migration [root@localhost libvirt]# man virsh |grep auto-converge [--auto-converge] domain desturi [migrateuri] [graphicsuri] [listen-address] [dname] during the migration. --auto-converge forces convergence during live migration. [root@localhost libvirt]# echo $? 0 bug is fixed.
Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory, and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. https://rhn.redhat.com/errata/RHSA-2015-0323.html