__i915_gem_o..._iter_get_sg(9)

📦 version 7.3.1, in nixpkgs unstable

✨ NAME ✨

okay bestie, welcome to the Kernel API Manual 💖 you're looking at the page for __i915_gem_object_page_iter_get_sg — the header up top truncates it all dramatic as __i915_gem_o..._iter_get_sg(9), but we're using the full name here. No cap, this one is a helper to find the target scatterlist pointer and the target page position using the pgoff_t n input argument and i915_gem_object_page_iter.

🦋 SYNOPSIS 🦋

struct scatterlist * __i915_gem_object_page_iter_get_sg (struct
drm_i915_gem_object *obj , struct i915_gem_object_page_iter *iter ,
pgoff_t n , unsigned int *offset );

that's the signature, copy it exactly, don't freestyle it ✨

🎀 ARGUMENTS 🎀

  • obj — the i915 GEM buffer object
  • iter — the i915 GEM buffer object page iterator
  • n — page offset
  • offset — the searched physical offset; it will be used for returning the physical page offset value

🔥 CONTEXT 🔥

Lock behavior, bestie, pay attention: it takes and releases the mutex lock of the i915_gem_object_page_iter 🫶 it also takes and releases the RCU lock to search the radix_tree of the i915_gem_object_page_iter ✨

🌸 RETURN 🌸

It returns the target scatterlist pointer and the target page position. That's the return vibe — both of those 👑

💅 DESCRIPTION 💅

Recommended to use wrapper macro: i915_gem_object_page_iter_get_sg — that's the manual's whole recommendation, and honestly bestie, just use the wrapper macro 😌💖

🌈 SEE ALSO 🌈

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

xoxo, signing off from source ./drivers/gpu/drm/i915/gem, October 2026 edition 🫶💖

📦 where this page comes from