STRUCT XE_PTW(9)

🎀 struct xe_ptw(9) 🎀

okay so bestie, welcome to the Kernel API Manual — we're looking at struct xe_ptw, and it is literally the base class for driver pagetable subclassing. no cap. 💅

✨ SYNOPSIS ✨

       struct xe_ptw {
           struct xe_ptw **children;
           struct xe_ptw **staging;
        };

🫶 Members 🫶

• children — pointer to an array of children, if any. yes, "if any" is doing important work here. 🧚
• staging — pointer to an array of staging, if any. same energy. 🌸

💖 Description 💖

Drivers could subclass this, and if it's a page-directory, they typically embed an array of xe_ptw pointers. that's the whole cute little base-class situation: it's giving "make me your foundation" energy, and the page-directory case usually brings its own array of xe_ptw pointers along for the ride. 🦋

🦋 SEE ALSO 🦋

• Kernel file ./drivers/gpu/drm/xe/xe_pt_walk.h — bestie, start here. ✨
• struct xe_pt_walk(9)
• xe_pt_entry_fn(9)
• struct xe_pt_walk_ops(9)
• xe_pt_covers(9)
• xe_pt_num_entries(9)
• xe_pt_offset(9)

mwah 💋 — this page lives under ./drivers/gpu/drm/xe, dated October 2026, and it's struct xe_ptw(9). periodt. 👑