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.
32
33       A  subsequent  call  of  this  function  if the initial has failed will
34       return the same error code.
35

RETURNS

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

REPORTING BUGS

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

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

SEE ALSO

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