NAME

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

SYNOPSIS

#include <openssl/ssl.h>
int SSL_pending(
        SSL ∗ssl );

DESCRIPTION

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

NOTES

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

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

The number of bytes pending is returned. 

SEE ALSO

Function: SSL_read(3), ssl(3)