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       Since  GnuTLS  3.3.0 this function is no longer necessary to be explic‐
18       itly called. To disable the implicit call (in a library constructor) of
19       this  function  set the environment variable GNUTLS_NO_EXPLICIT_INIT to
20       1.
21
22       This function performs any required precalculations, detects  the  sup‐
23       ported  CPU  capabilities  and initializes the underlying cryptographic
24       backend. In order to free any resources taken by this call  you  should
25       gnutls_global_deinit() when gnutls usage is no longer needed.
26
27       This    function    increments    a    global    counter,    so    that
28       gnutls_global_deinit() only releases resources when it has been  called
29       as  many  times as gnutls_global_init().  This is useful when GnuTLS is
30       used by more than one library in an application.  This function can  be
31       called  many  times,  but  will only do something the first time. It is
32       thread safe since GnuTLS 3.3.0.
33
34       A subsequent call of this function  if  the  initial  has  failed  will
35       return the same error code.
36

RETURNS

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

REPORTING BUGS

42       Report bugs to <bugs@gnutls.org>.
43       Home page: https://www.gnutls.org
44
45

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

SEE ALSO

53       The full documentation for gnutls is maintained as  a  Texinfo  manual.
54       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
55       visit
56
57       https://www.gnutls.org/manual/
58
59gnutls                              3.6.13               gnutls_global_init(3)
Impressum