SSL_get_verify_result.pod revision 68651 
156160Sru=pod
256160Sru
321495Sjmacd=head1 NAME
456160Sru
521495SjmacdSSL_get_verify_result - get result of peer certificate verification
621495Sjmacd
721495Sjmacd=head1 SYNOPSIS
821495Sjmacd
921495Sjmacd #include <openssl/ssl.h>
1021495Sjmacd
1121495Sjmacd long SSL_get_verify_result(SSL *ssl);
1221495Sjmacd
1321495Sjmacd=head1 DESCRIPTION
1421495Sjmacd
1521495SjmacdSSL_get_verify_result() returns the result of the verification of the
1621495SjmacdX509 certificate presented by the peer, if any.
1721495Sjmacd
1821495Sjmacd=head1 NOTES
1921495Sjmacd
2021495SjmacdSSL_get_verify_result() can only return one error code while the verification
2121495Sjmacdof a certificate can fail because of many reasons at the same time. Only
2242660Smarkmthe last verification error that occured during the processing is available
2342660Smarkmfrom SSL_get_verify_result().
2421495Sjmacd
2521495SjmacdThe verification result is part of the established session and is restored
2621495Sjmacdwhen a session is reused.
2721495Sjmacd
2821495Sjmacd=head1 BUGS
2921495Sjmacd
3021495SjmacdIf no peer certificate was presented, the returned result code is
3121495SjmacdX509_V_OK. This is because no verification error occured, it does however
3221495Sjmacdnot indicate success. SSL_get_verify_result() is only useful in connection
3321495Sjmacdwith L<SSL_get_peer_certificate(3)|SSL_get_peer_certificate(3)>.
3421495Sjmacd
3521495Sjmacd=head1 RETURN VALUES
3621495Sjmacd
3721495SjmacdThe following return values can currently occur:
3821495Sjmacd
3921495Sjmacd=over 4
4021495Sjmacd
4121495Sjmacd=item X509_V_OK
4221495Sjmacd
4321495SjmacdThe verification succeeded or no peer certificate was presented.
4421495Sjmacd
4521495Sjmacd=item Any other value
4621495Sjmacd
4721495SjmacdDocumented in L<verify(1)|verify(1)>.
4821495Sjmacd
4921495Sjmacd=back
5021495Sjmacd
5121495Sjmacd=head1 SEE ALSO
5221495Sjmacd
5321495SjmacdL<ssl(3)|ssl(3)>, L<SSL_set_verify_result(3)|SSL_set_verify_result(3)>,
5421495SjmacdL<SSL_get_peer_certificate(3)|SSL_get_peer_certificate(3)>,
5521495SjmacdL<verify(1)|verify(1)>
5621495Sjmacd
5721495Sjmacd=cut
5821495Sjmacd