Section 3: library functions
gnutls_x509_privkey_get_key_id – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_get_key_id(gnutls_x509_privkey_t key, unsigned int flags, unsigned char * output_data, size_t * output_data_size); Argumentsgnutls_x509_privkey_t key Holds the key 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_privkey_generate – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_generate(gnutls_x509_privkey_t key, gnutls_pk_algorithm_t algo, unsigned int bits, unsigned int flags); Argumentsgnutls_x509_privkey_t key should contain a gnutls_x509_privkey_t structure gnutls_pk_algorithm_t algo is one of the algorithms in gnutls_pk_algorithm_t. unsigned int bits the size of the modulus unsigned int flags unused for now. Must be 0.DescriptionThis function will generate a random…
gnutls_x509_privkey_fix – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_fix(gnutls_x509_privkey_t key); Argumentsgnutls_x509_privkey_t key Holds the keyDescriptionThis function will recalculate the secondary parameters in a key. In RSA keys, this can be the coefficient and exponent1,2. 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…
gnutls_x509_privkey_export_rsa_raw2 – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_export_rsa_raw2(gnutls_x509_privkey_t key, gnutls_datum_t * m, gnutls_datum_t * e, gnutls_datum_t * d, gnutls_datum_t * p, gnutls_datum_t * q, gnutls_datum_t * u, gnutls_datum_t * e1, gnutls_datum_t * e2); Argumentsgnutls_x509_privkey_t key a structure that holds the rsa parameters gnutls_datum_t * m will hold the modulus gnutls_datum_t * e will hold the…
gnutls_x509_privkey_export_rsa_raw – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_export_rsa_raw(gnutls_x509_privkey_t key, gnutls_datum_t * m, gnutls_datum_t * e, gnutls_datum_t * d, gnutls_datum_t * p, gnutls_datum_t * q, gnutls_datum_t * u); Argumentsgnutls_x509_privkey_t key a structure that holds the rsa parameters gnutls_datum_t * m will hold the modulus gnutls_datum_t * e will hold the public exponent gnutls_datum_t * d will…
gnutls_x509_privkey_export_pkcs8 – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_export_pkcs8(gnutls_x509_privkey_t key, gnutls_x509_crt_fmt_t format, const char * password, unsigned int flags, void * output_data, size_t * output_data_size); Argumentsgnutls_x509_privkey_t key Holds the key gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. const char * password the password that will be used to encrypt the key….
gnutls_x509_privkey_export_ecc_raw – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_export_ecc_raw(gnutls_x509_privkey_t key, gnutls_ecc_curve_t * curve, gnutls_datum_t * x, gnutls_datum_t * y, gnutls_datum_t * k); Argumentsgnutls_x509_privkey_t key a structure that holds the rsa parameters gnutls_ecc_curve_t * curve will hold the curve gnutls_datum_t * x will hold the x coordinate gnutls_datum_t * y will hold the y coordinate gnutls_datum_t *…
gnutls_x509_privkey_export_dsa_raw – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_export_dsa_raw(gnutls_x509_privkey_t key, gnutls_datum_t * p, gnutls_datum_t * q, gnutls_datum_t * g, gnutls_datum_t * y, gnutls_datum_t * x); Argumentsgnutls_x509_privkey_t key a structure that holds the DSA parameters 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…
gnutls_x509_privkey_export2_pkcs8 – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_export2_pkcs8(gnutls_x509_privkey_t key, gnutls_x509_crt_fmt_t format, const char * password, unsigned int flags, gnutls_datum_t * out); Argumentsgnutls_x509_privkey_t key Holds the key gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. const char * password the password that will be used to encrypt the key. unsigned int flags…
gnutls_x509_privkey_export2 – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_export2(gnutls_x509_privkey_t key, gnutls_x509_crt_fmt_t format, gnutls_datum_t * out); Argumentsgnutls_x509_privkey_t key Holds the key gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. gnutls_datum_t * out will contain a private key PEM or DER encodedDescriptionThis function will export the private key to a PKCS1 structure for RSA…
gnutls_x509_privkey_export – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_export(gnutls_x509_privkey_t key, gnutls_x509_crt_fmt_t format, void * output_data, size_t * output_data_size); Argumentsgnutls_x509_privkey_t key Holds the key gnutls_x509_crt_fmt_t format the format of output params. One of PEM or DER. void * output_data will contain a private key PEM or DER encoded size_t * output_data_size holds the size of output_data (and…
gnutls_x509_privkey_deinit – API function Synopsis#include <gnutls/x509.h> void gnutls_x509_privkey_deinit(gnutls_x509_privkey_t key); Argumentsgnutls_x509_privkey_t key The structure to be deinitializedDescriptionThis function will deinitialize a private key structure. 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_privkey_cpy – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_cpy(gnutls_x509_privkey_t dst, gnutls_x509_privkey_t src); Argumentsgnutls_x509_privkey_t dst The destination key, which should be initialized. gnutls_x509_privkey_t src The source keyDescriptionThis function will copy a private key from source to destination key. Destination has to be initialized. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Reporting BugsReport bugs…
gnutls_x509_policy_release – API function Synopsis#include <gnutls/x509.h> void gnutls_x509_policy_release(struct gnutls_x509_policy_st * policy); Argumentsstruct gnutls_x509_policy_st * policy a certificate policyDescriptionThis function will deinitialize all memory associated with the provided policy . The policy is allocated using gnutls_x509_crt_get_policy(). Since3.1.5 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…
gnutls_x509_policies_set – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_policies_set(gnutls_x509_policies_t policies, const struct gnutls_x509_policy_st * policy); Argumentsgnutls_x509_policies_t policies An initialized policies structure const struct gnutls_x509_policy_st * policy Contains the policy to setDescriptionThis function will store the specified policy in the provided policies structure. ReturnsOn success, GNUTLS_E_SUCCESS (0), otherwise a negative error value. Since3.3.0 Reporting BugsReport bugs to…
gnutls_x509_policies_init – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_policies_init(gnutls_x509_policies_t * policies); Argumentsgnutls_x509_policies_t * policies The authority key ID structureDescriptionThis function will initialize an authority key ID structure. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Since3.3.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc…..
gnutls_x509_policies_get – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_policies_get(gnutls_x509_policies_t policies, unsigned int seq, struct gnutls_x509_policy_st * policy); Argumentsgnutls_x509_policies_t policies The policies structure unsigned int seq The index of the name to get struct gnutls_x509_policy_st * policy Will hold the policyDescriptionThis function will return a specific policy as stored in the policies structure. The returned values should…
gnutls_x509_policies_deinit – API function Synopsis#include <gnutls/x509-ext.h> void gnutls_x509_policies_deinit(gnutls_x509_policies_t policies); Argumentsgnutls_x509_policies_t policies The authority key identifier structureDescriptionThis function will deinitialize an authority key identifier structure. Since3.3.0 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…
gnutls_x509_othername_to_virtual – API function Synopsis#include <gnutls/x509-ext.h> int gnutls_x509_othername_to_virtual(const char * oid, const gnutls_datum_t * othername, unsigned int * virt_type, gnutls_datum_t * virt); Argumentsconst char * oid The othername object identifier const gnutls_datum_t * othername — undescribed — unsigned int * virt_type GNUTLS_SAN_OTHERNAME_XXX gnutls_datum_t * virt allocated printable dataDescriptionThis function will parse and convert the othername…
gnutls_x509_name_constraints_init – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_name_constraints_init(gnutls_x509_name_constraints_t * nc); Argumentsgnutls_x509_name_constraints_t * nc The nameconstraints structureDescriptionThis function will initialize a name constraints structure. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Since3.3.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution…