| 1 |
|
| 2 |
|
| 3 |
|
| 4 |
|
| 5 |
@deftypefun {int} {gnutls_hpke_init} (gnutls_hpke_context_t * @var{ctx}, gnutls_hpke_mode_t @var{mode}, gnutls_hpke_role_t @var{role}, gnutls_hpke_kem_t @var{kem}, gnutls_hpke_kdf_t @var{kdf}, gnutls_hpke_aead_t @var{aead}) |
| 6 |
@var{ctx}: A pointer to the HPKE context to initialize. |
| 7 |
|
| 8 |
@var{mode}: The HPKE mode to use (Base, PSK, Auth, or AuthPSK). |
| 9 |
|
| 10 |
@var{role}: The role of the context (Sender or Receiver). |
| 11 |
|
| 12 |
@var{kem}: The KEM algorithm to use (e.g., DHKEM(X25519)). |
| 13 |
|
| 14 |
@var{kdf}: The KDF algorithm to use (e.g., HKDF-SHA256). |
| 15 |
|
| 16 |
@var{aead}: The AEAD algorithm to use (e.g., AES-128-GCM). |
| 17 |
|
| 18 |
This function initializes the HPKE context with the specified parameters. |
| 19 |
It allocates memory for the context and sets the initial values for the fields based on the provided parameters. |
| 20 |
|
| 21 |
The context must be deinitialized using @code{gnutls_hpke_deinit()} when it |
| 22 |
is no longer needed to free any allocated resources and securely erase sensitive information. |
| 23 |
|
| 24 |
@strong{Returns:} 0 on success, or a negative error code on failure |
| 25 |
|
| 26 |
@strong{Since:} 3.8.13 |
| 27 |
@end deftypefun |