NAME
gnutls_x509_crt_list_verify - This function verifies the given
certificate list
SYNOPSIS
#include <gnutls/x509.h>
int gnutls_x509_crt_list_verify(const gnutls_x509_crt_t * cert_list,
int cert_list_length, const gnutls_x509_crt_t * CA_list, int
CA_list_length, const gnutls_x509_crl_t * CRL_list, int
CRL_list_length, unsigned int flags, unsigned int * verify);
ARGUMENTS
const gnutls_x509_crt_t * cert_list
is the certificate list to be verified
int cert_list_length
holds the number of certificate in cert_list
const gnutls_x509_crt_t * CA_list
is the CA list which will be used in verification
int CA_list_length
holds the number of CA certificate in CA_list
const gnutls_x509_crl_t * CRL_list
holds a list of CRLs.
int CRL_list_length
the length of CRL list.
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.
DESCRIPTION
This function will try to verify the given certificate list and return
its status. If no flags are specified (0), this function will use the
basicConstraints (2.5.29.19) PKIX extension. This means that only a
certificate authority is allowed to sign a certificate.
You must also check the peer’s name in order to check if the verified
certificate belongs to the actual peer.
The certificate verification output will be put in verify and will be
one or more of the gnutls_certificate_status_t enumerated elements
bitwise or’d. For a more detailed verification status use
gnutls_x509_crt_verify() per list element.
GNUTLS_CERT_INVALID
the certificate chain is not valid.
GNUTLS_CERT_REVOKED
a certificate in the chain has been revoked.
RETURNS
On success, GNUTLS_E_SUCCESS is returned, otherwise a negative error
value.and a negative value in case of an error.
REPORTING BUGS
Report bugs to <bug-gnutls@gnu.org>. GnuTLS home page:
http://www.gnu.org/software/gnutls/ General help using GNU software:
http://www.gnu.org/gethelp/
COPYRIGHT
Copyright © 2008 Free Software Foundation.
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.