i915_gem_obj..._iter_get_sg(9)

📦 version 7.3.1, in nixpkgs unstable

💖 NAME 💖

okay so this page is all about i915_gem_object_page_iter_get_sg — a wrapper macro for __i915_gem_object_page_iter_get_sg() — and it lives in the Kernel API Manual under the extremely abbreviated title i915_gem_obj..._iter_get_sg(9). long function name, tiny page header, main character energy ✨

✨ SYNOPSIS ✨

i915_gem_object_page_iter_get_sg (obj , it , n , offset );

🎀 ARGUMENTS 🎀

  • obj — the i915 GEM buffer object, bestie 🫶
  • it — the i915 GEM buffer object page iterator, yes specifically that kind of iterator 💅
  • n — the page offset
  • offset — the searched physical offset; it will be used for returning the physical page offset value, no cap

🌸 CONTEXT 🌸

  • she takes and releases the mutex lock of the i915_gem_object_page_iter 🎀
  • she also takes and releases the RCU lock to search the radix_tree of i915_gem_object_page_iter 🦋

literally locks on, locks off, searches the radix_tree, and keeps it moving.

⭐ RETURN ⭐

The target scatterlist pointer and the target page position. both of them, together, iconic. 💖

🦋 DESCRIPTION 🦋

so here's the vibe check: in order to avoid the truncation of the input parameter, it checks the page offset n's type from the input parameter before calling __i915_gem_object_page_iter_get_sg. a little type check before the real call, so the input doesn't get truncated — iykyk. ✨

💜 SEE ALSO 💜

the whole friend group is linked up, fr fr 🫶

mwah 💋 — this page comes from ./drivers/gpu/drm/i915/gem, dated October 2026, and the footer labels it i915_gem_obj..._iter_get_sg(9). slay and goodbye, bestie 💅

📦 where this page comes from