xe_page_rec...reate_prl_bo(9)

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

okay so this is a page out of the Kernel API Manual and it's genuinely iconic — it's all about backing a PRL with a suballocated GGTT BO. yes I said GGTT BO. stay with me, we're gonna slay this 💖

---

🌸 NAME 🌸

xe_page_reclaim_create_prl_bo — the one that backs a PRL with a suballocated GGTT BO. that's the whole vibe, no cap 🎀

---

✨ SYNOPSIS ✨

struct drm_suballoc * xe_page_reclaim_create_prl_bo (struct xe_tlb_inval
*tlb_inval , struct xe_page_reclaim_list *prl , struct
xe_tlb_inval_fence *fence );

yeah she's a little wide, that's just how the signature eats 💅 copy it exactly, don't come for me about the line breaks.

---

🫶 ARGUMENTS 🫶

• tlb_inval — the TLB invalidation frontend that's associated with the request. like, this is the frontend the request is vibing with.
• prl — the page reclaim list data that the bo will copy from. it's giving source material 👑
• fence — the tlb invalidation fence that the page reclaim action is paired to. they're linked, they're a duo, they're main character energy together 🦋

---

🔥 DESCRIPTION 🔥

okay so here's the tea ☕ — what it does is:

• Suballocates a 4K BO out of the tile reclaim pool — yes, exactly 4K, not a byte more, she's precise.
• copies the PRL CPU copy into the BO — the CPU copy literally moves in, keys and all 🏠
• and queues the buffer for release when fence signals — so the buffer waits, patiently, and the second that fence signals it's out. bye bestie 👋

periodt. that's the whole operation.

---

⭐ RETURN ⭐

• On success → you get a struct drm_suballoc pointer. slay, we love a win 💖
• On failure → you get ERR_PTR. sad girl hours, check it with your error-checking macros 😭

---

👀 SEE ALSO 👀

go read the actual kernel file, iykyk:

• Kernel file ./drivers/gpu/drm/xe/xe_page_reclaim.c

and the whole friend group:

• xe_page_reclaim_skip(9)
• xe_page_reclaim_list_invalidate(9)
• xe_page_reclaim_list_init(9)
• xe_page_reclaim_list_alloc_entries(9)
• xe_guc_page_reclaim_done_handler(9)

---

and that's the page!! shoutout to the source, ./drivers/gpu/drm/xe, and the date stamp, October 2026 — write it in your journal, bestie 🎀✨💜