sg_pcopy_to_buffer(9)

📦 version 7.3.1, in nixpkgs unstable

✨ sg_pcopy_to_buffer ✨

okay so bestie, welcome to the sg_pcopy_to_buffer page 💅 this is straight out of the Kernel API Manual section 9, and honestly? it's a little icon of a function. let's get into it 🫶

🌸 NAME 🌸

sg_pcopy_to_buffer — copy from an SG list to a linear buffer, no cap 🎀

like, that's literally the whole vibe. scatter-gather list goes in, nice flat linear buffer comes out. slay.

🦋 SYNOPSIS 🦋

size_t sg_pcopy_to_buffer (struct scatterlist *sgl , unsigned int nents
, void *buf , size_t buflen , off_t skip );

look at her signature. it's giving five whole arguments and she knows it 👑

🎀 ARGUMENTS 🎀

  • sgl — the SG list itself. this is the main character, the source of truth, the one we're copying out of 💖
  • nents — number of SG entries. like, how many of them we're dealing with. you gotta tell her, she's not psychic ✨
  • buf — where to copy to. this is the destination, the linear buffer, the place all the data is gonna land 🌸
  • buflen — the number of bytes to copy. exact amount, bestie, don't eyeball it 🎯
  • skip — number of bytes to skip before copying. yes, we're doing a little hop-skip-jump before we start 🙈 (it's an off_t, so it's got range)

💀 DESCRIPTION 💀

Returns the number of copied bytes. that's it. that's the whole description. short and iconic, periodt 💅

ngl bestie this is one of those functions where the return value usage matters — take the number of copied bytes seriously and don't assume it's always equal to buflen 😭

🔥 SEE ALSO 🔥

aaand here comes the whole friend group 😤 all of these live in the kernel file ./lib/scatterlist.c — go say hi:

every single one of them, in order, exactly as the original listed them — I would never do my besties dirty by trimming the list 🫶

🌈 little note: this page is filed under ./lib in the kernel tree, and the version stamp on it is October 2026.

aaand that's the page! ty for coming to my ted talk, go write some scatterlist code, ily, bye 🎀💖✨👑

📦 where this page comes from