summaryrefslogtreecommitdiffstats
path: root/doc/manpages/gnutls_ocsp_resp_get_response.3
blob: 797a997c8ac0f3a6de4216134429918ee832950b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "gnutls_ocsp_resp_get_response" 3 "3.7.9" "gnutls" "gnutls"
.SH NAME
gnutls_ocsp_resp_get_response \- API function
.SH SYNOPSIS
.B #include <gnutls/ocsp.h>
.sp
.BI "int gnutls_ocsp_resp_get_response(gnutls_ocsp_resp_const_t " resp ", gnutls_datum_t * " response_type_oid ", gnutls_datum_t * " response ");"
.SH ARGUMENTS
.IP "gnutls_ocsp_resp_const_t resp" 12
should contain a \fBgnutls_ocsp_resp_t\fP type
.IP "gnutls_datum_t * response_type_oid" 12
newly allocated output buffer with response type OID
.IP "gnutls_datum_t * response" 12
newly allocated output buffer with DER encoded response
.SH "DESCRIPTION"
This function will extract the response type OID in and the
response data from an OCSP response.  Normally the
 \fIresponse_type_oid\fP is always "1.3.6.1.5.5.7.48.1.1" which means the
 \fIresponse\fP should be decoded as a Basic OCSP Response, but
technically other response types could be used.

This function is typically only useful when you want to extract the
response type OID of an response for diagnostic purposes.
Otherwise \fBgnutls_ocsp_resp_import()\fP will decode the basic OCSP
response part and the caller need not worry about that aspect.

Since 3.7.0  \fIresponse_type_oid\fP \->size does not account for the terminating
null byte.
.SH "RETURNS"
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise a
negative error value.
.SH "REPORTING BUGS"
Report bugs to <bugs@gnutls.org>.
.br
Home page: https://www.gnutls.org

.SH COPYRIGHT
Copyright \(co 2001- Free Software Foundation, Inc., and others.
.br
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.
.SH "SEE ALSO"
The full documentation for
.B gnutls
is maintained as a Texinfo manual.
If the /usr/share/doc/gnutls/
directory does not contain the HTML form visit
.B
.IP https://www.gnutls.org/manual/
.PP