Bug 680403 - Grid: incongruity in commands help messages/their man pages/commands line options
Summary: Grid: incongruity in commands help messages/their man pages/commands line opt...
Keywords:
Status: CLOSED WONTFIX
Alias: None
Product: Red Hat Enterprise MRG
Classification: Red Hat
Component: grid
Version: 1.3
Hardware: Unspecified
OS: Linux
low
low
Target Milestone: ---
: ---
Assignee: grid-maint-list
QA Contact: MRG Quality Engineering
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2011-02-25 12:52 UTC by Martin Kudlej
Modified: 2016-05-24 16:50 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-05-24 16:50:10 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Martin Kudlej 2011-02-25 12:52:53 UTC
Version-Release number of selected component (if applicable):
condor-7.4.5-0.8

Description of problem: There are Grid 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/condor:
 options reported by the program ONLY - there are not in man page:
    -addr
    -all
    -help
    -name
    -pool
    -version

/usr/bin/condor_dagman:
17 options reported by the man page ONLY - there is no useful output from -help or -h parameter call:
    -DumpRescue
    -allowlogerror
    -allowversionmismatch
    -autorescue
    -csdversion
    -dag
    -debug
    -dorescuefrom
    -lockfile
    -maxidle
    -maxjobs
    -maxpost
    -maxpre
    -noeventchecks
    -rescue
    -usedagdir
    -waitfordebug

/usr/bin/condor_findhost:
1 options reported by the program ONLY:
    -h
1 options reported by the man page ONLY:
    -help

/usr/bin/condor_history:
option(s) reported by the man page ONLY:
    -completedsince
    -long
    -name
    -xml

/usr/bin/condor_hold:
1 option(s) reported by the program ONLY:
    -reason
1 option(s) reported by the man page ONLY:
    -debug

/usr/bin/condor_power:
option(s) reported by the program ONLY:
  -p
  -i

/usr/bin/condor_q:
4 option(s) reported by the program ONLY:
    --help
    --usage
    -expert
    -version
3 option(s) reported by the man page ONLY:
    -debug
    -globus
    -l

/usr/bin/condor_qedit:
6 option(s) reported by the man page ONLY - when condor is off, there is no help message, just error message:
    -constraint
    -debug
    -long
    -n
    -name
    -pool

/usr/bin/condor_release:
1 option(s) reported by the program ONLY:
    -reason
1 option(s) reported by the man page ONLY:
    -debug

/usr/bin/condor_reschedule:
1 option(s) reported by the man page ONLY:
    -debug

/usr/bin/condor_rm:
1 option(s) reported by the program ONLY:
    -reason
1 option(s) reported by the man page ONLY:
    -debug

/usr/bin/condor_router_history:
1 option(s) reported by the man page ONLY:
    --h

/usr/bin/condor_router_q:
27 option(s) reported by the program ONLY - because it hasn't man page at all:
    --help
    --usage
    -analyze
    -attributes
    -avgqueuetime
    -better-analyze
    -constraint
    -cputime
    -currentrun
    -dag
    -direct
    -expert
    -format
    -global
    -goodput
    -help
    -hold
    -io
    -jobads
    -long
    -machineads
    -name
    -pool
    -run
    -submitter
   -version
    -xml

/usr/bin/condor_router_rm:
9 option(s) reported by the program ONLY - because it hasn't man page at all: 
    -addr
    -all
    -constraint
    -forcex
    -help
    -name
    -pool
    -reason
    -version

/usr/bin/condor_ssh_to_job:
option(s) reported by the man page ONLY:
    -help

/usr/bin/condor_status:
3 option(s) reported by the program ONLY:
    -generic
    -grid
    -target
2 option(s) reported by the man page ONLY:
    -attributes
    -quill

/usr/bin/condor_submit:
option(s) reported by the man page ONLY:
    -debug
option(s) reported by the program ONLY:
   -stm

/usr/bin/condor_submit_dag:
9 option(s) reported by the program ONLY:
    -AllowLogError
    -AllowVersionMismatch
    -AutoRescue
    -DoRescueFrom
    -MaxPost
    -MaxPre
    -NoEventChecks
    -OldRescue
    -UseDagDir
