From: "Theodore Ts'o" <tytso@mit.edu>
To: Ext4 Developers List <linux-ext4@vger.kernel.org>
Cc: "Theodore Ts'o" <tytso@mit.edu>
Subject: [PATCH 03/27] ext4: add KUnit tests for ext4_ext_split() leaf and index splitting
Date: Wed, 11 Nov 2026 23:06:14 -0500 [thread overview]
Message-ID: <20261112040638.1576836-4-tytso@mit.edu> (raw)
In-Reply-To: <20261112040638.1576836-1-tytso@mit.edu>
Commit 7831b3664109 ("ext4: add KUnit tests for fs/ext4/extents.c")
updated both block-allocation paths in ext4_ext_split() to call
ext4_ext_getblk() and noted node splitting in the commit message, but
none of the test cases in fs/ext4/extents-test.c actually reached
ext4_ext_split(). In test_insert_extent_grow_and_merge_up(), inserting a
5th extent into a full depth-0 root triggers ext4_ext_grow_indepth(),
moving the 4 extents into an external leaf block with eh_max == 340 and
returning from ext4_ext_create_new_leaf() without splitting.
Add two KUnit test cases to exercise ext4_ext_split() across leaf and
intermediate index levels:
- test_insert_extent_leaf_split(): fills a depth-1 external leaf block
to capacity (340 extents), inserts in the middle to trigger a leaf
split that moves tail extents into a new leaf block, and then fills
the second leaf and appends past its end to exercise the m == 0
leaf-addition path.
- test_insert_extent_index_split(): exercises depth 1 -> 2 tree growth
followed by leaf splitting via the repeat loop in
ext4_ext_create_new_leaf(), and then clamps the depth-1 index block's
eh_max to exercise simultaneous leaf and intermediate index block
splitting (k == 1) in ext4_ext_split().
Fixes: 7831b3664109 ("ext4: add KUnit tests for fs/ext4/extents.c")
Signed-off-by: Theodore Ts'o <tytso@mit.edu>
---
fs/ext4/extents-test.c | 206 +++++++++++++++++++++++++++++++++++++++--
fs/ext4/move_extent.c | 5 +
2 files changed, 203 insertions(+), 8 deletions(-)
diff --git a/fs/ext4/extents-test.c b/fs/ext4/extents-test.c
index 705648186218..47ddeb94e2bf 100644
--- a/fs/ext4/extents-test.c
+++ b/fs/ext4/extents-test.c
@@ -1584,6 +1584,198 @@ static void test_insert_extent_grow_and_merge_up(struct kunit *test)
KUNIT_EXPECT_EQ(test, ext4_ext_get_actual_len(&ex[0]), 12);
}
+/*
+ * Verify ext4_ext_split() at depth 1 both when splitting a full leaf in the
+ * middle (moving tail extents to a newly allocated leaf block) and when
+ * appending past the end of a full leaf (m == 0).
+ */
+static void test_insert_extent_leaf_split(struct kunit *test)
+{
+ struct inode *inode = &k_ctx.k_ei->vfs_inode;
+ struct ext4_extent_header *eh = ext_inode_hdr(inode);
+ struct ext4_ext_path *path;
+ int i;
+
+ ext_reset_tree(inode);
+
+ /*
+ * Insert 340 non-contiguous extents [i * 4, i * 4 + 2) @ 2000 + i * 4
+ * to grow from depth 0 to depth 1 and completely fill the external
+ * 4096-byte leaf block (eh_max = 340).
+ */
+ for (i = 0; i < 340; i++) {
+ KUNIT_ASSERT_EQ_MSG(test,
+ ext_insert_one(inode, i * 4, 2,
+ 2000 + i * 4, false, 0),
+ 0, "i=%d", i);
+ }
+ KUNIT_EXPECT_EQ(test, ext_depth(inode), 1);
+ KUNIT_EXPECT_EQ(test, le16_to_cpu(eh->eh_entries), 1);
+
+ /*
+ * Insert [402, 403) @ 9000 in the middle of the full leaf between
+ * [400, 402) and [404, 406): triggers ext4_ext_split() with m = 239,
+ * moving [404..1358) into a newly allocated second leaf block.
+ */
+ k_ctx.alloc_calls = 0;
+ KUNIT_ASSERT_EQ(test, ext_insert_one(inode, 402, 1, 9000, false, 0), 0);
+ KUNIT_EXPECT_EQ(test, k_ctx.alloc_calls, 1U);
+ KUNIT_EXPECT_EQ(test, ext_depth(inode), 1);
+ KUNIT_EXPECT_EQ(test, le16_to_cpu(eh->eh_entries), 2);
+ KUNIT_EXPECT_EQ(test, le32_to_cpu(EXT_FIRST_INDEX(eh)[0].ei_block), 0U);
+ KUNIT_EXPECT_EQ(test, le32_to_cpu(EXT_FIRST_INDEX(eh)[1].ei_block),
+ 404U);
+ KUNIT_EXPECT_EQ(test, ext4_ext_check_inode(inode), 0);
+
+ path = ext4_find_extent(inode, 402, NULL, EXT4_EX_NOCACHE);
+ KUNIT_ASSERT_FALSE(test, IS_ERR_OR_NULL(path));
+ KUNIT_EXPECT_EQ(test, le16_to_cpu(path[1].p_hdr->eh_entries), 102);
+ KUNIT_EXPECT_EQ(test, le32_to_cpu(path[1].p_ext->ee_block), 402U);
+ KUNIT_EXPECT_EQ(test, ext4_ext_pblock(path[1].p_ext), 9000ULL);
+ ext4_free_ext_path(path);
+
+ path = ext4_find_extent(inode, 404, NULL, EXT4_EX_NOCACHE);
+ KUNIT_ASSERT_FALSE(test, IS_ERR_OR_NULL(path));
+ KUNIT_EXPECT_EQ(test, le16_to_cpu(path[1].p_hdr->eh_entries), 239);
+ KUNIT_EXPECT_EQ(test, le32_to_cpu(path[1].p_ext->ee_block), 404U);
+ KUNIT_EXPECT_EQ(test, ext4_ext_pblock(path[1].p_ext), 2404ULL);
+ ext4_free_ext_path(path);
+
+ /*
+ * Fill the second leaf to capacity (239 + 101 = 340 entries), then
+ * append [1764, 1766) @ 3764 past its end to exercise ext4_ext_split()
+ * with m == 0 (adding a new leaf without moving existing entries).
+ */
+ for (i = 340; i < 441; i++) {
+ KUNIT_ASSERT_EQ_MSG(test,
+ ext_insert_one(inode, i * 4, 2,
+ 2000 + i * 4, false, 0),
+ 0, "i=%d", i);
+ }
+ k_ctx.alloc_calls = 0;
+ KUNIT_ASSERT_EQ(test, ext_insert_one(inode, 1764, 2, 3764, false, 0),
+ 0);
+ KUNIT_EXPECT_EQ(test, k_ctx.alloc_calls, 1U);
+ KUNIT_EXPECT_EQ(test, ext_depth(inode), 1);
+ KUNIT_EXPECT_EQ(test, le16_to_cpu(eh->eh_entries), 3);
+ KUNIT_EXPECT_EQ(test, le32_to_cpu(EXT_FIRST_INDEX(eh)[2].ei_block),
+ 1764U);
+
+ path = ext4_find_extent(inode, 1764, NULL, EXT4_EX_NOCACHE);
+ KUNIT_ASSERT_FALSE(test, IS_ERR_OR_NULL(path));
+ KUNIT_EXPECT_EQ(test, le16_to_cpu(path[1].p_hdr->eh_entries), 1);
+ KUNIT_EXPECT_EQ(test, le32_to_cpu(path[1].p_ext->ee_block), 1764U);
+ KUNIT_EXPECT_EQ(test, ext4_ext_pblock(path[1].p_ext), 3764ULL);
+ ext4_free_ext_path(path);
+}
+
+/*
+ * Verify multi-level tree growth from depth 1 -> 2 followed by leaf split
+ * (ext4_ext_create_new_leaf repeat loop), and intermediate index block
+ * splitting in ext4_ext_split() when both leaf and depth-1 index are full.
+ */
+static void test_insert_extent_index_split(struct kunit *test)
+{
+ struct inode *inode = &k_ctx.k_ei->vfs_inode;
+ struct ext4_extent_header *eh = ext_inode_hdr(inode);
+ struct ext4_extent_idx *idx;
+ struct ext4_ext_path *path;
+ struct buffer_head *bh;
+ int i;
+
+ ext_reset_tree(inode);
+
+ /*
+ * Build a full depth-1 root index (eh_entries = eh_max = 4) pointing
+ * to 4 full leaf blocks (eh_entries = eh_max = 2).
+ */
+ eh->eh_depth = cpu_to_le16(1);
+ eh->eh_entries = cpu_to_le16(4);
+ eh->eh_max = cpu_to_le16(ext4_ext_space_root_idx_test(inode, 0));
+ idx = EXT_FIRST_INDEX(eh);
+
+ for (i = 0; i < 4; i++) {
+ struct ext4_extent_header *leaf_eh;
+ struct ext4_extent *ex;
+ ext4_lblk_t lblk = 10 + i * 10;
+
+ idx[i].ei_block = cpu_to_le32(lblk);
+ ext4_idx_store_pblock(&idx[i], EXT_META_BASE_PBLK + i);
+
+ bh = ext4_ext_getblk_stub(inode, EXT_META_BASE_PBLK + i,
+ GFP_KERNEL);
+ KUNIT_ASSERT_NOT_NULL(test, bh);
+ leaf_eh = ext_block_hdr(bh);
+ leaf_eh->eh_magic = EXT4_EXT_MAGIC;
+ leaf_eh->eh_depth = 0;
+ leaf_eh->eh_entries = cpu_to_le16(2);
+ leaf_eh->eh_max = cpu_to_le16(2);
+ ex = EXT_FIRST_EXTENT(leaf_eh);
+ ex[0].ee_block = cpu_to_le32(lblk);
+ ex[0].ee_len = cpu_to_le16(2);
+ ext4_ext_store_pblock(&ex[0], 2000 + i * 10);
+ ex[1].ee_block = cpu_to_le32(lblk + 4);
+ ex[1].ee_len = cpu_to_le16(2);
+ ext4_ext_store_pblock(&ex[1], 2004 + i * 10);
+ brelse(bh);
+ }
+
+ /*
+ * Inserting [48, 50) @ 2038 finds both leaf 3 and the root index full:
+ * ext4_ext_grow_indepth() grows depth 1 -> 2, and the repeat loop in
+ * ext4_ext_create_new_leaf() calls ext4_ext_split() at depth 1.
+ */
+ k_ctx.alloc_calls = 0;
+ KUNIT_ASSERT_EQ(test, ext_insert_one(inode, 48, 2, 2038, false, 0), 0);
+ KUNIT_EXPECT_EQ(test, k_ctx.alloc_calls, 2U);
+ KUNIT_EXPECT_EQ(test, ext_depth(inode), 2);
+ KUNIT_EXPECT_EQ(test, le16_to_cpu(eh->eh_entries), 1);
+
+ /*
+ * Clamp the depth-1 index block's eh_max to its current 5 entries so
+ * inserting [12, 13) @ 9000 into full leaf 0 splits both leaf 0 and
+ * the intermediate depth-1 index block (depth = 2, at = 0, k = 1).
+ */
+ bh = ext4_ext_getblk_stub(inode, ext4_idx_pblock(EXT_FIRST_INDEX(eh)),
+ GFP_KERNEL);
+ KUNIT_ASSERT_NOT_NULL(test, bh);
+ KUNIT_ASSERT_EQ(test, le16_to_cpu(ext_block_hdr(bh)->eh_entries), 5);
+ ext_block_hdr(bh)->eh_max = cpu_to_le16(5);
+ brelse(bh);
+
+ k_ctx.alloc_calls = 0;
+ KUNIT_ASSERT_EQ(test, ext_insert_one(inode, 12, 1, 9000, false, 0), 0);
+ KUNIT_EXPECT_EQ(test, k_ctx.alloc_calls, 2U);
+ KUNIT_EXPECT_EQ(test, ext_depth(inode), 2);
+ KUNIT_EXPECT_EQ(test, le16_to_cpu(eh->eh_entries), 2);
+ KUNIT_EXPECT_EQ(test, le32_to_cpu(EXT_FIRST_INDEX(eh)[0].ei_block),
+ 10U);
+ KUNIT_EXPECT_EQ(test, le32_to_cpu(EXT_FIRST_INDEX(eh)[1].ei_block),
+ 14U);
+ KUNIT_EXPECT_EQ(test, ext4_ext_check_inode(inode), 0);
+
+ path = ext4_find_extent(inode, 12, NULL, EXT4_EX_NOCACHE);
+ KUNIT_ASSERT_FALSE(test, IS_ERR_OR_NULL(path));
+ KUNIT_EXPECT_EQ(test, path->p_depth, 2);
+ KUNIT_EXPECT_EQ(test, le32_to_cpu(path[2].p_ext->ee_block), 12U);
+ KUNIT_EXPECT_EQ(test, ext4_ext_pblock(path[2].p_ext), 9000ULL);
+ ext4_free_ext_path(path);
+
+ path = ext4_find_extent(inode, 14, NULL, EXT4_EX_NOCACHE);
+ KUNIT_ASSERT_FALSE(test, IS_ERR_OR_NULL(path));
+ KUNIT_EXPECT_EQ(test, path->p_depth, 2);
+ KUNIT_EXPECT_EQ(test, le32_to_cpu(path[2].p_ext->ee_block), 14U);
+ KUNIT_EXPECT_EQ(test, ext4_ext_pblock(path[2].p_ext), 2004ULL);
+ ext4_free_ext_path(path);
+
+ path = ext4_find_extent(inode, 48, NULL, EXT4_EX_NOCACHE);
+ KUNIT_ASSERT_FALSE(test, IS_ERR_OR_NULL(path));
+ KUNIT_EXPECT_EQ(test, path->p_depth, 2);
+ KUNIT_EXPECT_EQ(test, le32_to_cpu(path[2].p_ext->ee_block), 48U);
+ KUNIT_EXPECT_EQ(test, ext4_ext_pblock(path[2].p_ext), 2038ULL);
+ ext4_free_ext_path(path);
+}
+
/*
* Verify ext4_ext_remove_space() for middle-of-extent hole punching, full
* extent removal with left-scooting, and ext4_ext_truncate() tail removal.
@@ -2073,17 +2265,13 @@ static void test_swap_extents(struct kunit *test)
KUNIT_ASSERT_EQ(test, ext_insert_one(inode1, 10, 10, 100, false, 0), 0);
KUNIT_ASSERT_EQ(test, ext_insert_one(inode2, 10, 10, 200, false, 0), 0);
- inode_lock(inode1);
- inode_lock(inode2);
- down_write(&EXT4_I(inode1)->i_data_sem);
- down_write(&EXT4_I(inode2)->i_data_sem);
+ lock_two_nondirectories(inode1, inode2);
+ ext4_double_down_write_data_sem(inode1, inode2);
replaced = ext4_swap_extents(NULL, inode1, inode2, 12, 12, 5, 1, &err);
- up_write(&EXT4_I(inode2)->i_data_sem);
- up_write(&EXT4_I(inode1)->i_data_sem);
- inode_unlock(inode2);
- inode_unlock(inode1);
+ ext4_double_up_write_data_sem(inode1, inode2);
+ unlock_two_nondirectories(inode1, inode2);
KUNIT_EXPECT_EQ(test, err, 0);
KUNIT_EXPECT_EQ(test, replaced, 5);
@@ -2787,6 +2975,8 @@ static struct kunit_case extents_test_cases[] = {
KUNIT_CASE(test_can_extents_be_merged),
KUNIT_CASE(test_insert_extent_merge_and_nomerge),
KUNIT_CASE(test_insert_extent_grow_and_merge_up),
+ KUNIT_CASE(test_insert_extent_leaf_split),
+ KUNIT_CASE(test_insert_extent_index_split),
KUNIT_CASE(test_remove_space_tail_and_hole_punch),
KUNIT_CASE(test_remove_space_multilevel_collapse),
KUNIT_CASE(test_remove_space_bigalloc_partial_cluster),
diff --git a/fs/ext4/move_extent.c b/fs/ext4/move_extent.c
index 3329b7ad5dbd..d1405e763912 100644
--- a/fs/ext4/move_extent.c
+++ b/fs/ext4/move_extent.c
@@ -656,3 +656,8 @@ int ext4_move_extents(struct file *o_filp, struct file *d_filp, __u64 orig_blk,
unlock_two_nondirectories(orig_inode, donor_inode);
return ret;
}
+
+#if IS_ENABLED(CONFIG_EXT4_KUNIT_TESTS)
+EXPORT_SYMBOL_FOR_EXT4_TEST(ext4_double_down_write_data_sem);
+EXPORT_SYMBOL_FOR_EXT4_TEST(ext4_double_up_write_data_sem);
+#endif
--
2.56.0.542.g3ef89b7020-goog
next prev parent reply other threads:[~2026-11-12 4:07 UTC|newest]
Thread overview: 55+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-11-12 4:06 [PATCH 00/27] ext4: add lots of KUnit tests! Theodore Ts'o
2026-11-12 4:06 ` [PATCH 01/27] ext4: add KUinit tests for fs/ext4/extents_status.c Theodore Ts'o
2026-11-12 4:18 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 02/27] ext4: add KUnit tests for fs/ext4/extents.c Theodore Ts'o
2026-11-12 4:28 ` sashiko-bot
2026-11-12 4:06 ` Theodore Ts'o [this message]
2026-11-12 4:15 ` [PATCH 03/27] ext4: add KUnit tests for ext4_ext_split() leaf and index splitting sashiko-bot
2026-11-12 4:06 ` [PATCH 04/27] ext4: add KUnit tests for fs/ext4/xattr.c Theodore Ts'o
2026-11-12 4:26 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 05/27] ext4: add KUnit tests for fs/ext4/namei.c Theodore Ts'o
2026-11-12 4:21 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 06/27] ext4: expand KUnit tests for fs/ext4/mballoc.c Theodore Ts'o
2026-11-12 4:26 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 07/27] ext4: add KUnit tests for fs/ext4/inline.c Theodore Ts'o
2026-11-12 4:29 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 08/27] ext4: zero s_fc_replay_state in ext4_fc_replay_cleanup() Theodore Ts'o
2026-11-12 4:16 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 09/27] ext4: add KUnit tests for fs/ext4/fast_commit.c Theodore Ts'o
2026-11-12 4:28 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 10/27] ext4: expand KUnit tests for fs/ext4/inode.c Theodore Ts'o
2026-11-12 4:36 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 11/27] ext4: add KUnit tests for fs/ext4/ialloc.c Theodore Ts'o
2026-11-12 4:25 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 12/27] ext4: add KUnit tests for fs/ext4/balloc.c Theodore Ts'o
2026-11-12 4:16 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 13/27] ext4: add KUnit tests for fs/ext4/orphan.c Theodore Ts'o
2026-11-12 4:18 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 14/27] ext4: add KUnit tests for fs/ext4/block_validity.c Theodore Ts'o
2026-11-12 4:21 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 15/27] ext4: check multi-block overlap on left traversal in add_system_zone() Theodore Ts'o
2026-11-12 4:10 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 16/27] ext4: enable full feature coverage in fs/ext4/.kunitconfig Theodore Ts'o
2026-11-12 4:24 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 17/27] ext4: add KUnit tests for fs/ext4/super.c Theodore Ts'o
2026-11-12 4:27 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 18/27] ext4: add KUnit tests for fs/ext4/sysfs.c Theodore Ts'o
2026-11-12 4:32 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 19/27] ext4: add KUnit tests for fs/ext4/ioctl.c Theodore Ts'o
2026-11-12 4:35 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 20/27] ext4: add KUnit tests for fs/ext4/resize.c Theodore Ts'o
2026-11-12 4:34 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 21/27] ext4: add KUnit tests for fs/ext4/migrate.c Theodore Ts'o
2026-11-12 4:37 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 22/27] ext4: add KUnit tests for fs/ext4/indirect.c Theodore Ts'o
2026-11-12 4:46 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 23/27] ext4: expand KUnit tests in fs/ext4/extents-test.c for file range operations Theodore Ts'o
2026-11-12 4:34 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 24/27] ext4: add KUnit tests for fs/ext4/fsmap.c Theodore Ts'o
2026-11-12 4:30 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 25/27] ext4: add KUnit tests for fs/ext4/move_extent.c Theodore Ts'o
2026-11-12 4:36 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 26/27] ext4: add KUnit tests for fs/ext4/mmp.c Theodore Ts'o
2026-11-12 4:29 ` sashiko-bot
2026-11-12 4:06 ` [PATCH 27/27] ext4: add KUnit tests for fs/ext4/dir.c Theodore Ts'o
2026-11-12 4:41 ` sashiko-bot
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20261112040638.1576836-4-tytso@mit.edu \
--to=tytso@mit.edu \
--cc=linux-ext4@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox