xe_pt_walk_shared(9)

💅 xe_pt_walk_shared(9) 💅

okay bestie, welcome to the Kernel API Manual glow-up for xe_pt_walk_shared(9) — this is the one about walking shared page tables of a page-table tree, and it's lowkey iconic for unbind-type stuff. 🫶

✨ NAME ✨

xe_pt_walk_shared — walk shared page tables of a page-table tree.

🦋 SYNOPSIS 🦋

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

🌸 ARGUMENTS 🌸

• parent — root page table directory. the main-character tree root.
• level — level of the root. yes bestie, the root's level.
• addr — start address. where the vibe begins.
• end — last address + 1. not just the last address — it's last address + 1; that part matters, no cap.
• walk — walk info. the little info bundle that keeps the walk going.

🎀 DESCRIPTION 🎀

okay so this function is similar to xe_pt_walk_range, but it skips page tables that are private to the range. slay.

and because the root (or parent) page table is typically also a shared page table, this function is different in one specific way: it calls the pt_entry callback and the post_descend callback also for the root. yes, the root gets callback attention too.

you can detect the root in the callbacks by checking whether parent == *child. that's the little root-detection vibe check.

walking only the shared page tables is common for unbind-type operations, where the page-table entries for an address range are cleared or detached from the main page-table tree. very "cleaning up the shared bits" energy.

🔥 RETURN 🔥

0 on success, and a negative error code on error: if a callback returns an error, the walk will be terminated and the error returned by this function. periodt.

👑 SEE ALSO 👑

• Kernel file ./drivers/gpu/drm/xe/xe_pt_walk.c GPU page-table tree walking.(9), xe_pt_walk_range(9)

---

xoxo, from ./drivers/gpu/drm/xe, dated October 2026, signed with love by xe_pt_walk_shared(9) 💅✨