gnutls_hpke_init(3) — Linux manual page

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURNS | SINCE | REPORTING BUGS | COPYRIGHT | SEE ALSO | COLOPHON

gnutls_hpke_init(3)               gnutls              gnutls_hpke_init(3)

NAME         top

       gnutls_hpke_init - API function

SYNOPSIS         top

       #include <gnutls/hpke.h>

       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);

ARGUMENTS         top

       gnutls_hpke_context_t * ctx
                   A pointer to the HPKE context to initialize.

       gnutls_hpke_mode_t mode
                   The HPKE mode to use (Base, PSK, Auth, or AuthPSK).

       gnutls_hpke_role_t role
                   The role of the context (Sender or Receiver).

       gnutls_hpke_kem_t kem
                   The KEM algorithm to use (e.g., DHKEM(X25519)).

       gnutls_hpke_kdf_t kdf
                   The KDF algorithm to use (e.g., HKDF-SHA256).

       gnutls_hpke_aead_t aead
                   The AEAD algorithm to use (e.g., AES-128-GCM).

DESCRIPTION         top

       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 gnutls_hpke_deinit() when
       it is no longer needed to free any allocated resources and
       securely erase sensitive information.

RETURNS         top

       0 on success, or a negative error code on failure

SINCE         top

       3.8.13

REPORTING BUGS         top

       Report bugs to <bugs@gnutls.org>.
       Home page: https://www.gnutls.org

COPYRIGHT         top

       Copyright © 2001-2023 Free Software Foundation, Inc., and others.
       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.

SEE ALSO         top

       The full documentation for gnutls is maintained as a Texinfo
       manual.  If the /usr/share/doc/gnutls/ directory does not contain
       the HTML form visit

       https://www.gnutls.org/manual/

COLOPHON         top

       This page is part of the GnuTLS (GnuTLS Transport Layer Security
       Library) project.  Information about the project can be found at
       ⟨http://www.gnutls.org/⟩.  If you have a bug report for this
       manual page, send it to bugs@gnutls.org.  This page was obtained
       from the tarball fetched from
       ⟨https://www.gnupg.org/ftp/gcrypt/gnutls/⟩ on 2026-05-24.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information
       in this COLOPHON (which is not part of the original manual page),
       send a mail to man-pages@man7.org

gnutls                            3.8.13              gnutls_hpke_init(3)