Blame doc/functions/gnutls_ocsp_req_get_cert_id

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {int} {gnutls_ocsp_req_get_cert_id} (gnutls_ocsp_req_const_t @var{req}, unsigned @var{indx}, gnutls_digest_algorithm_t * @var{digest}, gnutls_datum_t * @var{issuer_name_hash}, gnutls_datum_t * @var{issuer_key_hash}, gnutls_datum_t * @var{serial_number})
Packit Service 4684c1
@var{req}: should contain a @code{gnutls_ocsp_req_t}  type
Packit Service 4684c1
Packit Service 4684c1
@var{indx}: Specifies which extension OID to get. Use (0) to get the first one.
Packit Service 4684c1
Packit Service 4684c1
@var{digest}: output variable with @code{gnutls_digest_algorithm_t}  hash algorithm
Packit Service 4684c1
Packit Service 4684c1
@var{issuer_name_hash}: output buffer with hash of issuer's DN
Packit Service 4684c1
Packit Service 4684c1
@var{issuer_key_hash}: output buffer with hash of issuer's public key
Packit Service 4684c1
Packit Service 4684c1
@var{serial_number}: output buffer with serial number of certificate to check
Packit Service 4684c1
Packit Service 4684c1
This function will return the certificate information of the
Packit Service 4684c1
 @code{indx} 'ed request in the OCSP request.  The information returned
Packit Service 4684c1
corresponds to the CertID structure:
Packit Service 4684c1
Packit Service 4684c1
<informalexample><programlisting>
Packit Service 4684c1
CertID	  ::=     SEQUENCE @{
Packit Service 4684c1
hashAlgorithm       AlgorithmIdentifier,
Packit Service 4684c1
issuerNameHash      OCTET STRING, -- Hash of Issuer's DN
Packit Service 4684c1
issuerKeyHash       OCTET STRING, -- Hash of Issuers public key
Packit Service 4684c1
serialNumber	CertificateSerialNumber @}
Packit Service 4684c1
</programlisting></informalexample>
Packit Service 4684c1
Packit Service 4684c1
Each of the pointers to output variables may be NULL to indicate
Packit Service 4684c1
that the caller is not interested in that value.
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned, otherwise a
Packit Service 4684c1
negative error code is returned.  If you have reached the last
Packit Service 4684c1
CertID available @code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE}  will be
Packit Service 4684c1
returned.
Packit Service 4684c1
@end deftypefun