gnutls_hpke_export(3)

Usage

#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.

Overview

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