gnutls_privkey_derive_secret(3)

gnutls_privkey_derive_secret3

Api function

Usage

#include <gnutls/abstract.h>

int gnutls_privkey_derive_secret(gnutls_privkey_t privkey, gnutls_pubkey_t pubkey, const gnutls_datum_t * nonce, gnutls_datum_t * secret, unsigned int flags);

Arguments

gnutls_privkey_t privkey

a private key of type gnutls_privkey_t

gnutls_pubkey_t pubkey

a public key of type gnutls_pubkey_t

const gnutls_datum_t * nonce

an optional nonce value

gnutls_datum_t * secret

where shared secret will be stored

unsigned int flags

must be zero

Overview

This function will calculate a shared secret from our privkey and peer's pubkey . The result will be stored in secret , whose data member should be freed after use using gnutls_free(). privkey and
pubkey must be backed by the X.509 keys.

Returns

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value.

Since

3.8.2

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

Reporting bugs

Report bugs to <[email protected]>.
Home page: https://www.gnutls.org

From gnutls 3.8.13-3 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.