btree_merge(9)

✨ btree_merge(9) ✨

okay so bestie, this is btree_merge(9) straight from the Kernel API Manual, and it's literally about merging two btrees. group-chat huddle time 💖

---

🌸 NAME 🌸

btree_merge — merge two btrees, periodt.

---

🦋 SYNOPSIS 🦋

int btree_merge (struct btree_head *target , struct btree_head *victim ,
       struct btree_geo *geo , gfp_t gfp );

---

💅 ARGUMENTS 💅

• target — the tree that gets all the entries. she's eating good tonight 👑
• victim — the tree that gets merged into target. pour one out for her 🫶
• geo — the btree geometry.
• gfp — allocation flags.

---

🌸 DESCRIPTION 🌸

So here's the vibe check: the two trees target and victim may not contain the same keys. no cap, that's a bug — it triggers a BUG. not cute, not slay, just a bug 💀

This function returns zero if the trees were merged successfully. it may return a failure when memory allocation fails, in which case both trees might have been partially merged, i.e. some entries have been moved from victim to target. so yeah, allocation fail is giving "we tried, bestie, but it's complicated" 😭

---

🔥 SEE ALSO 🔥

• Kernel file ./include/linux/btree.h
• B+Tree basics(9)
• struct btree_head(9)
• btree_alloc(9)
• btree_free(9)
• btree_init_mempool(9)
• btree_init(9)
• btree_destroy(9)
• btree_lookup(9)
• btree_insert(9)
• btree_update(9)
• btree_remove(9)
• btree_last(9)
• btree_get_prev(9)

---

— signing off from ./include/linux in October 2026, btree_merge(9) besties forever 💅✨