manpagez: man pages & more
man gnutls_certificate_set_ocsp_status_request_function2(3)
Home | html | info | man
gnutls_certificate_set_ocsp_status_request_function2(3)




NAME

       gnutls_certificate_set_ocsp_status_request_function2 - API function


SYNOPSIS

       #include <gnutls/gnutls.h>

       gnutls_certificate_set_ocsp_status_request_function2(3)
       tificate_credentials_t     sc,      unsigned      idx,      gnutls_sta-
       tus_request_ocsp_func ocsp_func, void * ptr);


ARGUMENTS

       gnutls_certificate_credentials_t sc
                   is a gnutls_certificate_credentials_t type.

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

       gnutls_status_request_ocsp_func ocsp_func
                   function pointer to OCSP status request callback.

       void * ptr  opaque pointer passed to callback function


DESCRIPTION

       This function is to be used by server to register a callback to  handle
       OCSP  status  requests  that correspond to the indexed certificate from
       the client.  The callback will be invoked if the client supplied a sta-
       tus-request OCSP extension.

       The callback function prototype is:

       typedef  int  (*gnutls_status_request_ocsp_func) (gnutls_session_t ses-
       sion, void *ptr, gnutls_datum_t *ocsp_response);

       The callback will be invoked if the client requests an OCSP certificate
       status.   The  callback  may  return GNUTLS_E_NO_CERTIFICATE_STATUS, if
       there is no recent OCSP response. If the callback returns GNUTLS_E_SUC-
       CESS,  it is expected to have the  ocsp_response field set with a valid
       (DER-encoded) OCSP response. The response must  be  a  value  allocated
       using gnutls_malloc(), and will be deinitialized by the caller.


RETURNS

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


SINCE

       3.5.5


REPORTING BUGS

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



COPYRIGHT

       Copyright (C) 2001-2017 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                 gnutls_certificate_set_ocsp_status_request_function2(3)

gnutls 3.5.8 - Generated Fri Jan 13 09:53:00 CST 2017
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.