__i915_gem_..._dma_address(9)

📦 version 7.3.1, in nixpkgs unstable

💅 __i915_gem_..._dma_address(9) — a Kernel API Manual moment ✨

okay so bestie, you're in the Kernel API Manual and this page is literally all about one tiny helper that goes digging for bus addresses. it's giving "small function, big friend group" energy. let's get into it 🫶

✨ NAME ✨

__i915_gem_object_get_dma_address — the helper that grabs the bus addresses of a targeted DMA-mapped scatterlist out of an i915 GEM buffer object 💖

like, that's the whole job. it's a helper. it helps. it's helpful. iconic behavior honestly 👑

🦋 SYNOPSIS 🦋

dma_addr_t __i915_gem_object_get_dma_address (struct drm_i915_gem_object
*obj , pgoff_t n );

that's it. that's the whole vibe check. a dma_addr_t in the front, two arguments in the back, no cap 💅

🎀 ARGUMENTS 🎀

  • obj — your i915 GEM buffer object. the main character of this operation, no notes 💜
  • n — the page offset. yes queen, tell her which page you're obsessed with 🌸

⭐ RETURN ⭐

it hands you back the bus addresses of the targeted DMA-mapped scatterlis 📬

that's the return value. that's what you get. go off, dma_addr_t 🎉

🔥 DESCRIPTION 🔥

so like — the manual is very clear about this one: they recommend you use the wrapper macro i915_gem_object_get_dma_address. like, they're not yelling, but they are saying it 😭 it's the nicer, safer-looking door to walk through, bestie 🚪✨

also! they literally say See also __i915_gem_object_page_iter_get_sg and __i915_gem_object_get_sg_dma — so if you wanna go deeper down the rabbit hole, those two are right there waiting for you 🐇🕳️

ngl, this function is lowkey the "ask the friend who actually knows the address" of the i915 gem world 🧚

🌈 SEE ALSO 🌈

that's the whole friend group right there 🫂💕 every single one of them, accounted for, nobody left on read 👑

💀 warning-ish note, bestie: the manpage uses a double-underscore name for a reason — this is the inner helper. the DESCRIPTION says use the wrapper macro i915_gem_object_get_dma_address and honestly? listen to her. she knows. 🙈

and that's a wrap on this one, bestie!! 🎀✨ source vibes came from ./drivers/gpu/drm/i915/gem, stamped October 2026, and it all lives under the name __i915_gem_..._dma_address(9) — mwah, slay, periodt 💅💖

📦 where this page comes from