Linux Manuals session 3

gnutls_x509_trust_list_add_cas – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_trust_list_add_cas(gnutls_x509_trust_list_t list, const gnutls_x509_crt_t * clist, unsigned clist_size, unsigned int flags); Argumentsgnutls_x509_trust_list_t list The structure of the list const gnutls_x509_crt_t * clist A list of CAs unsigned clist_size The length of the CA list unsigned int flags should be 0 or an or’ed sequence of GNUTLS_TL options.DescriptionThis function…

gnutls_x509_rdn_get_oid – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_rdn_get_oid(const gnutls_datum_t * idn, int indx, void * buf, size_t * buf_size); Argumentsconst gnutls_datum_t * idn should contain a DER encoded RDN sequence int indx Indicates which OID to return. Use 0 for the first one. void * buf a pointer to a structure to hold the peer’s…

gnutls_x509_rdn_get_by_oid – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_rdn_get_by_oid(const gnutls_datum_t * idn, const char * oid, int indx, unsigned int raw_flag, void * buf, size_t * buf_size); Argumentsconst gnutls_datum_t * idn should contain a DER encoded RDN sequence const char * oid an Object Identifier int indx In case multiple same OIDs exist in the RDN…

gnutls_x509_rdn_get – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_rdn_get(const gnutls_datum_t * idn, char * buf, size_t * buf_size); Argumentsconst gnutls_datum_t * idn should contain a DER encoded RDN sequence char * buf a pointer to a structure to hold the peer’s name size_t * buf_size holds the size of bufDescriptionThis function will return the name of…

gnutls_x509_privkey_verify_params – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_verify_params(gnutls_x509_privkey_t key); Argumentsgnutls_x509_privkey_t key should contain a gnutls_x509_privkey_t structureDescriptionThis function will verify the private key parameters. 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 distribution of…

gnutls_x509_privkey_verify_data – Verify the signed data using private key Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_verify_data(gnutls_x509_privkey_t key, unsigned int flags, const gnutls_datum_t * data, const gnutls_datum_t * signature); Argumentsgnutls_x509_privkey_t key Holds the key unsigned int flags should be 0 for now const gnutls_datum_t * data holds the data to be signed const gnutls_datum_t * signature contains the signatureDescriptionThis…

gnutls_x509_privkey_sign_hash – API function Synopsis#include <gnutls/compat.h> int gnutls_x509_privkey_sign_hash(gnutls_x509_privkey_t key, const gnutls_datum_t * hash, gnutls_datum_t * signature); Argumentsgnutls_x509_privkey_t key Holds the key const gnutls_datum_t * hash holds the data to be signed gnutls_datum_t * signature will contain newly allocated signatureDescriptionThis function will sign the given hash using the private key. Do not use this function directly…

gnutls_x509_privkey_sign_data – API function Synopsis#include <gnutls/compat.h> int gnutls_x509_privkey_sign_data(gnutls_x509_privkey_t key, gnutls_digest_algorithm_t digest, unsigned int flags, const gnutls_datum_t * data, void * signature, size_t * signature_size); Argumentsgnutls_x509_privkey_t key Holds the key gnutls_digest_algorithm_t digest should be MD5 or SHA1 unsigned int flags should be 0 for now const gnutls_datum_t * data holds the data to be signed void…

gnutls_x509_privkey_sec_param – API function Synopsis#include <gnutls/x509.h> gnutls_sec_param_t gnutls_x509_privkey_sec_param(gnutls_x509_privkey_t key); Argumentsgnutls_x509_privkey_t key a key structureDescriptionThis function will return the security parameter appropriate with this private key. ReturnsOn success, a valid security parameter is returned otherwise GNUTLS_SEC_PARAM_UNKNOWN is returned. Since2.12.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc…..

