bionic (3) gnutls_global_init.3.gz

Provided by: gnutls-doc_3.5.18-1ubuntu1.6_all bug

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_EXPLICIT_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.

       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: http://www.gnutls.org


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