diff options
author | Matt Caswell <matt@openssl.org> | 2016-10-25 23:46:27 +0100 |
---|---|---|
committer | Matt Caswell <matt@openssl.org> | 2016-11-04 12:09:46 +0000 |
commit | 740bfebaf6d879f051da625d3c583f7cbba8944f (patch) | |
tree | 8eae6d730432732b143716c6b4c001a0195714d3 /doc/man3/SSL_write.pod | |
parent | 02ba18a63e1f4ae1d0c0a185f9b7701fcddc1835 (diff) |
Clarify the return values for SSL_read_ex()/SSL_write_ex()
Give more detail on what constitutes success/failure.
Reviewed-by: Rich Salz <rsalz@openssl.org>
Diffstat (limited to 'doc/man3/SSL_write.pod')
-rw-r--r-- | doc/man3/SSL_write.pod | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/doc/man3/SSL_write.pod b/doc/man3/SSL_write.pod index 98d691a26c..6c9b28832e 100644 --- a/doc/man3/SSL_write.pod +++ b/doc/man3/SSL_write.pod @@ -71,8 +71,16 @@ undefined. =head1 RETURN VALUES -SSL_write_ex() will return 1 for success or 0 for failure. In the event of a -failure call SSL_get_error() to find out the reason. +SSL_write_ex() will return 1 for success or 0 for failure. Success means that +all requested application data bytes have been written to the SSL connection or, +if SSL_MODE_ENABLE_PARTIAL_WRITE is in use, at least 1 application data byte has +been written to the SSL connection. Failure means that not all the requested +bytes have been written yet (if SSL_MODE_ENABLE_PARTIAL_WRITE is not in use) or +no bytes could be written to the SSL connection (if +SSL_MODE_ENABLE_PARTIAL_WRITE is in use). Failures can be retryable (e.g. the +network write buffer has temporarily filled up) or non-retryable (e.g. a fatal +network error). In the event of a failure call L<SSL_get_error(3)> to find out +the reason and if the call is retryable or not. For SSL_write() the following return values can occur: |