spum_create_request(9)

💅 spum_create_request(9) — aka the Kernel API Manual glow-up 🎀

okay so bestie, welcome to the spum_create_request page from the Kernel API Manual, section 9 (that's the kernel-API girlies only, no syscall peasants here 💅). We're building SPU request messages and we're gonna do it correctly.

---

✨ NAME ✨

spum_create_request — build a SPU request message header, all the way up to and including the BD header. Like, the whole thing.

The message gets constructed starting at spu_hdr. And listen — the caller is the one who has to allocate this buffer, okay? And it must be in DMA-able memory and at least SPU_HEADER_ALLOC_LEN bytes long. No cap, if you skimp on the buffer it's not gonna be cute. 😭

---

🌸 SYNOPSIS 🌸

u32 spum_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
);

look at her. six arguments. main character energy fr fr. 👑

---

🦋 ARGUMENTS 🦋

• spu_hdr — the start of the buffer where the SPU request header is gonna be written. This is your canvas, bestie. 🎨
• req_opts — the SPU request message options. the vibe check for your request.
• cipher_parms — everything having to do with the cipher algorithm.
• hash_parms — everything having to do with the hash algorithm.
• aead_parms — everything having to do with the AEAD operation. AEAD girlies stay winning. 💜
• data_size — length of the data to be encrypted or authenticated. ⚠️ and if it's AEAD, this does not include the length of the AAD. do not come for me on this, it's literally in the spec.

---

🫶 RETURN 🫶

returns the length of the SPU header, in bytes. and if something goes wrong? returns 0. that's the error signal, so if you see a 0 don't just celebrate, check yourself. 💀

---

🌈 SEE ALSO 🌈

the whole friend group, and yes we're tagging everyone:

• Kernel file ./drivers/crypto/bcm/spu.c
• spum_ns2_ctx_max_payload(9)
• spum_nsp_ctx_max_payload(9)
• spum_response_hdr_len(9)
• spum_hash_pad_len(9)
• spum_gcm_ccm_pad_len(9)
• spum_assoc_resp_len(9)
• spum_aead_ivlen(9)
• spum_hash_type(9)
• spum_digest_size(9)
• spum_cipher_req_init(9)
• spum_cipher_req_finish(9)
• spum_request_pad(9)
• spum_xts_tweak_in_payload(9)
• spum_tx_status_len(9)
• spum_rx_status_len(9)
• spum_status_process(9)
• spum_ccm_update_iv(9)
• spum_wordalign_padlen(9)

---

💖 reminder bestie: DMA-able memory. at least SPU_HEADER_ALLOC_LEN bytes. that's the whole assignment. slay it.

---

and that's the page!! brought to you by ./drivers/crypto/bcm, dated October 2026, filed under spum_create_request(9) — mwah, go build some headers, ily 🧚‍♀️⭐