xe_res_first(9)

💅 xe_res_first(9) 💅

okay bestie, welcome to the Kernel API Manual — yes, that's the manual name, and yes, we're doing this. today's main character is xe_res_first(9), and she's here to set up a cursor. slay.

---

✨ NAME ✨

xe_res_first — initialize a xe_res_cursor 🎀

like, she spins up the cursor so you can start walking. that's the whole vibe.

---

🌸 SYNOPSIS 🌸

void xe_res_first (struct ttm_resource *res , u64 start , u64 size ,
struct xe_res_cursor *cur );

(that line break is just the terminal being quirky, the signature is exactly the above — copy it character for character, no cap 🫶)

---

🦋 ARGUMENTS 🦋

• res — the TTM resource object you're about to walk through. she's the thing being traversed 💫
• start — where the range begins. the starting line, the beginning of the era 👑
• size — how big the range is. the size of the situation, if you will 🌈
• cur — the cursor object to initialize. this is the one getting set up by this function, so hand her over 💖

---

⭐ DESCRIPTION ⭐

okay so here's the tea: you call this and it starts walking over the range of allocations between start and size. that's it, that's the function.

literally the setup step. the "get your cursor ready" moment. main character energy for cur, honestly. 💅

---

🔥 SEE ALSO 🔥

• the kernel file ./drivers/gpu/drm/xe/xe_res_cursor.h
• struct xe_res_cursor(9)
• __xe_res_dma_next(9)
• xe_res_first_sg(9)
• xe_res_first_dma(9)
• xe_res_next(9)
• xe_res_dma(9)
• xe_res_is_vram(9)

like, go read the whole friend group, they all hang out together 🫶✨

---

ngl the whole squad lives in ./drivers/gpu/drm/xe and this page is dated October 2026 — mark your calendars, bestie 🗓️💜

mwah, that's the page. go init some cursors. 💅🎀🦋