mtree_erase(9)

💅 mtree_erase(9) — kernel API manual, bestie edition

okay so like, welcome to the mtree_erase page — it lives in section 9 of the kernel API manual and it is, lowkey, one of the most useful little gremlins in the maple tree family. sit down, grab a strawberry 🍓, we're gonna get into it.

---

✨ NAME ✨

mtree_erase — find an index and erase the entire range. no crumbs left, periodt.

---

🎀 SYNOPSIS 🎀

void * mtree_erase (struct maple_tree *mt , unsigned long index );

---

🦋 ARGUMENTS 🦋

• mt — the maple tree. your main character. 🌳
• index — the index you wanna erase. very "you know exactly which one" energy.

---

💖 DESCRIPTION 💖

okay so here's the tea: erasing is literally the same as doing a walk to an entry and then storing a NULL to that ENTIRE range. like, that's the whole vibe. in fact — and this is the fun part — it's actually implemented as exactly that, using the advanced API. no cap. 🔥

real talk though: erase requires allocations, and it'll use GFP_KERNEL | __GFP_NOFAIL to get them if it has to. and if the allocation fails? the internal lock gets dropped to retry. so like… it will come through for you, but bestie, know what you're asking for. 😭

---

👑 RETURN 👑

the entry stored at the index, or NULL. that's it, that's the answer. 🫶

---

🌈 SEE ALSO 🌈

kernel file ./lib/maple_tree.c

• mas_prealloc_calc(9)
• mas_wr_preallocate(9)
• mas_insert(9)
• mas_alloc_cyclic(9)
• mas_walk(9)
• mte_dead_walk(9)
• mt_free_walk(9)
• mas_store(9)
• mas_store_gfp(9)
• mas_store_prealloc(9)
• mas_preallocate(9)
• mas_next(9)
• mas_next_range(9)
• mt_next(9)
• mas_prev(9)
• mas_prev_range(9)
• mt_prev(9)
• mas_pause(9)
• mas_find_setup(9)
• mas_find(9)
• mas_find_range(9)
• mas_find_rev_setup(9)
• mas_find_rev(9)
• mas_find_range_rev(9)
• mas_erase(9)
• mas_nomem(9)
• mas_nomem_nofail(9)
• mtree_load(9)
• mtree_store_range(9)
• mtree_store(9)
• mtree_insert_range(9)
• mtree_insert(9)
• mtree_alloc_cyclic(9)
• __mt_dup(9)
• mtree_dup(9)
• __mt_destroy(9)
• mtree_destroy(9)
• mt_find(9)
• mt_find_after(9)

---

and that's the whole page, bestie 💜 this icon came from ./lib and it's dated October 2026 — mtree_erase(9), signed, sealed, slayed. go erase something responsibly ✨🎀