gnutls_hpke_export - API function

NAME SYNOPSIS ARGUMENTS DESCRIPTION RETURNS SINCE REPORTING BUGS COPYRIGHT SEE ALSO

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.

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.