Bug 680402

Summary: Messaging/Management: incongruity in commands help messages/their man pages/commands line options
Product: Red Hat Enterprise MRG Reporter: Martin Kudlej <mkudlej>
Component: distributionAssignee: mrg-program-list <mrg-program-list>
Status: CLOSED DEFERRED QA Contact: MRG Quality Engineering <mrgqe-bugs>
Severity: low Docs Contact:
Priority: low    
Version: 1.3CC: matt, tross
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-03-28 20:27:43 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Martin Kudlej 2011-02-25 12:52:15 UTC
Version-Release number of selected component (if applicable):
cumin-0.1.4492-1
qpid-cpp-server-0.7.946106-27

Description of problem: There are Messaging/Management executable commands in /usr/bin and /usr/sbin. Some of them have differences among --help option output/man page and command line options:


/usr/bin/cumin:
4 option(s) reported by the program ONLY - because there is no manpage:
    --datas
    --help
    --webs
    -h

/usr/bin/cumin-admin:
11 option(s) reported by the program ONLY - no manpage:
    --brokers
    --database
    --debug
    --help
    --init-only
    --log-file
    --log-level
    --print-events
    --print-stats
    --section
    -h

/usr/bin/cumin-data:
11 option(s) reported by the program ONLY - no manpage, also it doesn't print "help" message when it runs without prarameters(I expect that it requires any parameter, so it should print "help" message as for example cumin-admin):
    --brokers
    --database
    --debug
    --help
    --init-only
    --log-file
    --log-level
    --print-events
    --print-stats
    --section
    -h

/usr/bin/cumin-web:
11 option(s) reported by the program ONLY - no manpage:
    --brokers
    --database
    --debug
    --help
    --host
    --init-only
    --log-file
    --log-level
    --port
    --section
    -h

/usr/bin/qpid-cluster:
15 option(s) reported by the program ONLY - no manpage:
    --all-connections
    --all-stop
    --connections
    --del-connection
    --force
    --numeric
    --stop
    --timeout
    -C
    -c
    -d
    -f
    -k
    -n
    -s

/usr/bin/qpid-cluster-store - no manpage:
6 option(s) reported by the program ONLY:
    --display
    --help
    --mark-clean
    -c
    -d
    -h

/usr/bin/qpid-config:
22 option(s) reported by the program ONLY - no manpage:
    --alternate-exchange
    --bindings
    --broker-addr
    --cluster-durable
    --durable
    --file-count
    --file-size
    --force
    --force-if-not-empty
    --force-if-used
    --generate-queue-events
    --ive
    --limit-policy
    --max-queue-count
    --max-queue-size
    --order
    --passive
    --sequence
    --timeout
    -a
    -b
    -f

/usr/bin/qpid-printevents:
2 option(s) reported by the program ONLY - no manpage:
    --help
    -h

/usr/bin/qpid-queue-stats:
6 option(s) reported by the program ONLY - no manpage:
    --broker-address
    --filter
    --help
    -a
    -f
    -h

/usr/bin/qpid-route:
14 option(s) reported by the program ONLY - no manpage:
    --ack
    --del-empty-link
    --durable
    --quiet
    --src-local
    --timeout
    --transport
    --verbose
    -d
    -e
    -q
    -s
    -t
    -v

/usr/bin/qpid-stat:
14 option(s) reported by the program ONLY - no manpage:
    --cluster
    --increasing
    --limit
    --sort-by
    --timeout
    -C
    -I
    -L
    -S
    -b
    -c
    -e
    -q
    -u

/usr/bin/sesame:
15 option(s) reported by the program ONLY - no manpage:
    --config
    --host
    --log-enable
    --max-ssf
    --mech
    --min-ssf
    --no-config
    --port
    --proto
    --pub-interval
    --pwd
    --pwd-file
    --service
    --state-dir
    --uid

/usr/sbin/qpidd:
30 option(s) reported by the program ONLY - they are not in manpage:
    --acl-file
    --cluster-cman
    --cluster-mechanism
    --cluster-name
    --cluster-password
    --cluster-read-max
    --cluster-size
    --cluster-url
    --cluster-username
    --create-replication-queue
    --jfile-size-pgs
    --num-jfiles
    --replication-exchange-name
    --replication-exchange-type
    --replication-listener-name
    --replication-queue
    --ssl-cert-db
    --ssl-cert-name
    --ssl-cert-password-file
    --ssl-port
    --ssl-require-client-authentication
    --ssl-sasl-no-dict
    --ssl-use-export-policy
    --store-dir
    --tpl-jfile-size-pgs
    --tpl-num-jfiles
    --tpl-wcache-page-size
    --truncate
    --watchdog-interval
    --wcache-page-size

Comment 1 Matthew Farrellee 2011-02-25 13:01:10 UTC
Please split off BZs for cumin, cumin-admin, cumin-web and cumin-data man pages. cumin-data and cumin-web are arguably libexec programs, and either they could have man pages, the cumin.conf file needs a man page, or they should be covered in the cumin man page.

Comment 2 Matthew Farrellee 2011-03-28 20:27:43 UTC
Break this BZ up, file against specific components.