[
https://issues.apache.org/jira/browse/HADOOP-9514?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13642856#comment-13642856
]
Thomas Graves commented on HADOOP-9514:
---------------------------------------
It would be nice if we could make the usage across the commands consistent.
Its nice to have a GenericOptionsParser but we either need to pull out the
things that aren't truly generic across the commands or better yet have a way
for different commands to specify which apply and perhaps add to it so that the
usage comes out nicely to differentiate subcommands from generic options. We
also need to remove the general usage of "bin/hadoop command [genericOptions]
[commandOptions]"
Note that this came about from discussion on YARN-126.
Note that even within subcommands of particular CLI's are inconsistent. For
example with yarn:
$ yarn rmadmin
Usage: java RMAdmin
[-refreshQueues]
[-refreshNodes]
[-refreshUserToGroupsMappings]
[-refreshSuperUserGroupsConfiguration]
[-refreshAdminAcls]
[-refreshServiceAcl]
[-getGroups [username]]
[-help [cmd]]
$yarn application
usage: application
-kill <arg> Kills the application.
-list Lists all the Applications from RM.
-status <arg> Prints the status of the application.
Another examples is hdfs dfsadmin and then look at hdfs fsck (which happens to
be printing generic usage options twice on trunk/branch-2)
> Hadoop CLI's have inconsistent usages
> -------------------------------------
>
> Key: HADOOP-9514
> URL: https://issues.apache.org/jira/browse/HADOOP-9514
> Project: Hadoop Common
> Issue Type: Bug
> Components: scripts
> Affects Versions: 3.0.0, 2.0.4-alpha
> Reporter: Thomas Graves
> Labels: usability
>
> Many of the hadoop command line interfaces (yarn/mapred/hdfs/hadoop) and
> subcommands have inconsistent usages, in many cases have options that don't
> apply (-archives/-files/-jt), and due to the usage of GenericOptionsParser
> print the usage as "bin/hadoop command [genericOptions] [commandOptions]"
> even though you were running yarn or hdfs commands.
> This makes for a bad user experience and its confusing as to what options are
> really available and how to use them.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
