From a86893f8759d331a94600c60b6c80f359ec25cd0 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 a0121e9bb1f..876f4652369 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