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_t resp, unsigned indx,
12       gnutls_digest_algorithm_t * digest, gnutls_datum_t *  issuer_name_hash,
13       gnutls_datum_t   *  issuer_key_hash,  gnutls_datum_t  *  serial_number,
14       unsigned int * cert_status, time_t * this_update, time_t * next_update,
15       time_t * revocation_time, unsigned int * revocation_reason);
16

ARGUMENTS

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

DESCRIPTION

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

RETURNS

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

REPORTING BUGS

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

COPYRIGHT

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