Repository: hadoop Updated Branches: refs/heads/trunk a3f93beaa -> b8f93cd27
HDFS-10488. Update WebHDFS documentation regarding CREATE and MKDIR default permissions. Contributed by Wellington Chevreuil. Project: http://git-wip-us.apache.org/repos/asf/hadoop/repo Commit: http://git-wip-us.apache.org/repos/asf/hadoop/commit/b8f93cd2 Tree: http://git-wip-us.apache.org/repos/asf/hadoop/tree/b8f93cd2 Diff: http://git-wip-us.apache.org/repos/asf/hadoop/diff/b8f93cd2 Branch: refs/heads/trunk Commit: b8f93cd2750cde31d3e80c1aecd426e0cea89ef2 Parents: a3f93be Author: Andrew Wang <w...@apache.org> Authored: Thu Jul 7 10:36:12 2016 -0700 Committer: Andrew Wang <w...@apache.org> Committed: Thu Jul 7 10:36:55 2016 -0700 ---------------------------------------------------------------------- hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/WebHDFS.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/hadoop/blob/b8f93cd2/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/WebHDFS.md ---------------------------------------------------------------------- diff --git a/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/WebHDFS.md b/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/WebHDFS.md index b4842d479..9ede4da 100644 --- a/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/WebHDFS.md +++ b/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/WebHDFS.md @@ -350,6 +350,8 @@ File and Directory Operations Location: webhdfs://<HOST>:<PORT>/<PATH> Content-Length: 0 + If no permissions are specified, the newly created file will be assigned with default 644 permission. No umask mode will be applied from server side (so "fs.permissions.umask-mode" value configuration set on Namenode side will have no effect). + **Note** that the reason of having two-step create/append is for preventing clients to send out data before the redirect. This issue is addressed by the "`Expect: 100-continue`" header in HTTP/1.1; see [RFC 2616, Section 8.2.3](http://www.w3.org/Protocols/rfc2616/rfc2616-sec8.html#sec8.2.3). Unfortunately, there are software library bugs (e.g. Jetty 6 HTTP server and Java 6 HTTP client), which do not correctly implement "`Expect: 100-continue`". The two-step create/append is a temporary workaround for the software library bugs. See also: [`overwrite`](#Overwrite), [`blocksize`](#Block_Size), [`replication`](#Replication), [`permission`](#Permission), [`buffersize`](#Buffer_Size), [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).create @@ -442,6 +444,8 @@ See also: [`offset`](#Offset), [`length`](#Length), [`buffersize`](#Buffer_Size) {"boolean": true} + If no permissions are specified, the newly created directory will have 755 permission as default. No umask mode will be applied from server side (so "fs.permissions.umask-mode" value configuration set on Namenode side will have no effect). + See also: [`permission`](#Permission), [FileSystem](../../api/org/apache/hadoop/fs/FileSystem.html).mkdirs ### Create a Symbolic Link @@ -1957,7 +1961,7 @@ See also: [`SETOWNER`](#Set_Owner) |:---- |:---- | | Description | The permission of a file/directory. | | Type | Octal | -| Default Value | 755 | +| Default Value | 644 for files, 755 for directories | | Valid Values | 0 - 1777 | | Syntax | Any radix-8 integer (leading zeros may be omitted.) | --------------------------------------------------------------------- To unsubscribe, e-mail: common-commits-unsubscr...@hadoop.apache.org For additional commands, e-mail: common-commits-h...@hadoop.apache.org
