Blame doc/manpages/gnutls_ocsp_req_add_cert_id.3

Packit aea12f
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
Packit Service 991b93
.TH "gnutls_ocsp_req_add_cert_id" 3 "3.6.14" "gnutls" "gnutls"
Packit aea12f
.SH NAME
Packit aea12f
gnutls_ocsp_req_add_cert_id \- API function
Packit aea12f
.SH SYNOPSIS
Packit aea12f
.B #include <gnutls/ocsp.h>
Packit aea12f
.sp
Packit aea12f
.BI "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 ");"
Packit aea12f
.SH ARGUMENTS
Packit aea12f
.IP "gnutls_ocsp_req_t req" 12
Packit aea12f
should contain a \fBgnutls_ocsp_req_t\fP type
Packit aea12f
.IP "gnutls_digest_algorithm_t digest" 12
Packit aea12f
hash algorithm, a \fBgnutls_digest_algorithm_t\fP value
Packit aea12f
.IP "const gnutls_datum_t * issuer_name_hash" 12
Packit aea12f
hash of issuer's DN
Packit aea12f
.IP "const gnutls_datum_t * issuer_key_hash" 12
Packit aea12f
hash of issuer's public key
Packit aea12f
.IP "const gnutls_datum_t * serial_number" 12
Packit aea12f
serial number of certificate to check
Packit aea12f
.SH "DESCRIPTION"
Packit aea12f
This function will add another request to the OCSP request for a
Packit aea12f
particular certificate having the issuer name hash of
Packit aea12f
 \fIissuer_name_hash\fP and issuer key hash of  \fIissuer_key_hash\fP (both
Packit aea12f
hashed using  \fIdigest\fP ) and serial number  \fIserial_number\fP .
Packit aea12f
Packit aea12f
The information needed corresponds to the CertID structure:
Packit aea12f
Packit aea12f
<informalexample><programlisting>
Packit aea12f
CertID	  ::=     SEQUENCE {
Packit aea12f
hashAlgorithm       AlgorithmIdentifier,
Packit aea12f
issuerNameHash      OCTET STRING, \-\- Hash of Issuer's DN
Packit aea12f
issuerKeyHash       OCTET STRING, \-\- Hash of Issuers public key
Packit aea12f
serialNumber	CertificateSerialNumber }
Packit aea12f
</programlisting></informalexample>
Packit aea12f
.SH "RETURNS"
Packit aea12f
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise a
Packit aea12f
negative error code is returned.
Packit aea12f
.SH "REPORTING BUGS"
Packit aea12f
Report bugs to <bugs@gnutls.org>.
Packit aea12f
.br
Packit aea12f
Home page: https://www.gnutls.org
Packit aea12f
Packit aea12f
.SH COPYRIGHT
Packit Service 991b93
Copyright \(co 2001- Free Software Foundation, Inc., and others.
Packit aea12f
.br
Packit aea12f
Copying and distribution of this file, with or without modification,
Packit aea12f
are permitted in any medium without royalty provided the copyright
Packit aea12f
notice and this notice are preserved.
Packit aea12f
.SH "SEE ALSO"
Packit aea12f
The full documentation for
Packit aea12f
.B gnutls
Packit aea12f
is maintained as a Texinfo manual.
Packit aea12f
If the /usr/share/doc/gnutls/
Packit aea12f
directory does not contain the HTML form visit
Packit aea12f
.B
Packit aea12f
.IP https://www.gnutls.org/manual/
Packit aea12f
.PP