SSL_pending 3 2005-04-23 0.9.9-dev OpenSSL

NAME

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

LIBRARY

libcrypto, -lcrypto

SYNOPSIS


 #include 


 int SSL_pending(const SSL *ssl);

DESCRIPTION

_S_S_L___p_e_n_d_i_n_g_(_) returns the number of bytes which are available inside ssssll for immediate read.

NOTES

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

RETURN VALUES

The number of bytes pending is returned.

BUGS

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

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

SEE ALSO

_S_S_L___r_e_a_d(3), _s_s_l(3)