1gnutls_ocsp_resp_verify(3)          gnutls          gnutls_ocsp_resp_verify(3)
2
3
4

NAME

6       gnutls_ocsp_resp_verify - API function
7

SYNOPSIS

9       #include <gnutls/ocsp.h>
10
11       int           gnutls_ocsp_resp_verify(gnutls_ocsp_resp_t          resp,
12       gnutls_x509_trust_list_t trustlist, unsigned int * verify, unsigned int
13       flags);
14

ARGUMENTS

16       gnutls_ocsp_resp_t resp
17                   should contain a gnutls_ocsp_resp_t type
18
19       gnutls_x509_trust_list_t trustlist
20                   trust anchors as a gnutls_x509_trust_list_t type
21
22       unsigned int * verify
23                   output    variable    with    verification    status,    an
24                   gnutls_ocsp_verify_reason_t
25
26       unsigned int flags
27                   verification flags from gnutls_certificate_verify_flags
28

DESCRIPTION

30       Verify signature of the Basic OCSP Response against the public  key  in
31       the  certificate  of  a trusted signer.  The  trustlist should be popu‐
32       lated with trust anchors.  The function will extract  the  signer  cer‐
33       tificate  from  the  Basic OCSP Response and will verify it against the
34       trustlist .  A trusted signer  is  a  certificate  that  is  either  in
35       trustlist , or it is signed directly by a certificate in
36        trustlist and has the id-ad-ocspSigning Extended Key Usage bit set.
37
38       The  output  verify variable will hold verification status codes (e.g.,
39       GNUTLS_OCSP_VERIFY_SIGNER_NOT_FOUND,  GNUTLS_OCSP_VERIFY_INSECURE_ALGO‐
40       RITHM) which are only valid if the function returned GNUTLS_E_SUCCESS.
41
42       Note  that the function returns GNUTLS_E_SUCCESS even when verification
43       failed.  The caller must always inspect the  verify  variable  to  find
44       out the verification status.
45
46       The  flags variable should be 0 for now.
47

RETURNS

49       On  success,  GNUTLS_E_SUCCESS  (0)  is  returned, otherwise a negative
50       error value.
51

REPORTING BUGS

53       Report bugs to <bugs@gnutls.org>.
54       Home page: https://www.gnutls.org
55
56

58       Copyright © 2001-2019 Free Software Foundation, Inc., and others.
59       Copying and distribution of this file, with  or  without  modification,
60       are  permitted  in  any  medium  without royalty provided the copyright
61       notice and this notice are preserved.
62

SEE ALSO

64       The full documentation for gnutls is maintained as  a  Texinfo  manual.
65       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
66       visit
67
68       https://www.gnutls.org/manual/
69
70gnutls                               3.6.8          gnutls_ocsp_resp_verify(3)
Impressum