spu2_cipher_req_init(9)

💖 spu2_cipher_req_init(9) 💖

okay bestie, welcome to the Kernel API Manual page for spu2_cipher_req_init(9) — yes we're doing kernel crypto group-chat style, and it's gonna slay. 🫶

---

✨ NAME ✨

spu2_cipher_req_init builds an skcipher SPU2 request message header, including FMD and OMD. that's the whole assignment, no cap. 💅

---

✨ SYNOPSIS ✨

u16 spu2_cipher_req_init (u8 *spu_hdr , struct spu_cipher_parms
*cipher_parms );

---

🎀 ARGUMENTS 🎀

• spu_hdr — Location of start of SPU request (FMD field) ✨ like, where the SPU request begins, and specifically the FMD field.
• cipher_parms — Parameters describing cipher request 🦋 your little bundle of cipher request info.

---

🦋 DESCRIPTION 🦋

okay so this one gets called at setkey time, and its whole job is to initialize a msg header that can be reused for all subsequent skcipher requests. iconic, honestly. 🔥

It constructs the message starting at spu_hdr. The caller should allocate this buffer in DMA-able memory at least SPU_HEADER_ALLOC_LEN bytes long. so yes, DMA-able memory, and at least that many bytes — do not skimp, bestie. 💀

this is a "should allocate" situation, not a vibe-check-optional situation. keep it DMA-able and at least SPU_HEADER_ALLOC_LEN bytes. 🫶

---

🌸 RETURN 🌸

returns the total length of the SPU header (FMD and OMD) in bytes. and if an error occurs, it returns 0. 🎀

---

🔥 SEE ALSO 🔥

the Kernel file is literally ./drivers/crypto/bcm/spu2.c, and here's the whole squad of (9) besties — every single one, no skips: 💅

• spu2_cipher_xlate(9)
• spu2_hash_xlate(9)
• spu2_fmd_init(9)
• spu2_fmd_ctrl0_write(9)
• spu2_fmd_ctrl1_write(9)
• spu2_fmd_ctrl2_write(9)
• spu2_fmd_ctrl3_write(9)
• spu2_ctx_max_payload(9)
• spu2_payload_length(9)
• spu2_response_hdr_len(9)
• spu2_hash_pad_len(9)
• spu2_gcm_ccm_pad_len(9)
• spu2_assoc_resp_len(9)
• spu2_aead_ivlen(9)
• spu2_hash_type(9)
• spu2_digest_size(9)
• spu2_create_request(9)
• spu2_cipher_req_finish(9)
• spu2_request_pad(9)
• spu2_xts_tweak_in_payload(9)
• spu2_tx_status_len(9)
• spu2_rx_status_len(9)
• spu2_status_process(9)
• spu2_ccm_update_iv(9)
• spu2_wordalign_padlen(9)

okay bye bestie 🫶 — source/version ./drivers/crypto/bcm, dated October 2026, for spu2_cipher_req_init(9). periodt 💅✨