From 00eee37a93980b0a6f157723124138e677c3db90 Mon Sep 17 00:00:00 2001 From: Masatake Iwasaki Date: Sat, 26 Jan 2019 05:25:42 +0900 Subject: [PATCH] HDFS-12729. Document special paths in HDFS. Contributed by Masatake Iwasaki. (cherry picked from commit dc5af4c6b7bdf437713a8c6ca3c535c4b6d6992e) --- .../hadoop-hdfs/src/site/markdown/HdfsDesign.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/HdfsDesign.md b/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/HdfsDesign.md index 471a27f0fbb..ed225a9322f 100644 --- a/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/HdfsDesign.md +++ b/hadoop-hdfs-project/hadoop-hdfs/src/site/markdown/HdfsDesign.md @@ -71,6 +71,11 @@ HDFS supports [user quotas](HdfsQuotaAdminGuide.html) and [access permissions](H HDFS does not support hard links or soft links. However, the HDFS architecture does not preclude implementing these features. +While HDFS follows [naming convention of the FileSystem](../hadoop-common/filesystem/model.html#Paths_and_Path_Elements), +some paths and names (e.g. `/.reserved` and `.snapshot` ) are reserved. +Features such as [transparent encryption](TransparentEncryption.html) and +[snapshot](HdfsSnapshots.html) use reserved paths. + The NameNode maintains the file system namespace. Any change to the file system namespace or its properties is recorded by the NameNode. An application can specify the number of replicas of a file that should be maintained by HDFS. The number of copies of a file is called the replication factor of that file. This information is stored by the NameNode. Data Replication