crypto_kpp_set_secret(9)

💅 crypto_kpp_set_secret(9) — like, the Kernel API Manual edition 🎀

okay bestie, so this is crypto_kpp_set_secret from the Kernel API Manual, and it's literally the function that hands your private key over to a KPP implementation. she's giving ✨key delivery✨ and honestly? iconic.

---

🦋 NAME 🦋

crypto_kpp_set_secret — Invoke kpp operation

no cap, that's the whole vibe: you invoke a kpp operation. periodt.

---

🌸 SYNOPSIS 🌸

int crypto_kpp_set_secret (struct crypto_kpp *tfm , const void *buffer ,
unsigned int len );

she takes three things and gives you back an int, we love a simple queen 💅

---

🎀 ARGUMENTS 🎀

• tfm — the tfm handle. that's your transform handle, your main character, the whole reason we're here 🫶
• buffer — the Buffer holding the packet representation of the private key. and like, lowkey important: the structure of the packet key depends on the particular KPP implementation. Packing and unpacking helpers are provided for ECDH and DH — see the respective header files for those implementations, iykyk ✨
• len — Length of the packet private key buffer. just the length bestie, don't overthink it 🍓

---

💖 DESCRIPTION 💖

Function invokes the specific kpp operation for a given alg.

that's it, that's the tea ☕ she looks at your tfm, figures out which alg you're running, and invokes the specific kpp operation for it. literally just passing the vibe check through to the right implementation 💫

---

⭐ RETURN ⭐

zero on success; error code in case of error

so like, 0 = slay, anything else = 😭 read the error code and go fix it. no in-between.

ngl, always check the return value. "error code in case of error" is the manpage equivalent of "the vibes will tell you" — she will not elaborate further 💀

---

🌈 SEE ALSO 🌈

• Kernel file ./include/crypto/kpp.h
• struct kpp_request(9)
• struct crypto_kpp(9)
• struct kpp_alg(9)
• Generic Key-agreement Protocol Primitives API(9)
• crypto_alloc_kpp(9)
• crypto_free_kpp(9)
• kpp_request_alloc(9)
• kpp_request_free(9)
• kpp_request_set_callback(9)
• kpp_request_set_input(9)
• kpp_request_set_output(9)
• struct kpp_secret(9)
• crypto_kpp_generate_public_key(9)
• crypto_kpp_compute_shared_secret(9)
• crypto_kpp_maxsize(9)

---

and that's the whole page bestie, go read the friends, they're all linked above 🧚

sign-off time 🎀 this one lives in ./include/crypto, dated October 2026, and it's the crypto_kpp_set_secret(9) page — mwah, catch you in the next manpage 💜