Linux Manuals session 3

NAME gnutls_pubkey_import_x509 – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_x509(gnutls_pubkey_t key, gnutls_x509_crt_t crt, unsigned int flags); ARGUMENTS gnutls_pubkey_t key The public key gnutls_x509_crt_t crt The certificate to be imported unsigned int flags should be zero DESCRIPTION This function will import the given public key to the abstract gnutls_pubkey_t structure. RETURNS On success, GNUTLS_E_SUCCESS (0) is…

NAME gnutls_pubkey_import_url – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_url(gnutls_pubkey_t key, const char * url, unsigned int flags); ARGUMENTS gnutls_pubkey_t key A key of type gnutls_pubkey_t const char * url A PKCS 11 url unsigned int flags One of GNUTLS_PKCS11_OBJ_* flags DESCRIPTION This function will import a PKCS11 certificate or a TPM key as a…

NAME gnutls_pubkey_import_tpm_url – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_tpm_url(gnutls_pubkey_t pkey, const char * url, const char * srk_password, unsigned int flags); ARGUMENTS gnutls_pubkey_t pkey The public key const char * url The URL of the TPM key to be imported const char * srk_password The password for the SRK key (optional) unsigned int flags…

NAME gnutls_pubkey_import_tpm_raw – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_tpm_raw(gnutls_pubkey_t pkey, const gnutls_datum_t * fdata, gnutls_tpmkey_fmt_t format, const char * srk_password, unsigned int flags); ARGUMENTS gnutls_pubkey_t pkey The public key const gnutls_datum_t * fdata The TPM key to be imported gnutls_tpmkey_fmt_t format The format of the private key const char * srk_password The password for…

NAME gnutls_pubkey_import_rsa_raw – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_rsa_raw(gnutls_pubkey_t key, const gnutls_datum_t * m, const gnutls_datum_t * e); ARGUMENTS gnutls_pubkey_t key Is a structure will hold the parameters const gnutls_datum_t * m holds the modulus const gnutls_datum_t * e holds the public exponent DESCRIPTION This function will replace the parameters in the given structure….

NAME gnutls_pubkey_import_privkey – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_privkey(gnutls_pubkey_t key, gnutls_privkey_t pkey, unsigned int usage, unsigned int flags); ARGUMENTS gnutls_pubkey_t key The public key gnutls_privkey_t pkey The private key unsigned int usage GNUTLS_KEY_* key usage flags. unsigned int flags should be zero DESCRIPTION Imports the public key from a private. This function will import…

NAME gnutls_pubkey_import_pkcs11_url – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_pkcs11_url(gnutls_pubkey_t key, const char * url, unsigned int flags); ARGUMENTS gnutls_pubkey_t key A key of type gnutls_pubkey_t const char * url A PKCS 11 url unsigned int flags One of GNUTLS_PKCS11_OBJ_* flags DESCRIPTION This function will import a PKCS 11 certificate to a gnutls_pubkey_t structure. RETURNS…

NAME gnutls_pubkey_import_pkcs11 – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_pkcs11(gnutls_pubkey_t key, gnutls_pkcs11_obj_t obj, unsigned int flags); ARGUMENTS gnutls_pubkey_t key The public key gnutls_pkcs11_obj_t obj The parameters to be imported unsigned int flags should be zero DESCRIPTION Imports a public key from a pkcs11 key. This function will import the given public key to the abstract…

NAME gnutls_pubkey_import_openpgp_raw – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_openpgp_raw(gnutls_pubkey_t pkey, const gnutls_datum_t * data, gnutls_openpgp_crt_fmt_t format, const gnutls_openpgp_keyid_t keyid, unsigned int flags); ARGUMENTS gnutls_pubkey_t pkey The public key const gnutls_datum_t * data The public key data to be imported gnutls_openpgp_crt_fmt_t format The format of the public key const gnutls_openpgp_keyid_t keyid The key id to…

