gnutls_ocsp_resp_get_certs(3) gnutls gnutls_ocsp_resp_get_certs(3)
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 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 <bug-gnutls@gnu.org>.
General guidelines for reporting bugs: http://www.gnu.org/gethelp/
GnuTLS home page: http://www.gnu.org/software/gnutls/
COPYRIGHT
Copyright (C) 2012 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.
SEE ALSO
The full documentation for gnutls is maintained as a Texinfo manual. If the info and gnutls programs are properly installed at your site,
the command
info gnutls
should give you access to the complete manual. As an alternative you may obtain the manual from:
http://www.gnu.org/software/gnutls/manual/
gnutls 3.1.15 gnutls_ocsp_resp_get_certs(3)