.\" DO NOT MODIFY THIS FILE! It was generated by gdoc. .TH "gnutls_hpke_export" 3 "3.8.13" "gnutls" "gnutls" .SH NAME gnutls_hpke_export \- API function .SH SYNOPSIS .B #include .sp .BI "int gnutls_hpke_export(gnutls_hpke_context_t " ctx ", const gnutls_datum_t * " exporter_context ", size_t " length ", gnutls_datum_t * " secret ");" .SH ARGUMENTS .IP "gnutls_hpke_context_t ctx" 12 The HPKE context to use for exporting the secret. .IP "const gnutls_datum_t * exporter_context" 12 The application\-specific context to be included in the export. .IP "size_t length" 12 The requested length in bytes of the secret to be exported. .IP "gnutls_datum_t * secret" 12 A pointer to a gnutls_datum_t structure where the exported secret will be stored. .SH "DESCRIPTION" This function performs the export operation of HPKE. It derives a secret of \fIlength\fP 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 \fIsecret\fP . 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. \fIlength\fP should be a positive integer that does not exceed the maximum allowed size for HPKE exports. The function will allocate memory for \fIsecret\fP , and the caller is responsible for freeing this memory using \fBgnutls_free()\fP when it is no longer needed. .SH "RETURNS" 0 on success, or a negative error code on failure .SH "SINCE" 3.8.13 .SH "REPORTING BUGS" Report bugs to . .br Home page: https://www.gnutls.org .SH COPYRIGHT Copyright \(co 2001-2023 Free Software Foundation, Inc., and others. .br 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. .SH "SEE ALSO" The full documentation for .B gnutls is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit .B .IP https://www.gnutls.org/manual/ .PP