NAME

       gnutls_certificate_set_ocsp_status_request_file - API function

SYNOPSIS

       #include <gnutls/gnutls.h>

       int  gnutls_certificate_set_ocsp_status_request_file(gnutls_certificate_credentials_t  sc,
       const char * response_file, unsigned idx);

ARGUMENTS

       gnutls_certificate_credentials_t sc
                   is a credentials structure.

       const char * response_file
                   a filename of the OCSP response

       unsigned idx
                   is a certificate index as returned by gnutls_certificate_set_key() and friends

DESCRIPTION

       This function sets the filename of an OCSP response, that will be sent to  the  client  if
       requests an OCSP certificate status for the certificate chain specified by  idx .

       This  is a convenience function which may be inefficient on busy servers since the file is
       opened on  every  access.  Use  gnutls_certificate_set_ocsp_status_request_function2()  to
       fine-tune file accesses.

NOTE

       the ability to set multiple OCSP responses per credential structure via the index  idx was
       added  in  version  3.5.6.  To   keep   backwards   compatibility,   it   requires   using
       gnutls_certificate_set_flags()  with  the  GNUTLS_CERTIFICATE_API_V2  flag to make the set
       certificate functions return an index usable by this function.

RETURNS

       On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error code is returned.

SINCE

       3.1.3

REPORTING BUGS

       Report bugs to <bugs@gnutls.org>.
       Home page: http://www.gnutls.org

COPYRIGHT

       Copyright © 2001-2022 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

       http://www.gnutls.org/manual/

gnutls                                        3gnutls_certificate_set_ocsp_status_request_file(3)