X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=doc%2Fssl%2FSSL_write.pod;h=4c1a7ee71f3cce02b5412cccd8f4c3a4348408fa;hb=c477f8e7165d30c5c8ca98f7409714f56dc2048c;hp=7299f6e2ee28f9f96e36498cfa1d1aaa455149af;hpb=d93eb21c7c1e39db098a7f1331a75cc95a783c2a;p=oweals%2Fopenssl.git diff --git a/doc/ssl/SSL_write.pod b/doc/ssl/SSL_write.pod index 7299f6e2ee..4c1a7ee71f 100644 --- a/doc/ssl/SSL_write.pod +++ b/doc/ssl/SSL_write.pod @@ -65,37 +65,33 @@ When an SSL_write() operation has to be repeated because of B or B, it must be repeated with the same arguments. +When calling SSL_write() with num=0 bytes to be sent the behaviour is +undefined. + =head1 RETURN VALUES The following return values can occur: =over 4 -=item E0 +=item E 0 The write operation was successful, the return value is the number of bytes actually written to the TLS/SSL connection. -=item 0 +=item Z<><= 0 -The write operation was not successful, because the write side of the -SSL connection was shut down (the SSL_SENT_SHUTDOWN flag in the shutdown -state is set) by calling L or -L. It is also possible, that the -underlying connection was closed. -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). +The write operation was not successful, because either the connection was +closed, an error occurred or action must be taken by the calling process. +Call SSL_get_error() with the return value B to find out the reason. 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, why the closure happened. -=item E0 - -The write operation was not successful, because either an error occurred -or action must be taken by the calling process. Call SSL_get_error() with the -return value B to find out the reason. +Old documentation indicated a difference between 0 and -1, and that -1 was +retryable. +You should instead call SSL_get_error() to find out if it's retryable. =back