X-Git-Url: https://code.wpia.club/?a=blobdiff_plain;f=lib%2Fopenssl%2Fdoc%2Fssl%2FSSL_read.pod;fp=lib%2Fopenssl%2Fdoc%2Fssl%2FSSL_read.pod;h=8dff2448d004b60d9bc0e4084465c404cd018604;hb=02ed66432c92de70694700164f986190aad3cbc5;hp=8ca0ce5058da0e5f1299e16d559067e5983737d8;hpb=89016837dcbf2775cd15dc8cbaba00dc6379f86e;p=cassiopeia.git diff --git a/lib/openssl/doc/ssl/SSL_read.pod b/lib/openssl/doc/ssl/SSL_read.pod index 8ca0ce5..8dff244 100644 --- a/lib/openssl/doc/ssl/SSL_read.pod +++ b/lib/openssl/doc/ssl/SSL_read.pod @@ -2,7 +2,7 @@ =head1 NAME -SSL_read - read bytes from a TLS/SSL connection. +SSL_read - read bytes from a TLS/SSL connection =head1 SYNOPSIS @@ -18,16 +18,16 @@ buffer B. =head1 NOTES If necessary, SSL_read() will negotiate a TLS/SSL session, if -not already explicitly performed by L or -L. If the +not already explicitly performed by L or +L. If the peer requests a re-negotiation, it will be performed transparently during the SSL_read() operation. The behaviour of SSL_read() depends on the -underlying BIO. +underlying BIO. For the transparent negotiation to succeed, the B must have been initialized to client or server mode. This is being done by calling -L or SSL_set_accept_state() -before the first call to an SSL_read() or L +L or SSL_set_accept_state() +before the first call to an SSL_read() or L function. SSL_read() works based on the SSL/TLS records. The data are received in @@ -47,14 +47,14 @@ record is complete and SSL_read() can succeed. If the underlying BIO is B, SSL_read() will only return, once the read operation has been finished or an error occurred, except when a -renegotiation take place, in which case a SSL_ERROR_WANT_READ may occur. +renegotiation take place, in which case a SSL_ERROR_WANT_READ may occur. This behaviour can be controlled with the SSL_MODE_AUTO_RETRY flag of the -L call. +L call. If the underlying BIO is B, SSL_read() will also return when the underlying BIO could not satisfy the needs of SSL_read() to continue the operation. In this case a call to -L with the +L with the return value of SSL_read() will yield B or B. As at any time a re-negotiation is possible, a call to SSL_read() can also cause write operations! The calling process @@ -64,7 +64,7 @@ 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. -L can be used to find out whether there +L can be used to find out whether there are buffered bytes available for immediate retrieval. In this case SSL_read() can be called without blocking or actually receiving new data from the underlying socket. @@ -91,18 +91,13 @@ bytes actually read from the TLS/SSL connection. The read operation was not successful. The reason may either be a clean shutdown due to a "close notify" alert sent by the peer (in which case the SSL_RECEIVED_SHUTDOWN flag in the ssl shutdown state is set -(see L, -L). It is also possible, that +(see L, +L). It is also possible, that the peer simply shut down the underlying transport and the shutdown is incomplete. Call SSL_get_error() with the return value B to find out, whether an error occurred or the connection was shut down cleanly (SSL_ERROR_ZERO_RETURN). -SSLv2 (deprecated) does not support a shutdown alert protocol, so it can -only be detected, whether the underlying connection was closed. It cannot -be checked, whether the closure was initiated by the peer or by something -else. - =item E0 The read operation was not successful, because either an error occurred @@ -113,12 +108,21 @@ return value B to find out the reason. =head1 SEE ALSO -L, L, -L, L, -L, L -L, -L, -L, L, -L, L +L, L, +L, L, +L, L +L, +L, +L, L, +L, L + +=head1 COPYRIGHT + +Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved. + +Licensed under the OpenSSL license (the "License"). You may not use +this file except in compliance with the License. You can obtain a copy +in the file LICENSE in the source distribution or at +L. =cut