KCAPI_KPP_SSGEN(3)

📦
version 1.5.0 · 7 versions
, in fedora 43

✨ KCAPI_KPP_SSGEN(3) ✨

okay bestie, welcome to the Programming Interface corner of the libkcapi universe 💖 this is the page for kcapi_kpp_ssgen, and it is literally the "let's make a shared secret together" function. no cap.

🌸 NAME 🌸

kcapi_kpp_ssgen — generate a shared secret

🎀 SYNOPSIS 🎀

ssize_t kcapi_kpp_ssgen(struct kcapi_handle * handle,
                        const uint8_t * pubkey, size_t pubkeylen,
                        uint8_t * ss, size_t sslen, int access);

🦋 ARGUMENTS 🦋

  • handle — [in] the cipher handle. your main character. 🫶
  • pubkey — [in] public key of peer that shall be used to generate the shared secret with. yes, the peer's key — you're doing this together, it's giving collaborative. 💅
  • pubkeylen — [in] length of the public key buffer
  • ss — [out]</out> generated shared secret. this is where the magic lands, bestie. ✨
  • sslen — [in] length of key buffer
  • access — [in] kernel access type. pick your vibe:
    • KCAPI_ACCESS_HEURISTIC — use internal heuristic for fastest kernel access 🏎️
    • KCAPI_ACCESS_VMSPLICE — use vmsplice access
    • KCAPI_ACCESS_SENDMSG — sendmsg access

🔥 DESCRIPTION 🔥

so here's the tea ☕ — this returns the number of bytes returned by the shared secret generation operation upon success; a negative errno-style error code if an error occurred. like, if it works you get a happy little byte count, and if it doesn't you get a negative errno-style error code. periodt. 👑

👑 AUTHOR 👑

Stephan Mueller <smueller@chronox.de>

  • Author.

libkcapi Manual 1.5.0 🌈 July 2025 — and that's the whole page, bestie! go forth and generate shared secrets responsibly, mwah 💋🎀

📦 where this page comes from