gnutls_x509_privkey_init – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_init(gnutls_x509_privkey_t * key); Argumentsgnutls_x509_privkey_t * key The structure to be initializedDescriptionThis function will initialize an private key 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_privkey_import_rsa_raw2 – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_import_rsa_raw2(gnutls_x509_privkey_t key, const gnutls_datum_t * m, const gnutls_datum_t * e, const gnutls_datum_t * d, const gnutls_datum_t * p, const gnutls_datum_t * q, const gnutls_datum_t * u, const gnutls_datum_t * e1, const gnutls_datum_t * e2); Argumentsgnutls_x509_privkey_t key The structure to store the parsed key const gnutls_datum_t * m holds…

gnutls_x509_privkey_import_rsa_raw – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_import_rsa_raw(gnutls_x509_privkey_t key, const gnutls_datum_t * m, const gnutls_datum_t * e, const gnutls_datum_t * d, const gnutls_datum_t * p, const gnutls_datum_t * q, const gnutls_datum_t * u); Argumentsgnutls_x509_privkey_t key The structure to store the parsed key const gnutls_datum_t * m holds the modulus const gnutls_datum_t * e holds the…

gnutls_x509_privkey_import_pkcs8 – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_import_pkcs8(gnutls_x509_privkey_t key, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format, const char * password, unsigned int flags); Argumentsgnutls_x509_privkey_t key The structure to store the parsed key const gnutls_datum_t * data The DER or PEM encoded key. gnutls_x509_crt_fmt_t format One of DER or PEM const char * password the password to…

gnutls_x509_privkey_import_openssl – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_import_openssl(gnutls_x509_privkey_t key, const gnutls_datum_t * data, const char * password); Argumentsgnutls_x509_privkey_t key The structure to store the parsed key const gnutls_datum_t * data The DER or PEM encoded key. const char * password the password to decrypt the key (if it is encrypted).DescriptionThis function will convert the given…

gnutls_x509_privkey_import_ecc_raw – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_import_ecc_raw(gnutls_x509_privkey_t key, gnutls_ecc_curve_t curve, const gnutls_datum_t * x, const gnutls_datum_t * y, const gnutls_datum_t * k); Argumentsgnutls_x509_privkey_t key The structure to store the parsed key gnutls_ecc_curve_t curve holds the curve const gnutls_datum_t * x holds the x const gnutls_datum_t * y holds the y const gnutls_datum_t * k…

gnutls_x509_privkey_import_dsa_raw – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_import_dsa_raw(gnutls_x509_privkey_t key, const gnutls_datum_t * p, const gnutls_datum_t * q, const gnutls_datum_t * g, const gnutls_datum_t * y, const gnutls_datum_t * x); Argumentsgnutls_x509_privkey_t key The structure to store the parsed key const gnutls_datum_t * p holds the p const gnutls_datum_t * q holds the q const gnutls_datum_t *…

gnutls_x509_privkey_import2 – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_import2(gnutls_x509_privkey_t key, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format, const char * password, unsigned int flags); Argumentsgnutls_x509_privkey_t key The structure to store the parsed key const gnutls_datum_t * data The DER or PEM encoded key. gnutls_x509_crt_fmt_t format One of DER or PEM const char * password A password (optional)…

gnutls_x509_privkey_import – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_import(gnutls_x509_privkey_t key, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format); Argumentsgnutls_x509_privkey_t key The structure to store the parsed key 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 key to the native gnutls_x509_privkey_t…

gnutls_x509_privkey_get_pk_algorithm2 – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_get_pk_algorithm2(gnutls_x509_privkey_t key, unsigned int * bits); Argumentsgnutls_x509_privkey_t key should contain a gnutls_x509_privkey_t structure unsigned int * bits The number of bits in the public key algorithmDescriptionThis function will return the public key algorithm of a private key. Returnsa member of the gnutls_pk_algorithm_t enumeration on success, or a negative…

gnutls_x509_privkey_get_pk_algorithm – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_privkey_get_pk_algorithm(gnutls_x509_privkey_t key); Argumentsgnutls_x509_privkey_t key should contain a gnutls_x509_privkey_t structureDescriptionThis function will return the public key algorithm of a private key. Returnsa member of the gnutls_pk_algorithm_t enumeration on success, or a negative error code on error. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014…