Linux Manuals session 3

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

NAME gnutls_safe_renegotiation_status – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_safe_renegotiation_status(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Can be used to check whether safe renegotiation is being used in the current session. RETURNS 0 when safe renegotiation is not used and non (0) when safe renegotiation is used. SINCE 2.10.0 REPORTING BUGS Report…

NAME gnutls_rsa_params_init – API function SYNOPSIS #include <gnutls/compat.h> int gnutls_rsa_params_init(gnutls_rsa_params_t * rsa_params); ARGUMENTS gnutls_rsa_params_t * rsa_params Is a structure that will hold the parameters DESCRIPTION This function will initialize the temporary RSA parameters structure. RETURNS GNUTLS_E_SUCCESS on success, or an negative error code. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT…

NAME gnutls_rsa_params_import_raw – API function SYNOPSIS #include <gnutls/compat.h> int gnutls_rsa_params_import_raw(gnutls_rsa_params_t rsa_params, const gnutls_datum_t * m, const gnutls_datum_t * e, const gnutls_datum_t * d, const gnutls_datum_t * p, const gnutls_datum_t * q, const gnutls_datum_t * u); ARGUMENTS gnutls_rsa_params_t rsa_params Is a structure will hold the parameters const gnutls_datum_t * m holds the modulus const gnutls_datum_t *…

NAME gnutls_rsa_params_import_pkcs1 – API function SYNOPSIS #include <gnutls/compat.h> int gnutls_rsa_params_import_pkcs1(gnutls_rsa_params_t params, const gnutls_datum_t * pkcs1_params, gnutls_x509_crt_fmt_t format); ARGUMENTS gnutls_rsa_params_t params A structure where the parameters will be copied to const gnutls_datum_t * pkcs1_params should contain a PKCS1 RSAPrivateKey structure PEM or DER encoded gnutls_x509_crt_fmt_t format the format of params. PEM or DER. DESCRIPTION This function…

NAME gnutls_rsa_params_generate2 – API function SYNOPSIS #include <gnutls/compat.h> int gnutls_rsa_params_generate2(gnutls_rsa_params_t params, unsigned int bits); ARGUMENTS gnutls_rsa_params_t params The structure where the parameters will be stored unsigned int bits is the prime’s number of bits DESCRIPTION This function will generate new temporary RSA parameters for use in RSA-EXPORT ciphersuites. This function is normally slow. Note that…

NAME gnutls_rsa_params_export_raw – API function SYNOPSIS #include <gnutls/compat.h> int gnutls_rsa_params_export_raw(gnutls_rsa_params_t rsa, gnutls_datum_t * m, gnutls_datum_t * e, gnutls_datum_t * d, gnutls_datum_t * p, gnutls_datum_t * q, gnutls_datum_t * u, unsigned int * bits); ARGUMENTS gnutls_rsa_params_t rsa a structure that holds the rsa parameters gnutls_datum_t * m will hold the modulus gnutls_datum_t * e will hold…