---
name: "kcapi_kpp_ssgen"
section: "3"
platform: "linux"
package: "libkcapi-dev"
version: "1.4.0-1+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/kcapi_kpp_ssgen"
---

# kcapi\_kpp\_ssgen(3)

generate a shared secret

## 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\] cipher handle

*pubkey*

\[in\] public key of peer that shall be used to generate the shared secret with

*pubkeylen*

\[in\] length of the public key buffer

*ss*

\[out\] generated shared secret

*sslen*

\[in\] length of key buffer

*access*

\[in\] kernel access type (KCAPI\_ACCESS\_HEURISTIC - use internal heuristic for fastest kernel access; KCAPI\_ACCESS\_VMSPLICE - use vmsplice access; KCAPI\_ACCESS\_SENDMSG - sendmsg access)

## DESCRIPTION

*return* number of bytes returned by the shared secret generation operation upon success; a negative errno-style error code if an error occurred

## AUTHOR

**Stephan Mueller** \<smueller@chronox.de\>

Author.

## COPYRIGHT