i915_gem_obj...ke_purgeable(9)

💅 NAME 💅

okay so bestie, this page is for i915_gem_object_make_purgeable, straight out of the Kernel API Manual, section 9. ✨ What it does? It moves the object to the tail of the purgeable list. It's used with DONTNEED objects. And unlike with shrinkable objects, the shrinker will attempt to discard the backing pages, instead of trying to swap them out. That's the whole vibe. 💖

✨ SYNOPSIS ✨

void i915_gem_object_make_purgeable (struct drm_i915_gem_object *obj );

🫶 ARGUMENTS 🫶

• obj — the GEM object. That's it, that's the argument. 👑

🌸 DESCRIPTION 🌸

okay, rules time, and these are not optional. 🚨

This function MUST only be called on objects which have backing pages. Like, literally must. No backing pages? Not the move. 🙈

It also MUST be balanced with a previous call to i915_gem_object_make_unshrinkable. So don't just call it and ghost — keep that balance, fr fr. 💅

🦋 SEE ALSO 🦋

• Kernel file ./drivers/gpu/drm/i915/gem/i915_gem_shrinker.c
• i915_gem_shrink(9)
• i915_gem_shrink_all(9)
• i915_gem_object_make_unshrinkable(9)
• __i915_gem_object_make_shrinkable(9)
• __i915_gem_object_make_purgeable(9)
• i915_gem_object_make_shrinkable(9)

that's the whole page, bestie! 💖 source/version: ./drivers/gpu/drm/i915/gem; dated October 2026; and the footer title is i915_gem_obj...ke_purgeable(9). mwah, go slay your kernel work 👑✨