sgl_alloc(9)

🎀 sgl_alloc(9) 🎀

okay so bestie, welcome to the Kernel API Manual — this is the page for sgl_alloc(9) and it's honestly a whole vibe. it does exactly one thing and it does it iconically: it hands you a scatterlist and the pages that go with it. let's get into it 💅

---

✨ NAME ✨

sgl_alloc — allocate a scatterlist and its pages 🫶

like, both of them. together. one function call. main character energy fr fr.

---

🌸 SYNOPSIS 🌸

struct scatterlist * sgl_alloc (unsigned long long length , gfp_t gfp ,
unsigned int *nent_p );

---

🦋 ARGUMENTS 🦋

• length — the length in bytes of the scatterlist. yes, unsigned long long, she's got range 💜
• gfp — the memory allocation flags. this is where you tell the kernel how you want your memory to behave (iykyk) ✨
• nent_p — marked [out] in the original, so it's an output param, bestie — the number of entries in the scatterlist gets written back through this pointer. it's giving "you'll find out how many when we're done" 🎀

---

💀 RETURN 💀

a pointer to an initialized scatterlist, or NULL upon failure 😭

no cap: check for that NULL, okay? it's literally right there in the spec.

---

🔥 SEE ALSO 🔥

the kernel file lives at ./lib/scatterlist.c — that's the mothership 🏠 and here's the whole scatterlist family reunion, every single one of them, no skips:

• 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_free_n_order(9)
• sgl_free_order(9)
• sgl_free(9)
• sg_miter_start(9)
• sg_miter_skip(9)
• sg_miter_next(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 page, bestie, nothing left out 💖 this one ships from ./lib, dated October 2026 — go be iconic with your scatterlists, mwah 💋🌸