i915_gem_evict_something(9)

🎀 NAME 🎀

okay so, bestie, welcome to the i915_gem_evict_something(9) page from the Kernel API Manual — the one that’s literally about evicting vmas to make room for binding a new one. It’s giving “cleanup era,” but for address space. 💅✨

i915_gem_evict_something — evict vmas to make room for binding a new one. No cap, that’s the whole assignment. 🫶

🌸 SYNOPSIS 🌸

bestie, here’s the signature in all its glory:

int i915_gem_evict_something (struct i915_address_space *vm , struct
       i915_gem_ww_ctx *ww , u64 min_size , u64 alignment , unsigned long color
       , u64 start , u64 end , unsigned flags );

💖 ARGUMENTS 💖

• vm — the address space we’re evicting from. That’s our main character. ✨
• ww — an optional struct i915_gem_ww_ctx. Optional, bestie, so don’t panic. 🦋
• min_size — the size of the desired free space. We need room, okay? 🎀
• alignment — the alignment constraint of the desired free space. It’s gotta line up cute. 💅
• color — the color for the desired space. Yes, color. We love a colorful free space. 🌈
• start — start (inclusive) of the range from which to evict objects. Inclusive, so don’t forget that edge. 🔥
• end — end (exclusive) of the range from which to evict objects. Exclusive, periodt. 💀
• flags — additional flags to control the eviction algorithm. Flags on flags, iykyk. 🧚

👑 DESCRIPTION 👑

okay so the whole vibe: this function will try to evict vmas until it finds a free space that satisfies the requirements. But listen — callers must check first whether any such hole exists already before calling this function. That’s not a suggestion, bestie. 🫶

This function is used by the object/vma binding code. Love that for it. 🔥

Since this function is only used to free up virtual address space, it only ignores pinned vmas — and not an object where the backing storage itself is pinned. Hence obj->pages_pin_count does not protect against eviction. Please don’t forget that, fr fr. 😭

To clarify (because clarity is cute): this is for freeing up virtual address space, not for freeing memory in e.g. the shrinker. Periodt. 🌈

⭐ SEE ALSO ⭐

• Kernel file ./drivers/gpu/drm/i915/i915_gem_evict.c
• i915_gem_evict_for_node(9)
• i915_gem_evict_vm(9)

That’s the page, bestie! Its source/version line points to ./drivers/gpu/drm/i915, the date is October 2026, and the manual name is i915_gem_evict_something(9). Stay evicting, stay iconic. 💖✨