mirror/openssl
2
0
Fork 0
mirror of https://github.com/openssl/openssl.git synced 2025-01-18 13:44:20 +08:00
Code Issues Packages Projects Releases Wiki Activity

Clarification.

Browse Source
This commit is contained in:
Bodo Möller 2000-09-16 15:55:57 +00:00
parent 1e4e549296
commit c1629c9ea2
1 changed files with 11 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/crypto/BIO_s_bio.pod
View File

@ -77,12 +77,17 @@ value will return a value from BIO_write() less than the amount requested or if
buffer is full request a retry. BIO_ctrl_get_write_guarantee() is a function
whereas BIO_get_write_guarantee() is a macro.
BIO_get_read_request() and BIO_ctrl_get_read_request() return the amount of data
requested (or the buffer size if it is less) if the last read failed due to an
empty buffer. This can be used to determine how much data should be written to the
other half of the pair so the next read will succeed: this is most useful in TLS/SSL
applications where the amount of data read is usually meaningful rather than just
a buffer size. After a successful read this call will return zero.
BIO_get_read_request() and BIO_ctrl_get_read_request() return the
amount of data requested, or the buffer size if it is less, if the
last read attempt at the other half of the BIO pair failed due to an
empty buffer. This can be used to determine how much data should be
written to the BIO so the next read will succeed: this is most useful
in TLS/SSL applications where the amount of data read is usually
meaningful rather than just a buffer size. After a successful read
this call will return zero. It also will return zero once new data
has been written satisfying the read request or part of it.
Note that BIO_get_read_request() never returns an amount larger
than that returned by BIO_get_write_guarantee().
BIO_ctrl_reset_read_request() can also be used to reset the value returned by
BIO_get_read_request() to zero.