Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gnutls_ocsp_resp_verify(3) [centos man page]

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_t resp, gnutls_x509_trust_list_t trustlist, unsigned int * verify, unsigned int flags);

ARGUMENTS

       gnutls_ocsp_resp_t resp
		   should contain a gnutls_ocsp_resp_t structure

       gnutls_x509_trust_list_t trustlist
		   trust anchors as a gnutls_x509_trust_list_t structure

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

       unsigned int flags
		   verification flags, 0 for now.

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 certificate 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_INSE-
       CURE_ALGORITHM) 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 error value.

REPORTING BUGS

       Report bugs to <bug-gnutls@gnu.org>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GnuTLS home page: http://www.gnu.org/software/gnutls/

COPYRIGHT

       Copyright (C) 2012 Free Software Foundation, Inc..
       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

       The full documentation for gnutls is maintained as a Texinfo manual.  If the info and gnutls programs are properly installed at your  site,
       the command

	      info gnutls

       should give you access to the complete manual.  As an alternative you may obtain the manual from:

	      http://www.gnu.org/software/gnutls/manual/

gnutls								      3.1.15						gnutls_ocsp_resp_verify(3)

Check Out this Related Man Page

gnutls_x509_trust_list_verify_named_crt(3)			      gnutls				gnutls_x509_trust_list_verify_named_crt(3)

NAME

       gnutls_x509_trust_list_verify_named_crt - API function

SYNOPSIS

       #include <gnutls/x509.h>

       int  gnutls_x509_trust_list_verify_named_crt(gnutls_x509_trust_list_t  list,  gnutls_x509_crt_t	cert, const void * name, size_t name_size,
       unsigned int flags, unsigned int * verify, gnutls_verify_output_function func);

ARGUMENTS

       gnutls_x509_trust_list_t list
		   The structure of the list

       gnutls_x509_crt_t cert
		   is the certificate to be verified

       const void * name
		   is the certificate's name

       size_t name_size
		   is the certificate's name size

       unsigned int flags
		   Flags that may be used to change the verification algorithm. Use OR of the gnutls_certificate_verify_flags enumerations.

       unsigned int * verify
		   will hold the certificate verification output.

       gnutls_verify_output_function func
		   If non-null will be called on each chain element verification with the output.

DESCRIPTION

       This function will try to find a certificate that is associated with the provided name --see gnutls_x509_trust_list_add_named_crt().  If  a
       match is found the certificate is considered valid. In addition to that this function will also check CRLs. The	verify parameter will hold
       an OR'ed sequence of gnutls_certificate_status_t flags.

RETURNS

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

SINCE

       3.0

REPORTING BUGS

       Report bugs to <bug-gnutls@gnu.org>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GnuTLS home page: http://www.gnu.org/software/gnutls/

COPYRIGHT

       Copyright (C) 2012 Free Software Foundation, Inc..
       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

       The  full documentation for gnutls is maintained as a Texinfo manual.  If the info and gnutls programs are properly installed at your site,
       the command

	      info gnutls

       should give you access to the complete manual.  As an alternative you may obtain the manual from:

	      http://www.gnu.org/software/gnutls/manual/

gnutls								      3.1.15				gnutls_x509_trust_list_verify_named_crt(3)
Man Page