SysTutorials Posts

NAME 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); ARGUMENTS const gnutls_datum_t * ext a DER encoded extension gnutls_x509_aki_t aki An initialized authority key identifier structure unsigned int flags should be zero DESCRIPTION This function will return the subject key ID stored in the provided AuthorityKeyIdentifier…

NAME 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); ARGUMENTS const gnutls_datum_t * ext The DER-encoded extension data gnutls_x509_aia_t aia The authority info access structure unsigned int flags should be zero DESCRIPTION This function extracts the Authority Information Access (AIA) extension from the provided DER-encoded data;…

NAME 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); ARGUMENTS const gnutls_datum_t * id The key identifier gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free(). DESCRIPTION This function will convert the provided key identifier to a DER-encoded PKIX SubjectKeyIdentifier extension. The output data in…

NAME 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); ARGUMENTS gnutls_subject_alt_names_t sans The alternative names structure gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free(). DESCRIPTION This function will convert the provided alternative names structure to a DER-encoded SubjectAltName PKIX extension. The output data in ext will…

NAME 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); ARGUMENTS int 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…

NAME 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); ARGUMENTS time_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(). DESCRIPTION This function will convert the periods provided to a private key usage DER encoded extension…

NAME 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); ARGUMENTS gnutls_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(). DESCRIPTION This function will convert the provided policies, to a certificate policy DER encoded extension (2.5.29.32). The ext data…

NAME 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); ARGUMENTS gnutls_x509_name_constraints_t nc The nameconstraints structure gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free(). DESCRIPTION This 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…

NAME 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); ARGUMENTS unsigned 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(). DESCRIPTION This function will convert the keyUsage bit string to a DER encoded PKIX extension. The ext…

NAME 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); ARGUMENTS gnutls_x509_key_purposes_t p The key purposes structure gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free(). DESCRIPTION This 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…

NAME 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); ARGUMENTS gnutls_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(). DESCRIPTION This function will convert the provided policies, to a certificate policy DER encoded extension (2.5.29.31). The…

NAME 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); ARGUMENTS unsigned 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(). DESCRIPTION This function will convert the…

NAME 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); ARGUMENTS gnutls_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(). DESCRIPTION This function will convert the provided key identifier to a DER-encoded PKIX AuthorityKeyIdentifier extension. The output data in ext…

NAME 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); ARGUMENTS gnutls_x509_aia_t aia The authority info access structure gnutls_datum_t * ext The DER-encoded extension data; must be freed using gnutls_free(). DESCRIPTION This function will DER encode the Authority Information Access (AIA) extension; see RFC 5280 section 4.2.2.1 for more information on…

NAME gnutls_x509_ext_deinit – API function SYNOPSIS #include <gnutls/x509.h> void gnutls_x509_ext_deinit(gnutls_x509_ext_st * ext); ARGUMENTS gnutls_x509_ext_st * ext The extensions structure DESCRIPTION This function will deinitialize an extensions structure. SINCE 3.3.8 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution of this file, with…

NAME 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); ARGUMENTS const char * oid holds an Object Identifier in a null terminated string unsigned int flags 0 or GNUTLS_X509_DN_OID_* DESCRIPTION This function will return the name of a known DN OID. If GNUTLS_X509_DN_OID_RETURN_OID is specified this…

NAME gnutls_x509_dn_oid_known – API function SYNOPSIS #include <gnutls/x509.h> int gnutls_x509_dn_oid_known(const char * oid); ARGUMENTS const char * oid holds an Object Identifier in a null terminated string DESCRIPTION This 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…

NAME gnutls_x509_dn_init – API function SYNOPSIS #include <gnutls/x509.h> int gnutls_x509_dn_init(gnutls_x509_dn_t * dn); ARGUMENTS gnutls_x509_dn_t * dn the object to be initialized DESCRIPTION This function initializes a gnutls_x509_dn_t structure. The object returned must be deallocated using gnutls_x509_dn_deinit(). RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. SINCE 2.4.0 REPORTING BUGS Report bugs to…

NAME 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); ARGUMENTS gnutls_x509_dn_t dn the structure that will hold the imported DN const gnutls_datum_t * data should contain a DER encoded RDN sequence DESCRIPTION This function parses an RDN sequence and stores the result to a gnutls_x509_dn_t structure. The structure must…

NAME gnutls_x509_dn_get_rdn_ava – API function SYNOPSIS #include <gnutls/x509.h> int gnutls_x509_dn_get_rdn_ava(gnutls_x509_dn_t dn, int irdn, int iava, gnutls_x509_ava_st * ava); ARGUMENTS gnutls_x509_dn_t dn a pointer to DN int irdn index of RDN int iava index of AVA. gnutls_x509_ava_st * ava Pointer to structure which will hold output information. DESCRIPTION Get pointers to data within the DN. The…