Bug 691400

Summary: Typo about -d option in man page of cman_tool
Product: Red Hat Enterprise Linux 6 Reporter: Fabio Massimo Di Nitto <fdinitto>
Component: clusterAssignee: Fabio Massimo Di Nitto <fdinitto>
Status: CLOSED ERRATA QA Contact: Cluster QE <mspqa-list>
Severity: low Docs Contact:
Priority: low    
Version: 6.2CC: agk, ccaulfie, cfeist, cluster-maint, djansa, extras-orphan, fdinitto, jkortus, lhh, mbroz, rpeterso, swhiteho, teigland, yamato
Target Milestone: rc   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: cluster-3.0.12.1-2.el6 Doc Type: Bug Fix
Doc Text:
Do not document.
 Story Points: ---
Clone Of: 672792 Environment:
Last Closed: 2011-12-06 14:51:37 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Bug Depends On: 672792    
Bug Blocks:    

Description Fabio Massimo Di Nitto 2011-03-28 12:57:24 UTC 
+++ This bug was initially created as a clone of Bug #672792 +++

Created attachment 475380 [details]
A patch fixing the typo

Description of problem:

Man page of cman_tool.8 says cman_tool accepts following command line:

  cman_tool -d <value>

Howerver, it doesn't because of the specification of getopt command line
parser. It accepts

  cman_tool -d<value>

Man page should be fixed.

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

RHEL6 branch of git.

How reproducible:

 See -d option of man cman_tool
 Invoke cman_tool debug -d 256

Steps to Reproduce:
1.
2.
3.
  
Actual results:

  cman_tool: unknown option 255

Expected results:

The man page tells a command line which works.

Additional info:
Comment 1 Fabio Massimo Di Nitto 2011-03-28 13:02:29 UTC 
http://git.fedorahosted.org/git/?p=cluster.git;a=commitdiff;h=ab50640bc9093597e237efe6b728f13542b1ec4f
Comment 3 Fabio Massimo Di Nitto 2011-06-15 06:20:09 UTC 
(excess of paranoia.. getting use to the new procedures ;))

Unit test results:

(copy/paste from old man page: cman-3.0.12-41.el6)
DEBUG OPTIONS
       -d <value>
              The value is a bitmask of
              2 Barriers

[root@rhel6-node2 rpm]# cman_tool -d 233 join
cman_tool: unknown option 233

(copy/paste from current man page; cman-3.0.12.1-1.el6)
DEBUG OPTIONS
       -d<value>
              The value is a bitmask of
              2 Barriers


[root@rhel6-node2 rpm]# cman_tool -d233 join
Validating configuration
calling '/usr/sbin/ccs_config_validate  '
[SNIP]

now man page reflects real behaviour.
Comment 6 Lon Hohberger 2011-10-26 22:33:07 UTC 
    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
Do not document.
Comment 7 errata-xmlrpc 2011-12-06 14:51:37 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.

http://rhn.redhat.com/errata/RHBA-2011-1516.html