NAME

       gnutls_init - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       int gnutls_init(gnutls_session_t * session, unsigned int flags);

ARGUMENTS

       gnutls_session_t * session
                   is a pointer to a gnutls_session_t type.

       unsigned int flags
                   indicate if this session is to be used for server or client.

DESCRIPTION

       This  function  initializes the current session to null. Every session must be initialized before use, so
       internal structures can be allocated.  This function allocates structures which can  only  be  free'd  by
       calling gnutls_deinit().  Returns GNUTLS_E_SUCCESS (0) on success.

        flags  can  be  one of GNUTLS_CLIENT, GNUTLS_SERVER, GNUTLS_DATAGRAM, GNUTLS_NONBLOCK or GNUTLS_NOSIGNAL
       (since 3.4.2).

       The flag GNUTLS_NO_REPLAY_PROTECTION will disable any replay protection in DTLS mode. That must only used
       when replay protection is achieved using other means.

       Note  that  since  version 3.1.2 this function enables some common TLS extensions such as session tickets
       and  OCSP  certificate  status  request  in  client  side  by  default.   To   prevent   that   use   the
       GNUTLS_NO_EXTENSIONS flag.

RETURNS

       GNUTLS_E_SUCCESS on success, or an error code.

REPORTING BUGS

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

COPYRIGHT

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

       http://www.gnutls.org/manual/