Section 3: library functions
NAME gnutls_ocsp_req_import – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_import(gnutls_ocsp_req_t req, const gnutls_datum_t * data); ARGUMENTS gnutls_ocsp_req_t req The structure to store the parsed request. const gnutls_datum_t * data DER encoded OCSP request. DESCRIPTION This function will convert the given DER encoded OCSP request to the native gnutls_ocsp_req_t format. The output will be stored in…
NAME gnutls_ocsp_req_get_version – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_get_version(gnutls_ocsp_req_t req); ARGUMENTS gnutls_ocsp_req_t req should contain a gnutls_ocsp_req_t structure DESCRIPTION This function will return the version of the OCSP request. Typically this is always 1 indicating version 1. RETURNS version of OCSP request, or a negative error code on error. REPORTING BUGS Report bugs to…
NAME gnutls_ocsp_req_get_nonce – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_get_nonce(gnutls_ocsp_req_t req, unsigned int * critical, gnutls_datum_t * nonce); ARGUMENTS gnutls_ocsp_req_t req should contain a gnutls_ocsp_req_t structure unsigned int * critical whether nonce extension is marked critical, or NULL gnutls_datum_t * nonce will hold newly allocated buffer with nonce data DESCRIPTION This function will return the…
NAME gnutls_ocsp_req_get_extension – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_get_extension(gnutls_ocsp_req_t req, unsigned indx, gnutls_datum_t * oid, unsigned int * critical, gnutls_datum_t * data); ARGUMENTS gnutls_ocsp_req_t req should contain a gnutls_ocsp_req_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_req_get_cert_id – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_get_cert_id(gnutls_ocsp_req_t req, unsigned indx, gnutls_digest_algorithm_t * digest, gnutls_datum_t * issuer_name_hash, gnutls_datum_t * issuer_key_hash, gnutls_datum_t * serial_number); ARGUMENTS gnutls_ocsp_req_t req should contain a gnutls_ocsp_req_t structure unsigned indx Specifies which extension OID to get. Use (0) to get the first one. gnutls_digest_algorithm_t * digest output variable with gnutls_digest_algorithm_t…
NAME gnutls_ocsp_req_export – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_export(gnutls_ocsp_req_t req, gnutls_datum_t * data); ARGUMENTS gnutls_ocsp_req_t req Holds the OCSP request gnutls_datum_t * data newly allocate buffer holding DER encoded OCSP request DESCRIPTION This function will export the OCSP request to DER format. RETURNS In case of failure a negative error code will be returned,…
NAME gnutls_ocsp_req_deinit – API function SYNOPSIS #include <gnutls/ocsp.h> void gnutls_ocsp_req_deinit(gnutls_ocsp_req_t req); ARGUMENTS gnutls_ocsp_req_t req The structure to be deinitialized DESCRIPTION This function will deinitialize a OCSP request 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_req_add_cert_id – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_add_cert_id(gnutls_ocsp_req_t req, gnutls_digest_algorithm_t digest, const gnutls_datum_t * issuer_name_hash, const gnutls_datum_t * issuer_key_hash, const gnutls_datum_t * serial_number); ARGUMENTS gnutls_ocsp_req_t req should contain a gnutls_ocsp_req_t structure gnutls_digest_algorithm_t digest hash algorithm, a gnutls_digest_algorithm_t value const gnutls_datum_t * issuer_name_hash hash of issuer’s DN const gnutls_datum_t * issuer_key_hash hash of issuer’s…
NAME gnutls_ocsp_req_add_cert – API function SYNOPSIS #include <gnutls/ocsp.h> int gnutls_ocsp_req_add_cert(gnutls_ocsp_req_t req, gnutls_digest_algorithm_t digest, gnutls_x509_crt_t issuer, gnutls_x509_crt_t cert); ARGUMENTS gnutls_ocsp_req_t req should contain a gnutls_ocsp_req_t structure gnutls_digest_algorithm_t digest hash algorithm, a gnutls_digest_algorithm_t value gnutls_x509_crt_t issuer issuer of subject certificate gnutls_x509_crt_t cert certificate to request status for DESCRIPTION This function will add another request to the OCSP…
NAME gnutls_malloc – Allocates and returns data SYNOPSIS #include <gnutls/gnutls.h> void * gnutls_malloc(size_t s); ARGUMENTS size_t s DESCRIPTION This function will allocate ‘s’ bytes data, and return a pointer to memory. This function is supposed to be used by callbacks. The allocation function used is the one set by gnutls_global_set_mem_functions(). REPORTING BUGS Report bugs to…
NAME gnutls_mac_set_priority – API function SYNOPSIS #include <gnutls/compat.h> int gnutls_mac_set_priority(gnutls_session_t session, const int * list); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. const int * list is a 0 terminated list of gnutls_mac_algorithm_t elements. DESCRIPTION Sets the priority on the mac algorithms supported by gnutls. Priority is higher for elements specified before others. After specifying…
NAME gnutls_mac_self_test – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_mac_self_test(unsigned all, gnutls_mac_algorithm_t mac); ARGUMENTS unsigned all if non-zero then tests to all ciphers are performed. gnutls_mac_algorithm_t mac the message authentication algorithm to use DESCRIPTION This function will run self tests on the provided mac. RETURNS Zero or a negative error code on error. SINCE 3.3.0…
NAME gnutls_mac_list – API function SYNOPSIS #include <gnutls/gnutls.h> const gnutls_mac_algorithm_t * gnutls_mac_list( void); ARGUMENTS void DESCRIPTION Get a list of hash algorithms for use as MACs. Note that not necessarily all MACs are supported in TLS cipher suites. This function is not thread safe. RETURNS Return a (0)-terminated list of gnutls_mac_algorithm_t integers indicating the available…
NAME gnutls_mac_get_nonce_size – API function SYNOPSIS #include <gnutls/crypto.h> size_t gnutls_mac_get_nonce_size(gnutls_mac_algorithm_t algorithm); ARGUMENTS gnutls_mac_algorithm_t algorithm is an encryption algorithm DESCRIPTION Returns the size of the nonce used by the MAC in TLS. RETURNS length (in bytes) of the given MAC nonce size, or 0. SINCE 3.2.0 REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page:…
NAME gnutls_mac_get_name – API function SYNOPSIS #include <gnutls/gnutls.h> const char * gnutls_mac_get_name(gnutls_mac_algorithm_t algorithm); ARGUMENTS gnutls_mac_algorithm_t algorithm is a MAC algorithm DESCRIPTION Convert a gnutls_mac_algorithm_t value to a string. RETURNS a string that contains the name of the specified MAC algorithm, or NULL. REPORTING BUGS Report bugs to <bugs [at] gnutls.org>. Home page: http://www.gnutls.org COPYRIGHT Copyright…
NAME gnutls_mac_get_key_size – API function SYNOPSIS #include <gnutls/gnutls.h> size_t gnutls_mac_get_key_size(gnutls_mac_algorithm_t algorithm); ARGUMENTS gnutls_mac_algorithm_t algorithm is an encryption algorithm DESCRIPTION Returns the size of the MAC key used in TLS. RETURNS length (in bytes) of the given MAC key size, or 0 if the given MAC algorithm is invalid. REPORTING BUGS Report bugs to <bugs [at]…
NAME gnutls_mac_get_id – API function SYNOPSIS #include <gnutls/gnutls.h> gnutls_mac_algorithm_t gnutls_mac_get_id(const char * name); ARGUMENTS const char * name is a MAC algorithm name DESCRIPTION Convert a string to a gnutls_mac_algorithm_t value. The names are compared in a case insensitive way. RETURNS a gnutls_mac_algorithm_t id of the specified MAC algorithm string, or GNUTLS_MAC_UNKNOWN on failures. REPORTING…
NAME gnutls_mac_get – API function SYNOPSIS #include <gnutls/gnutls.h> gnutls_mac_algorithm_t gnutls_mac_get(gnutls_session_t session); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. DESCRIPTION Get currently used MAC algorithm. RETURNS the currently used mac algorithm, a gnutls_mac_algorithm_t value. 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…
NAME gnutls_load_file – API function SYNOPSIS #include <gnutls/gnutls.h> int gnutls_load_file(const char * filename, gnutls_datum_t * data); ARGUMENTS const char * filename the name of the file to load gnutls_datum_t * data Where the file will be stored DESCRIPTION This function will load a file into a datum. The data are zero terminated but the terminating…
NAME gnutls_kx_set_priority – API function SYNOPSIS #include <gnutls/compat.h> int gnutls_kx_set_priority(gnutls_session_t session, const int * list); ARGUMENTS gnutls_session_t session is a gnutls_session_t structure. const int * list is a 0 terminated list of gnutls_kx_algorithm_t elements. DESCRIPTION Sets the priority on the key exchange algorithms supported by gnutls. Priority is higher for elements specified before others. After…