centos man page for gnutls_ocsp_resp_get_certs

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)