--- src/secure/lib/libssl/man/SSL_read.3 2008/09/06 20:43:00 1.11 +++ src/secure/lib/libssl/man/SSL_read.3 2008/09/27 21:04:48 1.12 @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "SSL_read 3" -.TH SSL_read 3 "2008-09-06" "0.9.8h" "OpenSSL" +.TH SSL_read 3 "2008-09-27" "0.9.8i" "OpenSSL" .SH "NAME" SSL_read \- read bytes from a TLS/SSL connection. .SH "SYNOPSIS" @@ -193,6 +193,11 @@ needs of \fISSL_read()\fR. The action de non-blocking socket, nothing is to be done, but \fIselect()\fR can be used to check for the required condition. When using a buffering \s-1BIO\s0, like a \s-1BIO\s0 pair, data must be written into or retrieved out of the \s-1BIO\s0 before being able to continue. +.PP +\&\fISSL_pending\fR\|(3) can be used to find out whether there +are buffered bytes available for immediate retrieval. In this case +\&\fISSL_read()\fR can be called without blocking or actually receiving new +data from the underlying socket. .SH "WARNING" .IX Header "WARNING" When an \fISSL_read()\fR operation has to be repeated because of @@ -231,5 +236,6 @@ return value \fBret\fR to find out the r \&\fISSL_CTX_set_mode\fR\|(3), \fISSL_CTX_new\fR\|(3), \&\fISSL_connect\fR\|(3), \fISSL_accept\fR\|(3) \&\fISSL_set_connect_state\fR\|(3), +\&\fISSL_pending\fR\|(3), \&\fISSL_shutdown\fR\|(3), \fISSL_set_shutdown\fR\|(3), \&\fIssl\fR\|(3), \fIbio\fR\|(3)