diff options
author | Theodore Ts'o <tytso@mit.edu> | 2018-07-29 16:35:23 -0400 |
---|---|---|
committer | Theodore Ts'o <tytso@mit.edu> | 2018-07-29 16:35:23 -0400 |
commit | 0694f8c39f113bcdb759a7f84981a69bf5d7161d (patch) | |
tree | afd7ba3b26be10f4bbd9c2cc350858b99a4d0c51 | |
parent | f5cb282d8b08c05ad70ebde9a8fd2decf32a6406 (diff) |
docs: fix up the obviously obsolete bits in the new ext4 documentation
Signed-off-by: Theodore Ts'o <tytso@mit.edu>
-rw-r--r-- | Documentation/filesystems/ext4/ext4.rst | 47 | ||||
-rw-r--r-- | Documentation/index.rst | 2 |
2 files changed, 9 insertions, 40 deletions
diff --git a/Documentation/filesystems/ext4/ext4.rst b/Documentation/filesystems/ext4/ext4.rst index 47f614c47f56..9d4368d591fa 100644 --- a/Documentation/filesystems/ext4/ext4.rst +++ b/Documentation/filesystems/ext4/ext4.rst @@ -20,43 +20,32 @@ Note: More extensive information for getting started with ext4 can be found at the ext4 wiki site at the URL: http://ext4.wiki.kernel.org/index.php/Ext4_Howto - - Compile and install the latest version of e2fsprogs (as of this - writing version 1.41.3) from: + - The latest version of e2fsprogs can be found at: - http://sourceforge.net/project/showfiles.php?group_id=2406 + https://www.kernel.org/pub/linux/kernel/people/tytso/e2fsprogs/ or - https://www.kernel.org/pub/linux/kernel/people/tytso/e2fsprogs/ + http://sourceforge.net/project/showfiles.php?group_id=2406 or grab the latest git repository from: - git://git.kernel.org/pub/scm/fs/ext2/e2fsprogs.git - - - Note that it is highly important to install the mke2fs.conf file - that comes with the e2fsprogs 1.41.x sources in /etc/mke2fs.conf. If - you have edited the /etc/mke2fs.conf file installed on your system, - you will need to merge your changes with the version from e2fsprogs - 1.41.x. + https://git.kernel.org/pub/scm/fs/ext2/e2fsprogs.git - - Create a new filesystem using the ext4 filesystem type::: + - Create a new filesystem using the ext4 filesystem type: # mke2fs -t ext4 /dev/hda1 - Or to configure an existing ext3 filesystem to support extents::: + Or to configure an existing ext3 filesystem to support extents: # tune2fs -O extents /dev/hda1 If the filesystem was created with 128 byte inodes, it can be - converted to use 256 byte for greater efficiency via::: + converted to use 256 byte for greater efficiency via: # tune2fs -I 256 /dev/hda1 - (Note: we currently do not have tools to convert an ext4 - filesystem back to ext3; so please do not do try this on production - filesystems.) - - - Mounting::: + - Mounting: # mount -t ext4 /dev/hda1 /wherever @@ -106,26 +95,6 @@ Currently Available [1] Filesystems with a block size of 1k may see a limit imposed by the directory hash tree having a maximum depth of two. -Candidate Features for Future Inclusion ---------------------------------------- - -* online defrag (patches available but not well tested) -* reduced mke2fs time via lazy itable initialization in conjunction with - the uninit_bg feature (capability to do this is available in e2fsprogs - but a kernel thread to do lazy zeroing of unused inode table blocks - after filesystem is first mounted is required for safety) - -There are several others under discussion, whether they all make it in is -partly a function of how much time everyone has to work on them. Features like -metadata checksumming have been discussed and planned for a bit but no patches -exist yet so I'm not sure they're in the near-term roadmap. - -The big performance win will come with mballoc, delalloc and flex_bg -grouping of bitmaps and inode tables. Some test results available here: - - - http://www.bullopensource.org/ext4/20080818-ffsb/ffsb-write-2.6.27-rc1.html - - http://www.bullopensource.org/ext4/20080818-ffsb/ffsb-readwrite-2.6.27-rc1.html - Options ======= diff --git a/Documentation/index.rst b/Documentation/index.rst index 65c22b1ff5f2..f95ba981f8cd 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -109,7 +109,7 @@ The documentation in this section are provided by specific filesystem subprojects. .. toctree:: - :maxdepth: 4 + :maxdepth: 2 filesystems/ext4/index |