File: gnutls_ocsp_req_add_cert_id

package info (click to toggle)
gnutls28 3.3.8-6
  • links: PTS, VCS
  • area: main
  • in suites: jessie-kfreebsd
  • size: 51,388 kB
  • sloc: ansic: 191,357; asm: 60,370; sh: 21,457; makefile: 5,257; lisp: 1,531; yacc: 1,254; cpp: 1,155; perl: 199; sed: 16
file content (33 lines) | stat: -rw-r--r-- 1,334 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33




@deftypefun {int} {gnutls_ocsp_req_add_cert_id} (gnutls_ocsp_req_t @var{req}, gnutls_digest_algorithm_t @var{digest}, const gnutls_datum_t * @var{issuer_name_hash}, const gnutls_datum_t * @var{issuer_key_hash}, const gnutls_datum_t * @var{serial_number})
@var{req}: should contain a @code{gnutls_ocsp_req_t}  structure

@var{digest}: hash algorithm, a @code{gnutls_digest_algorithm_t}  value

@var{issuer_name_hash}: hash of issuer's DN

@var{issuer_key_hash}: hash of issuer's public key

@var{serial_number}: serial number of certificate to check

This function will add another request to the OCSP request for a
particular certificate having the issuer name hash of
 @code{issuer_name_hash} and issuer key hash of  @code{issuer_key_hash} (both
hashed using  @code{digest} ) and serial number  @code{serial_number} .

The information needed corresponds to the CertID structure:

<informalexample><programlisting>
CertID          ::=     SEQUENCE @{
hashAlgorithm       AlgorithmIdentifier,
issuerNameHash      OCTET STRING, -- Hash of Issuer's DN
issuerKeyHash       OCTET STRING, -- Hash of Issuers public key
serialNumber        CertificateSerialNumber @}
</programlisting></informalexample>

@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
negative error code is returned.
@end deftypefun