Author: cnauroth
Date: Tue Feb 11 22:18:08 2014
New Revision: 1567421
URL: http://svn.apache.org/r1567421
Log:
HDFS-5625. Write end user documentation for HDFS ACLs. Contributed by Chris
Nauroth.
Modified:
hadoop/common/branches/HDFS-4685/hadoop-common-project/hadoop-common/src/site/apt/FileSystemShell.apt.vm
Modified:
hadoop/common/branches/HDFS-4685/hadoop-common-project/hadoop-common/src/site/apt/FileSystemShell.apt.vm
URL:
http://svn.apache.org/viewvc/hadoop/common/branches/HDFS-4685/hadoop-common-project/hadoop-common/src/site/apt/FileSystemShell.apt.vm?rev=1567421&r1=1567420&r2=1567421&view=diff
==============================================================================
---
hadoop/common/branches/HDFS-4685/hadoop-common-project/hadoop-common/src/site/apt/FileSystemShell.apt.vm
(original)
+++
hadoop/common/branches/HDFS-4685/hadoop-common-project/hadoop-common/src/site/apt/FileSystemShell.apt.vm
Tue Feb 11 22:18:08 2014
@@ -231,6 +231,29 @@ get
Returns 0 on success and -1 on error.
+getfacl
+
+ Usage: <<<hdfs dfs -getfacl [-R] <path> >>>
+
+ Displays the Access Control Lists (ACLs) of files and directories. If a
+ directory has a default ACL, then getfacl also displays the default ACL.
+
+ Options:
+
+ * -R: List the ACLs of all files and directories recursively.
+
+ * <path>: File or directory to list.
+
+ Examples:
+
+ * <<<hdfs dfs -getfacl /file>>>
+
+ * <<<hdfs dfs -getfacl -R /dir>>>
+
+ Exit Code:
+
+ Returns 0 on success and non-zero on error.
+
getmerge
Usage: <<<hdfs dfs -getmerge <src> <localdst> [addnl]>>>
@@ -379,6 +402,52 @@ rmr
Returns 0 on success and -1 on error.
+setfacl
+
+ Usage: <<<hdfs dfs -setfacl [-R] [{-b|-k} {-m|-x <acl_spec>} <path>]|[--set
<acl_spec> <path>] >>>
+
+ Sets Access Control Lists (ACLs) of files and directories.
+
+ Options:
+
+ * -b: Remove all but the base ACL entries. The entries for user, group and
+ others are retained for compatibility with permission bits.
+
+ * -k: Remove the default ACL.
+
+ * -R: Apply operations to all files and directories recursively.
+
+ * -m: Modify ACL. New entries are added to the ACL, and existing entries
+ are retained.
+
+ * -x: Remove specified ACL entries. Other ACL entries are retained.
+
+ * --set: Fully replace the ACL, discarding all existing entries. The
+ <acl_spec> must include entries for user, group, and others for
+ compatibility with permission bits.
+
+ * <acl_spec>: Comma separated list of ACL entries.
+
+ * <path>: File or directory to modify.
+
+ Examples:
+
+ * <<<hdfs dfs -setfacl -m user:hadoop:rw- /file>>>
+
+ * <<<hdfs dfs -setfacl -x user:hadoop /file>>>
+
+ * <<<hdfs dfs -setfacl -b /file>>>
+
+ * <<<hdfs dfs -setfacl -k /dir>>>
+
+ * <<<hdfs dfs -setfacl --set
user::rw-,user:hadoop:rw-,group::r--,other::r-- /file>>>
+
+ * <<<hdfs dfs -setfacl -R -m user:hadoop:r-x /dir>>>
+
+ Exit Code:
+
+ Returns 0 on success and non-zero on error.
+
setrep
Usage: <<<hdfs dfs -setrep [-R] [-w] <numReplicas> <path> >>>
