SysTutorials Posts

NAME gnutls_session_resumption_requested – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_session_resumption_requested(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Check whether the client has asked for session resumption. This function is valid only on server side. RETURNS non zero if session resumption was asked, or a zero if not. REPORTING BUGS Report bugs to <bugs…

NAME gnutls_session_is_resumed – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_session_is_resumed(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Check whether session is resumed or not. RETURNS non zero if this session is resumed, or a zero if this is a new session. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT…

NAME gnutls_session_get_server_random – get the session’s server random value SYNOPSIS #include <gnutls/gnutls.h> const void * gnutls_session_get_server_random(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Return a pointer to the 32-byte server random field used in the session. The pointer must not be modified or deallocated. If a server random value has not yet been…

NAME gnutls_session_get_random – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_session_get_random(gnutls_session_t session, gnutls_datum_t * client, gnutls_datum_t * server); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_datum_t * client the client part of the random gnutls_datum_t * server the server part of the random DESCRIPTION This function returns pointers to the client and server random fields used…

NAME gnutls_session_get_ptr – API function SYNOPSIS #include <gnutls/gnutls.h> void * gnutls_session_get_ptr(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Get user pointer for session. Useful in callbacks. This is the pointer set with gnutls_session_set_ptr(). RETURNS the user given pointer from the session structure, or NULL if it was never set. REPORTING BUGS Report bugs…

NAME gnutls_session_get_master_secret – get the session’s master secret value SYNOPSIS #include <gnutls/gnutls.h> const void * gnutls_session_get_master_secret(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Return a pointer to the 48-byte master secret in the session. The pointer must not be modified or deallocated. If a master secret value has not yet been established, the…

NAME gnutls_session_get_id2 – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_session_get_id2(gnutls_session_t session, gnutls_datum_t * session_id); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_datum_t * session_id will point to the session ID. DESCRIPTION Returns the current session ID. The returned data should be treated as constant. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise an error code…

NAME gnutls_session_get_id – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_session_get_id(gnutls_session_t session, void * session_id, size_t * session_id_size); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. void * session_id is a pointer to space to hold the session id. size_t * session_id_size initially should contain the maximum session_id size and will be updated. DESCRIPTION Returns the current…

NAME gnutls_session_get_desc – API function SYNOPSIS #include <gnutls/gnutls.h> char * gnutls_session_get_desc(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls session DESCRIPTION This function returns a string describing the current session. The string is null terminated and allocated using gnutls_malloc(). RETURNS a description of the protocols and algorithms in the current session. SINCE 3.1.10 REPORTING BUGS Report…

NAME gnutls_session_get_data2 – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_session_get_data2(gnutls_session_t session, gnutls_datum_t * data); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_datum_t * data is a pointer to a datum that will hold the session. DESCRIPTION Returns all session parameters needed to be stored to support resumption. The client should call this, and store the…

NAME gnutls_session_get_data – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_session_get_data(gnutls_session_t session, void * session_data, size_t * session_data_size); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. void * session_data is a pointer to space to hold the session. size_t * session_data_size is the session_data’s size, or it will be set by the function. DESCRIPTION Returns all session…

NAME gnutls_session_get_client_random – get the session’s client random value SYNOPSIS #include <gnutls/gnutls.h> const void * gnutls_session_get_client_random(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Return a pointer to the 32-byte client random field used in the session. The pointer must not be modified or deallocated. If a client random value has not yet been…

NAME gnutls_session_force_valid – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_session_force_valid(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Clears the invalid flag in a session. That means that sessions were corrupt or invalid data were received can be re-used. Use only when debugging or experimenting with the TLS protocol. Should not be used in…

NAME gnutls_session_enable_compatibility_mode – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_session_enable_compatibility_mode(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function can be used to disable certain (security) features in TLS in order to maintain maximum compatibility with buggy clients. Because several trade-offs with security are enabled, if required they will be reported through the…

NAME gnutls_session_channel_binding – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_session_channel_binding(gnutls_session_t session, gnutls_channel_binding_t cbtype, gnutls_datum_t * cb); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_channel_binding_t cbtype an gnutls_channel_binding_t enumeration type gnutls_datum_t * cb output buffer array with data DESCRIPTION Extract given channel binding data of the cbtype (e.g., GNUTLS_CB_TLS_UNIQUE) type. RETURNS GNUTLS_E_SUCCESS on success, GNUTLS_E_UNIMPLEMENTED_FEATURE if…

NAME gnutls_server_name_set – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_server_name_set(gnutls_session_t session, gnutls_server_name_type_t type, const void * name, size_t name_length); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_server_name_type_t type specifies the indicator type const void * name is a string that contains the server name. size_t name_length holds the length of name DESCRIPTION This function is…

NAME gnutls_server_name_get – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_server_name_get(gnutls_session_t session, void * data, size_t * data_length, unsigned int * type, unsigned int indx); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. void * data will hold the data size_t * data_length will hold the data length. Must hold the maximum size of data. unsigned int…

NAME gnutls_sec_param_to_symmetric_bits – API function SYNOPSIS #include <gnutls/gnutls.h> unsigned int gnutls_sec_param_to_symmetric_bits(gnutls_sec_param_t param); ARGUMENTS gnutls_sec_param_t param is a security parameter DESCRIPTION This function will return the number of bits that correspond to symmetric cipher strength for the given security parameter. RETURNS The number of bits, or (0). SINCE 3.3.0 REPORTING BUGS Report bugs to <bugs [at]…

NAME gnutls_sec_param_to_pk_bits – API function SYNOPSIS #include <gnutls/gnutls.h> unsigned int gnutls_sec_param_to_pk_bits(gnutls_pk_algorithm_t algo, gnutls_sec_param_t param); ARGUMENTS gnutls_pk_algorithm_t algo is a public key algorithm gnutls_sec_param_t param is a security parameter DESCRIPTION When generating private and public key pairs a difficult question is which size of "bits" the modulus will be in RSA and the group size in…

NAME gnutls_sec_param_get_name – API function SYNOPSIS #include <gnutls/gnutls.h> const char * gnutls_sec_param_get_name(gnutls_sec_param_t param); ARGUMENTS gnutls_sec_param_t param is a security parameter DESCRIPTION Convert a gnutls_sec_param_t value to a string. RETURNS a pointer to a string that contains the name of the specified security level, or NULL. SINCE 2.12.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>….