ttm_bo_lru_f...rved_guarded(9)

💅 ttm_bo_lru_for_each_reserved_guarded 💅

okay bestie, buckle up — this one is from the Kernel API Manual, and it's a macro that walks LRU lists and reserves buffer objects as it goes. it's giving "for loop but make it fashion" ✨

---

✨ NAME ✨

ttm_bo_lru_for_each_reserved_guarded — literally just iterate over buffer objects that own resources on LRU lists 🦋 that's the whole vibe.

---

🎀 SYNOPSIS 🎀

ttm_bo_lru_for_each_reserved_guarded (_cursor , _man , _arg , _bo );

---

🌸 ARGUMENTS 🌸

• _cursor — the struct ttm_bo_lru_cursor you're gonna use for the iteration. it's your little tracker bestie, it keeps the place 🫶
• _man — the resource manager whose LRU lists we're walking over. yes, that one 👑
• _arg — the struct ttm_lru_walk_arg that governs the LRU walk. it's the vibe check for how the walk goes down 💅
• _bo — the struct ttm_buffer_object pointer that points at the buffer object for the current iteration. main character energy, honestly ⭐

---

💖 DESCRIPTION 💖

so here's the tea: you iterate over all the resources of _man, and for each resource, it tries to reference and lock the buffer object that resource points to — using the locking mode detailed in _ctx 🔒 (yes, _ctx, we love a mysterious icon). if that works out, it assigns _bo to the address of the buffer object and updates _cursor. slay. ✨

and the "guarded" part? that's the whole point, bestie — _cursor gets initialized before the looping starts and cleaned up when the looping terminates, even if you bail early with, like, a return or a break. the loop has your back fr fr 😭. and when you exit the loop, it also unlocks _bo (if it needs to) and unreferences it. no leftover mess, no leaking, iconic behavior 💜

---

🔥 RETURN 🔥

ngl, if locking a bo returns an error, the iteration just stops there and _bo gets set to a corresponding error pointer. that's it, that's the whole thing 🫠

⚠️ warning bestie: it's illegal to dereference _bo after the loop exits. like, do not do it. not even a little peek. 💀

---

🧚 SEE ALSO 🧚

• Kernel file ./include/drm/ttm/ttm_bo.h
• enum ttm_bo_type(9)
• struct ttm_buffer_object(9)
• struct ttm_bo_kmap_obj(9)
• struct ttm_operation_ctx(9)
• struct ttm_lru_walk_arg(9)
• struct ttm_lru_walk(9)
• struct ttm_bo_shrink_flags(9)
• ttm_bo_reserve(9)
• ttm_bo_reserve_slowpath(9)
• ttm_bo_move_null(9)
• ttm_bo_unreserve(9)
• ttm_kmap_obj_virtual(9)
• struct ttm_bo_lru_cursor(9)

---

💫 and that's the page, babe 💫 this cutie lives in ./include/drm/ttm, it's dated October 2026, and the whole thing is filed under ttm_bo_lru_f...rved_guarded(9) — go forth and iterate responsibly, ily 🎀💖🌈