Linux Manuals session 3

gnutls_x509_crt_get_subject – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_subject(gnutls_x509_crt_t cert, gnutls_x509_dn_t * dn); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure gnutls_x509_dn_t * dn output variable with pointer to uint8_t DN.DescriptionReturn the Certificate’s Subject DN as a gnutls_x509_dn_t data type, that can be decoded using gnutls_x509_dn_get_rdn_ava(). Note that dn should be treated as constant. Because it points…

gnutls_x509_crt_get_signature_algorithm – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_signature_algorithm(gnutls_x509_crt_t cert); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structureDescriptionThis function will return a value of the gnutls_sign_algorithm_t enumeration that is the signature algorithm that has been used to sign this certificate. Returnsa gnutls_sign_algorithm_t value, or a negative error code on error. Reporting BugsReport bugs to <bugs [at] gnutls.org>….

gnutls_x509_crt_get_signature – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_signature(gnutls_x509_crt_t cert, char * sig, size_t * sig_size); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure char * sig a pointer where the signature part will be copied (may be null). size_t * sig_size initially holds the size of sigDescriptionThis function will extract the signature field of a certificate….

gnutls_x509_crt_get_serial – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_serial(gnutls_x509_crt_t cert, void * result, size_t * result_size); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure void * result The place where the serial number will be copied size_t * result_size Holds the size of the result field.DescriptionThis function will return the X.509 certificate’s serial number. This is obtained…

gnutls_x509_crt_get_raw_issuer_dn – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_raw_issuer_dn(gnutls_x509_crt_t cert, gnutls_datum_t * dn); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure gnutls_datum_t * dn will hold the starting point of the DNDescriptionThis function will return a pointer to the DER encoded DN structure and the length. This points to allocated data that must be free’d using gnutls_free()….

gnutls_x509_crt_get_raw_dn – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_raw_dn(gnutls_x509_crt_t cert, gnutls_datum_t * dn); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure gnutls_datum_t * dn will hold the starting point of the DNDescriptionThis function will return a pointer to the DER encoded DN structure and the length. This points to allocated data that must be free’d using gnutls_free()….

gnutls_x509_crt_get_proxy – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_proxy(gnutls_x509_crt_t cert, unsigned int * critical, int * pathlen, char ** policyLanguage, char ** policy, size_t * sizeof_policy); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure unsigned int * critical will be non-zero if the extension is marked as critical int * pathlen pointer to output integer indicating path…

gnutls_x509_crt_get_private_key_usage_period – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_private_key_usage_period(gnutls_x509_crt_t cert, time_t * activation, time_t * expiration, unsigned int * critical); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure time_t * activation The activation time time_t * expiration The expiration time unsigned int * critical the extension statusDescriptionThis function will return the expiration and activation times of the…

gnutls_x509_crt_get_preferred_hash_algorithm – API function Synopsis#include <gnutls/compat.h> int gnutls_x509_crt_get_preferred_hash_algorithm(gnutls_x509_crt_t crt, gnutls_digest_algorithm_t * hash, unsigned int * mand); Argumentsgnutls_x509_crt_t crt Holds the certificate gnutls_digest_algorithm_t * hash The result of the call with the hash algorithm used for signature unsigned int * mand If non-zero it means that the algorithm MUST use this hash. May be NULL.DescriptionThis function…

gnutls_x509_crt_get_policy – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_policy(gnutls_x509_crt_t crt, int indx, struct gnutls_x509_policy_st * policy, unsigned int * critical); Argumentsgnutls_x509_crt_t crt should contain a gnutls_x509_crt_t structure int indx This specifies which policy to return. Use (0) to get the first one. struct gnutls_x509_policy_st * policy A pointer to a policy structure. unsigned int * critical…

gnutls_x509_crt_get_pk_rsa_raw – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_pk_rsa_raw(gnutls_x509_crt_t crt, gnutls_datum_t * m, gnutls_datum_t * e); Argumentsgnutls_x509_crt_t crt Holds the certificate gnutls_datum_t * m will hold the modulus gnutls_datum_t * e will hold the public exponentDescriptionThis function will export the RSA public key’s parameters found in the given structure. The new parameters will be allocated using…

gnutls_x509_crt_get_pk_dsa_raw – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_pk_dsa_raw(gnutls_x509_crt_t crt, gnutls_datum_t * p, gnutls_datum_t * q, gnutls_datum_t * g, gnutls_datum_t * y); Argumentsgnutls_x509_crt_t crt Holds the certificate gnutls_datum_t * p will hold the p gnutls_datum_t * q will hold the q gnutls_datum_t * g will hold the g gnutls_datum_t * y will hold the yDescriptionThis function…

gnutls_x509_crt_get_pk_algorithm – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_pk_algorithm(gnutls_x509_crt_t cert, unsigned int * bits); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure unsigned int * bits if bits is non null it will hold the size of the parameters’ in bitsDescriptionThis function will return the public key algorithm of an X.509 certificate. If bits is non null,…

gnutls_x509_crt_get_name_constraints – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_name_constraints(gnutls_x509_crt_t crt, gnutls_x509_name_constraints_t nc, unsigned int flags, unsigned int * critical); Argumentsgnutls_x509_crt_t crt should contain a gnutls_x509_crt_t structure gnutls_x509_name_constraints_t nc The nameconstraints intermediate structure unsigned int flags zero or GNUTLS_NAME_CONSTRAINTS_FLAG_APPEND unsigned int * critical the extension statusDescriptionThis function will return an intermediate structure containing the name constraints of…

gnutls_x509_crt_get_key_usage – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_key_usage(gnutls_x509_crt_t cert, unsigned int * key_usage, unsigned int * critical); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure unsigned int * key_usage where the key usage bits will be stored unsigned int * critical will be non-zero if the extension is marked as criticalDescriptionThis function will return certificate’s key…

gnutls_x509_crt_get_key_purpose_oid – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_key_purpose_oid(gnutls_x509_crt_t cert, int indx, void * oid, size_t * oid_size, unsigned int * critical); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure int indx This specifies which OID to return. Use (0) to get the first one. void * oid a pointer to a buffer to hold the OID…

gnutls_x509_crt_get_key_id – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_key_id(gnutls_x509_crt_t crt, unsigned int flags, unsigned char * output_data, size_t * output_data_size); Argumentsgnutls_x509_crt_t crt Holds the certificate unsigned int flags should be 0 for now unsigned char * output_data will contain the key ID size_t * output_data_size holds the size of output_data (and will be replaced by the…

gnutls_x509_crt_get_issuer_unique_id – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_issuer_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_issuer_dn_oid – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_issuer_dn_oid(gnutls_x509_crt_t cert, int indx, void * oid, size_t * oid_size); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure int indx This specifies which OID to return. Use (0) to get the first one. void * oid a pointer to a buffer to hold the OID (may be null) size_t…

gnutls_x509_crt_get_issuer_dn_by_oid – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crt_get_issuer_dn_by_oid(gnutls_x509_crt_t cert, const char * oid, int indx, unsigned int raw_flag, void * buf, size_t * buf_size); Argumentsgnutls_x509_crt_t cert should contain a gnutls_x509_crt_t structure const char * oid holds an Object Identified in null terminated string int indx In case multiple same OIDs exist in the RDN, this…