|
Packit Service |
4684c1 |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
4684c1 |
.TH "gnutls_ocsp_resp_get_certs" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit Service |
4684c1 |
.SH NAME
|
|
Packit Service |
4684c1 |
gnutls_ocsp_resp_get_certs \- API function
|
|
Packit Service |
4684c1 |
.SH SYNOPSIS
|
|
Packit Service |
4684c1 |
.B #include <gnutls/ocsp.h>
|
|
Packit Service |
4684c1 |
.sp
|
|
Packit Service |
4684c1 |
.BI "int gnutls_ocsp_resp_get_certs(gnutls_ocsp_resp_const_t " resp ", gnutls_x509_crt_t ** " certs ", size_t * " ncerts ");"
|
|
Packit Service |
4684c1 |
.SH ARGUMENTS
|
|
Packit Service |
4684c1 |
.IP "gnutls_ocsp_resp_const_t resp" 12
|
|
Packit Service |
4684c1 |
should contain a \fBgnutls_ocsp_resp_t\fP type
|
|
Packit Service |
4684c1 |
.IP "gnutls_x509_crt_t ** certs" 12
|
|
Packit Service |
4684c1 |
newly allocated array with \fBgnutls_x509_crt_t\fP certificates
|
|
Packit Service |
4684c1 |
.IP "size_t * ncerts" 12
|
|
Packit Service |
4684c1 |
output variable with number of allocated certs.
|
|
Packit Service |
4684c1 |
.SH "DESCRIPTION"
|
|
Packit Service |
4684c1 |
This function will extract the X.509 certificates found in the
|
|
Packit Service |
4684c1 |
Basic OCSP Response. The \fIcerts\fP output variable will hold a newly
|
|
Packit Service |
4684c1 |
allocated zero\-terminated array with X.509 certificates.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
Every certificate in the array needs to be de\-allocated with
|
|
Packit Service |
4684c1 |
\fBgnutls_x509_crt_deinit()\fP and the array itself must be freed using
|
|
Packit Service |
4684c1 |
\fBgnutls_free()\fP.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
Both the \fIcerts\fP and \fIncerts\fP variables may be NULL. Then the
|
|
Packit Service |
4684c1 |
function will work as normal but will not return the NULL:d
|
|
Packit Service |
4684c1 |
information. This can be used to get the number of certificates
|
|
Packit Service |
4684c1 |
only, or to just get the certificate array without its size.
|
|
Packit Service |
4684c1 |
.SH "RETURNS"
|
|
Packit Service |
4684c1 |
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise a
|
|
Packit Service |
4684c1 |
negative error value.
|
|
Packit Service |
4684c1 |
.SH "REPORTING BUGS"
|
|
Packit Service |
4684c1 |
Report bugs to <bugs@gnutls.org>.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Home page: https://www.gnutls.org
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
.SH COPYRIGHT
|
|
Packit Service |
4684c1 |
Copyright \(co 2001- Free Software Foundation, Inc., and others.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Copying and distribution of this file, with or without modification,
|
|
Packit Service |
4684c1 |
are permitted in any medium without royalty provided the copyright
|
|
Packit Service |
4684c1 |
notice and this notice are preserved.
|
|
Packit Service |
4684c1 |
.SH "SEE ALSO"
|
|
Packit Service |
4684c1 |
The full documentation for
|
|
Packit Service |
4684c1 |
.B gnutls
|
|
Packit Service |
4684c1 |
is maintained as a Texinfo manual.
|
|
Packit Service |
4684c1 |
If the /usr/share/doc/gnutls/
|
|
Packit Service |
4684c1 |
directory does not contain the HTML form visit
|
|
Packit Service |
4684c1 |
.B
|
|
Packit Service |
4684c1 |
.IP https://www.gnutls.org/manual/
|
|
Packit Service |
4684c1 |
.PP
|