Linux Manuals session 3

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….

NAME gnutls_error_is_fatal – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_error_is_fatal(int error); ARGUMENTS int error is a GnuTLS error code, a negative error code DESCRIPTION If a GnuTLS function returns a negative error code you may feed that value to this function to see if the error condition is fatal to a TLS session (i.e., must…

NAME gnutls_ecc_curve_list – API function SYNOPSIS #include <gnutls/gnutls.h> const gnutls_ecc_curve_t * gnutls_ecc_curve_list( void); ARGUMENTS void DESCRIPTION Get the list of supported elliptic curves. This function is not thread safe. RETURNS Return a (0)-terminated list of gnutls_ecc_curve_t integers indicating the available curves. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright ©…

NAME gnutls_ecc_curve_get_size – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_ecc_curve_get_size(gnutls_ecc_curve_t curve); ARGUMENTS gnutls_ecc_curve_t curve is an ECC curve DESCRIPTION Returns the size in bytes of the curve. RETURNS a the size or (0). SINCE 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…

NAME gnutls_ecc_curve_get_name – API function SYNOPSIS #include <gnutls/gnutls.h> const char * gnutls_ecc_curve_get_name(gnutls_ecc_curve_t curve); ARGUMENTS gnutls_ecc_curve_t curve is an ECC curve DESCRIPTION Convert a gnutls_ecc_curve_t value to a string. RETURNS a string that contains the name of the specified curve or NULL. SINCE 3.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT…

NAME gnutls_ecc_curve_get – API function SYNOPSIS #include <gnutls/gnutls.h> gnutls_ecc_curve_t gnutls_ecc_curve_get(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Returns the currently used elliptic curve. Only valid when using an elliptic curve ciphersuite. RETURNS the currently used curve, a gnutls_ecc_curve_t type. SINCE 3.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT…

NAME gnutls_dtls_set_timeouts – API function SYNOPSIS #include <gnutls/dtls.h> void gnutls_dtls_set_timeouts(gnutls_session_t session, unsigned int retrans_timeout, unsigned int total_timeout); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. unsigned int retrans_timeout The time at which a retransmission will occur in milliseconds unsigned int total_timeout The time at which the connection will be aborted, in milliseconds. DESCRIPTION This function will…