gnutls\_hpke\_derive\_keypair(3) gnutls gnutls\_hpke\_derive\_keypair(3)

# [NAME](#NAME)

gnutls\_hpke\_derive\_keypair - API function

# [SYNOPSIS](#SYNOPSIS)

**#include <gnutls/hpke.h>**

**int gnutls\_hpke\_derive\_keypair(gnutls\_hpke\_kem\_t kem, const gnutls\_datum\_t * ikm, gnutls\_privkey\_t privkey, gnutls\_pubkey\_t pubkey);**

# [ARGUMENTS](#ARGUMENTS)

[gnutls\_hpke\_kem\_t kem](#gnutls_hpke_kem_t)

The KEM algorithm to use for key pair generation.

[const gnutls\_datum\_t * ikm](#const)

A pointer to a gnutls\_datum\_t structure containing the input key material (IKM) to be used for key pair generation.

[gnutls\_privkey\_t privkey](#gnutls_privkey_t)

An initialized private key.

[gnutls\_pubkey\_t pubkey](#gnutls_pubkey_t)

An initialized public key.

# [DESCRIPTION](#DESCRIPTION)

This function derives a key pair (private key and public key) for the specified KEM algorithm from the provided input key material ( *ikm* ).

*ikm* is used as a seed for the key generation process, allowing for deterministic key pair generation if the same IKM is used. The function checks that the provided parameters are valid and that the KEM algorithm is supported.

*ikm* should be a non-empty byte string that serves as the seed for key pair generation.

# [RETURNS](#RETURNS)

0 on success, or a negative error code on failure

# [SINCE](#SINCE)

3.8.13

# [REPORTING BUGS](#REPORTING_BUGS)

Report bugs to <bugs@gnutls.org>.  
Home page: https://www.gnutls.org

# [COPYRIGHT](#COPYRIGHT)

Copyright © 2001-2023 Free Software Foundation, Inc., and others.  
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

# [SEE ALSO](#SEE_ALSO)

The full documentation for **gnutls** is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit

[https://www.gnutls.org/manual/](https://www.gnutls.org/manual/)

3.8.13 gnutls

---

Document: gnutls_hpke_derive_keypair(3) from gnutls 3.8.13-r3 (Chainguard OS)
Source: https://gitlab.com/gnutls/gnutls