SSL_get_verify_result.pod revision 76866
167754Smsmith=pod 267754Smsmith 367754Smsmith=head1 NAME 470243Smsmith 567754SmsmithSSL_get_verify_result - get result of peer certificate verification 667754Smsmith 767754Smsmith=head1 SYNOPSIS 867754Smsmith 967754Smsmith #include <openssl/ssl.h> 1067754Smsmith 1167754Smsmith long SSL_get_verify_result(SSL *ssl); 1270243Smsmith 1370243Smsmith=head1 DESCRIPTION 1467754Smsmith 1567754SmsmithSSL_get_verify_result() returns the result of the verification of the 1667754SmsmithX509 certificate presented by the peer, if any. 1767754Smsmith 1867754Smsmith=head1 NOTES 1967754Smsmith 2067754SmsmithSSL_get_verify_result() can only return one error code while the verification 2167754Smsmithof a certificate can fail because of many reasons at the same time. Only 2267754Smsmiththe last verification error that occurred during the processing is available 2367754Smsmithfrom SSL_get_verify_result(). 2467754Smsmith 2567754SmsmithThe verification result is part of the established session and is restored 2667754Smsmithwhen a session is reused. 2767754Smsmith 2867754Smsmith=head1 BUGS 2967754Smsmith 3067754SmsmithIf no peer certificate was presented, the returned result code is 3167754SmsmithX509_V_OK. This is because no verification error occurred, it does however 3267754Smsmithnot indicate success. SSL_get_verify_result() is only useful in connection 3367754Smsmithwith L<SSL_get_peer_certificate(3)|SSL_get_peer_certificate(3)>. 3467754Smsmith 3567754Smsmith=head1 RETURN VALUES 3667754Smsmith 3767754SmsmithThe following return values can currently occur: 3867754Smsmith 3967754Smsmith=over 4 4067754Smsmith 4167754Smsmith=item X509_V_OK 4267754Smsmith 4367754SmsmithThe verification succeeded or no peer certificate was presented. 4467754Smsmith 4567754Smsmith=item Any other value 4667754Smsmith 4767754SmsmithDocumented in L<verify(1)|verify(1)>. 4867754Smsmith 4967754Smsmith=back 5067754Smsmith 5167754Smsmith=head1 SEE ALSO 5267754Smsmith 5367754SmsmithL<ssl(3)|ssl(3)>, L<SSL_set_verify_result(3)|SSL_set_verify_result(3)>, 5467754SmsmithL<SSL_get_peer_certificate(3)|SSL_get_peer_certificate(3)>, 5567754SmsmithL<verify(1)|verify(1)> 5667754Smsmith 5767754Smsmith=cut 5867754Smsmith