Linux Manuals session 3

gnutls_x509_crt_set_authority_key_id – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_set_authority_key_id(gnutls_x509_crt_t cert, const void * id, size_t id_size); Argumentsgnutls_x509_crt_t cert a certificate of type gnutls_x509_crt_t const void * id The key ID size_t id_size Holds the size of the key ID field.DescriptionThis function will set the X.509 certificate’s authority key ID extension. Only the keyIdentifier field can be…

gnutls_x509_crt_set_authority_info_access – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_set_authority_info_access(gnutls_x509_crt_t crt, int what, gnutls_datum_t * data); Argumentsgnutls_x509_crt_t crt Holds the certificate int what what data to get, a gnutls_info_access_what_t type. gnutls_datum_t * data output data to be freed with gnutls_free().DescriptionThis function sets the Authority Information Access (AIA) extension, see RFC 5280 section 4.2.2.1 for more information. The…

gnutls_x509_crt_set_activation_time – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_set_activation_time(gnutls_x509_crt_t cert, time_t act_time); Argumentsgnutls_x509_crt_t cert a certificate of type gnutls_x509_crt_t time_t act_time The actual timeDescriptionThis function will set the time this Certificate was or will be activated. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page:…

gnutls_x509_crt_privkey_sign – API function Synopsis#include <gnutls/abstract.h> int gnutls_x509_crt_privkey_sign(gnutls_x509_crt_t crt, gnutls_x509_crt_t issuer, gnutls_privkey_t issuer_key, gnutls_digest_algorithm_t dig, unsigned int flags); Argumentsgnutls_x509_crt_t crt a certificate of type gnutls_x509_crt_t gnutls_x509_crt_t issuer is the certificate of the certificate issuer gnutls_privkey_t issuer_key holds the issuer’s private key gnutls_digest_algorithm_t dig The message digest to use, GNUTLS_DIG_SHA1 is a safe choice unsigned int…

gnutls_x509_crt_print – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_print(gnutls_x509_crt_t cert, gnutls_certificate_print_formats_t format, gnutls_datum_t * out); Argumentsgnutls_x509_crt_t cert The structure to be printed gnutls_certificate_print_formats_t format Indicate the format to use gnutls_datum_t * out Newly allocated datum with null terminated string.DescriptionThis function will pretty print a X.509 certificate, suitable for display to a human. If the format is…

gnutls_x509_crt_list_verify – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_list_verify(const gnutls_x509_crt_t * cert_list, int cert_list_length, const gnutls_x509_crt_t * CA_list, int CA_list_length, const gnutls_x509_crl_t * CRL_list, int CRL_list_length, unsigned int flags, unsigned int * verify); Argumentsconst gnutls_x509_crt_t * cert_list is the certificate list to be verified int cert_list_length holds the number of certificate in cert_list const gnutls_x509_crt_t *…

gnutls_x509_crt_list_import_pkcs11 – API function Synopsis#include <gnutls/pkcs11.h> int gnutls_x509_crt_list_import_pkcs11(gnutls_x509_crt_t * certs, unsigned int cert_max, gnutls_pkcs11_obj_t * const objs, unsigned int flags); Argumentsgnutls_x509_crt_t * certs A list of certificates of type gnutls_x509_crt_t unsigned int cert_max The maximum size of the list gnutls_pkcs11_obj_t * const objs A list of PKCS 11 objects unsigned int flags 0 for nowDescriptionThis…

gnutls_x509_crt_list_import2 – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_list_import2(gnutls_x509_crt_t ** certs, unsigned int * size, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format, unsigned int flags); Argumentsgnutls_x509_crt_t ** certs The structures to store the parsed certificate. Must not be initialized. unsigned int * size It will contain the size of the list. const gnutls_datum_t * data The PEM…

gnutls_x509_crt_list_import – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_list_import(gnutls_x509_crt_t * certs, unsigned int * cert_max, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format, unsigned int flags); Argumentsgnutls_x509_crt_t * certs The structures to store the parsed certificate. Must not be initialized. unsigned int * cert_max Initially must hold the maximum number of certs. It will be updated with the…

