NAME    [Toc]    [Back]

       SSL_pending - obtain number of readable bytes buffered in
       an SSL object

LIBRARY    [Toc]    [Back]

       libcrypto, -lcrypto

SYNOPSIS    [Toc]    [Back]

        #include <openssl/ssl.h>

        int SSL_pending(SSL *ssl);

DESCRIPTION    [Toc]    [Back]

       SSL_pending() returns the number of bytes which are available
 inside ssl for immediate read.

NOTES    [Toc]    [Back]

       Data are received in blocks from the peer. Therefore data
       can be buffered inside ssl and are ready for immediate
       retrieval with SSL_read(3).

RETURN VALUES    [Toc]    [Back]

       The number of bytes pending is returned.

BUGS    [Toc]    [Back]

       SSL_pending() takes into account only bytes from the
       TLS/SSL record that is currently being processed (if any).
       If the SSL object's read_ahead flag is set, additional
       protocol bytes may have been read containing more TLS/SSL
       records; these are ignored by SSL_pending().

       Up to OpenSSL 0.9.6, SSL_pending() does not check if the
       record type of pending data is application data.

SEE ALSO    [Toc]    [Back]

       SSL_read(3), ssl(3)



2001-04-12                    0.9.6g               SSL_pending(3)