Linux Manuals session 3

gnutls_openpgp_crt_import – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_import(gnutls_openpgp_crt_t key, const gnutls_datum_t * data, gnutls_openpgp_crt_fmt_t format); Argumentsgnutls_openpgp_crt_t key The structure to store the parsed key. const gnutls_datum_t * data The RAW or BASE64 encoded key. gnutls_openpgp_crt_fmt_t format One of gnutls_openpgp_crt_fmt_t elements.DescriptionThis function will convert the given RAW or Base64 encoded key to the native gnutls_openpgp_crt_t format….

gnutls_openpgp_crt_get_version – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_version(gnutls_openpgp_crt_t key); Argumentsgnutls_openpgp_crt_t key the structure that contains the OpenPGP public key.DescriptionExtract the version of the OpenPGP key. Returnsthe version number is returned, or a negative error code on errors. Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation, Inc.. Copying…

gnutls_openpgp_crt_get_subkey_usage – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_subkey_usage(gnutls_openpgp_crt_t key, unsigned int idx, unsigned int * key_usage); Argumentsgnutls_openpgp_crt_t key should contain a gnutls_openpgp_crt_t structure unsigned int idx the subkey index unsigned int * key_usage where the key usage bits will be storedDescriptionThis function will return certificate’s key usage, by checking the key algorithm. The key usage…

gnutls_openpgp_crt_get_subkey_revoked_status – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_subkey_revoked_status(gnutls_openpgp_crt_t key, unsigned int idx); Argumentsgnutls_openpgp_crt_t key the structure that contains the OpenPGP public key. unsigned int idx is the subkey indexDescriptionGet subkey revocation status. A negative error code indicates an error. Returnstrue (1) if the key has been revoked, or false (0) if it has not. Since2.4.0…

gnutls_openpgp_crt_get_subkey_pk_rsa_raw – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_subkey_pk_rsa_raw(gnutls_openpgp_crt_t crt, unsigned int idx, gnutls_datum_t * m, gnutls_datum_t * e); Argumentsgnutls_openpgp_crt_t crt Holds the certificate unsigned int idx Is the subkey index gnutls_datum_t * m will hold the modulus gnutls_datum_t * e will hold the public exponentDescriptionThis function will export the RSA public key’s parameters found in…

gnutls_openpgp_crt_get_subkey_pk_dsa_raw – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_subkey_pk_dsa_raw(gnutls_openpgp_crt_t crt, unsigned int idx, gnutls_datum_t * p, gnutls_datum_t * q, gnutls_datum_t * g, gnutls_datum_t * y); Argumentsgnutls_openpgp_crt_t crt Holds the certificate unsigned int idx Is the subkey index gnutls_datum_t * p will hold the p gnutls_datum_t * q will hold the q gnutls_datum_t * g will hold…

gnutls_openpgp_crt_get_subkey_pk_algorithm – API function Synopsis#include <gnutls/openpgp.h> gnutls_pk_algorithm_t gnutls_openpgp_crt_get_subkey_pk_algorithm(gnutls_openpgp_crt_t key, unsigned int idx, unsigned int * bits); Argumentsgnutls_openpgp_crt_t key is an OpenPGP key unsigned int idx is the subkey index 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…

gnutls_openpgp_crt_get_subkey_idx – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_subkey_idx(gnutls_openpgp_crt_t key, const gnutls_openpgp_keyid_t keyid); Argumentsgnutls_openpgp_crt_t key the structure that contains the OpenPGP public key. const gnutls_openpgp_keyid_t keyid the keyid.DescriptionGet subkey’s index. Returnsthe index of the subkey or a negative error value. Since2.4.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software…

gnutls_openpgp_crt_get_subkey_id – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_subkey_id(gnutls_openpgp_crt_t key, unsigned int idx, gnutls_openpgp_keyid_t keyid); Argumentsgnutls_openpgp_crt_t key the structure that contains the OpenPGP public key. unsigned int idx the subkey index gnutls_openpgp_keyid_t keyid the buffer to save the keyid.DescriptionGet the subkey’s key-id. Returnsthe 64-bit keyID of the OpenPGP key. Reporting BugsReport bugs to <bugs [at] gnutls.org>….

gnutls_openpgp_crt_get_subkey_fingerprint – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_subkey_fingerprint(gnutls_openpgp_crt_t key, unsigned int idx, void * fpr, size_t * fprlen); Argumentsgnutls_openpgp_crt_t key the raw data that contains the OpenPGP public key. unsigned int idx the subkey index void * fpr the buffer to save the fingerprint, must hold at least 20 bytes. size_t * fprlen the integer…

