Linux Manuals session 3

gnutls_x509_crq_set_key_usage – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_set_key_usage(gnutls_x509_crq_t crq, unsigned int usage); Argumentsgnutls_x509_crq_t crq a certificate request of type gnutls_x509_crq_t unsigned int usage an ORed sequence of the GNUTLS_KEY_* elements.DescriptionThis function will set the keyUsage certificate extension. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Since2.8.0 Reporting BugsReport bugs to <bugs [at]…

gnutls_x509_crq_set_key_rsa_raw – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_set_key_rsa_raw(gnutls_x509_crq_t crq, const gnutls_datum_t * m, const gnutls_datum_t * e); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_t structure const gnutls_datum_t * m holds the modulus const gnutls_datum_t * e holds the public exponentDescriptionThis function will set the public parameters from the given private key to the request. Only RSA…

gnutls_x509_crq_set_key_purpose_oid – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_set_key_purpose_oid(gnutls_x509_crq_t crq, const void * oid, unsigned int critical); Argumentsgnutls_x509_crq_t crq a certificate of type gnutls_x509_crq_t const void * oid a pointer to a (0)-terminated string that holds the OID unsigned int critical Whether this extension will be critical or notDescriptionThis function will set the key purpose OIDs…

gnutls_x509_crq_set_key – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_set_key(gnutls_x509_crq_t crq, gnutls_x509_privkey_t key); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_t structure gnutls_x509_privkey_t key holds a private keyDescriptionThis function will set the public parameters from the given private key to the request. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Reporting BugsReport bugs to <bugs [at]…

gnutls_x509_crq_set_dn_by_oid – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_set_dn_by_oid(gnutls_x509_crq_t crq, const char * oid, unsigned int raw_flag, const void * data, unsigned int sizeof_data); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_t structure const char * oid holds an Object Identifier in a (0)-terminated string unsigned int raw_flag must be 0, or 1 if the data are DER…

gnutls_x509_crq_set_dn – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_set_dn(gnutls_x509_crq_t crq, const char * dn, const char ** err); Argumentsgnutls_x509_crq_t crq a certificate of type gnutls_x509_crq_t const char * dn a comma separated DN string (RFC4514) const char ** err indicates the error position (if any)DescriptionThis function will set the DN on the provided certificate. The input…

gnutls_x509_crq_set_challenge_password – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_set_challenge_password(gnutls_x509_crq_t crq, const char * pass); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_t structure const char * pass holds a (0)-terminated passwordDescriptionThis function will set a challenge password to be used when revoking the request. ReturnsOn success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. Reporting BugsReport bugs…

gnutls_x509_crq_set_basic_constraints – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_set_basic_constraints(gnutls_x509_crq_t crq, unsigned int ca, int pathLenConstraint); Argumentsgnutls_x509_crq_t crq a certificate request of type gnutls_x509_crq_t unsigned int ca true(1) or false(0) depending on the Certificate authority status. int pathLenConstraint non-negative error codes indicate maximum length of path, and negative error codes indicate that the pathLenConstraints field should not…

gnutls_x509_crq_set_attribute_by_oid – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_set_attribute_by_oid(gnutls_x509_crq_t crq, const char * oid, void * buf, size_t buf_size); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_t structure const char * oid holds an Object Identifier in a null-terminated string void * buf a pointer to a structure that holds the attribute data size_t buf_size holds the size…

gnutls_x509_crq_privkey_sign – API function Synopsis#include <gnutls/abstract.h> int gnutls_x509_crq_privkey_sign(gnutls_x509_crq_t crq, gnutls_privkey_t key, gnutls_digest_algorithm_t dig, unsigned int flags); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_t structure gnutls_privkey_t key holds a private key gnutls_digest_algorithm_t dig The message digest to use, i.e., GNUTLS_DIG_SHA1 unsigned int flags must be 0DescriptionThis function will sign the certificate request with a private key. This…

gnutls_x509_crq_print – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_print(gnutls_x509_crq_t crq, gnutls_certificate_print_formats_t format, gnutls_datum_t * out); Argumentsgnutls_x509_crq_t crq The structure to be printed gnutls_certificate_print_formats_t format Indicate the format to use gnutls_datum_t * out Newly allocated datum with null terminated string.DescriptionThis function will pretty print a certificate request, suitable for display to a human. The output out needs…

gnutls_x509_crq_init – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_init(gnutls_x509_crq_t * crq); Argumentsgnutls_x509_crq_t * crq The structure to be initializedDescriptionThis function will initialize a PKCS10 certificate request 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…

gnutls_x509_crq_import – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_import(gnutls_x509_crq_t crq, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format); Argumentsgnutls_x509_crq_t crq The structure to store the parsed certificate request. 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 certificate request to a…

gnutls_x509_crq_get_version – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_get_version(gnutls_x509_crq_t crq); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_t structureDescriptionThis function will return the version of the specified Certificate request. Returnsversion of certificate request, or a negative error code on error. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying…

gnutls_x509_crq_get_subject_alt_othername_oid – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_get_subject_alt_othername_oid(gnutls_x509_crq_t crq, unsigned int seq, void * ret, size_t * ret_size); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_t structure unsigned int seq specifies the sequence number of the alt name (0 for the first one, 1 for the second etc.) void * ret is the place where the otherName…

gnutls_x509_crq_get_subject_alt_name – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_get_subject_alt_name(gnutls_x509_crq_t crq, unsigned int seq, void * ret, size_t * ret_size, unsigned int * ret_type, unsigned int * critical); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_t structure unsigned int seq specifies the sequence number of the alt name, 0 for the first one, 1 for the second etc. void…

gnutls_x509_crq_get_private_key_usage_period – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_get_private_key_usage_period(gnutls_x509_crq_t crq, time_t * activation, time_t * expiration, unsigned int * critical); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_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_crq_get_pk_algorithm – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_get_pk_algorithm(gnutls_x509_crq_t crq, unsigned int * bits); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_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 a PKCS10 certificate request. If bits is non-NULL, it…

gnutls_x509_crq_get_key_usage – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_get_key_usage(gnutls_x509_crq_t crq, unsigned int * key_usage, unsigned int * critical); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_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_crq_get_key_usage – API function Synopsis#include <gnutls/x509.h> int gnutls_x509_crq_get_key_usage(gnutls_x509_crq_t crq, unsigned int * key_usage, unsigned int * critical); Argumentsgnutls_x509_crq_t crq should contain a gnutls_x509_crq_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…