gnutls_hpke_export - Man Page

API function

Synopsis

#include <gnutls/hpke.h>

int gnutls_hpke_export(gnutls_hpke_context_t ctx, const gnutls_datum_t * exporter_context, size_t length, gnutls_datum_t * secret);

Arguments

gnutls_hpke_context_t ctx

The HPKE context to use for exporting the secret.

const gnutls_datum_t * exporter_context

The application-specific context to be included in the export.

size_t length

The requested length in bytes of the secret to be exported.

gnutls_datum_t * secret

A pointer to a gnutls_datum_t structure where the exported secret will be stored.

Description

This function performs the export operation of HPKE. It derives a secret of  length bytes from the exporter secret in the HPKE context, using the provided application-specific context and the KDF specified in the context. The resulting secret is stored in
secret . The function checks that the provided parameters are valid and that the context is properly initialized and that there is an exporter secret available in the context.

length should be a positive integer that does not exceed the maximum allowed size for HPKE exports.

The function will allocate memory for  secret , and the caller is responsible for freeing this memory using gnutls_free() when it is no longer needed.

Returns

0 on success, or a negative error code on failure

Since

3.8.13

Reporting Bugs

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

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/

Info

3.8.13 gnutls