Linux Manuals session 3

gnutls_session_set_finished_function – API function Synopsis#include <gnutls/gnutls.h> void gnutls_session_set_finished_function(gnutls_session_t session, gnutls_finished_callback_func func); Argumentsgnutls_session_t session is a gnutls_session_t structure. gnutls_finished_callback_func func a gnutls_finished_callback_func callback.DescriptionRegister a callback function for the session that will be called when a TLS Finished message has been generated. The function is typically used to copy away the TLS finished message for later use…

gnutls_session_set_data – API function Synopsis#include <gnutls/gnutls.h> int gnutls_session_set_data(gnutls_session_t session, const void * session_data, size_t session_data_size); Argumentsgnutls_session_t session is a gnutls_session_t structure. const void * session_data is a pointer to space to hold the session. size_t session_data_size is the session’s sizeDescriptionSets all session parameters, in order to resume a previously established session. The session data given…

gnutls_session_resumption_requested – API function Synopsis#include <gnutls/gnutls.h> int gnutls_session_resumption_requested(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionCheck whether the client has asked for session resumption. This function is valid only on server side. Returnsnon zero if session resumption was asked, or a zero if not. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright ©…

gnutls_session_is_resumed – API function Synopsis#include <gnutls/gnutls.h> int gnutls_session_is_resumed(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionCheck whether session is resumed or not. Returnsnon zero if this session is resumed, or a zero if this is a new session. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying…

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); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionReturn 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 established, the output will be…

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); Argumentsgnutls_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 randomDescriptionThis function returns pointers to the client and server random fields used in the TLS handshake. The…

gnutls_session_get_ptr – API function Synopsis#include <gnutls/gnutls.h> void * gnutls_session_get_ptr(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionGet user pointer for session. Useful in callbacks. This is the pointer set with gnutls_session_set_ptr(). Returnsthe user given pointer from the session structure, or NULL if it was never set. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org…

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); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionReturn 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 output will be garbage; in…

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); Argumentsgnutls_session_t session is a gnutls_session_t structure. gnutls_datum_t * session_id will point to the session ID.DescriptionReturns the current session ID. The returned data should be treated as constant. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise an error code is returned. Since3.1.4 Reporting BugsReport bugs…

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); Argumentsgnutls_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.DescriptionReturns the current session ID. This can be…

gnutls_session_get_desc – API function Synopsis#include <gnutls/gnutls.h> char * gnutls_session_get_desc(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls sessionDescriptionThis function returns a string describing the current session. The string is null terminated and allocated using gnutls_malloc(). Returnsa description of the protocols and algorithms in the current session. Since3.1.10 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org…

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

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); Argumentsgnutls_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.DescriptionReturns all session parameters needed to be stored…

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); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionReturn 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 established, the output will be…

gnutls_session_force_valid – API function Synopsis#include <gnutls/gnutls.h> void gnutls_session_force_valid(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionClears 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 typical applications. Reporting BugsReport bugs…

gnutls_session_enable_compatibility_mode – API function Synopsis#include <gnutls/gnutls.h> void gnutls_session_enable_compatibility_mode(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionThis 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 audit subsystem. Normally only servers…

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); Argumentsgnutls_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 dataDescriptionExtract given channel binding data of the cbtype (e.g., GNUTLS_CB_TLS_UNIQUE) type. ReturnsGNUTLS_E_SUCCESS on success, GNUTLS_E_UNIMPLEMENTED_FEATURE if the cbtype is unsupported, GNUTLS_E_CHANNEL_BINDING_NOT_AVAILABLE if…

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); Argumentsgnutls_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 nameDescriptionThis function is to be used by clients…

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); Argumentsgnutls_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 * type will…

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); Argumentsgnutls_sec_param_t param is a security parameterDescriptionThis function will return the number of bits that correspond to symmetric cipher strength for the given security parameter. ReturnsThe number of bits, or (0). Since3.3.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free…