SysTutorials Posts

NAME gnutls_certificate_free_credentials – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_certificate_free_credentials(gnutls_certificate_credentials_t sc); ARGUMENTS gnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure. DESCRIPTION This structure is complex enough to manipulate directly thus this helper function is provided in order to free (deallocate) it. This function does not free any temporary parameters associated with this structure (ie RSA and DH…

NAME gnutls_certificate_free_cas – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_certificate_free_cas(gnutls_certificate_credentials_t sc); ARGUMENTS gnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure. DESCRIPTION This function will delete all the CAs associated with the given credentials. Servers that do not use gnutls_certificate_verify_peers2() may call this to save some memory. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org…

NAME gnutls_certificate_free_ca_names – API function SYNOPSIS #include <gnutls/gnutls.h> void gnutls_certificate_free_ca_names(gnutls_certificate_credentials_t sc); ARGUMENTS gnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure. DESCRIPTION This function will delete all the CA name in the given credentials. Clients may call this to save some memory since in client side the CA names are not used. Servers might want to use this…

NAME gnutls_certificate_expiration_time_peers – API function SYNOPSIS #include <gnutls/gnutls.h> time_t gnutls_certificate_expiration_time_peers(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls session DESCRIPTION This function will return the peer’s certificate expiration time. RETURNS (time_t)-1 on error. DEPRECATED gnutls_certificate_verify_peers2() now verifies expiration times. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free Software…

NAME gnutls_certificate_client_set_retrieve_function – API function SYNOPSIS #include <gnutls/compat.h> void gnutls_certificate_client_set_retrieve_function(gnutls_certificate_credentials_t cred, gnutls_certificate_client_retrieve_function * func); ARGUMENTS gnutls_certificate_credentials_t cred is a gnutls_certificate_credentials_t structure. gnutls_certificate_client_retrieve_function * func is the callback function DESCRIPTION This function sets a callback to be called in order to retrieve the certificate to be used in the handshake. You are advised to use gnutls_certificate_set_retrieve_function2()…

NAME gnutls_certificate_client_get_request_status – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_certificate_client_get_request_status(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls session DESCRIPTION Get whether client certificate is requested or not. RETURNS 0 if the peer (server) did not request client authentication or 1 otherwise. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright ©…

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…