tjh.dev / kernel
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

Documentation: ext4: blockgroup: Add explicit title heading

Block groups documentation has three, first-level section headings.
These headings' text become toctree entries and the first one "Layout"
becomes docs title in the output, which isn't conveying the docs
contents.

Add explicit title heading and demote the rest.

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-6-bagasdotme@gmail.com

authored by

Bagas Sanjaya and committed by
Jonathan Corbet 36dc5367 5717d2dc

+7 -4
+7 -4
Documentation/filesystems/ext4/blockgroup.rst
··· 1 1 .. SPDX-License-Identifier: GPL-2.0 2 2 3 + Block Groups 4 + ------------ 5 + 3 6 Layout 4 - ------ 7 + ~~~~~~ 5 8 6 9 The layout of a standard block group is approximately as follows (each 7 10 of these fields is discussed in a separate section below): ··· 63 60 block maps, extent tree blocks, and extended attributes. 64 61 65 62 Flexible Block Groups 66 - --------------------- 63 + ~~~~~~~~~~~~~~~~~~~~~ 67 64 68 65 Starting in ext4, there is a new feature called flexible block groups 69 66 (flex_bg). In a flex_bg, several block groups are tied together as one ··· 81 78 flex_bg is given by 2 ^ ``sb.s_log_groups_per_flex``. 82 79 83 80 Meta Block Groups 84 - ----------------- 81 + ~~~~~~~~~~~~~~~~~ 85 82 86 83 Without the option META_BG, for safety concerns, all block group 87 84 descriptors copies are kept in the first block group. Given the default ··· 120 117 block and inode bitmaps. 121 118 122 119 Lazy Block Group Initialization 123 - ------------------------------- 120 + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 124 121 125 122 A new feature for ext4 are three block group descriptor flags that 126 123 enable mkfs to skip initializing other parts of the block group