Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_ocsp_req_get_cert_id(3)	    gnutls	gnutls_ocsp_req_get_cert_id(3)

NAME
       gnutls_ocsp_req_get_cert_id - API function

SYNOPSIS
       #include	<gnutls/ocsp.h>

       int  gnutls_ocsp_req_get_cert_id(gnutls_ocsp_req_const_t	 req, unsigned
       indx,  gnutls_digest_algorithm_t	 *  digest,   gnutls_datum_t   *   is-
       suer_name_hash, gnutls_datum_t *	issuer_key_hash, gnutls_datum_t	* ser-
       ial_number);

ARGUMENTS
       gnutls_ocsp_req_const_t req
		   should contain a gnutls_ocsp_req_t type

       unsigned	indx
		   Specifies  which  extension	OID to get. Use	(0) to get the
		   first one.

       gnutls_digest_algorithm_t * digest
		   output variable with	gnutls_digest_algorithm_t  hash	 algo-
		   rithm

       gnutls_datum_t *	issuer_name_hash
		   output buffer with hash of issuer's DN

       gnutls_datum_t *	issuer_key_hash
		   output buffer with hash of issuer's public key

       gnutls_datum_t *	serial_number
		   output buffer with serial number of certificate to check

DESCRIPTION
       This function will return the certificate information of	the
	indx 'ed request in the	OCSP request.  The information returned	corre-
       sponds 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>

       Each  of	 the pointers to output	variables may be NULL to indicate that
       the caller is not interested in that value.

RETURNS
       On success, GNUTLS_E_SUCCESS (0)	is returned, otherwise a negative  er-
       ror  code  is  returned.	 If you	have reached the last CertID available
       GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned.

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

COPYRIGHT
       Copyright (C) 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 no-
       tice and	this notice are	preserved.

SEE ALSO
       The full	documentation for gnutls is maintained as  a  Texinfo  manual.
       If the /usr/local/share/doc/gnutls/ directory does not contain the HTML
       form visit

       https://www.gnutls.org/manual/

gnutls				     3.8.9	gnutls_ocsp_req_get_cert_id(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_ocsp_req_get_cert_id&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help