Section 3: library functions
NAME gnutls_ocsp_resp_import – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_import(gnutls_ocsp_resp_t resp, const gnutls_datum_t * data); ARGUMENTS gnutls_ocsp_resp_t resp The structure to store the parsed response. const gnutls_datum_t * data DER encoded OCSP response. DESCRIPTION This function will convert the given DER encoded OCSP response to the native gnutls_ocsp_resp_t format. It also decodes the Basic OCSP…
NAME gnutls_ocsp_resp_get_version – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_get_version(gnutls_ocsp_resp_t resp); ARGUMENTS gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure DESCRIPTION This function will return the version of the Basic OCSP Response. Typically this is always 1 indicating version 1. RETURNS version of Basic OCSP response, or a negative error code on error. REPORTING BUGS Report…
NAME gnutls_ocsp_resp_get_status – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_get_status(gnutls_ocsp_resp_t resp); ARGUMENTS gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure DESCRIPTION This function will return the status of a OCSP response, an gnutls_ocsp_resp_status_t enumeration. RETURNS status of OCSP request as a gnutls_ocsp_resp_status_t, or a negative error code on error. REPORTING BUGS Report bugs to <bugs [at]…
NAME gnutls_ocsp_resp_get_single – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_get_single(gnutls_ocsp_resp_t resp, unsigned indx, gnutls_digest_algorithm_t * digest, gnutls_datum_t * issuer_name_hash, gnutls_datum_t * issuer_key_hash, gnutls_datum_t * serial_number, unsigned int * cert_status, time_t * this_update, time_t * next_update, time_t * revocation_time, unsigned int * revocation_reason); ARGUMENTS gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure unsigned indx Specifies response number…
NAME gnutls_ocsp_resp_get_signature_algorithm – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_get_signature_algorithm(gnutls_ocsp_resp_t resp); ARGUMENTS gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure DESCRIPTION This function will return a value of the gnutls_sign_algorithm_t enumeration that is the signature algorithm that has been used to sign the OCSP response. RETURNS a gnutls_sign_algorithm_t value, or a negative error code on error….
NAME gnutls_ocsp_resp_get_response – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_get_response(gnutls_ocsp_resp_t resp, gnutls_datum_t * response_type_oid, gnutls_datum_t * response); ARGUMENTS gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure gnutls_datum_t * response_type_oid newly allocated output buffer with response type OID gnutls_datum_t * response newly allocated output buffer with DER encoded response DESCRIPTION This function will extract the response type…
NAME gnutls_ocsp_resp_get_responder – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_get_responder(gnutls_ocsp_resp_t resp, gnutls_datum_t * dn); ARGUMENTS gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure gnutls_datum_t * dn newly allocated buffer with name DESCRIPTION This function will extract the name of the Basic OCSP Response in the provided buffer. The name will be in the form "C=xxxx,O=yyyy,CN=zzzz" as…
NAME gnutls_ocsp_resp_get_nonce – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_get_nonce(gnutls_ocsp_resp_t resp, unsigned int * critical, gnutls_datum_t * nonce); ARGUMENTS gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure unsigned int * critical whether nonce extension is marked critical gnutls_datum_t * nonce will hold newly allocated buffer with nonce data DESCRIPTION This function will return the Basic OCSP…
NAME gnutls_ocsp_resp_get_extension – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_get_extension(gnutls_ocsp_resp_t resp, unsigned indx, gnutls_datum_t * oid, unsigned int * critical, gnutls_datum_t * data); ARGUMENTS gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure unsigned indx Specifies which extension OID to get. Use (0) to get the first one. gnutls_datum_t * oid will hold newly allocated buffer with…
NAME gnutls_ocsp_resp_get_certs – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_get_certs(gnutls_ocsp_resp_t resp, gnutls_x509_crt_t ** certs, size_t * ncerts); ARGUMENTS gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure gnutls_x509_crt_t ** certs newly allocated array with gnutls_x509_crt_t certificates size_t * ncerts output variable with number of allocated certs. DESCRIPTION This function will extract the X.509 certificates found in the…
NAME gnutls_ocsp_resp_export – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_export(gnutls_ocsp_resp_t resp, gnutls_datum_t * data); ARGUMENTS gnutls_ocsp_resp_t resp Holds the OCSP response gnutls_datum_t * data newly allocate buffer holding DER encoded OCSP response DESCRIPTION This function will export the OCSP response to DER format. RETURNS In case of failure a negative error code will be returned,…
NAME gnutls_ocsp_resp_deinit – API function SYNOPSIS #include <gnutls/ocsp.h> void gnutls_ocsp_resp_deinit(gnutls_ocsp_resp_t resp); ARGUMENTS gnutls_ocsp_resp_t resp The structure to be deinitialized DESCRIPTION This function will deinitialize a OCSP response 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…
NAME gnutls_ocsp_resp_check_crt – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_resp_check_crt(gnutls_ocsp_resp_t resp, unsigned int indx, gnutls_x509_crt_t crt); ARGUMENTS gnutls_ocsp_resp_t resp should contain a gnutls_ocsp_resp_t structure unsigned int indx Specifies response number to get. Use (0) to get the first one. gnutls_x509_crt_t crt The certificate to check DESCRIPTION This function will check whether the OCSP response is…
NAME gnutls_ocsp_req_set_nonce – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_set_nonce(gnutls_ocsp_req_t req, unsigned int critical, const gnutls_datum_t * nonce); ARGUMENTS gnutls_ocsp_req_t req should contain a gnutls_ocsp_req_t structure unsigned int critical critical flag, normally false. const gnutls_datum_t * nonce the nonce data DESCRIPTION This function will add an nonce extension to the OCSP request. Calling this function…
NAME gnutls_ocsp_req_set_extension – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_set_extension(gnutls_ocsp_req_t req, const char * oid, unsigned int critical, const gnutls_datum_t * data); ARGUMENTS gnutls_ocsp_req_t req should contain a gnutls_ocsp_req_t structure const char * oid buffer with OID of extension as a string. unsigned int critical critical flag, normally false. const gnutls_datum_t * data the extension…
NAME gnutls_ocsp_req_randomize_nonce – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_randomize_nonce(gnutls_ocsp_req_t req); ARGUMENTS gnutls_ocsp_req_t req should contain a gnutls_ocsp_req_t structure DESCRIPTION This function will add or update an nonce extension to the OCSP request with a newly generated random value. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error code is returned. REPORTING BUGS…
NAME gnutls_ocsp_req_print – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_print(gnutls_ocsp_req_t req, gnutls_ocsp_print_formats_t format, gnutls_datum_t * out); ARGUMENTS gnutls_ocsp_req_t req 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 request, suitable for display to a…
NAME gnutls_ocsp_req_init – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_init(gnutls_ocsp_req_t * req); ARGUMENTS gnutls_ocsp_req_t * req The structure to be initialized DESCRIPTION This function will initialize an OCSP request 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…