NAME

       gnutls_session_supplemental_register - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       int  gnutls_session_supplemental_register(gnutls_session_t  session,  const  char  * name,
       gnutls_supplemental_data_format_type_t     type,     gnutls_supp_recv_func      recv_func,
       gnutls_supp_send_func send_func, unsigned flags);

ARGUMENTS

       gnutls_session_t session
                   the session for which this will be registered

       const char * name
                   the name of the supplemental data to register

       gnutls_supplemental_data_format_type_t type
                   the type of the supplemental data format

       gnutls_supp_recv_func recv_func
                   the function to receive the data

       gnutls_supp_send_func send_func
                   the function to send the data

       unsigned flags
                   must be zero

DESCRIPTION

       This  function  will  register  a  new  supplemental  data type (rfc4680).  The registered
       supplemental functions will be used for that specific session. The provided  type must  be
       an unassigned type in gnutls_supplemental_data_format_type_t.

       If    the    type    is    already    registered   or   handled   by   GnuTLS   internally
       GNUTLS_E_ALREADY_REGISTERED will be returned.

       As supplemental data are not defined under TLS 1.3, this function  will  disable  TLS  1.3
       support for the given session.

RETURNS

       GNUTLS_E_SUCCESS on success, otherwise a negative error code.

SINCE

       3.5.5

REPORTING BUGS

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

COPYRIGHT

       Copyright © 2001- 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

       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/