[jira] [Commented] (HADOOP-9514) Hadoop CLI's have inconsistent usages

["Thomas Graves (JIRA)" <ji...@apache.org>]

    [ 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