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