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_IMPLICIT_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  re‐
35       turn the same error code.
36

RETURNS

38       On  success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative er‐
39       ror 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-2023 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 no‐
50       tice 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.8.2               gnutls_global_init(3)
Impressum