Blame doc/functions/gnutls_certificate_set_ocsp_status_request_file2

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_certificate_set_ocsp_status_request_file2} (gnutls_certificate_credentials_t @var{sc}, const char * @var{response_file}, unsigned @var{idx}, gnutls_x509_crt_fmt_t @var{fmt})
Packit Service 4684c1
@var{sc}: is a credentials structure.
Packit Service 4684c1
Packit Service 4684c1
@var{response_file}: a filename of the OCSP response
Packit Service 4684c1
Packit Service 4684c1
@var{idx}: is a certificate index as returned by @code{gnutls_certificate_set_key()}  and friends
Packit Service 4684c1
Packit Service 4684c1
@var{fmt}: is PEM or DER
Packit Service 4684c1
Packit Service 4684c1
This function loads the OCSP responses to be sent to the
Packit Service 4684c1
peer for the certificate chain specified by  @code{idx} . When  @code{fmt} is
Packit Service 4684c1
set to PEM, multiple responses can be loaded.
Packit Service 4684c1
Packit Service 4684c1
This function must be called after setting any certificates, and
Packit Service 4684c1
cannot be used for certificates that are provided via a callback --
Packit Service 4684c1
that is when @code{gnutls_certificate_set_retrieve_function()}  is used. In
Packit Service 4684c1
that case consider using @code{gnutls_certificate_set_retrieve_function3()} .
Packit Service 4684c1
Packit Service 4684c1
This function can be called multiple times when multiple responses
Packit Service 4684c1
applicable to the certificate chain are available.
Packit Service 4684c1
If the response provided does not match any certificates present
Packit Service 4684c1
in the chain, the code @code{GNUTLS_E_OCSP_MISMATCH_WITH_CERTS}  is returned.
Packit Service 4684c1
If the response is already expired at the time of loading the code
Packit Service 4684c1
@code{GNUTLS_E_EXPIRED}  is returned.
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} On success, the number of loaded responses is returned,
Packit Service 4684c1
otherwise a negative error code.
Packit Service 4684c1
Packit Service 4684c1
@strong{Since:} 3.1.3
Packit Service 4684c1
@end deftypefun