Return-Path: <hdfs-issues-return-166106-archive-asf-public=cust-asf.ponee.io@hadoop.apache.org>
X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io
Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io
Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183])
	by cust-asf2.ponee.io (Postfix) with ESMTP id 3D5D1200B5E
	for <archive-asf-public-internal@cust-asf2.ponee.io>; Wed, 10 Aug 2016 22:02:25 +0200 (CEST)
Received: by cust-asf.ponee.io (Postfix)
	id 3C2EA160AB8; Wed, 10 Aug 2016 20:02:25 +0000 (UTC)
Delivered-To: archive-asf-public@cust-asf.ponee.io
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by cust-asf.ponee.io (Postfix) with SMTP id B2D19160AA4
	for <archive-asf-public@cust-asf.ponee.io>; Wed, 10 Aug 2016 22:02:24 +0200 (CEST)
Received: (qmail 13213 invoked by uid 500); 10 Aug 2016 20:02:23 -0000
Mailing-List: contact hdfs-issues-help@hadoop.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:hdfs-issues-help@hadoop.apache.org>
List-Unsubscribe: <mailto:hdfs-issues-unsubscribe@hadoop.apache.org>
List-Post: <mailto:hdfs-issues@hadoop.apache.org>
List-Id: <hdfs-issues.hadoop.apache.org>
Delivered-To: mailing list hdfs-issues@hadoop.apache.org
Received: (qmail 12982 invoked by uid 99); 10 Aug 2016 20:02:23 -0000
Received: from arcas.apache.org (HELO arcas) (140.211.11.28)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 10 Aug 2016 20:02:23 +0000
Received: from arcas.apache.org (localhost [127.0.0.1])
	by arcas (Postfix) with ESMTP id 34E802C02AE
	for <hdfs-issues@hadoop.apache.org>; Wed, 10 Aug 2016 20:02:22 +0000 (UTC)
Date: Wed, 10 Aug 2016 20:02:22 +0000 (UTC)
From: "Mingliang Liu (JIRA)" <jira@apache.org>
To: hdfs-issues@hadoop.apache.org
Message-ID: <JIRA.12996393.1470859287000.275850.1470859342213@Atlassian.JIRA>
In-Reply-To: <JIRA.12996393.1470859287000@Atlassian.JIRA>
References: <JIRA.12996393.1470859287000@Atlassian.JIRA> <JIRA.12996393.1470859287200@arcas>
Subject: [jira] [Created] (HDFS-10747) o.a.h.hdfs.tools.DebugAdmin usage
 message is misleading
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394
archived-at: Wed, 10 Aug 2016 20:02:25 -0000

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-issues-unsubscribe@hadoop.apache.org
For additional commands, e-mail: hdfs-issues-help@hadoop.apache.org