HADOOP-8808. Update FsShell documentation to mention deprecation of some of the commands, and mention alternatives (Akira AJISAKA via aw)

This commit is contained in:
Allen Wittenauer 2014-09-26 11:10:51 -07:00
parent ac70c27473
commit df5fed5c0e
2 changed files with 32 additions and 22 deletions

View File

@ -548,6 +548,9 @@ Release 2.6.0 - UNRELEASED
HADOOP-11101. How about inputstream close statement from catch block to HADOOP-11101. How about inputstream close statement from catch block to
finally block in FileContext#copy() ( skrho via vinayakumarb ) finally block in FileContext#copy() ( skrho via vinayakumarb )
HADOOP-8808. Update FsShell documentation to mention deprecation of some of
the commands, and mention alternatives (Akira AJISAKA via aw)
OPTIMIZATIONS OPTIMIZATIONS
HADOOP-10838. Byte array native checksumming. (James Thomas via todd) HADOOP-10838. Byte array native checksumming. (James Thomas via todd)

View File

@ -221,7 +221,9 @@ dus
Usage: <<<hdfs dfs -dus <args> >>> Usage: <<<hdfs dfs -dus <args> >>>
Displays a summary of file lengths. This is an alternate form of hdfs dfs -du -s. Displays a summary of file lengths.
<<Note:>> This command is deprecated. Instead use <<<hdfs dfs -du -s>>>.
expunge expunge
@ -311,7 +313,12 @@ getmerge
ls ls
Usage: <<<hdfs dfs -ls <args> >>> Usage: <<<hdfs dfs -ls [-R] <args> >>>
Options:
* The -R option will return stat recursively through the directory
structure.
For a file returns stat on the file with the following format: For a file returns stat on the file with the following format:
@ -337,7 +344,9 @@ lsr
Usage: <<<hdfs dfs -lsr <args> >>> Usage: <<<hdfs dfs -lsr <args> >>>
Recursive version of ls. Similar to Unix ls -R. Recursive version of ls.
<<Note:>> This command is deprecated. Instead use <<<hdfs dfs -ls -R>>>
mkdir mkdir
@ -413,13 +422,22 @@ put
rm rm
Usage: <<<hdfs dfs -rm [-skipTrash] URI [URI ...]>>> Usage: <<<hdfs dfs -rm [-f] [-r|-R] [-skipTrash] URI [URI ...]>>>
Delete files specified as args. Only deletes non empty directory and files. Delete files specified as args.
If the -skipTrash option is specified, the trash, if enabled, will be
bypassed and the specified file(s) deleted immediately. This can be useful Options:
when it is necessary to delete files from an over-quota directory. Refer to
rmr for recursive deletes. * The -f option will not display a diagnostic message or modify the exit
status to reflect an error if the file does not exist.
* The -R option deletes the directory and any content under it recursively.
* The -r option is equivalent to -R.
* The -skipTrash option will bypass trash, if enabled, and delete the
specified file(s) immediately. This can be useful when it is necessary
to delete files from an over-quota directory.
Example: Example:
@ -433,20 +451,9 @@ rmr
Usage: <<<hdfs dfs -rmr [-skipTrash] URI [URI ...]>>> Usage: <<<hdfs dfs -rmr [-skipTrash] URI [URI ...]>>>
Recursive version of delete. If the -skipTrash option is specified, the Recursive version of delete.
trash, if enabled, will be bypassed and the specified file(s) deleted
immediately. This can be useful when it is necessary to delete files from an
over-quota directory.
Example: <<Note:>> This command is deprecated. Instead use <<<hdfs dfs -rm -r>>>
* <<<hdfs dfs -rmr /user/hadoop/dir>>>
* <<<hdfs dfs -rmr hdfs://nn.example.com/user/hadoop/dir>>>
Exit Code:
Returns 0 on success and -1 on error.
setfacl setfacl