HADOOP-7192. Update fs -stat docs to reflect the format features. Contributed by Harsh J Chouraria.

git-svn-id: https://svn.apache.org/repos/asf/hadoop/common/trunk@1102951 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Todd Lipcon 2011-05-14 04:33:08 +00:00
parent 8f57b5102a
commit 1e0cc178c7
2 changed files with 21 additions and 5 deletions

View File

@ -456,6 +456,9 @@ Release 0.22.0 - Unreleased
HADOOP-7189. Add ability to enable 'debug' property in JAAS configuration.
(Ted Yu via todd)
HADOOP-7192. Update fs -stat docs to reflect the format features. (Harsh
J Chouraria via todd)
OPTIMIZATIONS
HADOOP-6884. Add LOG.isDebugEnabled() guard for each LOG.debug(..).

View File

@ -482,16 +482,29 @@
<section>
<title> stat </title>
<p>
<code>Usage: hdfs dfs -stat URI [URI &#x2026;]</code>
<code>Usage: hdfs dfs -stat [format] URI [URI &#x2026;]</code>
</p>
<p>
Returns the stat information on the path.
</p>
<p>Print statistics about the file/directory matching the given URI pattern in the specified format.</p>
<p>Format accepts:</p>
<ul>
<li>filesize in blocks (%b)</li>
<li>filename (%n)</li>
<li>block size (%o)</li>
<li>replication (%r)</li>
<li>modification date, formatted as Y-M-D H:M:S (%y)</li>
<li>modification date, in epoch seconds (%Y)</li>
</ul>
<p>Example:</p>
<ul>
<li>
<code> hdfs dfs -stat path </code>
</li>
<li>
<code> hdfs dfs -stat path </code>
<code> hdfs dfs -stat %y path </code>
</li>
<li>
<code> hdfs dfs -stat '%b %r' path </code>
</li>
</ul>
<p>Exit Code:<br/>
<code> Returns 0 on success and -1 on error.</code></p>