Blame doc/functions/gnutls_certificate_set_ocsp_status_request_file2

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