sg_miter_next(9)

💅 sg_miter_next(9) — like, the actual manual page, bestie

Ok so first things first: this is a page from the Kernel API Manual, and today's main character is sg_miter_next. Buckle up, it's short but it matters. 🎀

---

✨ NAME ✨

sg_miter_next — proceed mapping iterator to the next mapping

🌸 SYNOPSIS 🌸

bool sg_miter_next (struct sg_mapping_iter *miter );

🦋 ARGUMENTS 🦋

• miter — the sg mapping iter you want to proceed, bestie. that's the whole vibe of this function tbh.

💖 DESCRIPTION 💖

Ok so here's the tea: sg_miter_next proceeds miter to the next mapping. ✨

Now, important detail, don't skip this — miter should have been started using sg_miter_start. Like, it needs to already exist and be set up properly, no cap. 🙈

On successful return, three things point to the current mapping:

• miter->page
• miter->addr
• miter->length

All three, together, pointing right at the current mapping. Gorgeous. Literally it's giving "the whole squad showed up." 👑

🌈 CONTEXT 🌈

May sleep if !SG_MITER_ATOMIC && !SG_MITER_LOCAL.

So like… only under those exact conditions, and nowhere else. Read those flags twice, fr fr. 🫶

⭐ RETURN ⭐

• true — if miter contains the next mapping. slay. 💅
• false — if end of sg list is reached. that's it, we're done, no more mappings, the era has ended. 😭

👑 SEE ALSO 👑

Kernel file ./lib/scatterlist.c — and like, the entire scatterlist extended family, honestly:

• sg_nents(9)
• sg_nents_for_len(9)
• sg_nents_for_dma(9)
• sg_last(9)
• sg_init_table(9)
• sg_init_one(9)
• __sg_free_table(9)
• sg_free_append_table(9)
• sg_free_table(9)
• __sg_alloc_table(9)
• sg_alloc_table(9)
• sg_alloc_append_table_from_pages(9)
• sg_alloc_table_from_pages_segment(9)
• sgl_alloc_order(9)
• sgl_alloc(9)
• sgl_free_n_order(9)
• sgl_free_order(9)
• sgl_free(9)
• sg_miter_start(9)
• sg_miter_skip(9)
• sg_miter_stop(9)
• sg_copy_buffer(9)
• sg_copy_from_buffer(9)
• sg_copy_to_buffer(9)
• sg_pcopy_from_buffer(9)
• sg_pcopy_to_buffer(9)
• sg_zero_buffer(9)
• extract_iter_to_sg(9)

That's the whole group chat, every single one of them, no one left on read. 💜

---

and yeah — ./lib, October 2026. that's where this page lives and when it was dated. 🧚 consider that the cute lil sign-off, mwah 💋