.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "gnutls_hpke_init" 3 "3.8.13" "gnutls" "gnutls"
.SH NAME
gnutls_hpke_init \- API function
.SH SYNOPSIS
.B #include <gnutls/hpke.h>
.sp
.BI "int gnutls_hpke_init(gnutls_hpke_context_t * " ctx ", gnutls_hpke_mode_t " mode ", gnutls_hpke_role_t " role ", gnutls_hpke_kem_t " kem ", gnutls_hpke_kdf_t " kdf ", gnutls_hpke_aead_t " aead ");"
.SH ARGUMENTS
.IP "gnutls_hpke_context_t * ctx" 12
A pointer to the HPKE context to initialize.
.IP "gnutls_hpke_mode_t mode" 12
The HPKE mode to use (Base, PSK, Auth, or AuthPSK).
.IP "gnutls_hpke_role_t role" 12
The role of the context (Sender or Receiver).
.IP "gnutls_hpke_kem_t kem" 12
The KEM algorithm to use (e.g., DHKEM(X25519)).
.IP "gnutls_hpke_kdf_t kdf" 12
The KDF algorithm to use (e.g., HKDF\-SHA256).
.IP "gnutls_hpke_aead_t aead" 12
The AEAD algorithm to use (e.g., AES\-128\-GCM).
.SH "DESCRIPTION"
This function initializes the HPKE context with the specified parameters.
It allocates memory for the context and sets the initial values for the fields based on the provided parameters.

The context must be deinitialized using \fBgnutls_hpke_deinit()\fP when it
is no longer needed to free any allocated resources and securely erase sensitive information.
.SH "RETURNS"
0 on success, or a negative error code on failure
.SH "SINCE"
3.8.13
.SH "REPORTING BUGS"
Report bugs to <bugs@gnutls.org>.
.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