xe_pt_walk_range(9)

💅 xe_pt_walk_range(9) — like, the Kernel API Manual era 💅

okay bestie, gather round, because this one is a lil helper function from the Kernel API Manual and it's honestly serving "I do one thing and I do it well" energy. Let's get into it 🎀

---

✨ NAME ✨

xe_pt_walk_range — walks a range of a gpu page table tree, and hits up a callback for every single page-table entry at all the levels. yes, all of them. no skipped levels, no cutting corners, we're thorough here 💅

---

🌸 SYNOPSIS 🌸

int xe_pt_walk_range (struct xe_ptw *parent , unsigned int level , u64
addr , u64 end , struct xe_pt_walk *walk );

that's the whole vibe. five args, one int coming back at you ✨

---

🦋 ARGUMENTS 🦋

• parent — the root page table where the walk starts. like, the main character of the tree 👑
• level — the level of that root page table. gotta know where you're starting, iykyk.
• addr — the virtual address start. where we begin, bestie 🌱
• end — the virtual address end + 1. yes, plus one — it's that exclusive-end thing, don't come for me, that's just how it is 🙈
• walk — the walk info. all the walk-y details live in here 🫶

---

💖 DESCRIPTION 💖

so like… it's similar to the CPU page-table walker, right? this is a helper that walks a gpu page table and calls a callback function you provide for each entry. that's it, that's the whole job. it's giving "reliable friend who texts back" energy, fr fr ✨

no cap, that's genuinely all it does — you hand it a tree and a range, it strolls through and pings your callback at every entry on the way. iconic behaviour honestly 🌈

---

🔥 RETURN 🔥

• 0 on success — slay, we did it 💅
• a negative error code on error — and bestie, listen, that error is propagated from the callback, so if your callback throws hands, that's what you get back. also, on error the walk is terminated. like, stopped. done. no more entries. periodt 💀

fr fr though: error in the callback = walk over. plan accordingly 🫶

---

👑 SEE ALSO 👑

• Kernel file ./drivers/gpu/drm/xe/xe_pt_walk.c GPU page-table tree walking.(9) — the source file itself, go read it, it's right there 🍓
• xe_pt_walk_shared(9) — its bestie, go say hi 💜

---

and that's the page!! 🌸 this lil drop came to you from ./drivers/gpu/drm/xe (the source/version, mwah 💋) and it's dated October 2026 — mark your calendars bestie, that's the era we're in ⭐🧚‍♀️