1gnutls_ocsp_resp_get_certs(3) gnutls gnutls_ocsp_resp_get_certs(3)
2
3
4
6 gnutls_ocsp_resp_get_certs - API function
7
9 #include <gnutls/ocsp.h>
10
11 int gnutls_ocsp_resp_get_certs(gnutls_ocsp_resp_const_t resp,
12 gnutls_x509_crt_t ** certs, size_t * ncerts);
13
15 gnutls_ocsp_resp_const_t resp
16 should contain a gnutls_ocsp_resp_t type
17
18 gnutls_x509_crt_t ** certs
19 newly allocated array with gnutls_x509_crt_t certificates
20
21 size_t * ncerts
22 output variable with number of allocated certs.
23
25 This function will extract the X.509 certificates found in the Basic
26 OCSP Response. The certs output variable will hold a newly allocated
27 zero-terminated array with X.509 certificates.
28
29 Every certificate in the array needs to be de-allocated with
30 gnutls_x509_crt_deinit() and the array itself must be freed using
31 gnutls_free().
32
33 Both the certs and ncerts variables may be NULL. Then the function
34 will work as normal but will not return the NULL:d information. This
35 can be used to get the number of certificates only, or to just get the
36 certificate array without its size.
37
39 On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative er‐
40 ror value.
41
43 Report bugs to <bugs@gnutls.org>.
44 Home page: https://www.gnutls.org
45
46
48 Copyright © 2001- Free Software Foundation, Inc., and others.
49 Copying and distribution of this file, with or without modification,
50 are permitted in any medium without royalty provided the copyright no‐
51 tice and this notice are preserved.
52
54 The full documentation for gnutls is maintained as a Texinfo manual.
55 If the /usr/share/doc/gnutls/ directory does not contain the HTML form
56 visit
57
58 https://www.gnutls.org/manual/
59
60gnutls 3.7.6 gnutls_ocsp_resp_get_certs(3)