KCAPI_AEAD_SETASSOCL(3)

✨ kcapi_aead_setassoclen — bestie, we're setting the auth data size 💅

okay so this is a page from the libkcapi manual (section 3, the library-functions section, iykyk), and the function we're obsessing over today is kcapi_aead_setassoclen — literally just "set authentication data size" and nothing more, no cap.

---

🌸 SYNOPSIS 🌸

void kcapi_aead_setassoclen(struct kcapi_handle * handle,
                            size_t assoclen);

that's it, that's the whole vibe 🎀

---

🦋 ARGUMENTS 🦋

• handle — [in] the cipher handle, aka your main character ✨
• assoclen — [in] the length of associated data length, fr fr 📏

---

💖 DESCRIPTION 💖

so the associated data? it gets retained in the cipher handle — like it literally lives there, no cap 🫶. and then, during initialization of a cipher handle, it gets sent to the kernel. periodt.

now here's the part you need to know, bestie: the kernel cipher implementations may verify the appropriateness of the authentication data size 👀, and they may return an error during initialization if that authentication size is not considered appropriate. so like… if the kernel isn't feeling it, initialization is not giving, and you get an error. slay responsibly 💀

---

👑 AUTHOR 👑

Stephan Mueller <smueller@chronox.de> — Author. iconic behaviour, honestly 🎀

---

🌈 COPYRIGHT 🌈

that's a wrap on the libkcapi Manual 1.5.0, dated July 2025 — go forth and set those assoc lengths, you absolute legend 💜✨🌸