NAME gnutls_pubkey_import_openpgp – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_openpgp(gnutls_pubkey_t key, gnutls_openpgp_crt_t crt, unsigned int flags); ARGUMENTS gnutls_pubkey_t key The public key gnutls_openpgp_crt_t crt The certificate to be imported unsigned int flags should be zero DESCRIPTION Imports a public key from an openpgp key. This function will import the given public key to the abstract…

NAME gnutls_pubkey_import_ecc_x962 – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_ecc_x962(gnutls_pubkey_t key, const gnutls_datum_t * parameters, const gnutls_datum_t * ecpoint); ARGUMENTS gnutls_pubkey_t key The structure to store the parsed key const gnutls_datum_t * parameters DER encoding of an ANSI X9.62 parameters const gnutls_datum_t * ecpoint DER encoding of ANSI X9.62 ECPoint DESCRIPTION This function will convert…

NAME gnutls_pubkey_import_ecc_raw – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_ecc_raw(gnutls_pubkey_t key, gnutls_ecc_curve_t curve, const gnutls_datum_t * x, const gnutls_datum_t * y); ARGUMENTS gnutls_pubkey_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 DESCRIPTION This function will convert…

NAME gnutls_pubkey_import_dsa_raw – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import_dsa_raw(gnutls_pubkey_t key, const gnutls_datum_t * p, const gnutls_datum_t * q, const gnutls_datum_t * g, const gnutls_datum_t * y); ARGUMENTS gnutls_pubkey_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 * g…

NAME gnutls_pubkey_import – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_import(gnutls_pubkey_t key, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format); ARGUMENTS gnutls_pubkey_t key The structure to store the parsed public key. const gnutls_datum_t * data The DER or PEM encoded certificate. gnutls_x509_crt_fmt_t format One of DER or PEM DESCRIPTION This function will import the provided public key in…

NAME gnutls_pubkey_get_verify_algorithm – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_verify_algorithm(gnutls_pubkey_t key, const gnutls_datum_t * signature, gnutls_digest_algorithm_t * hash); ARGUMENTS gnutls_pubkey_t key Holds the certificate const gnutls_datum_t * signature contains the signature gnutls_digest_algorithm_t * hash The result of the call with the hash algorithm used for signature DESCRIPTION This function will read the certifcate and the…

NAME gnutls_pubkey_get_preferred_hash_algorithm – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_preferred_hash_algorithm(gnutls_pubkey_t key, gnutls_digest_algorithm_t * hash, unsigned int * mand); ARGUMENTS gnutls_pubkey_t key Holds the certificate gnutls_digest_algorithm_t * hash The result of the call with the hash algorithm used for signature unsigned int * mand If non zero it means that the algorithm MUST use this hash….

NAME gnutls_pubkey_get_pk_algorithm – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_pk_algorithm(gnutls_pubkey_t key, unsigned int * bits); ARGUMENTS gnutls_pubkey_t key should contain a gnutls_pubkey_t structure unsigned int * bits If set will return the number of bits of the parameters (may be NULL) DESCRIPTION This function will return the public key algorithm of a public key and…

NAME gnutls_pubkey_get_openpgp_key_id – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_openpgp_key_id(gnutls_pubkey_t key, unsigned int flags, unsigned char * output_data, size_t * output_data_size, unsigned int * subkey); ARGUMENTS gnutls_pubkey_t key Holds the public key unsigned int flags should be 0 or GNUTLS_PUBKEY_GET_OPENPGP_FINGERPRINT unsigned char * output_data will contain the key ID size_t * output_data_size holds the size…

NAME gnutls_pubkey_get_key_usage – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_key_usage(gnutls_pubkey_t key, unsigned int * usage); ARGUMENTS gnutls_pubkey_t key should contain a gnutls_pubkey_t structure unsigned int * usage If set will return the number of bits of the parameters (may be NULL) DESCRIPTION This function will return the key usage of the public key. RETURNS On…

NAME gnutls_pubkey_get_key_id – API function SYNOPSIS #include <gnutls/abstract.h> int gnutls_pubkey_get_key_id(gnutls_pubkey_t key, unsigned int flags, unsigned char * output_data, size_t * output_data_size); ARGUMENTS gnutls_pubkey_t key Holds the public 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…