gnutls_certificate_verify_peers3 — API function
#include <gnutls/gnutls.h>
int
gnutls_certificate_verify_peers3( |
gnutls_session_t session, |
| const char * hostname, | |
unsigned int * status); |
is a gnutls session
is the expected name of the peer; may be
NULL
is the output of the verification
This function will verify the peer's certificate and store
the status in the status variable as a bitwise
or'd gnutls_certificate_status_t values or zero if the
certificate is trusted. Note that value in status is set only when the
return value of this function is success (i.e, failure to
trust a certificate does not imply a negative return value).
The default verification flags used by this function can be
overriden using gnutls_certificate_set_verify_flags(). See
the documentation of gnutls_certificate_verify_peers2() for
details in the verification process.
If the hostname
provided is non−NULL then this function will compare
the hostname in the certificate against the given. The
comparison will be accurate for ascii names; non−ascii
names are compared byte−by−byte. If names do not
match the GNUTLS_CERT_UNEXPECTED_OWNER status flag
will be set.
In order to verify the purpose of the
end−certificate (by checking the extended key usage),
use gnutls_certificate_verify_peers().
The full documentation for gnutls is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit
| COPYRIGHT |
|---|
|
Copyright © 2001-2014 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. |