i915_gem_object_get_page(9)

📦 version 7.3.1, in nixpkgs unstable

✨ i915_gem_object_get_page ✨

okay so first things first, this is a page from the Kernel API Manual (yes, the kernel has a manual, and yes it's giving very much "the library is open" energy 📚). The function itself is i915_gem_object_get_page(9) and honestly bestie, the NAME section is gonna tell you everything you need:

🌸 NAME 🌸

i915_gem_object_get_page — it's a wrapper macro for __i915_gem_object_get_page. that's it. that's the whole vibe. it's the cute little entrance to the real function, like a bouncer who's just checking your ID before letting you into the club 🫶

💅 SYNOPSIS 💅

i915_gem_object_get_page (obj , n );

look at her. two arguments, one semicolon, zero notes. iconic ✨

🎀 ARGUMENTS 🎀

  • obj — your i915 GEM buffer object. the whole point of the operation, the main character of this story 👑
  • n — the page offset. which page are we grabbing? you tell it. be specific, bestie 💖

🔥 RETURN 🔥

it hands you back the target page pointer. that's the prize. you asked for a page, you get a page. slay 🦋

🌈 DESCRIPTION 🌈

okay so here's the tea ☕ — the whole reason this wrapper macro even exists is to avoid truncation of the input parameter. like, that's literally its job. before it calls __i915_gem_object_get_page, it checks the page offset n's type from the input parameter — just making sure the type is right so nothing gets chopped off or lost in translation, no cap 💀

and also, definitely peep __i915_gem_object_page_iter_get_sg while you're here. iykyk ✨

💜 SEE ALSO 💜

the kernel file lives right here, bestie, go read it fr fr:

./drivers/gpu/drm/i915/gem/i915_gem_object.h

and the whole friend group, because this function does NOT exist in isolation 🧚:

like literally the entire i915 GEM extended universe is in here. bring snacks 🍓

and that's the page!! sourced straight from ./drivers/gpu/drm/i915/gem, dated October 2026 — sooo futuristic of her, we love a forward-thinking queen 💅🎀 go get those page pointers bestie, you got this 💖

📦 where this page comes from