10 option(s) reported by the man page ONLY:
    -allowlogerror
    -allowversionmismatch
    -autorescue
    -dorescuefrom
    -maxpost
    -maxpre
    -noeventchecks
    -oldrescue
    -remote
    -usedagdir

/usr/bin/condor_transfer_data:
1 option(s) reported by the program ONLY:
    -stm
1 option(s) reported by the man page ONLY:
    -spool

/usr/bin/condor_vacate:
1 option(s) reported by the man page ONLY:
    -debug

/usr/bin/wallaby:
12 option(s) reported by the program ONLY - no manpage:
    --auth-mechanism
    --help
    --host
    --password
    --port
    --user
    -H
    -M
    -P
    -U
    -h
    -p

/usr/bin/wallaby-agent:
23 option(s) reported by the program ONLY - no manpage:
    --auth-mechanism
    --dbname
    --foreground
    --help
    --host
    --logfile
    --password
    --port
    --run-as
    --snapdb
    --user
    --verbose
    -H
    -M
    -P
    -U
    -d
    -f
    -h
    -l
    -p
    -s
    -v

/usr/sbin/amazon_gahp:
4 option(s) reported by the program ONLY - no manpage:
    -d
    -f
    -m
    -w

/usr/sbin/carod:
carod doesn't print "help"(-h) message when LL_DAEMON_LOG is not defined.
if LL_DAEMON_LOG is defined - option(s) reported by the program ONLY - no manpage:
  -d
  --daemon
  -l
  --logdebug
  -h
  --help
  -p
  --pidfile

/usr/sbin/caroniad:
caroniad doesn't print "help"(-h) message when EC2E_DAEMON_LOG is not defined.
if EC2E_DAEMON_LOG is defined - option(s) reported by the program ONLY - no manpage:
  -d
  --daemon
  -l
  --logdebug
  -h
  --help
  -p
  --pidfile

/usr/sbin/condor_configure_store:
36 option(s) reported by the program ONLY - no manpage:
    --add
    --auth-mechanism
    --broker
    --delete
    --edit
    --features
    --groups
    --help
    --list
    --list-all-features
    --list-all-groups
    --list-all-nodes
    --list-all-params
    --list-all-subsystems
    --nodes
    --params
    --password
    --port
    --subsys
    --user
    --verbose
    -a
    -b
    -d
    -e
    -f
    -g
    -h
    -l
    -m
    -n
    -o
    -p
    -s
    -u
    -v

/usr/sbin/condor_fetchlog:
2 option(s) reported by the program ONLY:
    -debug
    -view_collector

/usr/sbin/condor_master:
2 option(s) reported by the man page ONLY - no help message:
    -f
    -n

/usr/sbin/condor_off:
6 option(s) reported by the program ONLY:
    -collector
    -kbdd
    -master
    -negotiator
    -schedd
    -startd
1 option(s) reported by the man page ONLY:
    -debug

/usr/sbin/condor_on:
6 option(s) reported by the program ONLY:
    -collector
    -kbdd
    -master
    -negotiator
    -schedd
    -startd
1 option(s) reported by the man page ONLY:
    -debug

/usr/sbin/condor_reconfig:
6 option(s) reported by the program ONLY:
    -collector
    -kbdd
    -master
    -negotiator
    -schedd
    -startd
1 option(s) reported by the man page ONLY:
    -debug

/usr/sbin/condor_restart:
9 option(s) reported by the program ONLY:
    -collector
    -fast
    -graceful
    -kbdd
    -master
    -negotiator
    -peaceful
    -schedd
    -startd
1 option(s) reported by the man page ONLY:
    -debug

/usr/sbin/condor_startd:
1 option(s) reported by the program ONLY - no manpage:
    -skip-benchmarks

/usr/sbin/condor_store_cred:
2 option(s) reported by the program ONLY:
    -d
    -h
1 option(s) reported by the man page ONLY:
    -help

/usr/sbin/condor_updates_stats:
1 option(s) reported by the program ONLY:
    -max
2 option(s) reported by the man page ONLY:
    --notime
    --time


Also all commands should unified where they will output the "help"(-h/-help/--help) message, to stderr or to stdout. 
For example condor_history outputs "help" message to stdout, but condor_cod outputs it to stderr.
It should be stdout according http://www.gnu.org/prep/standards/standards.html#g_t_002d_002dhelp


Note You need to log in before you can comment on or make changes to this bug.