dma_resv_iter_first(9)

✨ dma_resv_iter_first 💅

okay so this is a page from the Kernel API Manual, and it's about grabbing the very first fence out of a locked dma_resv object. bestie. it's giving "start of the list" energy and honestly? iconic.

---

✨ NAME ✨

dma_resv_iter_first — literally the first fence from a locked dma_resv object 🎀

---

🌸 SYNOPSIS 🌸

struct dma_fence * dma_resv_iter_first (struct dma_resv_iter *cursor);

---

🦋 ARGUMENTS 🦋

• cursor — the cursor, babes 💫 it's the thing that records where you're currently at, so the iterator knows its position. no cap, that's its whole job.

---

💖 DESCRIPTION 💖

okay so here's the vibe: you call this, you get the first fence. obsessed. 🌈

and then the subsequent fences get iterated with dma_resv_iter_next_unlocked. that's your next step, iykyk. 💅

what it actually does: it returns the first fence in the dma_resv object while holding the dma_resv.lock. 🔒 like, the lock is held, that's the whole point, don't come for me.

🫶 lowkey important: the lock is held when this runs — that's part of the deal here, so don't be weird about it.

---

🌟 SEE ALSO 🌟

• Kernel file ./drivers/dma-buf/dma-resv.c 📁
• Reservation Object Overview(9)
• dma_resv_init(9)
• dma_resv_fini(9)
• dma_resv_reserve_fences(9)
• dma_resv_reset_max_fences(9)
• dma_resv_add_fence(9)
• dma_resv_replace_fences(9)
• dma_resv_iter_first_unlocked(9)
• dma_resv_iter_next_unlocked(9)
• dma_resv_iter_next(9)
• dma_resv_copy_fences(9)
• dma_resv_get_fences(9)
• dma_resv_get_singleton(9)
• dma_resv_wait_timeout(9)
• dma_resv_set_deadline(9)
• dma_resv_test_signaled(9)
• dma_resv_describe(9)

---

mwah 💋 that's the whole page, and it lives in ./drivers/dma-buf, dated October 2026, from the Kernel API Manual — slay, go read the others, bestie 🧚✨