mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-08-30 21:52:21 +00:00
6e1429fb10
ext4 docs are organized in three master docs (overview.rst, globals.rst,
and dynamic.rst), in which these include other docs via include::
directive. These docs sturcture is better served by toctrees instead.
Convert the master docs to use toctrees.
Fixes: 0bf1f51e34 ("ext4: Add atomic block write documentation")
Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
Acked-by: Theodore Ts'o <tytso@mit.edu>
Acked-by: Darrick J. Wong <djwong@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20250620105643.25141-3-bagasdotme@gmail.com
31 lines
930 B
ReStructuredText
31 lines
930 B
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
High Level Design
|
|
=================
|
|
|
|
An ext4 file system is split into a series of block groups. To reduce
|
|
performance difficulties due to fragmentation, the block allocator tries
|
|
very hard to keep each file's blocks within the same group, thereby
|
|
reducing seek times. The size of a block group is specified in
|
|
``sb.s_blocks_per_group`` blocks, though it can also calculated as 8 *
|
|
``block_size_in_bytes``. With the default block size of 4KiB, each group
|
|
will contain 32,768 blocks, for a length of 128MiB. The number of block
|
|
groups is the size of the device divided by the size of a block group.
|
|
|
|
All fields in ext4 are written to disk in little-endian order. HOWEVER,
|
|
all fields in jbd2 (the journal) are written to disk in big-endian
|
|
order.
|
|
|
|
.. toctree::
|
|
|
|
blocks
|
|
blockgroup
|
|
special_inodes
|
|
allocators
|
|
checksums
|
|
bigalloc
|
|
inlinedata
|
|
eainode
|
|
verity
|
|
atomic_writes
|