ENUM XE_MADV_PURGEABLE_STATE(9)

💅 enum xe_madv_purgeable_state(9)

okay so bestie, this is a page from the Kernel API Manual and it's literally all about enum xe_madv_purgeable_state — the buffer object purgeable state enumeration 🎀. yes, that's a mouthful, but stick with me, it's actually iconic.

---

🌸 NAME 🌸

enum xe_madv_purgeable_state — the Buffer object purgeable state enumeration ✨ (that's it, that's the name, she's pretty self-explanatory iykyk)

---

🦋 SYNOPSIS 🦋

enum xe_madv_purgeable_state {
    XE_MADV_PURGEABLE_WILLNEED ,
    XE_MADV_PURGEABLE_DONTNEED ,
    XE_MADV_PURGEABLE_PURGED

};

like, that's the whole vibe right there 👑

---

✨ Constants ✨

so these are your three states, bestie — know them, love them:

• XE_MADV_PURGEABLE_WILLNEED — the buffer object is needed and should not be purged 💖. and fun fact: this is the default state, so if you don't do anything, this is where you're at. lowkey the main character default.
• XE_MADV_PURGEABLE_DONTNEED — the buffer object is not currently needed and the kernel is allowed to purge it under memory pressure 😭. it's giving "you can let this one go if things get tight".
• XE_MADV_PURGEABLE_PURGED — the buffer object has been purged by the kernel 💀. yeah. it happened. she's gone.

---

🫶 Description 🫶

okay so what is this enum even for? it defines the possible purgeable states for a buffer object, which lets userspace hand memory usage hints to the kernel so memory management under pressure is better 🌈. it's literally teamwork between you and the kernel, no cap.

⚠️ real talk though: accessing a purged buffer will result in an error. and per i915 semantics, once purged, a BO remains permanently invalid and must be destroyed and recreated 😳. not "maybe", not "sometimes" — permanently. so don't try to be cute and reuse it, bestie, it's over.

---

👑 SEE ALSO 👑

go read these next, they're all in the Kernel file ./drivers/gpu/drm/xe/xe_bo.h:

• xe_bo_is_purged(9)
• xe_bo_madv_is_dontneed(9)
• xe_bo_willneed_get_locked(9)
• xe_bo_willneed_put_locked(9)
• xe_bo_vma_count_inc_locked(9)
• xe_bo_vma_count_dec_locked(9)
• xe_bo_size(9)
• xe_bo_has_valid_ccs_bb(9)
• xe_bo_put_deferred(9)
• xe_bo_put_async(9)
• xe_bo_sg_is_contiguous(9)
• struct xe_bo_shrink_flags(9)
• xe_bo_is_mem_type(9)

like, that's a whole reading list, but you got this 🧚💜

---

mwah 💋 this lil page lives under ./drivers/gpu/drm/xe, dated October 2026, and it's filed as enum xe_madv...geable_state(9) — ok bye, go purge responsibly 🍓