i915_gem_object_get_sg_dma(9)

📦 version 7.3.1, in nixpkgs unstable

💅 i915_gem_object_get_sg_dma(9) 💅

okay so bestie, welcome to the Kernel API Manual ✨ — yes we're in the kernel API manual, this is that girl's natural habitat, and today's main character is i915_gem_object_get_sg_dma. She's a wrapper macro. She's small. She's iconic. Let's get into it 🎀

🌸 NAME 🌸

i915_gem_object_get_sg_dma — literally just a wrapper macro for __i915_gem_object_get_sg_dma(). That's it. That's the whole vibe. She's the friendly front desk for the double-underscore one, iykyk 💅

🦋 SYNOPSIS 🦋

i915_gem_object_get_sg_dma (obj , n , offset );

no cap, that's the whole call. three things in, and the universe (well, the scatterlist) comes back out 🫶

✨ ARGUMENTS ✨

  • obj — the i915 GEM buffer object 💖 this is the whole reason we're here.
  • n — the page offset ✨
  • offset — the searched physical offset — and heads up, this one's not just an input! it gets used for returning the physical page offset value, so she's doing double duty, main character energy fr fr 👑

🔥 RETURN 🔥

You get back the target scatterlist pointer and the target page position. Two things. Both slay. ⭐

💜 DESCRIPTION 💜

So here's the tea 🍓: to avoid truncation of the input parameter, she checks the type of the page offset n — like, from the input parameter itself — before calling __i915_gem_object_get_sg_dma. Type check first, then the call. That's the whole point of the wrapper, ngl. ✨

Also, see __i915_gem_object_page_iter_get_sg — she's the cousin, say hi 😭

🌈 SEE ALSO 🌈

like, the whole friend group showed up to the function's birthday party 🧚💜

and that's a wrap bestie!! source lives at ./drivers/gpu/drm/i915/gem and the date on this lil beauty is October 2026 — go off, calendar icon 🌸💖 periodt ✨👑

📦 where this page comes from