manpagez: man pages & more
man gnutls_global_init(3)
Home | html | info | man
gnutls_global_init(3)               gnutls               gnutls_global_init(3)




NAME

       gnutls_global_init - API function


SYNOPSIS

       #include <gnutls/gnutls.h>

       gnutls_global_init(3) 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_EXPLICIT_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(3).  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 (C) 2001-2020 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/




gnutls                              3.6.12               gnutls_global_init(3)

gnutls 3.6.12 - Generated Sun Feb 2 12:51:27 CST 2020
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.