Bug 1135955

Summary: The usage for migrate's option --auto-converge missed in virsh man page
Product: Red Hat Enterprise Linux 7 Reporter: zhengqin <zsong>
Component: libvirtAssignee: Libvirt Maintainers <libvirt-maint>
Status: CLOSED ERRATA QA Contact: Virtualization Bugs <virt-bugs>
Severity: high Docs Contact:
Priority: high    
Version: 7.1CC: dyuan, jdenemar, mzhan, rbalakri, sowang, zhwang, zpeng
Target Milestone: rc   
Target Release: ---   
Hardware: All   
OS: All   
Whiteboard:
Fixed In Version: libvirt-1.2.8-1.el7 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2015-03-05 07:43:39 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description zhengqin 2014-09-01 10:04:36 UTC
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.

Comment 1 Jiri Denemark 2014-09-03 14:48:02 UTC
Fixed upstream by v1.2.7-158-g338ae9e:

commit 338ae9e2d4a2a847900839d8d47079617a0939be
Author: Pradipta Kr. Banerjee <pradipta.banerjee>
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.com>
    Signed-off-by: Ján Tomko <jtomko>

Comment 4 Song Wang 2014-12-15 06:08:09 UTC
[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.

Comment 6 errata-xmlrpc 2015-03-05 07:43:39 UTC
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