NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <openssl/ssl.h>

       int SSL_pending(
               SSL *ssl );

DESCRIPTION    [Toc]    [Back]

       The SSL_pending() function 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 the SSL_read() function.

RESTRICTIONS    [Toc]    [Back]

       The  SSL_pending()  function takes into account only bytes
       from the TLS/SSL record that is 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 the SSL_pending() function.

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

RETURN VALUES    [Toc]    [Back]

       The number of bytes pending is returned.

SEE ALSO    [Toc]    [Back]

       Function: SSL_read(3), ssl(3)



                                                   SSL_pending(3)