i915_gem_object_can_migrate(9)

📦 version 7.3.1, in nixpkgs unstable

✨ i915_gem_object_can_migrate(9) ✨

okay so bestie, welcome to the kernel API manual (section 9, she's fancy 💅) — today we're looking at i915_gem_object_can_migrate, and honestly? she's a vibe checker for GPU objects. let's get into it 🦋

🌸 NAME 🌸

i915_gem_object_can_migrate — answers the question "can this object likely be migrated?" 💫 (key word: likely, bestie, hold that thought)

🎀 SYNOPSIS 🎀

bool i915_gem_object_can_migrate (struct drm_i915_gem_object *obj , enum
       intel_region_id id );

she takes two things and gives you back a bool. that's it. that's the whole function. icon behavior.

🫶 ARGUMENTS 🫶

  • obj — the object we're trying to migrate, aka the main character of this whole operation 👑
  • id — the region we intend to migrate to, aka the destination vibe 🌈

💖 DESCRIPTION 💖

so what she does is: check whether the object backend actually supports migration to the given region. that's the whole job. no cap.

but — and this is the important part, don't skip it — pinning may affect the ability to migrate as returned by this function 😭 like, if something's pinned, the answer you get back might not be the answer you expect. it's giving "it's complicated".

also she's primarily intended as a helper for checking the possibility of migrating objects. so she's a helper! she's not the whole story! and heads up: she might be slightly less permissive than i915_gem_object_migrate when it comes to objects with the I915_BO_ALLOC_USER flag set. so like, she's a little stricter in that specific case. not a hater, just careful 🧚

⭐ RETURN ⭐

  • true if migration is possible 💚
  • false otherwise 💀

literally that simple. slay.

🔥 SEE ALSO 🔥

the source lives in the kernel file ./drivers/gpu/drm/i915/gem/i915_gem_object.c — go read her fr fr 📖

and here's the whole friend group, alphabetically-adjacent and ready to be clicked:

and that's the page!! mwah 💋 this whole thing lives under ./drivers/gpu/drm/i915/gem and it's dated October 2026, and yes the footer says i915_gem_object_can_migrate(9) one more time because she loves a dramatic exit ✨🦋💜
📦 where this page comes from