mirror of
https://github.com/openssl/openssl.git
synced 2024-11-27 05:21:51 +08:00
a528d4f0a9
If something was "present in all versions" of SSLeay, or if it was added to a version of SSLeay (and therefore predates OpenSSL), remove mention of it. Documentation history now starts with OpenSSL. Remove mention of all history before OpenSSL 0.9.8, inclusive. Remove all AUTHOR sections. Reviewed-by: Tim Hudson <tjh@openssl.org>
43 lines
919 B
Plaintext
43 lines
919 B
Plaintext
=pod
|
|
|
|
=head1 NAME
|
|
|
|
SSL_pending - obtain number of readable bytes buffered in an SSL object
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
#include <openssl/ssl.h>
|
|
|
|
int SSL_pending(const SSL *ssl);
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
SSL_pending() returns the number of bytes which are available inside
|
|
B<ssl> for immediate read.
|
|
|
|
=head1 NOTES
|
|
|
|
Data are received in blocks from the peer. Therefore data can be buffered
|
|
inside B<ssl> and are ready for immediate retrieval with
|
|
L<SSL_read(3)>.
|
|
|
|
=head1 RETURN VALUES
|
|
|
|
The number of bytes pending is returned.
|
|
|
|
=head1 BUGS
|
|
|
|
SSL_pending() takes into account only bytes from the TLS/SSL record
|
|
that is currently being processed (if any). If the B<SSL> object's
|
|
I<read_ahead> flag is set (see
|
|
L<SSL_CTX_set_read_ahead(3)>), additional protocol
|
|
bytes may have been read containing more TLS/SSL records; these are ignored by
|
|
SSL_pending().
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<SSL_read(3)>,
|
|
L<SSL_CTX_set_read_ahead(3)>, L<ssl(3)>
|
|
|
|
=cut
|