gnutls\_ocsp\_req\_add\_cert\_id(3) gnutls gnutls\_ocsp\_req\_add\_cert\_id(3)

# [NAME](#NAME)

gnutls\_ocsp\_req\_add\_cert\_id - API function

# [SYNOPSIS](#SYNOPSIS)

**#include <gnutls/ocsp.h>**

**int gnutls\_ocsp\_req\_add\_cert\_id(gnutls\_ocsp\_req\_t req, gnutls\_digest\_algorithm\_t digest, const gnutls\_datum\_t * issuer\_name\_hash, const gnutls\_datum\_t * issuer\_key\_hash, const gnutls\_datum\_t * serial\_number);**

# [ARGUMENTS](#ARGUMENTS)

[gnutls\_ocsp\_req\_t req](#gnutls_ocsp_req_t)

should contain a **gnutls\_ocsp\_req\_t** type

[gnutls\_digest\_algorithm\_t digest](#gnutls_digest_algorithm_t)

hash algorithm, a **gnutls\_digest\_algorithm\_t** value

[const gnutls\_datum\_t * issuer\_name\_hash](#const)

hash of issuer's DN

[const gnutls\_datum\_t * issuer\_key\_hash](#const~2)

hash of issuer's public key

[const gnutls\_datum\_t * serial\_number](#const~3)

serial number of certificate to check

# [DESCRIPTION](#DESCRIPTION)

This function will add another request to the OCSP request for a particular certificate having the issuer name hash of  
*issuer\_name\_hash* and issuer key hash of *issuer\_key\_hash* (both hashed using *digest* ) and serial number *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>

# [RETURNS](#RETURNS)

On success, **GNUTLS\_E\_SUCCESS** (0) is returned, otherwise a negative error code is returned.

# [REPORTING BUGS](#REPORTING_BUGS)

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

# [COPYRIGHT](#COPYRIGHT)

Copyright © 2001-2023 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](#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

[https://www.gnutls.org/manual/](https://www.gnutls.org/manual/)

3.8.13 gnutls

---

Document: gnutls_ocsp_req_add_cert_id(3) from gnutls 3.8.13-r1 (Chainguard OS)
Source: https://gitlab.com/gnutls/gnutls