gnutls_certific...s_request_file2(3) gnutls gnutls_certific...s_request_file2(3)

NAME
     gnutls_certificate_set_ocsp_status_request_file2 - API function

SYNOPSIS
     #include <gnutls/gnutls.h>

     int	gnutls_certificate_set_ocsp_status_request_file2(gnutls_certifi-
     cate_credentials_t	 sc,  const  char   *	response_file,	 unsigned   idx,
     gnutls_x509_crt_fmt_t fmt);

ARGUMENTS
     gnutls_certificate_credentials_t sc
		 is a credentials structure.

     const char * response_file
		 a filename of the OCSP response

     unsigned idxis   a	  certificate	index  as  returned  by	 gnutls_certifi-
		 cate_set_key() and friends

     gnutls_x509_crt_fmt_t fmt
		 is PEM or DER

DESCRIPTION
     This function loads the OCSP responses to be sent to the peer for the  cer-
     tificate  chain  specified	 by  idx . When	 fmt is set to PEM, multiple re-
     sponses can be loaded.

     This function must be called after setting any certificates, and cannot  be
     used  for	certificates  that  are	 provided via a callback -- that is when
     gnutls_certificate_set_retrieve_function() is used. In that  case	consider
     using gnutls_certificate_set_retrieve_function3().

     This function can be called multiple times when multiple responses applica-
     ble  to the certificate chain are available.  If the response provided does
     not   match   any	 certificates	present	  in   the   chain,   the   code
     GNUTLS_E_OCSP_MISMATCH_WITH_CERTS	is returned.  If the response is already
     expired at the time of loading the code GNUTLS_E_EXPIRED is returned.

RETURNS
     On success, the number of loaded responses is returned, otherwise	a  nega-
     tive error code.

SINCE
     3.1.3

REPORTING BUGS
     Report bugs to <bugs@gnutls.org>.
     Home page: https://www.gnutls.org


COPYRIGHT
     Copyright (C) 2001-2023 Free Software Foundation, Inc., and others.
     Copying  and  distribution	 of this file, with or without modification, are
     permitted in any medium without royalty provided the copyright  notice  and
     this notice are preserved.

SEE ALSO
     The  full	documentation  for gnutls is maintained as a Texinfo manual.  If
     the /usr/share/doc/gnutls/ directory does not contain the HTML form visit

     https://www.gnutls.org/manual/

gnutls				     3.8.13 gnutls_certific...s_request_file2(3)