Author: Linux Manual

gnutls_certificate_get_ours – API function Synopsis#include <gnutls/gnutls.h> const gnutls_datum_t * gnutls_certificate_get_ours(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls sessionDescriptionGets the certificate as sent to the peer in the last handshake. The certificate is in raw (DER) format. No certificate list is being returned. Only the first certificate. Returnsa pointer to a gnutls_datum_t containing our certificate, or NULL…

gnutls_certificate_get_openpgp_keyring – export keyring from a #gnutls_certificate_credentials_t Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_get_openpgp_keyring(gnutls_certificate_credentials_t sc, gnutls_openpgp_keyring_t * keyring); Argumentsgnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure. gnutls_openpgp_keyring_t * keyring the exported keyring. Should be treated as constantDescriptionThis function will export the OpenPGP keyring associated with the given credentials. Since2.4.0 Reporting BugsReport bugs to <bug-gnutls [at] gnu.org>. GnuTLS home page: http://www.gnu.org/software/gnutls/…

gnutls_certificate_get_issuer – API function Synopsis#include <gnutls/gnutls.h> int gnutls_certificate_get_issuer(gnutls_certificate_credentials_t sc, gnutls_x509_crt_t cert, gnutls_x509_crt_t * issuer, unsigned int flags); Argumentsgnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure. gnutls_x509_crt_t cert is the certificate to find issuer for gnutls_x509_crt_t * issuer Will hold the issuer if any. Should be treated as constant. unsigned int flags Use zero or GNUTLS_TL_GET_COPYDescriptionThis function will…

gnutls_certificate_get_crt_raw – API function Synopsis#include <gnutls/gnutls.h> int gnutls_certificate_get_crt_raw(gnutls_certificate_credentials_t sc, unsigned idx1, unsigned idx2, gnutls_datum_t * cert); Argumentsgnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure. unsigned idx1 the index of the certificate if multiple are present unsigned idx2 the index in the certificate list. Zero gives the server’s certificate. gnutls_datum_t * cert Will hold the DER encoded certificate.DescriptionThis…

gnutls_certificate_free_keys – API function Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_free_keys(gnutls_certificate_credentials_t sc); Argumentsgnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure.DescriptionThis function will delete all the keys and the certificates associated with the given credentials. This function must not be called when a TLS negotiation that uses the credentials is in progress. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page:…

gnutls_certificate_free_crls – API function Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_free_crls(gnutls_certificate_credentials_t sc); Argumentsgnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure.DescriptionThis function will delete all the CRLs associated with the given credentials. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution of this file, with or without modification, are permitted…

gnutls_certificate_free_credentials – API function Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_free_credentials(gnutls_certificate_credentials_t sc); Argumentsgnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure.DescriptionThis 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 parameters are not freed by…

gnutls_certificate_free_cas – API function Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_free_cas(gnutls_certificate_credentials_t sc); Argumentsgnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure.DescriptionThis 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 BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation,…

gnutls_certificate_free_ca_names – API function Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_free_ca_names(gnutls_certificate_credentials_t sc); Argumentsgnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure.DescriptionThis 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 function if a large list…

gnutls_certificate_expiration_time_peers – API function Synopsis#include <gnutls/gnutls.h> time_t gnutls_certificate_expiration_time_peers(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls sessionDescriptionThis function will return the peer’s certificate expiration time. Returns(time_t)-1 on error. Deprecatedgnutls_certificate_verify_peers2() now verifies expiration times. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution of this file, with…

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); Argumentsgnutls_certificate_credentials_t cred is a gnutls_certificate_credentials_t structure. gnutls_certificate_client_retrieve_function * func is the callback functionDescriptionThis 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() because it is much more…

gnutls_certificate_client_get_request_status – API function Synopsis#include <gnutls/gnutls.h> int gnutls_certificate_client_get_request_status(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls sessionDescriptionGet whether client certificate is requested or not. Returns0 if the peer (server) did not request client authentication or 1 otherwise. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution…

gnutls_certificate_allocate_credentials – API function Synopsis#include <gnutls/gnutls.h> int gnutls_certificate_allocate_credentials(gnutls_certificate_credentials_t * res); Argumentsgnutls_certificate_credentials_t * res is a pointer to a gnutls_certificate_credentials_t structure.DescriptionThis structure is complex enough to manipulate directly thus this helper function is provided in order to allocate it. ReturnsGNUTLS_E_SUCCESS on success, or an error code. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org…

gnutls_certificate_activation_time_peers – API function Synopsis#include <gnutls/gnutls.h> time_t gnutls_certificate_activation_time_peers(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls sessionDescriptionThis function will return the peer’s certificate activation time. This is the creation time for openpgp keys. Returns(time_t)-1 on error. Deprecatedgnutls_certificate_verify_peers2() now verifies activation times. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation,…

gnutls_bye – API function Synopsis#include <gnutls/gnutls.h> int gnutls_bye(gnutls_session_t session, gnutls_close_request_t how); Argumentsgnutls_session_t session is a gnutls_session_t structure. gnutls_close_request_t how is an integerDescriptionTerminates 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 and further receives and sends…

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); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionReturns 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. ReturnsThe type of credentials for the server authentication schema, a gnutls_credentials_type_t type. Reporting BugsReport…

gnutls_auth_get_type – API function Synopsis#include <gnutls/gnutls.h> gnutls_credentials_type_t gnutls_auth_get_type(gnutls_session_t session); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionReturns 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 function are to be used…

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); Argumentsgnutls_session_t session is a gnutls_session_t structure.DescriptionReturns 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. ReturnsThe type of credentials for the client authentication schema, a gnutls_credentials_type_t type. Reporting BugsReport…

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); Argumentsgnutls_anon_server_credentials_t res is a gnutls_certificate_credentials_t structure gnutls_params_function * func is the function to be calledDescriptionThis 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 (0) on success. Reporting BugsReport…

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); Argumentsgnutls_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.DescriptionThis 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 BugsReport bugs to <bugs [at] gnutls.org>….