gnutls_openpgp_crt_get_subkey_expiration_time – API function Synopsis#include <gnutls/openpgp.h> time_t gnutls_openpgp_crt_get_subkey_expiration_time(gnutls_openpgp_crt_t key, unsigned int idx); Argumentsgnutls_openpgp_crt_t key the structure that contains the OpenPGP public key. unsigned int idx the subkey indexDescriptionGet subkey expiration time. A value of ‘0’ means that the key doesn’t expire at all. Returnsthe time when the OpenPGP key expires. Since2.4.0 Reporting BugsReport bugs to…

gnutls_openpgp_crt_get_subkey_creation_time – API function Synopsis#include <gnutls/openpgp.h> time_t gnutls_openpgp_crt_get_subkey_creation_time(gnutls_openpgp_crt_t key, unsigned int idx); Argumentsgnutls_openpgp_crt_t key the structure that contains the OpenPGP public key. unsigned int idx the subkey indexDescriptionGet subkey creation time. Returnsthe timestamp when the OpenPGP sub-key was created. Since2.4.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software…

gnutls_openpgp_crt_get_subkey_count – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_subkey_count(gnutls_openpgp_crt_t key); Argumentsgnutls_openpgp_crt_t key is an OpenPGP keyDescriptionThis function will return the number of subkeys present in the given OpenPGP certificate. Returnsthe number of subkeys, or a negative error code on error. Since2.4.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software…

gnutls_openpgp_crt_get_revoked_status – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_revoked_status(gnutls_openpgp_crt_t key); Argumentsgnutls_openpgp_crt_t key the structure that contains the OpenPGP public key.DescriptionGet revocation status of key. Returnstrue (1) if the key has been revoked, or false (0) if it has not. Since2.4.0 Reporting BugsReport bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org CopyrightCopyright © 2001-2014 Free Software Foundation,…

gnutls_openpgp_crt_get_preferred_key_id – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_preferred_key_id(gnutls_openpgp_crt_t key, gnutls_openpgp_keyid_t keyid); Argumentsgnutls_openpgp_crt_t key the structure that contains the OpenPGP public key. gnutls_openpgp_keyid_t keyid the struct to save the keyid.DescriptionGet preferred key id. If it hasn’t been set it returns GNUTLS_E_INVALID_REQUEST. Returnsthe 64-bit preferred keyID of the OpenPGP key. Reporting BugsReport bugs to <bugs [at] gnutls.org>….

gnutls_openpgp_crt_get_pk_rsa_raw – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_pk_rsa_raw(gnutls_openpgp_crt_t crt, gnutls_datum_t * m, gnutls_datum_t * e); Argumentsgnutls_openpgp_crt_t crt Holds the certificate gnutls_datum_t * m will hold the modulus gnutls_datum_t * e will hold the public exponentDescriptionThis function will export the RSA public key’s parameters found in the given structure. The new parameters will be allocated using…

gnutls_openpgp_crt_get_pk_dsa_raw – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_pk_dsa_raw(gnutls_openpgp_crt_t crt, gnutls_datum_t * p, gnutls_datum_t * q, gnutls_datum_t * g, gnutls_datum_t * y); Argumentsgnutls_openpgp_crt_t crt Holds the certificate 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 * y will hold the yDescriptionThis function…

gnutls_openpgp_crt_get_pk_algorithm – API function Synopsis#include <gnutls/openpgp.h> gnutls_pk_algorithm_t gnutls_openpgp_crt_get_pk_algorithm(gnutls_openpgp_crt_t key, unsigned int * bits); Argumentsgnutls_openpgp_crt_t key is an OpenPGP key 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 an OpenPGP certificate. If bits is non null, it…

gnutls_openpgp_crt_get_name – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_name(gnutls_openpgp_crt_t key, int idx, char * buf, size_t * sizeof_buf); Argumentsgnutls_openpgp_crt_t key the structure that contains the OpenPGP public key. int idx the index of the ID to extract char * buf a pointer to a structure to hold the name, may be NULL to only get the…

gnutls_openpgp_crt_get_key_usage – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_key_usage(gnutls_openpgp_crt_t key, unsigned int * key_usage); Argumentsgnutls_openpgp_crt_t key should contain a gnutls_openpgp_crt_t structure unsigned int * key_usage where the key usage bits will be storedDescriptionThis function will return certificate’s key usage, by checking the key algorithm. The key usage value will ORed values of the: GNUTLS_KEY_DIGITAL_SIGNATURE, GNUTLS_KEY_KEY_ENCIPHERMENT. ReturnsGNUTLS_E_SUCCESS…