Author: Linux Manual

gnutls_certificate_set_pin_function – API function Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_set_pin_function(gnutls_certificate_credentials_t cred, gnutls_pin_callback_t fn, void * userdata); Argumentsgnutls_certificate_credentials_t cred is a gnutls_certificate_credentials_t structure. gnutls_pin_callback_t fn A PIN callback void * userdata Data to be passed in the callbackDescriptionThis function will set a callback function to be used when required to access a protected object. This function overrides any…

gnutls_certificate_set_params_function – API function Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_set_params_function(gnutls_certificate_credentials_t res, gnutls_params_function * func); Argumentsgnutls_certificate_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 or RSA parameters for certificate authentication. The callback should return GNUTLS_E_SUCCESS (0) on success….

gnutls_certificate_set_openpgp_keyring_mem – API function Synopsis#include <gnutls/openpgp.h> int gnutls_certificate_set_openpgp_keyring_mem(gnutls_certificate_credentials_t c, const uint8_t * data, size_t dlen, gnutls_openpgp_crt_fmt_t format); Argumentsgnutls_certificate_credentials_t c A certificate credentials structure const uint8_t * data buffer with keyring data. size_t dlen length of data buffer. gnutls_openpgp_crt_fmt_t format the format of the keyringDescriptionThe function is used to set keyrings that will be used internally…

gnutls_certificate_set_openpgp_keyring_file – API function Synopsis#include <gnutls/openpgp.h> int gnutls_certificate_set_openpgp_keyring_file(gnutls_certificate_credentials_t c, const char * file, gnutls_openpgp_crt_fmt_t format); Argumentsgnutls_certificate_credentials_t c A certificate credentials structure const char * file filename of the keyring. gnutls_openpgp_crt_fmt_t format format of keyring.DescriptionThe function is used to set keyrings that will be used internally by various OpenPGP functions. For example to find a key…

gnutls_certificate_set_openpgp_key_mem2 – API function Synopsis#include <gnutls/openpgp.h> int gnutls_certificate_set_openpgp_key_mem2(gnutls_certificate_credentials_t res, const gnutls_datum_t * cert, const gnutls_datum_t * key, const char * subkey_id, gnutls_openpgp_crt_fmt_t format); Argumentsgnutls_certificate_credentials_t res the destination context to save the data. const gnutls_datum_t * cert the datum that contains the public key. const gnutls_datum_t * key the datum that contains the secret key. const…

gnutls_certificate_set_openpgp_key_mem – API function Synopsis#include <gnutls/openpgp.h> int gnutls_certificate_set_openpgp_key_mem(gnutls_certificate_credentials_t res, const gnutls_datum_t * cert, const gnutls_datum_t * key, gnutls_openpgp_crt_fmt_t format); Argumentsgnutls_certificate_credentials_t res the destination context to save the data. const gnutls_datum_t * cert the datum that contains the public key. const gnutls_datum_t * key the datum that contains the secret key. gnutls_openpgp_crt_fmt_t format the format of…

gnutls_certificate_set_openpgp_key_file2 – API function Synopsis#include <gnutls/openpgp.h> int gnutls_certificate_set_openpgp_key_file2(gnutls_certificate_credentials_t res, const char * certfile, const char * keyfile, const char * subkey_id, gnutls_openpgp_crt_fmt_t format); Argumentsgnutls_certificate_credentials_t res the destination context to save the data. const char * certfile the file that contains the public key. const char * keyfile the file that contains the secret key. const…

gnutls_certificate_set_openpgp_key_file – API function Synopsis#include <gnutls/openpgp.h> int gnutls_certificate_set_openpgp_key_file(gnutls_certificate_credentials_t res, const char * certfile, const char * keyfile, gnutls_openpgp_crt_fmt_t format); Argumentsgnutls_certificate_credentials_t res the destination context to save the data. const char * certfile the file that contains the public key. const char * keyfile the file that contains the secret key. gnutls_openpgp_crt_fmt_t format the format of…

gnutls_certificate_set_openpgp_key – API function Synopsis#include <gnutls/openpgp.h> int gnutls_certificate_set_openpgp_key(gnutls_certificate_credentials_t res, gnutls_openpgp_crt_t crt, gnutls_openpgp_privkey_t pkey); Argumentsgnutls_certificate_credentials_t res is a gnutls_certificate_credentials_t structure. gnutls_openpgp_crt_t crt contains an openpgp public key gnutls_openpgp_privkey_t pkey is an openpgp private keyDescriptionThis function sets a certificate/private key pair in the gnutls_certificate_credentials_t structure. This function may be called more than once (in case multiple keys/certificates…

