hadoop-common-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From t...@apache.org
Subject svn commit: r1102950 - in /hadoop/common/branches/branch-0.22: CHANGES.txt src/docs/src/documentation/content/xdocs/file_system_shell.xml
Date Sat, 14 May 2011 04:32:55 GMT
Author: todd
Date: Sat May 14 04:32:55 2011
New Revision: 1102950

URL: http://svn.apache.org/viewvc?rev=1102950&view=rev
Log:
HADOOP-7192. Update fs -stat docs to reflect the format features. Contributed by Harsh J Chouraria.

Modified:
    hadoop/common/branches/branch-0.22/CHANGES.txt
    hadoop/common/branches/branch-0.22/src/docs/src/documentation/content/xdocs/file_system_shell.xml

Modified: hadoop/common/branches/branch-0.22/CHANGES.txt
URL: http://svn.apache.org/viewvc/hadoop/common/branches/branch-0.22/CHANGES.txt?rev=1102950&r1=1102949&r2=1102950&view=diff
==============================================================================
--- hadoop/common/branches/branch-0.22/CHANGES.txt (original)
+++ hadoop/common/branches/branch-0.22/CHANGES.txt Sat May 14 04:32:55 2011
@@ -237,6 +237,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(..).

Modified: hadoop/common/branches/branch-0.22/src/docs/src/documentation/content/xdocs/file_system_shell.xml
URL: http://svn.apache.org/viewvc/hadoop/common/branches/branch-0.22/src/docs/src/documentation/content/xdocs/file_system_shell.xml?rev=1102950&r1=1102949&r2=1102950&view=diff
==============================================================================
--- hadoop/common/branches/branch-0.22/src/docs/src/documentation/content/xdocs/file_system_shell.xml
(original)
+++ hadoop/common/branches/branch-0.22/src/docs/src/documentation/content/xdocs/file_system_shell.xml
Sat May 14 04:32:55 2011
@@ -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>



Mime
View raw message