i915_vma_insert(9)

💖 i915_vma_insert(9) 💖

okay so bestie, welcome to the Kernel API Manual page for i915_vma_insert(9) — the function that finds a slot for the vma in its address space. lowkey iconic kernel business, no cap 🫶✨

🌸 NAME 🌸

i915_vma_insert — finds a slot for the vma in its address space 💅

🎀 SYNOPSIS 🎀

int i915_vma_insert (struct i915_vma *vma , struct i915_gem_ww_ctx *ww ,
       u64 size , u64 alignment , u64 flags );

🦋 ARGUMENTS 🦋

• vma — the vma. literally the vma 💖
• ww — An optional struct i915_gem_ww_ctx
• size — requested size in bytes (can be larger than the VMA)
• alignment — required alignment ✨
• flags — mask of PIN_* flags to use 🔥

🌈 DESCRIPTION 🌈

First up, it tries to allocate some free space that meets the requirements for the VMA. Failing that, if the flags permit, it will evict an old VMA — preferably the oldest idle entry — to make room for the new VMA 😭✨

⭐ RETURN ⭐

0 on success, negative error code otherwise 🫶

🍓 SEE ALSO 🍓

• Kernel file ./drivers/gpu/drm/i915/i915_vma.c
• i915_vma_instance(9)
• i915_vma_bind(9)
• i915_ggtt_clear_scanout(9)

kisses from ./drivers/gpu/drm/i915, October 2026 — i915_vma_insert(9), signing off 💜🎀 periodt.