SuSE 11.3 - man page for gnutls_global_init (suse section 3)
|Linux & Unix Commands - Search Man Pages
gnutls_global_init(3) gnutls gnutls_global_init(3)
gnutls_global_init - initialize the global data to defaults.
int gnutls_global_init( void);
This function initializes the global data to defaults. Every gnutls application has a
global data which holds common parameters shared by gnutls session structures. You should
call gnutls_global_deinit() when gnutls usage is no longer needed
Note that this function will also initialize libgcrypt, if it has not been initialized
before. Thus if you want to manually initialize libgcrypt you must do it before calling
this function. This is useful in cases you want to disable libgcrypt's internal lockings
This function increment 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.
Note! This function is not thread safe. If two threads call this function simultane-
ously, they can cause a race between checking the global counter and incrementing it,
causing both threads to execute the library initialization code. That would lead to a
memory leak. To handle this, your application could invoke this function after aquiring a
thread mutex. To ignore the potential memory leak is also an option.
On success, GNUTLS_E_SUCCESS (zero) is returned, otherwise an error code is returned.
Report bugs to <firstname.lastname@example.org>. GnuTLS home page: http://www.gnu.org/soft-
ware/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/
Copyright (C) 2008 Free Software Foundation.
Copying and distribution of this file, with or without modification, are permitted in any
medium without royalty provided the copyright notice and this notice are preserved.
The full documentation for gnutls is maintained as a Texinfo manual. If the info and
gnutls programs are properly installed at your site, the command
should give you access to the complete manual.
gnutls 2.8.6 gnutls_global_init(3)
All times are GMT -4. The time now is 12:35 PM.