NAME    [Toc]    [Back]

       SSL_get_verify_result - get result of peer certificate
       verification

LIBRARY    [Toc]    [Back]

       libcrypto, -lcrypto

SYNOPSIS    [Toc]    [Back]

        #include <openssl/ssl.h>

        long SSL_get_verify_result(SSL *ssl);

DESCRIPTION    [Toc]    [Back]

       SSL_get_verify_result() returns the result of the verification
 of the X509 certificate presented by the peer, if
       any.

NOTES    [Toc]    [Back]

       SSL_get_verify_result() can only return one error code
       while the verification of a certificate can fail because
       of many reasons at the same time. Only the last verification
 error that occurred during the processing is available
 from SSL_get_verify_result().

       The verification result is part of the established session
       and is restored when a session is reused.

BUGS    [Toc]    [Back]

       If no peer certificate was presented, the returned result
       code is X509_V_OK. This is because no verification error
       occurred, it does however not indicate success.
       SSL_get_verify_result() is only useful in connection with
       SSL_get_peer_certificate(3).

RETURN VALUES    [Toc]    [Back]

       The following return values can currently occur:

       X509_V_OK
           The verification succeeded or no peer certificate was
           presented.

       Any other value
           Documented in openssl_verify(1).

SEE ALSO    [Toc]    [Back]

       ssl(3), SSL_set_verify_result(3), SSL_get_peer_certificate(3), openssl_verify(1)



2001-04-12                    0.9.6g     SSL_get_verify_result(3)