i915_gem_object_unpin_map(9)

📦 version 7.3.1, in nixpkgs unstable

💅 i915_gem_object_unpin_map — the Kernel API Manual page you've been waiting for ✨

okay so bestie, welcome to the Kernel API Manual, page i915_gem_object_unpin_map(9). this one's short and sweet and honestly? it's giving "clean up after yourself" energy. let's get into it 🫶

🌸 NAME 🌸

i915_gem_object_unpin_map — releases an earlier mapping 🎀

like, you mapped something before, remember? now we're un-mapping it. balance. symmetry. iconic.

✨ SYNOPSIS ✨

void i915_gem_object_unpin_map (struct drm_i915_gem_object *obj );

no cap, that's the whole signature. it returns void, so don't go looking for a return value, there isn't one 💀

🦋 ARGUMENTS 🦋

  • obj — the object to unmap. that's it. that's the whole argument. she's low maintenance 👑

💖 DESCRIPTION 💖

so here's the lore: remember how you pinned the object and mapped its pages? yeah. now you're done with your access, and it's time to call i915_gem_object_unpin_map to release the pin upon the mapping 🎯

the way this works is literally so satisfying: once the pin count reaches zero, that mapping may be removed. zero means free. zero means bye bestie. that's the vibe check 🌈

⚠️ fr fr though: this is the "I'm finished with my access" call. don't be out here unpinning maps you haven't finished with. the pin count going to zero is what lets the mapping get removed, and that's the whole point of her 💅

🌟 SEE ALSO 🌟

the Kernel file to go peek at is ./drivers/gpu/drm/i915/gem/i915_gem_object.h — that's where the goods live 📁

and here's the whole friend group, in the order the page lists them (yes, all of them, I would never skip one, not on my watch):

not the double-underscore versions being the introverted siblings of the regular ones 😭 anyway. i915_gem_object_pin_map(9) is the one that got you here — she's the pin, this page is the unpin. they're a matched set, iykyk 💜

🧚 and that's the whole page, bestie. short, sweet, and completely slaying.

🌸💅🎀 sign-off time 🎀💅🌸

this little masterpiece comes from the source path ./drivers/gpu/drm/i915/gem and is dated October 2026 — so like, future-coded of her, honestly. no cap, she ate. periodt. 👑✨🍓

📦 where this page comes from