spu_skcipher_rx_sg_create(9)

📦 version 7.3.1, in nixpkgs unstable

💅 spu_skcipher_rx_sg_create(9) — bestie edition

okay so this is a page from the Kernel API Manual and honestly? it's giving "underrated little helper energy." pull up a chair 🎀

✨ NAME ✨

spu_skcipher_rx_sg_create — literally builds up the scatterlist of buffers you use to receive a SPU response message for an skcipher request. and yes, it's thorough: it includes buffers to catch the SPU message headers and the response data. no crumbs left behind, periodt. 💅

🌸 SYNOPSIS 🌸

int spu_skcipher_rx_sg_create (struct brcm_message *mssg , struct
        iproc_reqctx_s *rctx , u8 rx_frag_num , unsigned int chunksize , u32
        stat_pad_len );

like, look at her signature. five params. all mains. 💖

🦋 ARGUMENTS 🦋

  • mssg — the mailbox message that's holding the receive sg. she's the one carrying the goods 🫶
  • rctx — the crypto request context. the vibe context, if you will ✨
  • rx_frag_num — how many scatterlist elements you need to hold the SPU response message. a u8, so keep it cute and small 💀
  • chunksize — number of bytes of response data you're expecting. an unsigned int, bestie, plan accordingly 🌸
  • stat_pad_len — number of bytes required to pad the STAT field to a 4-byte boundary. yes it's a u32. yes it's doing exactly what it says 😭

🧚 DESCRIPTION 🧚

so here's the tea 🔥: the scatterlist that gets allocated right here is freed in spu_chunk_cleanup when the request completes. and when does it complete? whether the request is handled successfully or there's an error. both paths. no leaks, no drama, no "oops I forgot to free it." iconic behavior honestly 👑

ngl, the cleanup contract is the whole point — you allocate here, someone else (specifically spu_chunk_cleanup) handles the goodbye. don't double-free, bestie. 🙈

⭐ RETURN ⭐

  • 0 if successful 🎉
  • < 0 if an error 💀

that's it. that's the whole vibe check.

🌈 SEE ALSO 🌈

the whole friend group 🫶 — all from the kernel file ./drivers/crypto/bcm/cipher.c:

like, the whole roster. iykyk 💜

and that's the page, bestie 🎀 this one lives in ./drivers/crypto/bcm, dated October 2026, filed under spu_skcipher_rx_sg_create(9). mwah, go build some scatterlists 💋✨

📦 where this page comes from