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

FreeBSD Manual Pages

  
 
  

home | help
gnutls_ocsp_resp_verify(3)	    gnutls	    gnutls_ocsp_resp_verify(3)

NAME
       gnutls_ocsp_resp_verify - API function

SYNOPSIS
       #include	<gnutls/ocsp.h>

       int	  gnutls_ocsp_resp_verify(gnutls_ocsp_resp_const_t	 resp,
       gnutls_x509_trust_list_t	trustlist, unsigned int	* verify, unsigned int
       flags);

ARGUMENTS
       gnutls_ocsp_resp_const_t	resp
		   should contain a gnutls_ocsp_resp_t type

       gnutls_x509_trust_list_t	trustlist
		   trust anchors as a gnutls_x509_trust_list_t type

       unsigned	int * verify
		   output    variable	 with	 verification	 status,    an
		   gnutls_ocsp_verify_reason_t

       unsigned	int flags
		   verification	flags from gnutls_certificate_verify_flags

DESCRIPTION
       Verify  signature  of the Basic OCSP Response against the public	key in
       the certificate of a trusted signer.  The  trustlist  should  be	 popu-
       lated  with  trust  anchors.  The function will extract the signer cer-
       tificate	from the Basic OCSP Response and will verify  it  against  the
       trustlist  .   A	 trusted  signer  is  a	 certificate that is either in
       trustlist , or it is signed directly by a certificate in
	trustlist and has the id-ad-ocspSigning	Extended Key Usage bit set.

       The output  verify variable will	hold verification status codes	(e.g.,
       GNUTLS_OCSP_VERIFY_SIGNER_NOT_FOUND,  GNUTLS_OCSP_VERIFY_INSECURE_ALGO-
       RITHM) which are	only valid if the function returned GNUTLS_E_SUCCESS.

       Note that the function returns GNUTLS_E_SUCCESS even when  verification
       failed.	 The  caller  must always inspect the  verify variable to find
       out the verification status.

       The  flags variable should be 0 for now.

RETURNS
       On success, GNUTLS_E_SUCCESS (0)	is returned, otherwise a negative  er-
       ror value.

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_resp_verify(3)

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

home | help