DECLARE_NEXT_HOLE_ADDR(9)

💅 DECLARE_NEXT_HOLE_ADDR(9) 💅

ok so bestie, welcome to the Kernel API Manual — this one's a macro page, subsection 9, and no cap it's giving "tiny macro, very demure, extremely important" energy. let's get into it 🎀

---

✨ NAME ✨

DECLARE_NEXT_HOLE_ADDR — it's literally a macro that declares next hole functions. that's the whole vibe. 🕳️✨

---

🌸 SYNOPSIS 🌸

DECLARE_NEXT_HOLE_ADDR (name , first , last );

look at her. three args, no notes. 🫶

---

🦋 ARGUMENTS 🦋

• name — the name of the function you're declaring. yes babe you get to pick it, main character energy fr.
• first — the first rb member to traverse. and it has to be either rb_left or rb_right — pick one, king 👑
• last — the last rb member to traverse. also either rb_right or rb_left. yes it's the mirror of first, we love symmetry 💫

---

💜 DESCRIPTION 💜

okay so here's the tea ☕ — this macro declares a function that returns the next hole of the addr rb tree. like, the function that goes hunting for the next gap. 🕳️🔍

and while we're traversing the tree, we take the searched size into account. the way that this is so smart?? 😭 we only visit branches that have potential big enough holes. no wasting time on tiny gaps, we're not doing that today. efficiency slay. 💅🔥

---

🌈 SEE ALSO 🌈

the whole squad, assembled ⭐:

• Kernel file ./drivers/gpu/drm/drm_mm.c Overview(9)
• drm_mm_reserve_node(9)
• drm_mm_insert_node_in_range(9)
• drm_mm_remove_node(9)
• lru scan roster(9)
• drm_mm_scan_init_with_range(9)
• drm_mm_scan_add_block(9)
• drm_mm_scan_remove_block(9)
• drm_mm_scan_color_evict(9)
• drm_mm_init(9)
• drm_mm_takedown(9)
• drm_mm_print(9)

go read them, iykyk 🧚💖

---

ngl bestie, this page lives in ./drivers/gpu/drm and it's stamped October 2026 — so if you're reading DECLARE_NEXT_HOLE_ADDR(9) and it's not October 2026 anymore, that's just the version tag doing its thing. mwah, bye 💋🎀✨