168651Skris=pod
268651Skris
368651Skris=head1 NAME
468651Skris
568651SkrisSSL_get_verify_result - get result of peer certificate verification
668651Skris
768651Skris=head1 SYNOPSIS
868651Skris
968651Skris #include <openssl/ssl.h>
1068651Skris
11160814Ssimon long SSL_get_verify_result(const SSL *ssl);
1268651Skris
1368651Skris=head1 DESCRIPTION
1468651Skris
1568651SkrisSSL_get_verify_result() returns the result of the verification of the
1668651SkrisX509 certificate presented by the peer, if any.
1768651Skris
1868651Skris=head1 NOTES
1968651Skris
2068651SkrisSSL_get_verify_result() can only return one error code while the verification
2168651Skrisof a certificate can fail because of many reasons at the same time. Only
2276866Skristhe last verification error that occurred during the processing is available
2368651Skrisfrom SSL_get_verify_result().
2468651Skris
2568651SkrisThe verification result is part of the established session and is restored
2668651Skriswhen a session is reused.
2768651Skris
2868651Skris=head1 BUGS
2968651Skris
3068651SkrisIf no peer certificate was presented, the returned result code is
3176866SkrisX509_V_OK. This is because no verification error occurred, it does however
3268651Skrisnot indicate success. SSL_get_verify_result() is only useful in connection
3368651Skriswith L<SSL_get_peer_certificate(3)|SSL_get_peer_certificate(3)>.
3468651Skris
3568651Skris=head1 RETURN VALUES
3668651Skris
3768651SkrisThe following return values can currently occur:
3868651Skris
3968651Skris=over 4
4068651Skris
4168651Skris=item X509_V_OK
4268651Skris
4368651SkrisThe verification succeeded or no peer certificate was presented.
4468651Skris
4568651Skris=item Any other value
4668651Skris
4768651SkrisDocumented in L<verify(1)|verify(1)>.
4868651Skris
4968651Skris=back
5068651Skris
5168651Skris=head1 SEE ALSO
5268651Skris
5368651SkrisL<ssl(3)|ssl(3)>, L<SSL_set_verify_result(3)|SSL_set_verify_result(3)>,
5468651SkrisL<SSL_get_peer_certificate(3)|SSL_get_peer_certificate(3)>,
5568651SkrisL<verify(1)|verify(1)>
5668651Skris
5768651Skris=cut
58