Linux Manuals session 3

gnutls_openpgp_privkey_export_rsa_raw – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_privkey_export_rsa_raw(gnutls_openpgp_privkey_t pkey, 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_openpgp_privkey_t pkey Holds the certificate gnutls_datum_t * m will hold the modulus gnutls_datum_t * e will hold the public exponent gnutls_datum_t * d will hold the private exponent…

gnutls_openpgp_privkey_export_dsa_raw – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_privkey_export_dsa_raw(gnutls_openpgp_privkey_t pkey, gnutls_datum_t * p, gnutls_datum_t * q, gnutls_datum_t * g, gnutls_datum_t * y, gnutls_datum_t * x); Argumentsgnutls_openpgp_privkey_t pkey 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…

gnutls_openpgp_privkey_export2 – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_privkey_export2(gnutls_openpgp_privkey_t key, gnutls_openpgp_crt_fmt_t format, const char * password, unsigned int flags, gnutls_datum_t * out); Argumentsgnutls_openpgp_privkey_t key Holds the key. gnutls_openpgp_crt_fmt_t format One of gnutls_openpgp_crt_fmt_t elements. const char * password the password that will be used to encrypt the key. (unused for now) unsigned int flags (0) for future…

gnutls_openpgp_privkey_export – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_privkey_export(gnutls_openpgp_privkey_t key, gnutls_openpgp_crt_fmt_t format, const char * password, unsigned int flags, void * output_data, size_t * output_data_size); Argumentsgnutls_openpgp_privkey_t key Holds the key. gnutls_openpgp_crt_fmt_t format One of gnutls_openpgp_crt_fmt_t elements. const char * password the password that will be used to encrypt the key. (unused for now) unsigned int flags…

gnutls_openpgp_privkey_deinit – API function Synopsis#include <gnutls/openpgp.h> void gnutls_openpgp_privkey_deinit(gnutls_openpgp_privkey_t key); Argumentsgnutls_openpgp_privkey_t key The structure to be initializedDescriptionThis function will deinitialize a 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 without…

gnutls_openpgp_keyring_init – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_keyring_init(gnutls_openpgp_keyring_t * keyring); Argumentsgnutls_openpgp_keyring_t * keyring A pointer to the type to be initializedDescriptionThis function will initialize an keyring structure. ReturnsGNUTLS_E_SUCCESS on success, or an error code. 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_openpgp_keyring_import – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_keyring_import(gnutls_openpgp_keyring_t keyring, const gnutls_datum_t * data, gnutls_openpgp_crt_fmt_t format); Argumentsgnutls_openpgp_keyring_t keyring The structure to store the parsed key. const gnutls_datum_t * data The RAW or BASE64 encoded keyring. gnutls_openpgp_crt_fmt_t format One of gnutls_openpgp_keyring_fmt elements.DescriptionThis function will convert the given RAW or Base64 encoded keyring to the native gnutls_openpgp_keyring_t format….

gnutls_openpgp_keyring_get_crt_count – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_keyring_get_crt_count(gnutls_openpgp_keyring_t ring); Argumentsgnutls_openpgp_keyring_t ring is an OpenPGP key ringDescriptionThis function will return the number of OpenPGP certificates present in the given keyring. Returnsthe number of subkeys, 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…

gnutls_openpgp_keyring_get_crt – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_keyring_get_crt(gnutls_openpgp_keyring_t ring, unsigned int idx, gnutls_openpgp_crt_t * cert); Argumentsgnutls_openpgp_keyring_t ring Holds the keyring. unsigned int idx the index of the certificate to export gnutls_openpgp_crt_t * cert An uninitialized gnutls_openpgp_crt_t typeDescriptionThis function will extract an OpenPGP certificate from the given keyring. If the index given is out of range…

gnutls_openpgp_keyring_deinit – API function Synopsis#include <gnutls/openpgp.h> void gnutls_openpgp_keyring_deinit(gnutls_openpgp_keyring_t keyring); Argumentsgnutls_openpgp_keyring_t keyring A pointer to the type to be initializedDescriptionThis function will deinitialize a keyring 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…

gnutls_openpgp_keyring_check_id – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_keyring_check_id(gnutls_openpgp_keyring_t ring, const gnutls_openpgp_keyid_t keyid, unsigned int flags); Argumentsgnutls_openpgp_keyring_t ring holds the keyring to check against const gnutls_openpgp_keyid_t keyid will hold the keyid to check for. unsigned int flags unused (should be 0)DescriptionCheck if a given key ID exists in the keyring. ReturnsGNUTLS_E_SUCCESS on success (if keyid exists)…

gnutls_openpgp_crt_verify_self – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_verify_self(gnutls_openpgp_crt_t key, unsigned int flags, unsigned int * verify); Argumentsgnutls_openpgp_crt_t key the structure that holds the key. unsigned int flags unused (should be 0) unsigned int * verify will hold the key verification output.DescriptionVerifies the self signature in the key. The key verification output will be put in…

gnutls_openpgp_crt_verify_ring – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_verify_ring(gnutls_openpgp_crt_t key, gnutls_openpgp_keyring_t keyring, unsigned int flags, unsigned int * verify); Argumentsgnutls_openpgp_crt_t key the structure that holds the key. gnutls_openpgp_keyring_t keyring holds the keyring to check against unsigned int flags unused (should be 0) unsigned int * verify will hold the certificate verification output.DescriptionVerify all signatures in the…

gnutls_openpgp_crt_set_preferred_key_id – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_set_preferred_key_id(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 selected keyidDescriptionThis allows setting a preferred key id for the given certificate. This key will be used by functions that involve key handling. If the provided keyid is NULL…

gnutls_openpgp_crt_print – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_print(gnutls_openpgp_crt_t cert, gnutls_certificate_print_formats_t format, gnutls_datum_t * out); Argumentsgnutls_openpgp_crt_t cert The structure to be printed gnutls_certificate_print_formats_t format Indicate the format to use gnutls_datum_t * out Newly allocated datum with (0) terminated string.DescriptionThis function will pretty print an OpenPGP certificate, suitable for display to a human. The format should be…

gnutls_openpgp_crt_init – API function Synopsis#include <gnutls/openpgp.h> int gnutls_openpgp_crt_init(gnutls_openpgp_crt_t * key); Argumentsgnutls_openpgp_crt_t * key The structure to be initializedDescriptionThis function will initialize an OpenPGP key structure. ReturnsGNUTLS_E_SUCCESS on success, or an error code. 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,…

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…