[jira] [Created] (HDFS-10747) o.a.h.hdfs.tools.DebugAdmin usage message is misleading

["Mingliang Liu (JIRA)" <ji...@apache.org>]

Mingliang Liu created HDFS-10747:
------------------------------------

             Summary: o.a.h.hdfs.tools.DebugAdmin usage message is misleading
                 Key: HDFS-10747
                 URL: https://issues.apache.org/jira/browse/HDFS-10747
             Project: Hadoop HDFS
          Issue Type: Bug
          Components: hdfs-client
            Reporter: Mingliang Liu
            Assignee: Mingliang Liu
            Priority: Minor


[HDFS-6917] added a helpful hdfs debug command to validate blocks and call recoverlease. The usage doc is kinda misleading, as following:

{code}
$ hdfs debug verify
creating a new configuration
verify [-meta <metadata-file>] [-block <block-file>]
  Verify HDFS metadata and block files.  If a block file is specified, we
  will verify that the checksums in the metadata file match the block
  file.
{code}
Actually the {{-meta <metadata-file>}} is necessary. {{[]}} is for optional arguments, if we follow the [convention|http://pubs.opengroup.org/onlinepubs/9699919799].

{code}
$ hdfs debug recoverLease
creating a new configuration
recoverLease [-path <path>] [-retries <num-retries>]
  Recover the lease on the specified path.  The path must reside on an
  HDFS filesystem.  The default number of retries is 1.
{code}
{{-path <path>}} is also the same case.





--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: hdfs-dev-unsubscribe@hadoop.apache.org
For additional commands, e-mail: hdfs-dev-help@hadoop.apache.org