Linux Manuals session 3

NAME gnutls_ia_free_client_credentials – Used to free an allocated #gnutls_ia_client_credentials_t structure SYNOPSIS #include <gnutls/extra.h> void gnutls_ia_free_client_credentials(gnutls_ia_client_credentials_t sc); ARGUMENTS gnutls_ia_client_credentials_t sc is a gnutls_ia_client_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to free (deallocate) it. REPORTING BUGS Report bugs to <bug-gnutls [at] gnu.org>. GnuTLS home page:…

NAME gnutls_ia_extract_inner_secret – API function SYNOPSIS #include <gnutls/extra.h> void gnutls_ia_extract_inner_secret(gnutls_session_t session, char * buffer); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. char * buffer pre-allocated buffer to hold 48 bytes of inner secret. DESCRIPTION Copy the 48 bytes large inner secret into the specified buffer This function is typically used after the TLS/IA handshake has…

NAME gnutls_ia_endphase_send – API function SYNOPSIS #include <gnutls/extra.h> int gnutls_ia_endphase_send(gnutls_session_t session, int final_p); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. int final_p Set iff this should signal the final phase. DESCRIPTION Send a TLS/IA end phase message. In the client, this should only be used to acknowledge an end phase message sent by the server….

NAME gnutls_ia_enable – Indicate willingness for TLS/IA application phases SYNOPSIS #include <gnutls/extra.h> void gnutls_ia_enable(gnutls_session_t session, int allow_skip_on_resume); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. int allow_skip_on_resume non-zero if local party allows to skip the TLS/IA application phases for a resumed session. DESCRIPTION Specify whether we must advertise support for the TLS/IA extension during the handshake….

NAME gnutls_ia_allocate_server_credentials – Used to allocate an gnutls_ia_server_credentials_t structure SYNOPSIS #include <gnutls/extra.h> int gnutls_ia_allocate_server_credentials(gnutls_ia_server_credentials_t * sc); ARGUMENTS gnutls_ia_server_credentials_t * sc is a pointer to a gnutls_ia_server_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. Adding this credential to a session will enable…

NAME gnutls_ia_allocate_client_credentials – Used to allocate an gnutls_ia_server_credentials_t structure SYNOPSIS #include <gnutls/extra.h> int gnutls_ia_allocate_client_credentials(gnutls_ia_client_credentials_t * sc); ARGUMENTS gnutls_ia_client_credentials_t * sc is a pointer to a gnutls_ia_server_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. Adding this credential to a session will enable…

NAME gnutls_hmac_set_nonce – API function SYNOPSIS #include <gnutls/crypto.h> void gnutls_hmac_set_nonce(gnutls_hmac_hd_t handle, const void * nonce, size_t nonce_len); ARGUMENTS gnutls_hmac_hd_t handle is a gnutls_cipher_hd_t structure. const void * nonce the data to set as nonce size_t nonce_len The length of data DESCRIPTION This function will set the nonce in the MAC algorithm. SINCE 3.2.0 REPORTING BUGS…

NAME gnutls_hmac_output – API function SYNOPSIS #include <gnutls/crypto.h> void gnutls_hmac_output(gnutls_hmac_hd_t handle, void * digest); ARGUMENTS gnutls_hmac_hd_t handle is a gnutls_hmac_hd_t structure. void * digest is the output value of the MAC DESCRIPTION This function will output the current MAC value and reset the state of the MAC. SINCE 2.10.0 REPORTING BUGS Report bugs to <bugs…

NAME gnutls_hmac_init – API function SYNOPSIS #include <gnutls/crypto.h> int gnutls_hmac_init(gnutls_hmac_hd_t * dig, gnutls_mac_algorithm_t algorithm, const void * key, size_t keylen); ARGUMENTS gnutls_hmac_hd_t * dig is a gnutls_hmac_hd_t structure. gnutls_mac_algorithm_t algorithm the HMAC algorithm to use const void * key The key to be used for encryption size_t keylen The length of the key DESCRIPTION This…

NAME gnutls_hmac_get_len – API function SYNOPSIS #include <gnutls/crypto.h> int gnutls_hmac_get_len(gnutls_mac_algorithm_t algorithm); ARGUMENTS gnutls_mac_algorithm_t algorithm the hmac algorithm to use DESCRIPTION This function will return the length of the output data of the given hmac algorithm. RETURNS The length or zero on error. SINCE 2.10.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org…

NAME gnutls_hmac_fast – API function SYNOPSIS #include <gnutls/crypto.h> int gnutls_hmac_fast(gnutls_mac_algorithm_t algorithm, const void * key, size_t keylen, const void * text, size_t textlen, void * digest); ARGUMENTS gnutls_mac_algorithm_t algorithm the hash algorithm to use const void * key the key to use size_t keylen The length of the key const void * text the data…

NAME gnutls_hmac_deinit – API function SYNOPSIS #include <gnutls/crypto.h> void gnutls_hmac_deinit(gnutls_hmac_hd_t handle, void * digest); ARGUMENTS gnutls_hmac_hd_t handle is a gnutls_hmac_hd_t structure. void * digest is the output value of the MAC DESCRIPTION This function will deinitialize all resources occupied by the given hmac context. SINCE 2.10.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home…

NAME gnutls_hmac – API function SYNOPSIS #include <gnutls/crypto.h> int gnutls_hmac(gnutls_hmac_hd_t handle, const void * text, size_t textlen); ARGUMENTS gnutls_hmac_hd_t handle is a gnutls_cipher_hd_t structure. const void * text the data to hash size_t textlen The length of data to hash DESCRIPTION This function will hash the given data using the algorithm specified by the context….

NAME gnutls_hex_encode – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_hex_encode(const gnutls_datum_t * data, char * result, size_t * result_size); ARGUMENTS const gnutls_datum_t * data contain the raw data char * result the place where hex data will be copied size_t * result_size holds the size of the result DESCRIPTION This function will convert the given…

NAME gnutls_hex_decode – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_hex_decode(const gnutls_datum_t * hex_data, void * result, size_t * result_size); ARGUMENTS const gnutls_datum_t * hex_data contain the encoded data void * result the place where decoded data will be copied size_t * result_size holds the size of the result DESCRIPTION This function will decode the given…

NAME gnutls_hex2bin – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_hex2bin(const char * hex_data, size_t hex_size, void * bin_data, size_t * bin_size); ARGUMENTS const char * hex_data string with data in hex format size_t hex_size size of hex data void * bin_data output array with binary data size_t * bin_size when calling should hold maximum size…

NAME gnutls_heartbeat_set_timeouts – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_heartbeat_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_heartbeat_pong – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_heartbeat_pong(gnutls_session_t session, unsigned int flags); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. unsigned int flags should be zero DESCRIPTION This function replies to a ping by sending a pong to the peer. RETURNS GNUTLS_E_SUCCESS on success, otherwise a negative error code. SINCE 3.1.2 REPORTING BUGS Report…

NAME gnutls_heartbeat_ping – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_heartbeat_ping(gnutls_session_t session, size_t data_size, unsigned int max_tries, unsigned int flags); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. size_t data_size is the length of the ping payload. unsigned int max_tries if flags is GNUTLS_HEARTBEAT_WAIT then this sets the number of retransmissions. Use zero for indefinite (until timeout)….

NAME gnutls_heartbeat_get_timeout – API function SYNOPSIS #include <gnutls/gnutls.h> unsigned int gnutls_heartbeat_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 ping message. This function is useful when ping is used in non-blocking mode, to estimate when to call gnutls_heartbeat_ping() if no…