Blame doc/functions/gnutls_certificate_set_ocsp_status_request_function

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {void} {gnutls_certificate_set_ocsp_status_request_function} (gnutls_certificate_credentials_t @var{sc}, gnutls_status_request_ocsp_func @var{ocsp_func}, void * @var{ptr})
Packit Service 4684c1
@var{sc}: is a @code{gnutls_certificate_credentials_t}  type.
Packit Service 4684c1
Packit Service 4684c1
@var{ocsp_func}: function pointer to OCSP status request callback.
Packit Service 4684c1
Packit Service 4684c1
@var{ptr}: opaque pointer passed to callback function
Packit Service 4684c1
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 @code{GNUTLS_E_NO_CERTIFICATE_STATUS} , if
Packit Service 4684c1
there is no recent OCSP response. If the callback returns @code{GNUTLS_E_SUCCESS} ,
Packit Service 4684c1
it is expected to have the  @code{ocsp_response} field set with a valid (DER-encoded)
Packit Service 4684c1
OCSP response. The response must be a value allocated using @code{gnutls_malloc()} ,
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 @code{gnutls_certificate_set_ocsp_status_request_function2()} .
Packit Service 4684c1
Packit Service 4684c1
@strong{Since:} 3.1.3
Packit Service 4684c1
@end deftypefun