crypto_cipher_setkey(9)

💅 crypto_cipher_setkey 💅

okay so bestie, welcome to crypto_cipher_setkey(9) — that's section 9 of the Kernel API Manual, and yes we're in kernel-land now, put your seatbelt on 🎀

---

✨ NAME ✨

crypto_cipher_setkey — set key for cipher 🔑

---

🌸 SYNOPSIS 🌸

int crypto_cipher_setkey (struct crypto_cipher *tfm , const u8 *key ,
unsigned int keylen );

that's literally the whole signature, no cap. three things go in, one int comes out 💖

---

🦋 ARGUMENTS 🦋

• tfm — the cipher handle, aka your main character struct, the struct crypto_cipher * you're working with 🫶
• key — the buffer holding the key. that's it, that's the buffer, const u8 *
• keylen — length of the key in bytes, an unsigned int, very demure, very mindful

---

👑 DESCRIPTION 👑

so the way this works: the caller-provided key gets set for the single block cipher referenced by the cipher handle. one key, one cipher, slay ✨

note note note 🎀 the key length determines the cipher type. like, it literally decides who the cipher is that day.

many block ciphers implement different cipher modes depending on the key size — the iconic example being AES-128 vs AES-192 vs. AES-256 🔥 so when you provide a 16 byte key for an AES cipher handle, AES-128 is performed. periodt. 16 bytes = AES-128, that's the vibe check 💅

---

🌈 RETURN 🌈

• 0 — yay! the setting of the key was successful 🎉
• < 0 — uh oh bestie, an error occurred 😭 (literally anything less than zero)

---

🧚 SEE ALSO 🧚

• Kernel file ./include/crypto/internal/cipher.h 📁
• Single Block Cipher API(9)
• crypto_alloc_cipher(9)
• crypto_free_cipher(9)
• crypto_has_cipher(9)
• crypto_cipher_blocksize(9)
• crypto_cipher_encrypt_one(9)
• crypto_cipher_decrypt_one(9)

go read all of them, iykyk 🦋

---

okay that's the whole page, mwah 💋 big kiss to ./include/crypto/internal, dated October 2026, filed under crypto_cipher_setkey(9) — and that's on periodt 💜🎀