xe_guc_page_...done_handler(9)

💅 xe_guc_page_...done_handler(9)

okay so real talk, bestie — this page lives in the Kernel API Manual, and it's about one lil function that handles the "page reclaim is done" moment. it's niche, it's crunchy, it's kernel-coded, and honestly? iconic. let's get into it 🫶

---

✨ NAME ✨

xe_guc_page_reclaim_done_handler — the page reclaim done handler. that's the whole vibe. it handles the done-ness. 💅

---

🦋 SYNOPSIS 🦋

int xe_guc_page_reclaim_done_handler (struct xe_guc *guc , u32 *msg ,
u32 len );

look at her. returns an int, takes a struct xe_guc * called guc, a u32 * called msg, and a u32 called len. no cap, that's the whole signature. ✨

---

🎀 ARGUMENTS 🎀

• guc — a guc. that's literally it, that's the description. the struct shows up and does struct things. main character energy tbh 🌸
• msg — the message that indicates page reclamation is done. it's the "we're so back" message 📩
• len — the length of the message. gotta know how much message you're working with, fr fr 📏

---

🔥 DESCRIPTION 🔥

so here's the lore 🍓: page reclamation is an extension of TLB invalidation. both of these operations share the same seqno and the same fence — they're basically twinning, it's giving sibling energy 👯

when either action completes, we need to signal the corresponding fence. that's the whole job. signal the fence. no fence left behind 🫡

and because the handling logic is currently identical for both, this function just delegates to the TLB invalidation handler. why write new code when the existing code already ate? 💀✨

not me pointing out the word currently — yes bestie, the manpage says the logic is currently identical, so if that changes someday, this delegation might need a glow-up. just saying 👀

---

🌈 RETURN 🌈

• 0 — success, we love a zero, slay 🎉
• -EPROTO — for malformed messages. the message showed up wrong and we're big mad about it 😭

---

⭐ SEE ALSO ⭐

• kernel file ./drivers/gpu/drm/xe/xe_page_reclaim.c — go read the source, iykyk 📂
• xe_page_reclaim_skip(9)
• xe_page_reclaim_create_prl_bo(9)
• xe_page_reclaim_list_invalidate(9)
• xe_page_reclaim_list_init(9)
• xe_page_reclaim_list_alloc_entries(9)

---

and that's the page, bestie 🧚💖 this one's from the ./drivers/gpu/drm/xe source, dated October 2026, and it's filed under xe_guc_page_...done_handler(9) — go forth and signal those fences 👑🌸