Linux Manuals session 3

NAME gnutls_certificate_allocate_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_certificate_allocate_credentials(gnutls_certificate_credentials_t * res); ARGUMENTS gnutls_certificate_credentials_t * res is a pointer to a gnutls_certificate_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. RETURNS GNUTLS_E_SUCCESS on success, or an error code. REPORTING BUGS Report bugs…

NAME gnutls_certificate_activation_time_peers – API function SYNOPSIS #include <gnutls/gnutls.h> time_t gnutls_certificate_activation_time_peers(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls session DESCRIPTION This function will return the peer’s certificate activation time. This is the creation time for openpgp keys. RETURNS (time_t)-1 on error. DEPRECATED gnutls_certificate_verify_peers2() now verifies activation times. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home…

NAME gnutls_bye – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_bye(gnutls_session_t session, gnutls_close_request_t how); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_close_request_t how is an integer DESCRIPTION Terminates the current TLS/SSL connection. The connection should have been initiated using gnutls_handshake(). how should be one of GNUTLS_SHUT_RDWR, GNUTLS_SHUT_WR. In case of GNUTLS_SHUT_RDWR the TLS session gets terminated…

NAME gnutls_auth_server_get_type – API function SYNOPSIS #include <gnutls/gnutls.h> gnutls_credentials_type_t gnutls_auth_server_get_type(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Returns the type of credentials that were used for server authentication. The returned information is to be used to distinguish the function used to access authentication data. RETURNS The type of credentials for the server authentication…

NAME gnutls_auth_get_type – API function SYNOPSIS #include <gnutls/gnutls.h> gnutls_credentials_type_t gnutls_auth_get_type(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Returns type of credentials for the current authentication schema. The returned information is to be used to distinguish the function used to access authentication data. Eg. for CERTIFICATE ciphersuites (key exchange algorithms: GNUTLS_KX_RSA, GNUTLS_KX_DHE_RSA), the same…

NAME gnutls_auth_client_get_type – API function SYNOPSIS #include <gnutls/gnutls.h> gnutls_credentials_type_t gnutls_auth_client_get_type(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Returns the type of credentials that were used for client authentication. The returned information is to be used to distinguish the function used to access authentication data. RETURNS The type of credentials for the client authentication…

NAME gnutls_anon_set_server_params_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_anon_set_server_params_function(gnutls_anon_server_credentials_t res, gnutls_params_function * func); ARGUMENTS gnutls_anon_server_credentials_t res is a gnutls_certificate_credentials_t structure gnutls_params_function * func is the function to be called DESCRIPTION This function will set a callback in order for the server to get the Diffie-Hellman parameters for anonymous authentication. The callback should return GNUTLS_E_SUCCESS…

NAME gnutls_anon_set_server_dh_params – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_anon_set_server_dh_params(gnutls_anon_server_credentials_t res, gnutls_dh_params_t dh_params); ARGUMENTS gnutls_anon_server_credentials_t res is a gnutls_anon_server_credentials_t structure gnutls_dh_params_t dh_params is a structure that holds Diffie-Hellman parameters. DESCRIPTION This function will set the Diffie-Hellman parameters for an anonymous server to use. These parameters will be used in Anonymous Diffie-Hellman cipher suites. REPORTING BUGS…

NAME gnutls_anon_set_params_function – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_anon_set_params_function(gnutls_anon_server_credentials_t res, gnutls_params_function * func); ARGUMENTS gnutls_anon_server_credentials_t res is a gnutls_anon_server_credentials_t structure gnutls_params_function * func is the function to be called DESCRIPTION This function will set a callback in order for the server to get the Diffie-Hellman or RSA parameters for anonymous authentication. The callback should…

NAME gnutls_anon_free_server_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_anon_free_server_credentials(gnutls_anon_server_credentials_t sc); ARGUMENTS gnutls_anon_server_credentials_t sc is a gnutls_anon_server_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 <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free…

NAME gnutls_anon_free_client_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_anon_free_client_credentials(gnutls_anon_client_credentials_t sc); ARGUMENTS gnutls_anon_client_credentials_t sc is a gnutls_anon_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 <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free…

NAME gnutls_anon_allocate_server_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_anon_allocate_server_credentials(gnutls_anon_server_credentials_t * sc); ARGUMENTS gnutls_anon_server_credentials_t * sc is a pointer to a gnutls_anon_server_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. RETURNS GNUTLS_E_SUCCESS on success, or an error code. REPORTING BUGS Report bugs…

NAME gnutls_anon_allocate_client_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_anon_allocate_client_credentials(gnutls_anon_client_credentials_t * sc); ARGUMENTS gnutls_anon_client_credentials_t * sc is a pointer to a gnutls_anon_client_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. RETURNS GNUTLS_E_SUCCESS on success, or an error code. REPORTING BUGS Report bugs…

NAME gnutls_alpn_set_protocols – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_alpn_set_protocols(gnutls_session_t session, const gnutls_datum_t * protocols, unsigned protocols_size, unsigned int flags); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. const gnutls_datum_t * protocols is the protocol names to add. unsigned protocols_size the number of protocols to add. unsigned int flags zero or GNUTLS_ALPN_* DESCRIPTION This function is…

NAME gnutls_alpn_get_selected_protocol – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_alpn_get_selected_protocol(gnutls_session_t session, gnutls_datum_t * protocol); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_datum_t * protocol will hold the protocol name DESCRIPTION This function allows you to get the negotiated protocol name. The returned protocol should be treated as opaque, constant value and only valid during the…

NAME gnutls_alert_send_appropriate – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_alert_send_appropriate(gnutls_session_t session, int err); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. int err is an integer DESCRIPTION Sends an alert to the peer depending on the error code returned by a gnutls function. This function will call gnutls_error_to_alert() to determine the appropriate alert to send. This…

NAME gnutls_alert_send – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_alert_send(gnutls_session_t session, gnutls_alert_level_t level, gnutls_alert_description_t desc); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_alert_level_t level is the level of the alert gnutls_alert_description_t desc is the alert description DESCRIPTION This function will send an alert to the peer in order to inform him of something important (eg….

NAME gnutls_alert_get_strname – API function SYNOPSIS #include <gnutls/gnutls.h> const char * gnutls_alert_get_strname(gnutls_alert_description_t alert); ARGUMENTS gnutls_alert_description_t alert is an alert number. DESCRIPTION This function will return a string of the name of the alert. RETURNS string corresponding to gnutls_alert_description_t value. SINCE 3.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright ©…

NAME gnutls_alert_get_name – API function SYNOPSIS #include <gnutls/gnutls.h> const char * gnutls_alert_get_name(gnutls_alert_description_t alert); ARGUMENTS gnutls_alert_description_t alert is an alert number. DESCRIPTION This function will return a string that describes the given alert number, or NULL. See gnutls_alert_get(). RETURNS string corresponding to gnutls_alert_description_t value. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT…

NAME gnutls_alert_get – API function SYNOPSIS #include <gnutls/gnutls.h> gnutls_alert_description_t gnutls_alert_get(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION This function will return the last alert number received. This function should be called when GNUTLS_E_WARNING_ALERT_RECEIVED or GNUTLS_E_FATAL_ALERT_RECEIVED errors are returned by a gnutls function. The peer may send alerts if he encounters an error. If…