SysTutorials Posts

NAME gnutls_handshake_get_last_out – API function SYNOPSIS #include <gnutls/gnutls.h> gnutls_handshake_description_t gnutls_handshake_get_last_out(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function is only useful to check where the last performed handshake failed. If the previous handshake succeed or was not performed at all then no meaningful value will be returned. Check gnutls_handshake_description_t in gnutls.h for…

NAME gnutls_handshake_get_last_in – API function SYNOPSIS #include <gnutls/gnutls.h> gnutls_handshake_description_t gnutls_handshake_get_last_in(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function is only useful to check where the last performed handshake failed. If the previous handshake succeed or was not performed at all then no meaningful value will be returned. Check gnutls_handshake_description_t in gnutls.h for…

NAME gnutls_handshake_description_get_name – API function SYNOPSIS #include <gnutls/gnutls.h> const char * gnutls_handshake_description_get_name(gnutls_handshake_description_t type); ARGUMENTS gnutls_handshake_description_t type is a handshake message description DESCRIPTION Convert a gnutls_handshake_description_t value to a string. RETURNS a string that contains the name of the specified handshake message or NULL. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT…

NAME gnutls_handshake – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_handshake(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function does the handshake of the TLS/SSL protocol, and initializes the TLS connection. This function will fail if any problem is encountered, and will return a negative error code. In case of a client, if…

NAME gnutls_global_set_time_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_global_set_time_function(gnutls_time_func time_func); ARGUMENTS gnutls_time_func time_func it’s the system time function, a gnutls_time_func() callback. DESCRIPTION This is the function where you can override the default system time function. The application provided function should behave the same as the standard function. SINCE 2.12.0 REPORTING BUGS Report bugs to…

NAME gnutls_global_set_mutex – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_global_set_mutex(mutex_init_func init, mutex_deinit_func deinit, mutex_lock_func lock, mutex_unlock_func unlock); ARGUMENTS mutex_init_func init mutex initialization function mutex_deinit_func deinit mutex deinitialization function mutex_lock_func lock mutex locking function mutex_unlock_func unlock mutex unlocking function DESCRIPTION With this function you are allowed to override the default mutex locks used in some parts…

NAME gnutls_global_set_mem_functions – API function SYNOPSIS #include <gnutls/compat.h> void gnutls_global_set_mem_functions(gnutls_alloc_function alloc_func, gnutls_alloc_function secure_alloc_func, gnutls_is_secure_function is_secure_func, gnutls_realloc_function realloc_func, gnutls_free_function free_func); ARGUMENTS gnutls_alloc_function alloc_func it’s the default memory allocation function. Like malloc(). gnutls_alloc_function secure_alloc_func This is the memory allocation function that will be used for sensitive data. gnutls_is_secure_function is_secure_func a function that returns 0 if the memory…

NAME gnutls_global_set_log_level – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_global_set_log_level(int level); ARGUMENTS int level it’s an integer from 0 to 99. DESCRIPTION This is the function that allows you to set the log level. The level is an integer between 0 and 9. Higher values mean more verbosity. The default value is 0. Larger values…

NAME gnutls_global_set_log_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_global_set_log_function(gnutls_log_func log_func); ARGUMENTS gnutls_log_func log_func it’s a log function DESCRIPTION This is the function where you set the logging function gnutls is going to use. This function only accepts a character array. Normally you may not use this function since it is only used for debugging…

NAME gnutls_global_set_audit_log_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_global_set_audit_log_function(gnutls_audit_log_func log_func); ARGUMENTS gnutls_audit_log_func log_func it is the audit log function DESCRIPTION This is the function to set the audit logging function. This is a function to report important issues, such as possible attacks in the protocol. This is different from gnutls_global_set_log_function() because it will report…

NAME gnutls_global_init_extra – initializes the global state of gnutls-extra SYNOPSIS #include <gnutls/extra.h> int gnutls_global_init_extra( void); ARGUMENTS void DESCRIPTION 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…

NAME gnutls_global_init – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_global_init( void); ARGUMENTS void DESCRIPTION This function performs any required precalculations, detects the supported 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…

NAME gnutls_global_deinit – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_global_deinit( void); ARGUMENTS void DESCRIPTION This function deinitializes the global data, that were initialized using gnutls_global_init(). REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution of this file, with or without modification, are…

NAME gnutls_free – Returns a free() like function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_free(void * ptr); ARGUMENTS void * ptr DESCRIPTION This function will free data pointed by ptr. The deallocation function used is the one set by gnutls_global_set_mem_functions(). REPORTING BUGS Report bugs to <bug-gnutls [at] gnu.org>. GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software:…

NAME gnutls_fips140_mode_enabled – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_fips140_mode_enabled( void); ARGUMENTS void DESCRIPTION Checks whether this library is in FIPS140 mode. RETURNS return non-zero if true or zero if false. SINCE 3.3.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution…

NAME gnutls_fingerprint – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_fingerprint(gnutls_digest_algorithm_t algo, const gnutls_datum_t * data, void * result, size_t * result_size); ARGUMENTS gnutls_digest_algorithm_t algo is a digest algorithm const gnutls_datum_t * data is the data void * result is the place where the result will be copied (may be null). size_t * result_size should hold…

NAME gnutls_extra_check_version – checks the libgnutls-extra version SYNOPSIS #include <gnutls/extra.h> const char * gnutls_extra_check_version(const char * req_version); ARGUMENTS const char * req_version version string to compare with, or NULL. DESCRIPTION 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…

NAME gnutls_ext_register – Register a handler for a TLS extension SYNOPSIS #include <gnutls/gnutls.h> int gnutls_ext_register(int type, const char * name, gnutls_ext_parse_type_t parse_type, gnutls_ext_recv_func recv_func, gnutls_ext_send_func send_func); ARGUMENTS int type the 16-bit integer referring to the extension type const char * name human printable name of the extension used for debugging gnutls_ext_parse_type_t parse_type either GNUTLS_EXT_TLS or…

NAME gnutls_est_record_overhead_size – API function SYNOPSIS #include <gnutls/gnutls.h> size_t gnutls_est_record_overhead_size(gnutls_protocol_t version, gnutls_cipher_algorithm_t cipher, gnutls_mac_algorithm_t mac, gnutls_compression_method_t comp, unsigned int flags); ARGUMENTS gnutls_protocol_t version is a gnutls_protocol_t value gnutls_cipher_algorithm_t cipher is a gnutls_cipher_algorithm_t value gnutls_mac_algorithm_t mac is a gnutls_mac_algorithm_t value gnutls_compression_method_t comp is a gnutls_compression_method_t value unsigned int flags must be zero DESCRIPTION This function will…

NAME gnutls_error_to_alert – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_error_to_alert(int err, int * level); ARGUMENTS int err is a negative integer int * level the alert level will be stored there DESCRIPTION Get an alert depending on the error code returned by a gnutls function. All alerts sent by this function should be considered fatal….