Section 3: library functions
NAME 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); ARGUMENTS gnutls_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…
NAME 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); ARGUMENTS gnutls_openpgp_crt_t key should contain a gnutls_openpgp_crt_t structure unsigned int * key_usage where the key usage bits will be stored DESCRIPTION This function will return certificate’s key usage, by checking the key algorithm. The key usage value will ORed values…
NAME gnutls_openpgp_crt_get_key_id – API function SYNOPSIS #include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_key_id(gnutls_openpgp_crt_t key, gnutls_openpgp_keyid_t keyid); ARGUMENTS gnutls_openpgp_crt_t key the structure that contains the OpenPGP public key. gnutls_openpgp_keyid_t keyid the buffer to save the keyid. DESCRIPTION Get key id string. RETURNS the 64-bit keyID of the OpenPGP key. SINCE 2.4.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>….
NAME gnutls_openpgp_crt_get_fingerprint – API function SYNOPSIS #include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_fingerprint(gnutls_openpgp_crt_t key, void * fpr, size_t * fprlen); ARGUMENTS gnutls_openpgp_crt_t key the raw data that contains the OpenPGP public key. void * fpr the buffer to save the fingerprint, must hold at least 20 bytes. size_t * fprlen the integer to save the length of the…
NAME gnutls_openpgp_crt_get_expiration_time – API function SYNOPSIS #include <gnutls/openpgp.h> time_t gnutls_openpgp_crt_get_expiration_time(gnutls_openpgp_crt_t key); ARGUMENTS gnutls_openpgp_crt_t key the structure that contains the OpenPGP public key. DESCRIPTION Get key expiration time. A value of ‘0’ means that the key doesn’t expire at all. RETURNS the time when the OpenPGP key expires. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>….
NAME gnutls_openpgp_crt_get_creation_time – API function SYNOPSIS #include <gnutls/openpgp.h> time_t gnutls_openpgp_crt_get_creation_time(gnutls_openpgp_crt_t key); ARGUMENTS gnutls_openpgp_crt_t key the structure that contains the OpenPGP public key. DESCRIPTION Get key creation time. RETURNS the timestamp when the OpenPGP key was created. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free Software Foundation, Inc…..
NAME gnutls_openpgp_crt_get_auth_subkey – API function SYNOPSIS #include <gnutls/openpgp.h> int gnutls_openpgp_crt_get_auth_subkey(gnutls_openpgp_crt_t crt, gnutls_openpgp_keyid_t keyid, unsigned int flag); ARGUMENTS gnutls_openpgp_crt_t crt the structure that contains the OpenPGP public key. gnutls_openpgp_keyid_t keyid the struct to save the keyid. unsigned int flag Non-zero indicates that a valid subkey is always returned. DESCRIPTION Returns the 64-bit keyID of the first…
NAME gnutls_openpgp_crt_export2 – API function SYNOPSIS #include <gnutls/openpgp.h> int gnutls_openpgp_crt_export2(gnutls_openpgp_crt_t key, gnutls_openpgp_crt_fmt_t format, gnutls_datum_t * out); ARGUMENTS gnutls_openpgp_crt_t key Holds the key. gnutls_openpgp_crt_fmt_t format One of gnutls_openpgp_crt_fmt_t elements. gnutls_datum_t * out will contain the raw or base64 encoded key DESCRIPTION This function will convert the given key to RAW or Base64 format. The output buffer…
gnutls_openpgp_crt_export – API function Synopsis #include <gnutls/openpgp.h> int gnutls_openpgp_crt_export(gnutls_openpgp_crt_t key, gnutls_openpgp_crt_fmt_t format, void * output_data, size_t * output_data_size); Arguments gnutls_openpgp_crt_t key Holds the key. gnutls_openpgp_crt_fmt_t format One of gnutls_openpgp_crt_fmt_t elements. void * output_data will contain the raw or base64 encoded key size_t * output_data_size holds the size of output_data (and will be replaced by the…
NAME gnutls_openpgp_crt_export – API function SYNOPSIS #include <gnutls/openpgp.h> int gnutls_openpgp_crt_export(gnutls_openpgp_crt_t key, gnutls_openpgp_crt_fmt_t format, void * output_data, size_t * output_data_size); ARGUMENTS gnutls_openpgp_crt_t key Holds the key. gnutls_openpgp_crt_fmt_t format One of gnutls_openpgp_crt_fmt_t elements. void * output_data will contain the raw or base64 encoded key size_t * output_data_size holds the size of output_data (and will be replaced by…
NAME gnutls_openpgp_crt_deinit – API function SYNOPSIS #include <gnutls/openpgp.h> void gnutls_openpgp_crt_deinit(gnutls_openpgp_crt_t key); ARGUMENTS gnutls_openpgp_crt_t key The structure to be initialized DESCRIPTION This function will deinitialize a key structure. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright © 2001-2014 Free Software Foundation, Inc.. Copying and distribution of this file, with or without…
NAME gnutls_openpgp_crt_check_hostname2 – API function SYNOPSIS #include <gnutls/openpgp.h> int gnutls_openpgp_crt_check_hostname2(gnutls_openpgp_crt_t key, const char * hostname, unsigned flags); ARGUMENTS gnutls_openpgp_crt_t key should contain a gnutls_openpgp_crt_t structure const char * hostname A null terminated string that contains a DNS name unsigned flags gnutls_certificate_verify_flags DESCRIPTION This function will check if the given key’s owner matches the given hostname….
NAME gnutls_openpgp_crt_check_hostname – API function SYNOPSIS #include <gnutls/openpgp.h> int gnutls_openpgp_crt_check_hostname(gnutls_openpgp_crt_t key, const char * hostname); ARGUMENTS gnutls_openpgp_crt_t key should contain a gnutls_openpgp_crt_t structure const char * hostname A null terminated string that contains a DNS name DESCRIPTION This function will check if the given key’s owner matches the given hostname. This is a basic implementation…
NAME gnutls_ocsp_status_request_is_checked – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_ocsp_status_request_is_checked(gnutls_session_t session, unsigned int flags); ARGUMENTS gnutls_session_t session is a gnutls session unsigned int flags should be zero DESCRIPTION Check whether an OCSP status response was included in the handshake and whether it was checked and valid (not too old or superseded). This is a helper…
NAME gnutls_ocsp_status_request_enable_client – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_ocsp_status_request_enable_client(gnutls_session_t session, gnutls_datum_t * responder_id, size_t responder_id_size, gnutls_datum_t * extensions); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. gnutls_datum_t * responder_id array with gnutls_datum_t with DER data of responder id size_t responder_id_size number of members in responder_id array gnutls_datum_t * extensions a gnutls_datum_t with DER encoded OCSP…
NAME gnutls_ocsp_resp_verify_direct – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_verify_direct(gnutls_ocsp_resp_t resp, gnutls_x509_crt_t issuer, unsigned int * verify, unsigned int flags); ARGUMENTS gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure gnutls_x509_crt_t issuer certificate believed to have signed the response unsigned int * verify output variable with verification status, an gnutls_ocsp_cert_status_t unsigned int flags verification flags, 0 for…
NAME gnutls_ocsp_resp_print – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_print(gnutls_ocsp_resp_t resp, gnutls_ocsp_print_formats_t format, gnutls_datum_t * out); ARGUMENTS gnutls_ocsp_resp_t resp The structure to be printed gnutls_ocsp_print_formats_t format Indicate the format to use gnutls_datum_t * out Newly allocated datum with (0) terminated string. DESCRIPTION This function will pretty print a OCSP response, suitable for display to a…
NAME gnutls_ocsp_resp_init – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_init(gnutls_ocsp_resp_t * resp); ARGUMENTS gnutls_ocsp_resp_t * resp The structure to be initialized DESCRIPTION This function will initialize an OCSP response structure. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright…