Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_global_init(3)		    gnutls		 gnutls_global_init(3)

NAME
       gnutls_global_init - API	function

SYNOPSIS
       #include	<gnutls/gnutls.h>

       int gnutls_global_init( void);

ARGUMENTS
	void

DESCRIPTION
       Since  GnuTLS  3.3.0 this function is no	longer necessary to be explic-
       itly called. To disable the implicit call (in a library constructor) of
       this function set the environment variable  GNUTLS_NO_IMPLICIT_INIT  to
       1.

       This  function  performs	any required precalculations, detects the sup-
       ported CPU capabilities and initializes	the  underlying	 cryptographic
       backend.	 In  order to free any resources taken by this call you	should
       gnutls_global_deinit() when gnutls usage	is no longer needed.

       This    function	   increments	 a    global	counter,    so	  that
       gnutls_global_deinit()  only releases resources when it has been	called
       as many times as	gnutls_global_init().  This is useful when  GnuTLS  is
       used  by	more than one library in an application.  This function	can be
       called many times, but will only	do something the  first	 time.	It  is
       thread safe since GnuTLS	3.3.0.

       A  subsequent  call of this function if the initial has failed will re-
       turn the	same error code.

RETURNS
       On success, GNUTLS_E_SUCCESS (0)	is returned, otherwise a negative  er-
       ror code	is returned.

REPORTING BUGS
       Report bugs to <bugs@gnutls.org>.
       Home page: https://www.gnutls.org

COPYRIGHT
       Copyright (C) 2001-2023 Free Software Foundation, Inc., and others.
       Copying	and  distribution  of this file, with or without modification,
       are permitted in	any medium without royalty provided the	copyright  no-
       tice and	this notice are	preserved.

SEE ALSO
       The  full  documentation	 for gnutls is maintained as a Texinfo manual.
       If the /usr/local/share/doc/gnutls/ directory does not contain the HTML
       form visit

       https://www.gnutls.org/manual/

gnutls				     3.8.9		 gnutls_global_init(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_global_init&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help