sgl_alloc_order(9)

✨ sgl_alloc_order(9) ✨

okay so bestie, we're in the Kernel API Manual today and this one is called sgl_alloc_order — it's a (9) page so you already know it's kernel-internal, iykyk 💅

---

🎀 NAME 🎀

sgl_alloc_order — allocate a scatterlist and all its pages, together, in one go 🫶

---

🌸 SYNOPSIS 🌸

struct scatterlist * sgl_alloc_order (unsigned long long length ,
unsigned int order , bool chainable , gfp_t gfp , unsigned int *nent_p
);

---

🦋 ARGUMENTS 🦋

• length — the length in bytes of the scatterlist. Lowkey important: it must be at least one ⭐
• order — this is the second argument you'd hand to alloc_pages 📄
• chainable — whether or not to allocate an extra element in the scatterlist, for scatterlist chaining purposes 🔗
• gfp — the memory allocation flags 🌈
• nent_p — [out], so it's where the answer comes back to you: the number of entries in the scatterlist that actually have pages 💖

---

👑 RETURN 👑

You get a pointer to an initialized scatterlist 💫 or NULL upon failure 😭 (yes, check it, always check it).

---

🌟 SEE ALSO 🌟

Kernel file ./lib/scatterlist.c, plus the whole scatterlist friend group:

• 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(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)

---

and that's the whole vibe check bestie, go allocate something iconic 💜✨

this page lives in ./lib, version dated October 2026, and it's sgl_alloc_order(9) — mwah, slay, periodt 🎀💅