spu2_create_request(9)

💖 NAME 💖

okay so spu2_create_request(9) — from the Kernel API Manual — is literally the function that builds a SPU2 request message header, includint FMD and OMD (yes, includint, we’re preserving the original spelling 😭💅).

---

✨ SYNOPSIS ✨

u32 spu2_create_request (u8 *spu_hdr , struct spu_request_opts *req_opts
, struct spu_cipher_parms *cipher_parms , struct spu_hash_parms
*hash_parms , struct spu_aead_parms *aead_parms , unsigned int data_size
);

---

🎀 ARGUMENTS 🎀

• spu_hdr — start of the buffer where the SPU request header is gonna be written 🫶
• req_opts — the SPU request message options, periodt 💅
• cipher_parms — all the parameters related to the cipher algorithm 🔐
• hash_parms — all the parameters related to the hash algorithm 🌸
• aead_parms — all the parameters related to the AEAD operation ✨
• data_size — length of the data to be encrypted or authenticated. if it’s AEAD, this does not include the length of AAD, bestie 🫶

---

🦋 DESCRIPTION 🦋

This function constructs the message starting at spu_hdr. The caller should allocate this buffer in DMA-able memory, and it needs to be at least SPU_HEADER_ALLOC_LEN bytes long — that’s the minimum, no cap 🎀✨.

---

🌸 RETURN 🌸

It returns the length of the SPU header in bytes. returns 0 if an error occurs 😭.

---

🔥 SEE ALSO 🔥

the whole squad is linked here, bestie:

• Kernel file ./drivers/crypto/bcm/spu2.c
• 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_cipher_req_init(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)

---

mwah 💋 — source/version: ./drivers/crypto/bcm, date: October 2026. go build those headers, bestie 🎀✨