gnutls_global_init(3)

1gnutls_global_init(3)               gnutls               gnutls_global_init(3)
2
3
4

NAME

6       gnutls_global_init - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       int gnutls_global_init( void);
12

ARGUMENTS

14        void
15

DESCRIPTION

17       This  function  performs any required precalculations, detects the sup‐
18       ported CPU capabilities and initializes  the  underlying  cryptographic
19       backend.  In  order to free any resources taken by this call you should
20       gnutls_global_deinit() when gnutls usage is no longer needed.
21
22       This    function    increments    a    global    counter,    so    that
23       gnutls_global_deinit()  only releases resources when it has been called
24       as many times as gnutls_global_init().  This is useful when  GnuTLS  is
25       used  by more than one library in an application.  This function can be
26       called many times, but will only do something the first time.
27
28       Since GnuTLS 3.3.0 this function is only required in  systems  that  do
29       not support library constructors and static linking. This function also
30       became thread safe.
31
32       A subsequent call of this function  if  the  initial  has  failed  will
33       return the same error code.
34

RETURNS

36       On  success,  GNUTLS_E_SUCCESS  [22m(0)  is  returned, otherwise a negative
37       error code is returned.
38

REPORTING BUGS

40       Report bugs to <bugs@gnutls.org>.
41       Home page: http://www.gnutls.org
42
43

COPYRIGHT

45       Copyright © 2001-2014 Free Software Foundation, Inc..
46       Copying and distribution of this file, with  or  without  modification,
47       are  permitted  in  any  medium  without royalty provided the copyright
48       notice and this notice are preserved.
49