gnutls_certificate_set_ocsp_status_request_function – API function Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_set_ocsp_status_request_function(gnutls_certificate_credentials_t sc, gnutls_status_request_ocsp_func ocsp_func, void * ptr); Argumentsgnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure. gnutls_status_request_ocsp_func ocsp_func function pointer to OCSP status request callback. void * ptr opaque pointer passed to callback functionDescriptionThis function is to be used by server to register a callback to handle OCSP status requests from…

gnutls_certificate_set_ocsp_status_request_file – API function Synopsis#include <gnutls/gnutls.h> int gnutls_certificate_set_ocsp_status_request_file(gnutls_certificate_credentials_t sc, const char * response_file, unsigned int flags); Argumentsgnutls_certificate_credentials_t sc is a credentials structure. const char * response_file a filename of the OCSP response unsigned int flags should be zeroDescriptionThis function sets the filename of an OCSP response, that will be sent to the client if requests…

gnutls_certificate_set_key – API function Synopsis#include <gnutls/abstract.h> int gnutls_certificate_set_key(gnutls_certificate_credentials_t res, const char ** names, int names_size, gnutls_pcert_st * pcert_list, int pcert_list_size, gnutls_privkey_t key); Argumentsgnutls_certificate_credentials_t res is a gnutls_certificate_credentials_t structure. const char ** names is an array of DNS name of the certificate (NULL if none) int names_size holds the size of the names list gnutls_pcert_st *…

gnutls_certificate_set_dh_params – API function Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_set_dh_params(gnutls_certificate_credentials_t res, gnutls_dh_params_t dh_params); Argumentsgnutls_certificate_credentials_t res is a gnutls_certificate_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 a certificate server to use. These parameters will be used in Ephemeral Diffie-Hellman cipher suites. Note that only a pointer to the…

gnutls_certificate_server_set_retrieve_function – API function Synopsis#include <gnutls/compat.h> void gnutls_certificate_server_set_retrieve_function(gnutls_certificate_credentials_t cred, gnutls_certificate_server_retrieve_function * func); Argumentsgnutls_certificate_credentials_t cred is a gnutls_certificate_credentials_t structure. gnutls_certificate_server_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_server_set_request – API function Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_server_set_request(gnutls_session_t session, gnutls_certificate_request_t req); Argumentsgnutls_session_t session is a gnutls_session_t structure. gnutls_certificate_request_t req is one of GNUTLS_CERT_REQUEST, GNUTLS_CERT_REQUIREDescriptionThis function specifies if we (in case of a server) are going to send a certificate request message to the client. If req is GNUTLS_CERT_REQUIRE then the server will return an error…

gnutls_certificate_send_x509_rdn_sequence – API function Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_send_x509_rdn_sequence(gnutls_session_t session, int status); Argumentsgnutls_session_t session is a pointer to a gnutls_session_t structure. int status is 0 or 1DescriptionIf status is non zero, this function will order gnutls not to send the rdnSequence in the certificate request message. That is the server will not advertise its trusted CAs…

gnutls_certificate_get_x509_crls – Used to export all the CRLs from a gnutls_certificate_credentials_t structure Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_get_x509_crls(gnutls_certificate_credentials_t sc, gnutls_x509_crl_t ** x509_crl_list, unsigned int * ncrls); Argumentsgnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure. gnutls_x509_crl_t ** x509_crl_list the exported CRL list. Should be treated as constant unsigned int * ncrls the number of exported CRLsDescriptionThis function will export all…

gnutls_certificate_get_x509_cas – Used to export all the CAs from a gnutls_certificate_credentials_t structure Synopsis#include <gnutls/gnutls.h> void gnutls_certificate_get_x509_cas(gnutls_certificate_credentials_t sc, gnutls_x509_crt_t ** x509_ca_list, unsigned int * ncas); Argumentsgnutls_certificate_credentials_t sc is a gnutls_certificate_credentials_t structure. gnutls_x509_crt_t ** x509_ca_list will point to the CA list. Should be treated as constant unsigned int * ncas the number of CAsDescriptionThis function will export…

gnutls_certificate_get_peers_subkey_id – API function Synopsis#include <gnutls/gnutls.h> int gnutls_certificate_get_peers_subkey_id(gnutls_session_t session, gnutls_datum_t * id); Argumentsgnutls_session_t session is a gnutls session gnutls_datum_t * id will contain the IDDescriptionGet the peer’s subkey ID when OpenPGP certificates are used. The returned id should be treated as constant. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise an error code is returned. Since3.1.3…

gnutls_certificate_get_peers – API function Synopsis#include <gnutls/gnutls.h> const gnutls_datum_t * gnutls_certificate_get_peers(gnutls_session_t session, unsigned int * list_size); Argumentsgnutls_session_t session is a gnutls session unsigned int * list_size is the length of the certificate list (may be NULL)DescriptionGet the peer’s raw certificate (chain) as sent by the peer. These certificates are in raw format (DER encoded for X.509)….