NAME

       gnutls_global_init - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       int gnutls_global_init( void);

ARGUMENTS

        void

DESCRIPTION

       Since  GnuTLS  3.3.0  this  function  is  no  longer necessary to be explicitly called. To
       disable the implicit call (in a library constructor) of this function set the  environment
       variable GNUTLS_NO_IMPLICIT_INIT to 1.

       This   function   performs   any  required  precalculations,  detects  the  supported  CPU
       capabilities and initializes the underlying cryptographic backend. In order  to  free  any
       resources  taken  by  this  call you should gnutls_global_deinit() when gnutls usage is no
       longer needed.

       This function increments a global counter, so that  gnutls_global_deinit()  only  releases
       resources  when  it has been called as many times as gnutls_global_init().  This is useful
       when GnuTLS is used by more than one library in an  application.   This  function  can  be
       called  many  times,  but  will  only do something the first time. It is thread safe since
       GnuTLS 3.3.0.

       A subsequent call of this function if the initial has failed will return  the  same  error
       code.

RETURNS

       On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error code is returned.

REPORTING BUGS

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

COPYRIGHT

       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

       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/