gnutls_ocsp_resp_get_single(3)

1gnutls_ocsp_resp_get_single(3)      gnutls      gnutls_ocsp_resp_get_single(3)
2
3
4

NAME

6       gnutls_ocsp_resp_get_single - API function
7

SYNOPSIS

9       #include <gnutls/ocsp.h>
10
11       int gnutls_ocsp_resp_get_single(gnutls_ocsp_resp_const_t resp, unsigned
12       indx,  gnutls_digest_algorithm_t  *  digest,   gnutls_datum_t   *   is‐
13       suer_name_hash,  gnutls_datum_t * issuer_key_hash, gnutls_datum_t * se‐
14       rial_number, unsigned int * cert_status, time_t * this_update, time_t *
15       next_update,  time_t  * revocation_time, unsigned int * revocation_rea‐
16       son);
17

ARGUMENTS

19       gnutls_ocsp_resp_const_t resp
20                   should contain a gnutls_ocsp_resp_t type
21
22       unsigned indx
23                   Specifies response number to get. Use (0) to get the  first
24                   one.
25
26       gnutls_digest_algorithm_t * digest
27                   output  variable  with gnutls_digest_algorithm_t hash algo‐
28                   rithm
29
30       gnutls_datum_t * issuer_name_hash
31                   output buffer with hash of issuer's DN
32
33       gnutls_datum_t * issuer_key_hash
34                   output buffer with hash of issuer's public key
35
36       gnutls_datum_t * serial_number
37                   output buffer with serial number of certificate to check
38
39       unsigned int * cert_status
40                   a certificate status, a gnutls_ocsp_cert_status_t enum.
41
42       time_t * this_update
43                   time at which the status is known to be correct.
44
45       time_t * next_update
46                   when newer information will be available, or (time_t)-1  if
47                   unspecified
48
49       time_t * revocation_time
50                   when   cert_status  is GNUTLS_OCSP_CERT_REVOKED, holds time
51                   of revocation.
52
53       unsigned int * revocation_reason
54                   revocation reason, a gnutls_x509_crl_reason_t enum.
55

DESCRIPTION

57       This function will return the certificate information of the
58        indx 'ed response in the Basic OCSP Response  resp .  The  information
59       returned  corresponds  to  the OCSP SingleResponse structure except the
60       final singleExtensions.
61
62       Each of the pointers to output variables may be NULL to  indicate  that
63       the caller is not interested in that value.
64

RETURNS

66       On  success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative er‐
67       ror code is returned.  If you have reached the  last  CertID  available
68       GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned.
69

REPORTING BUGS

71       Report bugs to <bugs@gnutls.org>.
72       Home page: https://www.gnutls.org
73
74

COPYRIGHT

76       Copyright © 2001-2023 Free Software Foundation, Inc., and others.
77       Copying  and  distribution  of this file, with or without modification,
78       are permitted in any medium without royalty provided the copyright  no‐
79       tice and this notice are preserved.
80