ttm_bo_lru_cursor_first(9)

ttm_bo_lru_cursor_first(9) 🦋

hiii bestie 💖 welcome to the Kernel API Manual page for ttm_bo_lru_cursor_first(9) — yes, manual name folded in right at the top, we're being efficient and cute. This is the function that kicks off the LRU-list crawl so you can find and lock a buffer object. It's giving "first step of a very serious walk," no cap. 💅

---

✨ NAME ✨

ttm_bo_lru_cursor_first — start iterating a manager's LRU lists to find and lock buffer object. 🎀

---

🎀 SYNOPSIS 🎀

struct ttm_buffer_object * ttm_bo_lru_cursor_first (struct
ttm_bo_lru_cursor *curs );

---

🌸 ARGUMENTS 🌸

• curs — the cursor initialized using ttm_bo_lru_cursor_init. That's the one you're handing over, bestie; it's already been set up by that init call. 🫶

---

🔥 RETURN 🔥

You get back a pointer to a locked and reference-counted buffer object 💖 — that's the win. Or you get NULL if none could be found and looping should be terminated. So if it's NULL, bestie, the search said no and the looping should stop. 😭

---

🌈 SEE ALSO 🌈

Kernel file: ./drivers/gpu/drm/ttm/ttm_bo_util.c — that's the neighborhood where the magic lives. ✨ Also peep these:

• ttm_move_memcpy(9)
• ttm_bo_move_memcpy(9)
• ttm_buffer_object_transfer(9)
• ttm_io_prot(9)
• ttm_bo_kmap_try_from_panic(9)
• ttm_bo_kmap(9)
• ttm_bo_kunmap(9)
• ttm_bo_vmap(9)
• ttm_bo_vunmap(9)
• ttm_bo_move_accel_cleanup(9)
• ttm_bo_move_sync_cleanup(9)
• ttm_bo_pipeline_gutting(9)
• ttm_lru_walk_for_evict(9)
• ttm_bo_lru_cursor_fini(9)
• ttm_bo_lru_cursor_init(9)
• ttm_bo_lru_cursor_next(9)
• ttm_bo_shrink(9)
• ttm_bo_shrink_suitable(9)
• ttm_bo_shrink_avoid_wait(9)

---

mwah 💋 this page's source/version deets are ./drivers/gpu/drm/ttm, dated October 2026, and it's for ttm_bo_lru_cursor_first(9). Catch you in the kernel source, bestie — slay responsibly. 🫶✨