gnutls_ocsp_resp_get_certs (3) Linux Manual Page
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 Basic OCSP Response. The certs output variable will hold a newly allocated zero-terminated array with X.509 certificates.Every certificate in the array needs to be de-allocated with gnutls_x509_crt_deinit() and the array itself must be freed using gnutls_free().
Both the certs and ncerts variables may be NULL. Then the function will work as normal but will not return the NULL:d information. This can be used to get the number of certificates only, or to just get the certificate array without its size.
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 © 2001-2014 Free Software Foundation, Inc..Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.