Author: Linux Manual

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…

NAME gnutls_dtls_set_mtu – API function SYNOPSIS #include <gnutls/dtls.h> void gnutls_dtls_set_mtu(gnutls_session_t session, unsigned int mtu); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. unsigned int mtu The maximum transfer unit of the transport DESCRIPTION This function will set the maximum transfer unit of the transport that DTLS packets are sent over. Note that this should exclude the…

NAME gnutls_dtls_set_data_mtu – API function SYNOPSIS #include <gnutls/dtls.h> int gnutls_dtls_set_data_mtu(gnutls_session_t session, unsigned int mtu); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. unsigned int mtu The maximum unencrypted transfer unit of the session DESCRIPTION This function will set the maximum size of the *unencrypted* records which will be sent over a DTLS session. It is equivalent…

NAME gnutls_dtls_prestate_set – API function SYNOPSIS #include <gnutls/dtls.h> void gnutls_dtls_prestate_set(gnutls_session_t session, gnutls_dtls_prestate_st * prestate); ARGUMENTS gnutls_session_t session a new session gnutls_dtls_prestate_st * prestate contains the client’s prestate DESCRIPTION This function will associate the prestate acquired by the cookie authentication with the client, with the newly established session. This functions must be called after a successful…

NAME gnutls_dtls_get_timeout – API function SYNOPSIS #include <gnutls/dtls.h> unsigned int gnutls_dtls_get_timeout(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function will return the milliseconds remaining for a retransmission of the previously sent handshake message. This function is useful when DTLS is used in non-blocking mode, to estimate when to call gnutls_handshake() if no…

NAME gnutls_dtls_get_mtu – API function SYNOPSIS #include <gnutls/dtls.h> unsigned int gnutls_dtls_get_mtu(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function will return the MTU size as set with gnutls_dtls_set_mtu(). This is not the actual MTU of data you can transmit. Use gnutls_dtls_get_data_mtu() for that reason. RETURNS the set maximum transfer unit. SINCE 3.0…

NAME gnutls_dtls_get_data_mtu – API function SYNOPSIS #include <gnutls/dtls.h> unsigned int gnutls_dtls_get_data_mtu(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function will return the actual maximum transfer unit for application data. I.e. DTLS headers are subtracted from the actual MTU which is set using gnutls_dtls_set_mtu(). RETURNS the maximum allowed transfer unit. SINCE 3.0 REPORTING…