ib_sg_to_pages(9)

📦 version 7.3.1, in nixpkgs unstable

💅 ib_sg_to_pages(9) — the Kernel API Manual, bestie edition 🎀

okay so picture this: you're deep in the Kernel API Manual (the 9 is the section, iykyk) and you've got a scatterlist that's way too long and a page vector that's way too empty. This little icon right here is the glow-up in between ✨

🦋 NAME 🦋

ib_sg_to_pages — converts the largest prefix of a sg list into a page vector. literally that's the whole job, and she ate 💅

🌸 SYNOPSIS 🌸

int ib_sg_to_pages (struct ib_mr *mr , struct scatterlist *sgl , int
sg_nents , unsigned int *sg_offset_p , int (*set_page)(struct ib_mr *,
u64) );

🎀 ARGUMENTS 🎀

  • mr — the memory region, bestie. that's the main character of this function 💖
  • sgl — a dma mapped scatterlist 🦋
  • sg_nents — how many entries are in the sg. the count. the census. the roster count 📋
  • sg_offset_p — a pointer to an offset, and she's both an input and an output, so pay attention:
    • IN — start offset in bytes into sg 🌸
    • OUT — offset in bytes for element n of the sg of the first byte that has not been processed, where n is the return value of this function 👑
  • set_page — the driver's page assignment function pointer 🔥

✨ DESCRIPTION ✨

So this is a core service helper, right? For drivers 🫶 Her whole thing is converting the largest prefix of a given sg list into a page vector. And when I say "the largest prefix," I mean the prefix that meets the requirements of ib_map_mr_sg — no cap, that's the exact bar she's clearing 💯

She returns the number of sg elements that were assigned to a page vector. that's it, that's the return value, that's the vibe check ✅

ngl bestie, if you were hoping for a whole separate RETURN VALUE section — she doesn't have one. the return value lives right here in DESCRIPTION and we respect her choices 💀

👑 SEE ALSO 👑

Kernel file ./drivers/infiniband/core/verbs.c — go read the source, it's giving main character energy 📖 And while you're in there, these besties are all in the same friend group:

and that's the page, bestie 🧚 this cutie lives in ./drivers/infiniband/core and she's dated October 2026 — so she's fresh, she's current, she's iconic 🌈⭐ stay hydrated and go map some sg lists 💜

📦 where this page comes from