sg_alloc_table_chained(9)

🌸 NAME 🌸

okay so this is sg_alloc_table_chained(9) from the Kernel API Manual, and it's literally the page for “Allocate and chain SGLs in an sg table” 💅✨ That's the whole vibe: allocate, chain, slay.

✨ SYNOPSIS ✨

the signature is right here, bestie — copy it exactly, no editorializing:

int sg_alloc_table_chained (struct sg_table *table , int nents , struct
       scatterlist *first_chunk , unsigned nents_first_chunk );

🎀 ARGUMENTS 🎀

• table — the sg table header to use. that's your main-character struct, fr fr 🫶
• nents — number of entries in the sg list. yes bestie, count them 💖
• first_chunk — the first SGL. like, the first one first 🌟
• nents_first_chunk — number of the SGL of first_chunk. okay so it's the count for that first chunk, got it 💅

🦋 DESCRIPTION 🦋

so this function allocates and chains SGLs in an sg table ✨ If nents is larger than nents_first_chunk, a chained sg table will be setup. that's the tea ☕

also important: first_chunk is ignored if nents_first_chunk <= 1, because user expects the SGL points non-chain SGL 🫡 no cap, that's the rule.

🔥 SEE ALSO 🔥

• Kernel file ./lib/sg_pool.c 👀
• sg_free_table_chained(9) — the friend in the same little kernel-file friend group 💜

mwah 💋 cute little sign-off: this page came from source/version ./lib, dated October 2026, and it's the sg_alloc_table_chained(9) page. periodt 🎀✨