Blame doc/manpages/gnutls_certificate_set_ocsp_status_request_function.3

Packit Service 4684c1
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
Packit Service 4684c1
.TH "gnutls_certificate_set_ocsp_status_request_function" 3 "3.6.14" "gnutls" "gnutls"
Packit Service 4684c1
.SH NAME
Packit Service 4684c1
gnutls_certificate_set_ocsp_status_request_function \- API function
Packit Service 4684c1
.SH SYNOPSIS
Packit Service 4684c1
.B #include <gnutls/gnutls.h>
Packit Service 4684c1
.sp
Packit Service 4684c1
.BI "void gnutls_certificate_set_ocsp_status_request_function(gnutls_certificate_credentials_t " sc ", gnutls_status_request_ocsp_func " ocsp_func ", void * " ptr ");"
Packit Service 4684c1
.SH ARGUMENTS
Packit Service 4684c1
.IP "gnutls_certificate_credentials_t sc" 12
Packit Service 4684c1
is a \fBgnutls_certificate_credentials_t\fP type.
Packit Service 4684c1
.IP "gnutls_status_request_ocsp_func ocsp_func" 12
Packit Service 4684c1
function pointer to OCSP status request callback.
Packit Service 4684c1
.IP "void * ptr" 12
Packit Service 4684c1
opaque pointer passed to callback function
Packit Service 4684c1
.SH "DESCRIPTION"
Packit Service 4684c1
This function is to be used by server to register a callback to
Packit Service 4684c1
handle OCSP status requests from the client.  The callback will be
Packit Service 4684c1
invoked if the client supplied a status\-request OCSP extension.
Packit Service 4684c1
The callback function prototype is:
Packit Service 4684c1
Packit Service 4684c1
typedef int (*gnutls_status_request_ocsp_func)
Packit Service 4684c1
(gnutls_session_t session, void *ptr, gnutls_datum_t *ocsp_response);
Packit Service 4684c1
Packit Service 4684c1
The callback will be invoked if the client requests an OCSP certificate
Packit Service 4684c1
status.  The callback may return \fBGNUTLS_E_NO_CERTIFICATE_STATUS\fP, if
Packit Service 4684c1
there is no recent OCSP response. If the callback returns \fBGNUTLS_E_SUCCESS\fP,
Packit Service 4684c1
it is expected to have the  \fIocsp_response\fP field set with a valid (DER\-encoded)
Packit Service 4684c1
OCSP response. The response must be a value allocated using \fBgnutls_malloc()\fP,
Packit Service 4684c1
and will be deinitialized by the caller.
Packit Service 4684c1
Packit Service 4684c1
It is possible to set a specific callback for each provided certificate
Packit Service 4684c1
using \fBgnutls_certificate_set_ocsp_status_request_function2()\fP.
Packit Service 4684c1
.SH "SINCE"
Packit Service 4684c1
3.1.3
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