dwww Home | Manual pages | Find package

gnutls_global_init(3)               gnutls               gnutls_global_init(3)

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 explic-
       itly 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  sup-
       ported  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  re-
       turn the same error code.

RETURNS
       On  success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative er-
       ror code is returned.

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 no-
       tice 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/

gnutls                               3.7.3               gnutls_global_init(3)

Generated by dwww version 1.14 on Sun Dec 29 18:26:21 CET 2024.