man7.org > Linux > man-pages

Linux/UNIX system programming training

gnutls_ocsp_req_add_cert_id(3) — Linux manual page

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURNS | REPORTING BUGS | COPYRIGHT | SEE ALSO | COLOPHON 

gnutls_ocsp_req_add_cert_id(3)    gnutls   gnutls_ocsp_req_add_cert_id(3)

NAME         top

       gnutls_ocsp_req_add_cert_id - API function

SYNOPSIS         top

       #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         top

       gnutls_ocsp_req_t req
                   should contain a gnutls_ocsp_req_t type

       gnutls_digest_algorithm_t digest
                   hash algorithm, a gnutls_digest_algorithm_t value

       const gnutls_datum_t * issuer_name_hash
                   hash of issuer's DN

       const gnutls_datum_t * issuer_key_hash
                   hash of issuer's public key

       const gnutls_datum_t * serial_number
                   serial number of certificate to check

DESCRIPTION         top

       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         top

       On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative
       error code is returned.

REPORTING BUGS         top

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

COPYRIGHT         top

       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         top

       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/

COLOPHON         top

       This page is part of the GnuTLS (GnuTLS Transport Layer Security
       Library) project.  Information about the project can be found at
       ⟨http://www.gnutls.org/⟩.  If you have a bug report for this
       manual page, send it to bugs@gnutls.org.  This page was obtained
       from the tarball fetched from
       ⟨https://www.gnupg.org/ftp/gcrypt/gnutls/⟩ on 2025-08-11.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information
       in this COLOPHON (which is not part of the original manual page),
       send a mail to man-pages@man7.org

gnutls                            3.8.10   gnutls_ocsp_req_add_cert_id(3)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI