SSL_get_verify_result.pod revision 68651 
1263105Sgjb=pod
2263105Sgjb
3263105Sgjb=head1 NAME
4263105Sgjb
5263105SgjbSSL_get_verify_result - get result of peer certificate verification
6263105Sgjb
7263105Sgjb=head1 SYNOPSIS
8263105Sgjb
9263105Sgjb #include <openssl/ssl.h>
10263105Sgjb
11263105Sgjb long SSL_get_verify_result(SSL *ssl);
12263105Sgjb
13263105Sgjb=head1 DESCRIPTION
14263105Sgjb
15263105SgjbSSL_get_verify_result() returns the result of the verification of the
16263105SgjbX509 certificate presented by the peer, if any.
17263105Sgjb
18263105Sgjb=head1 NOTES
19263105Sgjb
20263105SgjbSSL_get_verify_result() can only return one error code while the verification
21263105Sgjbof a certificate can fail because of many reasons at the same time. Only
22263105Sgjbthe last verification error that occured during the processing is available
23263105Sgjbfrom SSL_get_verify_result().
24263105Sgjb
25263105SgjbThe verification result is part of the established session and is restored
26263105Sgjbwhen a session is reused.
27263105Sgjb
28263105Sgjb=head1 BUGS
29263105Sgjb
30263105SgjbIf no peer certificate was presented, the returned result code is
31263105SgjbX509_V_OK. This is because no verification error occured, it does however
32263105Sgjbnot indicate success. SSL_get_verify_result() is only useful in connection
33263105Sgjbwith L<SSL_get_peer_certificate(3)|SSL_get_peer_certificate(3)>.
34263105Sgjb
35263105Sgjb=head1 RETURN VALUES
36263105Sgjb
37263105SgjbThe following return values can currently occur:
38263105Sgjb
39263105Sgjb=over 4
40263105Sgjb
41263105Sgjb=item X509_V_OK
42263105Sgjb
43263105SgjbThe verification succeeded or no peer certificate was presented.
44263105Sgjb
45263105Sgjb=item Any other value
46263105Sgjb
47263105SgjbDocumented in L<verify(1)|verify(1)>.
48263105Sgjb
49263105Sgjb=back
50263105Sgjb
51263105Sgjb=head1 SEE ALSO
52263105Sgjb
53263105SgjbL<ssl(3)|ssl(3)>, L<SSL_set_verify_result(3)|SSL_set_verify_result(3)>,
54263105SgjbL<SSL_get_peer_certificate(3)|SSL_get_peer_certificate(3)>,
55263105SgjbL<verify(1)|verify(1)>
56263105Sgjb
57263105Sgjb=cut
58263105Sgjb