for_each_sgt_page(9)

✨ for_each_sgt_page 💫

okay so bestie, this is a page from the Kernel API Manual (yes, the (9) section, we love a kernel-adjacent moment) and it's all about for_each_sgt_page — literally just iterate over the pages of the given sg_table. that's the whole vibe. 🦋

---

🌸 NAME 🌸

for_each_sgt_page — iterate over the pages of the given sg_table

like, you give it an sg_table and it walks the pages for you. no cap, that's it. 💅

---

⭐ SYNOPSIS ⭐

for_each_sgt_page (__pp , __iter , __sgt );

three args, in that exact order, spaces and all. write it down, don't freestyle it. 🎀

---

💖 ARGUMENTS 💖

• __pp — the page pointer, and heads up: it's an output 🫶 so this is where the page you're currently looking at lands.
• __iter — bestie… the page genuinely does not say what this one does. it's just sitting there with no description. i'm not gonna make something up, so: mysterious. iconic. leave it as-is. 🙈
• __sgt — the sg_table you're iterating over, and it's input (you're reading from it, not writing to it). 🔥

---

🦋 SEE ALSO 🦋

all the sibling lore lives in the kernel file ./drivers/gpu/drm/i915/i915_scatterlist.h, and the related entries are:

• __sg_next(9)
• __for_each_sgt_daddr(9)
• __for_each_daddr_next(9)
• i915_sg_dma_sizes(9)
• struct i915_refct_sgt_ops(9)
• struct i915_refct_sgt(9)
• i915_refct_sgt_put(9)
• i915_refct_sgt_get(9)
• __i915_refct_sgt_init(9)

go read those next, bestie, the whole friend group is there. 👑

---

lowkey a tiny page, highkey useful. the way that it just… iterates. periodt. 💀

---

and that's the whole page, fr fr 🌈 — brought to you by ./drivers/gpu/drm/i915, dated October 2026. go forth and iterate those pages, you main character. 💜🎀