xe_pt_destroy(9)

💅 xe_pt_destroy(9) — like, the Kernel API Manual, bestie 💅

okay so this is xe_pt_destroy(9), and before you ask — yes, it's a page-table tree teardown situation and yes, it's lowkey iconic. stay with me 🫶

---

✨ NAME ✨

xe_pt_destroy — bestie, it literally destroys a page-table tree. that's the whole vibe. no cap. 💀

---

🌸 SYNOPSIS 🌸

void xe_pt_destroy (struct xe_pt *pt , u32 flags , struct llist_head
*deferred );

like, three arguments, one void, zero drama (okay maybe a little drama, it IS destroying a whole tree) 🎀

---

🦋 ARGUMENTS 🦋

• pt — the root of the page-table tree we're about to destroy. the main character of this whole operation, honestly 👑
• flags — vm flags. and currently… unused. like, sitting there, looking pretty, doing absolutely nothing. we love a decorative parameter ✨
• deferred — a list head of a lockless list for deferred putting. if you pass NULL, it's immediate putting instead. so basically: NULL = no waiting around, we're doing this NOW 💅

---

🔥 DESCRIPTION 🔥

so here's the tea, bestie 🍓 — it puts the page-table bo, then it recursively calls xe_pt_destroy on all the children (yes, all of them, it's giving very thorough), and finally it frees pt. periodt. 💜

and then there's this note in the source: TODO: Can we remove the flags argument? — ngl, fair question, considering that argument is doing nothing at all 🙈

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/gpu/drm/xe/xe_pt.c — plus the whole friend group, fr fr:

• xe_pt_create(9)
• xe_pt_populate_empty(9)
• xe_pt_shift(9)
• xe_pt_clear(9)
• Pagetable building(9)
• struct xe_pt_stage_bind_walk(9)
• xe_pt_stage_bind(9)
• xe_pt_nonshared_offsets(9)
• xe_pt_zap_ptes(9)
• xe_pt_zap_ptes_range(9)
• xe_pt_stage_unbind(9)
• xe_pt_update_ops_prepare(9)
• xe_pt_update_ops_run(9)
• xe_pt_update_ops_fini(9)
• xe_pt_update_ops_abort(9)

---

and that's a wrap, bestie!! 🧚✨ this little beauty lives in ./drivers/gpu/drm/xe and it's dated October 2026 — yes, future-coded, we stay ahead of the timeline 💖🦋 mwah, go destroy some trees (page-table ones only, obviously) 🎀