9.3 GnuTLS-extra Functions

These functions are only available in the GPLv3+ version of the library called gnutls-extra. The prototypes for this library lie in ‘gnutls/extra.h’.

gnutls_extra_check_version

Function: const char * gnutls_extra_check_version (const char * req_version)

req_version: version string to compare with, or NULL.

Check GnuTLS Extra Library version.

See GNUTLS_EXTRA_VERSION for a suitable req_version string.

Return value: Check that the version of the library is at minimum the one given as a string in req_version and return the actual version string of the library; return NULL if the condition is not met. If NULL is passed to this function no check is done and only the version string is returned.

gnutls_global_init_extra

Function: int gnutls_global_init_extra ( void)

This function initializes the global state of gnutls-extra library to defaults.

Note that gnutls_global_init() has to be called before this function. If this function is not called then the gnutls-extra library will not be usable.

This function is not thread safe, see the discussion for gnutls_global_init() on how to deal with that.

Returns: On success, GNUTLS_E_SUCCESS (zero) is returned, otherwise an error code is returned.