| Summary: | Grid: incongruity in commands help messages/their man pages/commands line options | ||
|---|---|---|---|
| Product: | Red Hat Enterprise MRG | Reporter: | Martin Kudlej <mkudlej> |
| Component: | grid | Assignee: | grid-maint-list <grid-maint-list> |
| Status: | CLOSED WONTFIX | QA Contact: | MRG Quality Engineering <mrgqe-bugs> |
| Severity: | low | Docs Contact: | |
| Priority: | low | ||
| Version: | 1.3 | CC: | atangrin, iboverma, matt |
| 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: | 2016-05-24 16:50:10 UTC | Type: | --- |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
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