Bug 1493640

Summary: lsmcli volume-replicate-range -h and manpage differs
Product: Red Hat Enterprise Linux 7 Reporter: Jakub Krysl <jkrysl>
Component: libstoragemgmtAssignee: Gris Ge <fge>
Status: CLOSED ERRATA QA Contact: Jakub Krysl <jkrysl>
Severity: low Docs Contact:
Priority: unspecified    
Version: 7.4CC: jkrysl
Target Milestone: rc   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: libstoragemgmt-1.6.0-1.el7 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-04-10 15:37:02 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 Jakub Krysl 2017-09-20 15:41:25 UTC 
Description of problem:
There is a difference between --help and manpage with command lsmcli volume-replicate-range and its parameter --rep-type. Manpage allows only 2 replication types CLONE and COPY but --help allows 4: CLONE, COPY, MIRROR_ASYNC, MIRROR_SYNC.
All 4 of these replication types are allowed on command line, so manpage is probably the wrong one.

Version-Release number of selected component (if applicable):
1.4.0

How reproducible:
100%

Steps to Reproduce:
compare these 2 for 'lsmcli -u XXX volume-replicate-range --rep-type'
1.lsmcli volume-replicate-range --help
2.man lsmcli

Actual results:
Manpage and --help difference.

Expected results:
Both saying the same thing.

Additional info:
Comment 2 Gris Ge 2017-10-17 13:27:47 UTC 
Patch has been submitted to upstream for review:
https://github.com/libstorage/libstoragemgmt/pull/314
Comment 6 Jakub Krysl 2017-10-20 09:20:50 UTC 
Manpage and lsmcli volume-replicate-range now list only CLONE and COPY replication type. Trying MIRROR_SYNC or MIRROR_ASYNC is not allowed now:
# lsmcli -u "sim://" volume-replicate-range --src-vol VOL_ID_00001 --dst-vol VOL_ID_00001 --rep-type MIRROR_ASYNC --src-start 0 --dst-start 0 --count 10
usage: lsmcli volume-replicate-range [-h] [-v] [-u <URI>] [-P] [-H] [-t <SEP>]
                                     [-e] [-f] [-w CHILD_WAIT] [--header] [-b]
                                     [-s] --src-vol <SRC_VOL_ID> --dst-vol
                                     <DST_VOL_ID> --rep-type <REP_TYPE>
                                     --src-start <SRC_START_BLK> --dst-start
                                     <DST_START_BLK> --count <BLK_COUNT>
lsmcli volume-replicate-range: error: argument --rep-type: invalid choice: 'MIRROR_ASYNC' (choose from 'CLONE', 'COPY')
Comment 9 errata-xmlrpc 2018-04-10 15:37:02 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://access.redhat.com/errata/RHEA-2018:0864