1gnutls_certificate_verify_peers3(3) gnutls gnutls_certificate_verify_peers3(3)
2
3
4

NAME

6       gnutls_certificate_verify_peers3 - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       int  gnutls_certificate_verify_peers3(gnutls_session_t  session,  const
12       char * hostname, unsigned int * status);
13

ARGUMENTS

15       gnutls_session_t session
16                   is a gnutls session
17
18       const char * hostname
19                   is the expected name of the peer; may be NULL
20
21       unsigned int * status
22                   is the output of the verification
23

DESCRIPTION

25       This function will verify the peer's certificate and store  the  status
26       in  the   status variable as a bitwise or'd gnutls_certificate_status_t
27       values or zero if the certificate is trusted. Note that value in   sta‐
28       tus is set only when the return value of this function is success (i.e,
29       failure to trust a certificate does not imply a negative return value).
30       The  default verification flags used by this function can be overridden
31       using gnutls_certificate_set_verify_flags(). See the  documentation  of
32       gnutls_certificate_verify_peers2()  for  details  in  the  verification
33       process.
34
35       If the  hostname provided is non-NULL then this function  will  compare
36       the  hostname in the certificate against the given. The comparison will
37       be accurate for ascii names; non-ascii names are compared byte-by-byte.
38       If names do not match the GNUTLS_CERT_UNEXPECTED_OWNER status flag will
39       be set.
40
41       In order to verify the purpose of the end-certificate (by checking  the
42       extended key usage), use gnutls_certificate_verify_peers().
43

RETURNS

45       a negative error code on error and GNUTLS_E_SUCCESS (0) when the peer's
46       certificate was successfully parsed, irrespective  of  whether  it  was
47       verified.
48

SINCE

50       3.1.4
51

REPORTING BUGS

53       Report bugs to <bugs@gnutls.org>.
54       Home page: http://www.gnutls.org
55
56

58       Copyright © 2001-2014 Free Software Foundation, Inc..
59       Copying  and  distribution  of this file, with or without modification,
60       are permitted in any medium  without  royalty  provided  the  copyright
61       notice and this notice are preserved.
62

SEE ALSO

64       The  full  documentation  for gnutls is maintained as a Texinfo manual.
65       If the /usr/share/doc/gnutls/ directory does not contain the HTML  form
66       visit
67
68       http://www.gnutls.org/manual/
69
70gnutls                              3.3.29 gnutls_certificate_verify_peers3(3)
Impressum