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:11:30 -07:00
parent f694b44036
commit 424b1f6955
2 changed files with 32 additions and 22 deletions

View File

@ -209,6 +209,9 @@ Release 2.6.0 - UNRELEASED
HADOOP-11101. How about inputstream close statement from catch block to
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
HADOOP-10838. Byte array native checksumming. (James Thomas via todd)

View File

@ -221,7 +221,9 @@ dus
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
@ -311,7 +313,12 @@ getmerge
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:
@ -337,7 +344,9 @@ lsr
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
@ -413,13 +422,22 @@ put
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.
If the -skipTrash option is specified, the 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. Refer to
rmr for recursive deletes.
Delete files specified as args.
Options:
* 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:
@ -433,20 +451,9 @@ rmr
Usage: <<<hdfs dfs -rmr [-skipTrash] URI [URI ...]>>>
Recursive version of delete. If the -skipTrash option is specified, the
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.
Recursive version of delete.
Example:
* <<<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.
<<Note:>> This command is deprecated. Instead use <<<hdfs dfs -rm -r>>>
setfacl