Blame doc/functions/gnutls_global_init

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_global_init} ( @var{void})
Packit Service 4684c1
Packit Service 4684c1
Since GnuTLS 3.3.0 this function is no longer necessary to be explicitly
Packit Service 4684c1
called. To disable the implicit call (in a library constructor) of this
Packit Service 4684c1
function set the environment variable @code{GNUTLS_NO_EXPLICIT_INIT}  to 1.
Packit Service 4684c1
Packit Service 4684c1
This function performs any required precalculations, detects
Packit Service 4684c1
the supported CPU capabilities and initializes the underlying
Packit Service 4684c1
cryptographic backend. In order to free any resources 
Packit Service 4684c1
taken by this call you should @code{gnutls_global_deinit()}  
Packit Service 4684c1
when gnutls usage is no longer needed.
Packit Service 4684c1
Packit Service 4684c1
This function increments a global counter, so that
Packit Service 4684c1
@code{gnutls_global_deinit()}  only releases resources when it has been
Packit Service 4684c1
called as many times as @code{gnutls_global_init()} .  This is useful when
Packit Service 4684c1
GnuTLS is used by more than one library in an application.  This
Packit Service 4684c1
function can be called many times, but will only do something the
Packit Service 4684c1
first time. It is thread safe since GnuTLS 3.3.0.
Packit Service 4684c1
Packit Service 4684c1
A subsequent call of this function if the initial has failed will
Packit Service 4684c1
return the same error code.
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned,
Packit Service 4684c1
otherwise a negative error code is returned.
Packit Service 4684c1
@end deftypefun