gnutls_x509_crt_init – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_init(gnutls_x509_crt_t * cert); Argumentsgnutls_x509_crt_t * cert The structure to be initializedDescriptionThis function will initialize an X.509 certificate structure. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and…

gnutls_x509_crt_import_pkcs11_url – API function Synopsis#include <gnutls/pkcs11.h> int gnutls_x509_crt_import_pkcs11_url(gnutls_x509_crt_t crt, const char * url, unsigned int flags); Argumentsgnutls_x509_crt_t crt A certificate of type gnutls_x509_crt_t const char * url A PKCS 11 url unsigned int flags One of GNUTLS_PKCS11_OBJ_* flagsDescriptionThis function will import a PKCS 11 certificate directly from a token without involving the gnutls_pkcs11_obj_t structure. This…

gnutls_x509_crt_import_pkcs11 – API function Synopsis#include <gnutls/pkcs11.h> int gnutls_x509_crt_import_pkcs11(gnutls_x509_crt_t crt, gnutls_pkcs11_obj_t pkcs11_crt); Argumentsgnutls_x509_crt_t crt A certificate of type gnutls_x509_crt_t gnutls_pkcs11_obj_t pkcs11_crt A PKCS 11 object that contains a certificateDescriptionThis function will import a PKCS 11 certificate to a gnutls_x509_crt_t structure. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Since2.12.0 Reporting BugsReport bugs to…

gnutls_x509_crt_import – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_import(gnutls_x509_crt_t cert, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format); Argumentsgnutls_x509_crt_t cert The structure to store the parsed certificate. const gnutls_datum_t * data The DER or PEM encoded certificate. gnutls_x509_crt_fmt_t format One of DER or PEMDescriptionThis function will convert the given DER or PEM encoded Certificate to the native gnutls_x509_crt_t…

gnutls_x509_crt_get_version – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_version(gnutls_x509_crt_t cert); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structureDescriptionThis function will return the version of the specified Certificate. Returnsversion of certificate, or a negative error code on error. 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_x509_crt_get_verify_algorithm – API function Synopsis#include <gnutls/compat.h> int gnutls_x509_crt_get_verify_algorithm(gnutls_x509_crt_t crt, const gnutls_datum_t * signature, gnutls_digest_algorithm_t * hash); Argumentsgnutls_x509_crt_t crt Holds the certificate const gnutls_datum_t * signature contains the signature gnutls_digest_algorithm_t * hash The result of the call with the hash algorithm used for signatureDescriptionThis function will read the certifcate and the signed data to determine the…

gnutls_x509_crt_get_subject_unique_id – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_subject_unique_id(gnutls_x509_crt_t crt, char * buf, size_t * buf_size); Argumentsgnutls_x509_crt_t crt Holds the certificate char * buf user allocated memory buffer, will hold the unique id size_t * buf_size size of user allocated memory buffer (on input), will hold actual size of the unique ID on return.DescriptionThis function will…

gnutls_x509_crt_get_subject_key_id – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_subject_key_id(gnutls_x509_crt_t cert, void * ret, size_t * ret_size, unsigned int * critical); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure void * ret The place where the identifier will be copied size_t * ret_size Holds the size of the result field. unsigned int * critical will be non-zero if…

gnutls_x509_crt_get_subject_alt_othername_oid – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_subject_alt_othername_oid(gnutls_x509_crt_t cert, unsigned int seq, void * oid, size_t * oid_size); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure unsigned int seq specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.) void * oid is the place where the otherName…

gnutls_x509_crt_get_subject_alt_name2 – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_subject_alt_name2(gnutls_x509_crt_t cert, unsigned int seq, void * san, size_t * san_size, unsigned int * san_type, unsigned int * critical); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure unsigned int seq specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.) void…

gnutls_x509_crt_get_subject_alt_name – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_subject_alt_name(gnutls_x509_crt_t cert, unsigned int seq, void * san, size_t * san_size, unsigned int * critical); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure unsigned int seq specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.) void * san is the…