diff options
| -rw-r--r-- | Documentation/filesystems/00-INDEX | 2 | ||||
| -rw-r--r-- | Documentation/filesystems/exofs.txt | 23 |
2 files changed, 14 insertions, 11 deletions
diff --git a/Documentation/filesystems/00-INDEX b/Documentation/filesystems/00-INDEX index f15621ee5599..7001782ab932 100644 --- a/Documentation/filesystems/00-INDEX +++ b/Documentation/filesystems/00-INDEX | |||
| @@ -36,6 +36,8 @@ dnotify.txt | |||
| 36 | - info about directory notification in Linux. | 36 | - info about directory notification in Linux. |
| 37 | ecryptfs.txt | 37 | ecryptfs.txt |
| 38 | - docs on eCryptfs: stacked cryptographic filesystem for Linux. | 38 | - docs on eCryptfs: stacked cryptographic filesystem for Linux. |
| 39 | exofs.txt | ||
| 40 | - info, usage, mount options, design about EXOFS. | ||
| 39 | ext2.txt | 41 | ext2.txt |
| 40 | - info, mount options and specifications for the Ext2 filesystem. | 42 | - info, mount options and specifications for the Ext2 filesystem. |
| 41 | ext3.txt | 43 | ext3.txt |
diff --git a/Documentation/filesystems/exofs.txt b/Documentation/filesystems/exofs.txt index 0ced74c2f73c..abd2a9b5b787 100644 --- a/Documentation/filesystems/exofs.txt +++ b/Documentation/filesystems/exofs.txt | |||
| @@ -60,13 +60,13 @@ USAGE | |||
| 60 | 60 | ||
| 61 | mkfs.exofs --pid=65536 --format /dev/osd0 | 61 | mkfs.exofs --pid=65536 --format /dev/osd0 |
| 62 | 62 | ||
| 63 | The --format is optional if not specified no OSD_FORMAT will be | 63 | The --format is optional. If not specified, no OSD_FORMAT will be |
| 64 | preformed and a clean file system will be created in the specified pid, | 64 | performed and a clean file system will be created in the specified pid, |
| 65 | in the available space of the target. (Use --format=size_in_meg to limit | 65 | in the available space of the target. (Use --format=size_in_meg to limit |
| 66 | the total LUN space available) | 66 | the total LUN space available) |
| 67 | 67 | ||
| 68 | If pid already exist it will be deleted and a new one will be created in it's | 68 | If pid already exists, it will be deleted and a new one will be created in |
| 69 | place. Be careful. | 69 | its place. Be careful. |
| 70 | 70 | ||
| 71 | An exofs lives inside a single OSD partition. You can create multiple exofs | 71 | An exofs lives inside a single OSD partition. You can create multiple exofs |
| 72 | filesystems on the same device using multiple pids. | 72 | filesystems on the same device using multiple pids. |
| @@ -81,7 +81,7 @@ USAGE | |||
| 81 | 81 | ||
| 82 | 7. For reference (See do-exofs example script): | 82 | 7. For reference (See do-exofs example script): |
| 83 | do-exofs start - an example of how to perform the above steps. | 83 | do-exofs start - an example of how to perform the above steps. |
| 84 | do-exofs stop - an example of how to unmount the file system. | 84 | do-exofs stop - an example of how to unmount the file system. |
| 85 | do-exofs format - an example of how to format and mkfs a new exofs. | 85 | do-exofs format - an example of how to format and mkfs a new exofs. |
| 86 | 86 | ||
| 87 | 8. Extra compilation flags (uncomment in fs/exofs/Kbuild): | 87 | 8. Extra compilation flags (uncomment in fs/exofs/Kbuild): |
| @@ -104,8 +104,8 @@ Where: | |||
| 104 | exofs specific options: Options are separated by commas (,) | 104 | exofs specific options: Options are separated by commas (,) |
| 105 | pid=<integer> - The partition number to mount/create as | 105 | pid=<integer> - The partition number to mount/create as |
| 106 | container of the filesystem. | 106 | container of the filesystem. |
| 107 | This option is mandatory | 107 | This option is mandatory. |
| 108 | to=<integer> - Timeout in ticks for a single command | 108 | to=<integer> - Timeout in ticks for a single command. |
| 109 | default is (60 * HZ) [for debugging only] | 109 | default is (60 * HZ) [for debugging only] |
| 110 | 110 | ||
| 111 | =============================================================================== | 111 | =============================================================================== |
| @@ -116,7 +116,7 @@ DESIGN | |||
| 116 | with a special ID (defined in common.h). | 116 | with a special ID (defined in common.h). |
| 117 | Information included in the file system control block is used to fill the | 117 | Information included in the file system control block is used to fill the |
| 118 | in-memory superblock structure at mount time. This object is created before | 118 | in-memory superblock structure at mount time. This object is created before |
| 119 | the file system is used by mkexofs.c It contains information such as: | 119 | the file system is used by mkexofs.c. It contains information such as: |
| 120 | - The file system's magic number | 120 | - The file system's magic number |
| 121 | - The next inode number to be allocated | 121 | - The next inode number to be allocated |
| 122 | 122 | ||
| @@ -134,8 +134,8 @@ DESIGN | |||
| 134 | attributes. This applies to both regular files and other types (directories, | 134 | attributes. This applies to both regular files and other types (directories, |
| 135 | device files, symlinks, etc.). | 135 | device files, symlinks, etc.). |
| 136 | 136 | ||
| 137 | * Credentials are generated per object (inode and superblock) when they is | 137 | * Credentials are generated per object (inode and superblock) when they are |
| 138 | created in memory (read off disk or created). The credential works for all | 138 | created in memory (read from disk or created). The credential works for all |
| 139 | operations and is used as long as the object remains in memory. | 139 | operations and is used as long as the object remains in memory. |
| 140 | 140 | ||
| 141 | * Async OSD operations are used whenever possible, but the target may execute | 141 | * Async OSD operations are used whenever possible, but the target may execute |
| @@ -145,7 +145,8 @@ DESIGN | |||
| 145 | from executing in reverse order: | 145 | from executing in reverse order: |
| 146 | - The following are handled with the OBJ_CREATED and OBJ_2BCREATED | 146 | - The following are handled with the OBJ_CREATED and OBJ_2BCREATED |
| 147 | flags. OBJ_CREATED is set when we know the object exists on the OSD - | 147 | flags. OBJ_CREATED is set when we know the object exists on the OSD - |
| 148 | in create's callback function, and when we successfully do a read_inode. | 148 | in create's callback function, and when we successfully do a |
| 149 | read_inode. | ||
| 149 | OBJ_2BCREATED is set in the beginning of the create function, so we | 150 | OBJ_2BCREATED is set in the beginning of the create function, so we |
| 150 | know that we should wait. | 151 | know that we should wait. |
| 151 | - create/delete: delete should wait until the object is created | 152 | - create/delete: delete should wait until the object is created |
