mas_alloc_cyclic(9)

🍁 mas_alloc_cyclic(9) 🍁

okay so bestie, real talk: this is the Kernel API Manual page for mas_alloc_cyclic, and it's literally the internal call that goes "hiiii where do I put this entry 💅". It's the Maple Tree's little matchmaker for finding somewhere to store an entry. Periodt.

---

✨ NAME ✨

mas_alloc_cyclic — Internal call to find somewhere to store an entry

like, it's not the public-facing bestie, it's the internal one. iykyk.

---

🎀 SYNOPSIS 🎀

int mas_alloc_cyclic (struct ma_state *mas , unsigned long *startp ,
void *entry , unsigned long range_lo , unsigned long range_hi , unsigned
long *next , gfp_t gfp );

no cap, that's the whole signature. don't touch a single character of it 🙈

---

🦋 ARGUMENTS 🦋

okay the vibe check on every single parameter, one by one, because we do not skip:

• mas — The maple state. this is the main character of the whole operation, fr.
• startp — Pointer to ID. it points at where the ID lives 💖
• entry — The entry to store. the actual thing we're putting in, iconic.
• range_lo — Lower bound of range to search. the floor of the search zone.
• range_hi — Upper bound of range to search. the ceiling of the search zone.
• next — Pointer to next ID to allocate. yes hello, next in line please 🌸
• gfp — The GFP_FLAGS to use for allocations. the allocation energy, if you will ✨

---

🔥 RETURN 🔥

it returns an int, and here's how to read the results, bestie:

• 0 — the allocation succeeded without wrapping. clean run, no drama. slay 🫶
• 1 — the allocation succeeded after wrapping. it looped around and still came through. resilient queen 👑
• -EBUSY — there are no free entries. fully booked, nothing available, it's giving sold out 😭

no third option, no vibes-based guessing — those are the only three outcomes, so check your return value properly 💀

---

🌈 SEE ALSO 🌈

Kernel file ./lib/maple_tree.c, and literally the entire extended friend group of functions:

• mas_prealloc_calc(9)
• mas_wr_preallocate(9)
• mas_insert(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)
• mtree_erase(9)
• __mt_dup(9)
• mtree_dup(9)
• __mt_destroy(9)
• mtree_destroy(9)
• mt_find(9)
• mt_find_after(9)

that's the whole group chat, everyone invited 💜

---

ngl, this one's internal — so if you're reading it, you're either deep in ./lib/maple_tree.c or you're just curious. either way, proud of you 🧚

---

okay that's the page!! 💖 this lil number lives in ./lib, drops in October 2026, and goes by mas_alloc_cyclic(9) — catch you in the source, bestie, mwah 🎀⭐