Merge pull request #487 from intjonathan/patch-1

English clarity in filesystem documentation.
This commit is contained in:
Xiang Li 2014-01-23 04:03:05 -08:00
commit 9848072d21

View File

@ -5,13 +5,13 @@
![alt text](./img/etcd_fs_structure.jpg "etcd file system structure") ![alt text](./img/etcd_fs_structure.jpg "etcd file system structure")
## Node ## Node
In **Etcd**, the **Node** is the rudimentary element constructing the whole. In **etcd**, the **node** is the base from which the filesystem is constructed.
Currently **Etcd** file system is comprised in a Unix-like way of files and directories, and they are two kinds of nodes different in: **etcd**'s file system is Unix-like with two kinds of nodes: file and directories.
- **File Node** has data associated with it. - A **file node** has data associated with it.
- **Directory Node** has children nodes associated with it. - A **directory node** has child nodes associated with it.
Besides the file and directory difference, all nodes have common attributes and operations as follows: All nodes, regardless of type, have the following attributes and operations:
### Attributes: ### Attributes:
- **Expiration Time** [optional] - **Expiration Time** [optional]
@ -20,7 +20,7 @@ Besides the file and directory difference, all nodes have common attributes and
- **ACL** - **ACL**
The path of access control list of the node. The path to the node's access control list.
### Operation: ### Operation:
- **Get** (path, recursive, sorted) - **Get** (path, recursive, sorted)
@ -69,7 +69,7 @@ Besides the file and directory difference, all nodes have common attributes and
### Theory ### Theory
Etcd exports a Unix-like file system interface consisting of files and directories, collectively called nodes. Etcd exports a Unix-like file system interface consisting of files and directories, collectively called nodes.
Each node has various meta-data, including three names of access control lists used to control reading, writing and changing (change ACL names for the node). Each node has various meta-data, including three names of the access control lists used to control reading, writing and changing (change ACL names for the node).
We are storing the ACL names for nodes under a special *ACL* directory. We are storing the ACL names for nodes under a special *ACL* directory.
Each node has ACL name corresponding to one file within *ACL* dir. Each node has ACL name corresponding to one file within *ACL* dir.