spu_aead_tx_sg_create(9)

okay bestie, welcome to spu_aead_tx_sg_create(9) from the Kernel API Manual — it’s giving kernel-crypto scatterlist realness, and we’re gonna get through every detail together 💅✨

💖 NAME 💖

spu_aead_tx_sg_create — build up the scatterlist of buffers used to send a SPU request message for an AEAD request. Includes SPU message headers and the request data. 🎀

🌸 SYNOPSIS 🌸

the whole signature, untouched, because bestie we do not mess with function signatures 😤

int spu_aead_tx_sg_create (struct brcm_message *mssg , struct
iproc_reqctx_s *rctx , u8 tx_frag_num , u32 spu_hdr_len , struct
scatterlist *assoc , unsigned int assoc_len , int assoc_nents , unsigned
int aead_iv_len , unsigned int chunksize , u32 aad_pad_len , u32 pad_len
, bool incl_icv );

🎀 ARGUMENTS 🎀

every single one, no skipping, periodt:

• mssg — the mailbox message containing the transmit sg.
• rctx — the crypto request context.
• tx_frag_num — number of scatterlist elements required to construct the SPU request message.
• spu_hdr_len — length of SPU message header in bytes.
• assoc — crypto API associated data scatterlist.
• assoc_len — length of associated data.
• assoc_nents — number of scatterlist entries containing assoc data.
• aead_iv_len — length of AEAD IV, if included.
• chunksize — Number of bytes of request data.
• aad_pad_len — Number of bytes of padding at end of AAD. For GCM/CCM.
• pad_len — Number of pad bytes.
• incl_icv — If true, write separate ICV buffer after data and any padding.

🦋 DESCRIPTION 🦋

so the scatterlist that gets allocated here? it gets freed in spu_chunk_cleanup when the request completes, whether the request is handled successfully or there is an error. no cap, cleanup covers both the slay and the oops 💀✨

⭐ RETURN ⭐

0 if successful, < 0 if an error.

🫶 SEE ALSO 🫶

Kernel file ./drivers/crypto/bcm/cipher.c is the main-character source path, and here are all the (9) buddies:

• select_channel(9)
• spu_skcipher_rx_sg_create(9)
• spu_skcipher_tx_sg_create(9)
• handle_skcipher_req(9)
• handle_skcipher_resp(9)
• spu_ahash_rx_sg_create(9)
• spu_ahash_tx_sg_create(9)
• handle_ahash_req(9)
• spu_hmac_outer_hash(9)
• ahash_req_done(9)
• handle_ahash_resp(9)
• spu_aead_rx_sg_create(9)
• handle_aead_req(9)
• handle_aead_resp(9)
• spu_chunk_cleanup(9)
• finish_req(9)
• spu_rx_callback(9)
• skcipher_enqueue(9)
• spu_no_incr_hash(9)
• aead_gcm_esp_setkey(9)
• rfc4543_gcm_esp_setkey(9)
• aead_ccm_esp_setkey(9)
• spu_functions_register(9)
• spu_mb_init(9)

that’s the whole page, bestie — source/version path ./drivers/crypto/bcm, date October 2026, mwah 💋🎀🫶