From: Lutz Jänicke Date: Fri, 11 May 2001 09:54:20 +0000 (+0000) Subject: Clarify behaviour of SSL_write() by mentioning SSL_MODE_ENABLE_PARTIAL_WRITE X-Git-Tag: OpenSSL_0_9_6b~28 X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=42f310f5963da3c7fc137c549a4f6ae67cdabb40;p=oweals%2Fopenssl.git Clarify behaviour of SSL_write() by mentioning SSL_MODE_ENABLE_PARTIAL_WRITE flag as discussed on the mailing list. --- diff --git a/doc/ssl/SSL_write.pod b/doc/ssl/SSL_write.pod index be1ad76d3b..b0dfefae20 100644 --- a/doc/ssl/SSL_write.pod +++ b/doc/ssl/SSL_write.pod @@ -50,6 +50,17 @@ 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. +SSL_write() will only return with success, when the complete contents +of B of length B has been written. This default behaviour +can be changed with the SSL_MODE_ENABLE_PARTIAL_WRITE option of +L. When this flag is set, +SSL_write() will also return with success, when a partial write has been +successfully completed. In this case the SSL_write() operation is considered +completed. The bytes are sent and a new SSL_write() operation with a new +buffer (with the already sent bytes removed) must be started. +A partial write is performed with the size of a message block, which is +16kB for SSLv3/TLSv1. + =head1 WARNING When an SSL_write() operation has to be repeated because of