aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/filesystems/ext4.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/filesystems/ext4.txt')
-rw-r--r--Documentation/filesystems/ext4.txt51
1 files changed, 30 insertions, 21 deletions
diff --git a/Documentation/filesystems/ext4.txt b/Documentation/filesystems/ext4.txt
index 0d5394920a31..174eaff7ded9 100644
--- a/Documentation/filesystems/ext4.txt
+++ b/Documentation/filesystems/ext4.txt
@@ -2,19 +2,24 @@
2Ext4 Filesystem 2Ext4 Filesystem
3=============== 3===============
4 4
5This is a development version of the ext4 filesystem, an advanced level 5Ext4 is an an advanced level of the ext3 filesystem which incorporates
6of the ext3 filesystem which incorporates scalability and reliability 6scalability and reliability enhancements for supporting large filesystems
7enhancements for supporting large filesystems (64 bit) in keeping with 7(64 bit) in keeping with increasing disk capacities and state-of-the-art
8increasing disk capacities and state-of-the-art feature requirements. 8feature requirements.
9 9
10Mailing list: linux-ext4@vger.kernel.org 10Mailing list: linux-ext4@vger.kernel.org
11Web site: http://ext4.wiki.kernel.org
11 12
12 13
131. Quick usage instructions: 141. Quick usage instructions:
14=========================== 15===========================
15 16
17Note: More extensive information for getting started with ext4 can be
18 found at the ext4 wiki site at the URL:
19 http://ext4.wiki.kernel.org/index.php/Ext4_Howto
20
16 - Compile and install the latest version of e2fsprogs (as of this 21 - Compile and install the latest version of e2fsprogs (as of this
17 writing version 1.41) from: 22 writing version 1.41.3) from:
18 23
19 http://sourceforge.net/project/showfiles.php?group_id=2406 24 http://sourceforge.net/project/showfiles.php?group_id=2406
20 25
@@ -32,28 +37,26 @@ Mailing list: linux-ext4@vger.kernel.org
32 you will need to merge your changes with the version from e2fsprogs 37 you will need to merge your changes with the version from e2fsprogs
33 1.41.x. 38 1.41.x.
34 39
35 - Create a new filesystem using the ext4dev filesystem type: 40 - Create a new filesystem using the ext4 filesystem type:
36 41
37 # mke2fs -t ext4dev /dev/hda1 42 # mke2fs -t ext4 /dev/hda1
38 43
39 Or configure an existing ext3 filesystem to support extents and set 44 Or to configure an existing ext3 filesystem to support extents:
40 the test_fs flag to indicate that it's ok for an in-development
41 filesystem to touch this filesystem:
42 45
43 # tune2fs -O extents -E test_fs /dev/hda1 46 # tune2fs -O extents /dev/hda1
44 47
45 If the filesystem was created with 128 byte inodes, it can be 48 If the filesystem was created with 128 byte inodes, it can be
46 converted to use 256 byte for greater efficiency via: 49 converted to use 256 byte for greater efficiency via:
47 50
48 # tune2fs -I 256 /dev/hda1 51 # tune2fs -I 256 /dev/hda1
49 52
50 (Note: we currently do not have tools to convert an ext4dev 53 (Note: we currently do not have tools to convert an ext4
51 filesystem back to ext3; so please do not do try this on production 54 filesystem back to ext3; so please do not do try this on production
52 filesystems.) 55 filesystems.)
53 56
54 - Mounting: 57 - Mounting:
55 58
56 # mount -t ext4dev /dev/hda1 /wherever 59 # mount -t ext4 /dev/hda1 /wherever
57 60
58 - When comparing performance with other filesystems, remember that 61 - When comparing performance with other filesystems, remember that
59 ext3/4 by default offers higher data integrity guarantees than most. 62 ext3/4 by default offers higher data integrity guarantees than most.
@@ -104,8 +107,8 @@ exist yet so I'm not sure they're in the near-term roadmap.
104The big performance win will come with mballoc, delalloc and flex_bg 107The big performance win will come with mballoc, delalloc and flex_bg
105grouping of bitmaps and inode tables. Some test results available here: 108grouping of bitmaps and inode tables. Some test results available here:
106 109
107 - http://www.bullopensource.org/ext4/20080530/ffsb-write-2.6.26-rc2.html 110 - http://www.bullopensource.org/ext4/20080818-ffsb/ffsb-write-2.6.27-rc1.html
108 - http://www.bullopensource.org/ext4/20080530/ffsb-readwrite-2.6.26-rc2.html 111 - http://www.bullopensource.org/ext4/20080818-ffsb/ffsb-readwrite-2.6.27-rc1.html
109 112
1103. Options 1133. Options
111========== 114==========
@@ -177,6 +180,11 @@ barrier=<0|1(*)> This enables/disables the use of write barriers in
177 your disks are battery-backed in one way or another, 180 your disks are battery-backed in one way or another,
178 disabling barriers may safely improve performance. 181 disabling barriers may safely improve performance.
179 182
183inode_readahead=n This tuning parameter controls the maximum
184 number of inode table blocks that ext4's inode
185 table readahead algorithm will pre-read into
186 the buffer cache. The default value is 32 blocks.
187
180orlov (*) This enables the new Orlov block allocator. It is 188orlov (*) This enables the new Orlov block allocator. It is
181 enabled by default. 189 enabled by default.
182 190
@@ -209,15 +217,17 @@ noreservation
209bsddf (*) Make 'df' act like BSD. 217bsddf (*) Make 'df' act like BSD.
210minixdf Make 'df' act like Minix. 218minixdf Make 'df' act like Minix.
211 219
212check=none Don't do extra checking of bitmaps on mount.
213nocheck
214
215debug Extra debugging information is sent to syslog. 220debug Extra debugging information is sent to syslog.
216 221
217errors=remount-ro(*) Remount the filesystem read-only on an error. 222errors=remount-ro(*) Remount the filesystem read-only on an error.
218errors=continue Keep going on a filesystem error. 223errors=continue Keep going on a filesystem error.
219errors=panic Panic and halt the machine if an error occurs. 224errors=panic Panic and halt the machine if an error occurs.
220 225
226data_err=ignore(*) Just print an error message if an error occurs
227 in a file data buffer in ordered mode.
228data_err=abort Abort the journal if an error occurs in a file
229 data buffer in ordered mode.
230
221grpid Give objects the same group ID as their creator. 231grpid Give objects the same group ID as their creator.
222bsdgroups 232bsdgroups
223 233
@@ -243,8 +253,6 @@ nobh (a) cache disk block mapping information
243 "nobh" option tries to avoid associating buffer 253 "nobh" option tries to avoid associating buffer
244 heads (supported only for "writeback" mode). 254 heads (supported only for "writeback" mode).
245 255
246mballoc (*) Use the multiple block allocator for block allocation
247nomballoc disabled multiple block allocator for block allocation.
248stripe=n Number of filesystem blocks that mballoc will try 256stripe=n Number of filesystem blocks that mballoc will try
249 to use for allocation size and alignment. For RAID5/6 257 to use for allocation size and alignment. For RAID5/6
250 systems this should be the number of data 258 systems this should be the number of data
@@ -252,6 +260,7 @@ stripe=n Number of filesystem blocks that mballoc will try
252delalloc (*) Deferring block allocation until write-out time. 260delalloc (*) Deferring block allocation until write-out time.
253nodelalloc Disable delayed allocation. Blocks are allocation 261nodelalloc Disable delayed allocation. Blocks are allocation
254 when data is copied from user to page cache. 262 when data is copied from user to page cache.
263
255Data Mode 264Data Mode
256========= 265=========
257There are 3 different data modes: 266There are 3 different data modes: