From 084adb601f2d375395c6cdcedf8af91f1065fe4e Mon Sep 17 00:00:00 2001 From: Rob Austein Date: Mon, 9 Oct 2006 16:22:20 +0000 Subject: Feh, wrong vendor branch merge proceedure, clean up before trying again. svn path=/openssl/vendor/0.9.8d; revision=374 --- openssl/vendor/0.9.8d/doc/ssl/SSL_do_handshake.pod | 75 ---------------------- 1 file changed, 75 deletions(-) delete mode 100644 openssl/vendor/0.9.8d/doc/ssl/SSL_do_handshake.pod (limited to 'openssl/vendor/0.9.8d/doc/ssl/SSL_do_handshake.pod') diff --git a/openssl/vendor/0.9.8d/doc/ssl/SSL_do_handshake.pod b/openssl/vendor/0.9.8d/doc/ssl/SSL_do_handshake.pod deleted file mode 100644 index 24357645..00000000 --- a/openssl/vendor/0.9.8d/doc/ssl/SSL_do_handshake.pod +++ /dev/null @@ -1,75 +0,0 @@ -=pod - -=head1 NAME - -SSL_do_handshake - perform a TLS/SSL handshake - -=head1 SYNOPSIS - - #include - - int SSL_do_handshake(SSL *ssl); - -=head1 DESCRIPTION - -SSL_do_handshake() will wait for a SSL/TLS handshake to take place. If the -connection is in client mode, the handshake will be started. The handshake -routines may have to be explicitly set in advance using either -L or -L. - -=head1 NOTES - -The behaviour of SSL_do_handshake() depends on the underlying BIO. - -If the underlying BIO is B, SSL_do_handshake() will only return -once the handshake has been finished or an error occurred, except for SGC -(Server Gated Cryptography). For SGC, SSL_do_handshake() may return with -1, -but SSL_get_error() will yield B and -SSL_do_handshake() should be called again. - -If the underlying BIO is B, SSL_do_handshake() will also return -when the underlying BIO could not satisfy the needs of SSL_do_handshake() -to continue the handshake. In this case a call to SSL_get_error() with the -return value of SSL_do_handshake() will yield B or -B. The calling process then must repeat the call after -taking appropriate action to satisfy the needs of SSL_do_handshake(). -The action depends on the underlying BIO. When using a non-blocking socket, -nothing is to be done, but select() can be used to check for the required -condition. When using a buffering BIO, like a BIO pair, data must be written -into or retrieved out of the BIO before being able to continue. - -=head1 RETURN VALUES - -The following return values can occur: - -=over 4 - -=item 1 - -The TLS/SSL handshake was successfully completed, a TLS/SSL connection has been -established. - -=item 0 - -The TLS/SSL handshake was not successful but was shut down controlled and -by the specifications of the TLS/SSL protocol. Call SSL_get_error() with the -return value B to find out the reason. - -=item E0 - -The TLS/SSL handshake was not successful because a fatal error occurred either -at the protocol level or a connection failure occurred. The shutdown was -not clean. It can also occur of action is need to continue the operation -for non-blocking BIOs. Call SSL_get_error() with the return value B -to find out the reason. - -=back - -=head1 SEE ALSO - -L, L, -L, L, L, -L - -=cut -- cgit v1.2.3