Blame doc/manpages/gnutls_certificate_set_ocsp_status_request_file2.3

Packit aea12f
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
Packit Service 991b93
.TH "gnutls_certificate_set_ocsp_status_request_file2" 3 "3.6.14" "gnutls" "gnutls"
Packit aea12f
.SH NAME
Packit aea12f
gnutls_certificate_set_ocsp_status_request_file2 \- API function
Packit aea12f
.SH SYNOPSIS
Packit aea12f
.B #include <gnutls/gnutls.h>
Packit aea12f
.sp
Packit aea12f
.BI "int gnutls_certificate_set_ocsp_status_request_file2(gnutls_certificate_credentials_t " sc ", const char * " response_file ", unsigned " idx ", gnutls_x509_crt_fmt_t " fmt ");"
Packit aea12f
.SH ARGUMENTS
Packit aea12f
.IP "gnutls_certificate_credentials_t sc" 12
Packit aea12f
is a credentials structure.
Packit aea12f
.IP "const char * response_file" 12
Packit aea12f
a filename of the OCSP response
Packit aea12f
.IP "unsigned idx" 12
Packit aea12f
is a certificate index as returned by \fBgnutls_certificate_set_key()\fP and friends
Packit aea12f
.IP "gnutls_x509_crt_fmt_t fmt" 12
Packit aea12f
is PEM or DER
Packit aea12f
.SH "DESCRIPTION"
Packit aea12f
This function loads the OCSP responses to be sent to the
Packit aea12f
peer for the certificate chain specified by  \fIidx\fP . When  \fIfmt\fP 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 \fBgnutls_certificate_set_retrieve_function()\fP is used. In
Packit aea12f
that case consider using \fBgnutls_certificate_set_retrieve_function3()\fP.
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 \fBGNUTLS_E_OCSP_MISMATCH_WITH_CERTS\fP is returned.
Packit aea12f
If the response is already expired at the time of loading the code
Packit aea12f
\fBGNUTLS_E_EXPIRED\fP is returned.
Packit aea12f
.SH "RETURNS"
Packit Service 991b93
On success, the number of loaded responses is returned,
Packit Service 991b93
otherwise a negative error code.
Packit aea12f
.SH "SINCE"
Packit aea12f
3.1.3
Packit aea12f
.SH "REPORTING BUGS"
Packit aea12f
Report bugs to <bugs@gnutls.org>.
Packit aea12f
.br
Packit aea12f
Home page: https://www.gnutls.org
Packit aea12f
Packit aea12f
.SH COPYRIGHT
Packit Service 991b93
Copyright \(co 2001- Free Software Foundation, Inc., and others.
Packit aea12f
.br
Packit aea12f
Copying and distribution of this file, with or without modification,
Packit aea12f
are permitted in any medium without royalty provided the copyright
Packit aea12f
notice and this notice are preserved.
Packit aea12f
.SH "SEE ALSO"
Packit aea12f
The full documentation for
Packit aea12f
.B gnutls
Packit aea12f
is maintained as a Texinfo manual.
Packit aea12f
If the /usr/share/doc/gnutls/
Packit aea12f
directory does not contain the HTML form visit
Packit aea12f
.B
Packit aea12f
.IP https://www.gnutls.org/manual/
Packit aea12f
.PP