KCAPI_CIPHER_INIT(3)

✨ KCAPI_CIPHER_INIT ✨

okay so bestie, welcome to kcapi_cipher_init from the libkcapi crew — this is the one that initializes a cipher handle for you 💖 it's a libkcapi manual page (section 3, programming interface energy) and we're gonna get you fluent in it, no cap.

---

🌸 SYNOPSIS 🌸

int kcapi_cipher_init(struct kcapi_handle ** handle,
                      const char * ciphername, uint32_t flags);

like. three args. one int back. she's simple, she's iconic, she slays 💅

---

🎀 ARGUMENTS 🎀

• handle — [out] bestie this is the output, it's where the cipher handle gets filled in during the call 🫶 you bring the pointer-to-pointer, she fills it with the goods.
• ciphername — [in] the kernel crypto API cipher name, exactly as specified in /proc/crypto ✨ copy it character for character, do not freestyle, do not improvise, do not get cute with it.
• flags — [in] the flags that specify the type of cipher handle you want 🦋 this is where you tell her what kind of handle vibe you're going for.

---

💜 DESCRIPTION 💜

so what does she actually do? This function provides the initialization of a symmetric cipher handle and — the main character moment — establishes the connection to the kernel 🔥

On success, a pointer to a kcapi_handle object is returned in *handle. and then?? you should call kcapi_cipher_destroy afterwards to free resources 🧚 like, that's the clean-up era, don't skip it, we don't leave handles lying around, that's not the vibe.

Return values, and listen close because these matter:

• returns 0 upon success 🎉
• -ENOENT — algorithm not available 😭
• -EOPNOTSUPP — AF_ALG family not available 💀
• -EINVAL — accept syscall failed
• -ENOMEM — cipher handle cannot be allocated 🙈

bestie if you get a negative number back, that's not a win. check which one it is, she's telling you exactly what went wrong. periodt.

---

👑 AUTHOR 👑

Stephan Mueller <smueller@chronox.de> — Author. the icon, the legend, the one who wrote it fr fr 💖

---

🌈 COPYRIGHT 🌈

that's all she wrote — the copyright vibes belong to the libkcapi Manual, version 1.5.0, dated July 2025 ⭐

and that's the whole page, bestie 🎀 go forth and kcapi_cipher_init, remember your kcapi_cipher_destroy, and stay iconic ✨💅🦋