skip book previous and next navigation links
go up to top of book: HP Open Source Security for OpenVMS Volume 2:... HP Open Source Security for OpenVMS Volume 2:...
go to beginning of reference: SSL Application Programming Interface (API) Reference SSL Application Programming Interface (API) Reference
go to previous page: SSL_new SSL_new
go to next page: SSL_readSSL_read
end of book navigation links


SSL_pending
Description
Return Values
See Also
 Notes
Restrictions

NAME

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

Synopsis  

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


return to top DESCRIPTION  

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


return to top NOTES  

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 to top RETURN VALUES  

The number of bytes pending is returned.


return to top Restrictions  

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.


return to top SEE ALSO  

SSL_read(3) , ssl(3)
go to previous page: SSL_new SSL_new
go to next page: SSL_readSSL_read