Section 3: library functions
gnutls_x509_ext_import_basic_constraints – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_import_basic_constraints(const gnutls_datum_t * ext, unsigned int * ca, int * pathlen); Argumentsconst gnutls_datum_t * ext the DER encoded extension data unsigned int * ca will be non zero if the CA status is true int * pathlen the path length constraint; will be set to -1 for no…
gnutls_x509_ext_import_authority_key_id – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_import_authority_key_id(const gnutls_datum_t * ext, gnutls_x509_aki_t aki, unsigned int flags); Argumentsconst gnutls_datum_t * ext a DER encoded extension gnutls_x509_aki_t aki An initialized authority key identifier structure unsigned int flags should be zeroDescriptionThis function will return the subject key ID stored in the provided AuthorityKeyIdentifier extension. ReturnsOn success, GNUTLS_E_SUCCESS (0)…
gnutls_x509_ext_import_aia – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_import_aia(const gnutls_datum_t * ext, gnutls_x509_aia_t aia, unsigned int flags); Argumentsconst gnutls_datum_t * ext The DER-encoded extension data gnutls_x509_aia_t aia The authority info access structure unsigned int flags should be zeroDescriptionThis function extracts the Authority Information Access (AIA) extension from the provided DER-encoded data; see RFC 5280 section 4.2.2.1…
gnutls_x509_ext_export_subject_key_id – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_subject_key_id(const gnutls_datum_t * id, gnutls_datum_t * ext); Argumentsconst gnutls_datum_t * id The key identifier gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free().DescriptionThis function will convert the provided key identifier to a DER-encoded PKIX SubjectKeyIdentifier extension. The output data in ext will be allocated using…
gnutls_x509_ext_export_subject_alt_names – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_subject_alt_names(gnutls_subject_alt_names_t sans, gnutls_datum_t * ext); Argumentsgnutls_subject_alt_names_t sans The alternative names structure gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free().DescriptionThis function will convert the provided alternative names structure to a DER-encoded SubjectAltName PKIX extension. The output data in ext will be allocated using gnutls_malloc(). ReturnsOn…
gnutls_x509_ext_export_proxy – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_proxy(int pathLenConstraint, const char * policyLanguage, const char * policy, size_t sizeof_policy, gnutls_datum_t * ext); Argumentsint pathLenConstraint non-negative error codes indicate maximum length of path, and negative error codes indicate that the pathLenConstraints field should not be present. const char * policyLanguage OID describing the language of policy…
gnutls_x509_ext_export_private_key_usage_period – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_private_key_usage_period(time_t activation, time_t expiration, gnutls_datum_t * ext); Argumentstime_t activation The activation time time_t expiration The expiration time gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free().DescriptionThis function will convert the periods provided to a private key usage DER encoded extension (2.5.29.16). The ext data will…
gnutls_x509_ext_export_policies – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_policies(gnutls_x509_policies_t policies, gnutls_datum_t * ext); Argumentsgnutls_x509_policies_t policies A pointer to an initialized policies structure. gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free().DescriptionThis function will convert the provided policies, to a certificate policy DER encoded extension (2.5.29.32). The ext data will be allocated using gnutls_malloc()….
gnutls_x509_ext_export_name_constraints – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_name_constraints(gnutls_x509_name_constraints_t nc, gnutls_datum_t * ext); Argumentsgnutls_x509_name_constraints_t nc The nameconstraints structure gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free().DescriptionThis function will convert the provided name constraints structure to a DER-encoded PKIX NameConstraints (2.5.29.30) extension. The output data in ext will be allocated usin gnutls_malloc(). ReturnsOn success, GNUTLS_E_SUCCESS…
gnutls_x509_ext_export_key_usage – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_key_usage(unsigned int usage, gnutls_datum_t * ext); Argumentsunsigned int usage an ORed sequence of the GNUTLS_KEY_* elements. gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free().DescriptionThis function will convert the keyUsage bit string to a DER encoded PKIX extension. The ext data will be allocated using…
gnutls_x509_ext_export_key_purposes – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_key_purposes(gnutls_x509_key_purposes_t p, gnutls_datum_t * ext); Argumentsgnutls_x509_key_purposes_t p The key purposes structure gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free().DescriptionThis function will convert the key purposes structure to a DER-encoded PKIX ExtKeyUsageSyntax (2.5.29.37) extension. The output data in ext will be allocated usin gnutls_malloc(). ReturnsOn success, GNUTLS_E_SUCCESS…
gnutls_x509_ext_export_crl_dist_points – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_crl_dist_points(gnutls_x509_crl_dist_points_t cdp, gnutls_datum_t * ext); Argumentsgnutls_x509_crl_dist_points_t cdp A pointer to an initialized CRL distribution points structure. gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free().DescriptionThis function will convert the provided policies, to a certificate policy DER encoded extension (2.5.29.31). The ext data will be allocated…
gnutls_x509_ext_export_basic_constraints – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_basic_constraints(unsigned int ca, int pathlen, gnutls_datum_t * ext); Argumentsunsigned int ca non-zero for a CA int pathlen The path length constraint (set to -1 for no constraint) gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free().DescriptionThis function will convert the parameters provided to a basic…
gnutls_x509_ext_export_authority_key_id – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_authority_key_id(gnutls_x509_aki_t aki, gnutls_datum_t * ext); Argumentsgnutls_x509_aki_t aki An initialized authority key identifier structure gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free().DescriptionThis function will convert the provided key identifier to a DER-encoded PKIX AuthorityKeyIdentifier extension. The output data in ext will be allocated using gnutls_malloc()….
gnutls_x509_ext_export_aia – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_ext_export_aia(gnutls_x509_aia_t aia, gnutls_datum_t * ext); Argumentsgnutls_x509_aia_t aia The authority info access structure gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free().DescriptionThis function will DER encode the Authority Information Access (AIA) extension; see RFC 5280 section 4.2.2.1 for more information on the extension. ReturnsOn success, GNUTLS_E_SUCCESS…
gnutls_x509_ext_deinit – API function Synopsis#include <gnutls/x509.h> void gnutls_x509_ext_deinit(gnutls_x509_ext_st * ext); Argumentsgnutls_x509_ext_st * ext The extensions structureDescriptionThis function will deinitialize an extensions structure. Since3.3.8 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 in any medium…
gnutls_x509_dn_oid_name – API function Synopsis#include <gnutls/x509.h> const char * gnutls_x509_dn_oid_name(const char * oid, unsigned int flags); Argumentsconst char * oid holds an Object Identifier in a null terminated string unsigned int flags 0 or GNUTLS_X509_DN_OID_*DescriptionThis function will return the name of a known DN OID. If GNUTLS_X509_DN_OID_RETURN_OID is specified this function will return the given…
gnutls_x509_dn_oid_known – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_dn_oid_known(const char * oid); Argumentsconst char * oid holds an Object Identifier in a null terminated stringDescriptionThis function will inform about known DN OIDs. This is useful since functions like gnutls_x509_crt_set_dn_by_oid() use the information on known OIDs to properly encode their input. Object Identifiers that are not known…
gnutls_x509_dn_init – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_dn_init(gnutls_x509_dn_t * dn); Argumentsgnutls_x509_dn_t * dn the object to be initializedDescriptionThis function initializes a gnutls_x509_dn_t structure. The object returned must be deallocated using gnutls_x509_dn_deinit(). ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Since2.4.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright ©…
gnutls_x509_dn_import – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_dn_import(gnutls_x509_dn_t dn, const gnutls_datum_t * data); Argumentsgnutls_x509_dn_t dn the structure that will hold the imported DN const gnutls_datum_t * data should contain a DER encoded RDN sequenceDescriptionThis function parses an RDN sequence and stores the result to a gnutls_x509_dn_t structure. The structure must have been initialized with gnutls_x509_dn_init()….