SSL_rstate_string 3 2003-07-24 0.9.9-dev OpenSSL

NAME

SSL_rstate_string, SSL_rstate_string_long - get textual description of state of an SSL object during read operation

LIBRARY

libcrypto, -lcrypto

SYNOPSIS


 #include 


 const char *SSL_rstate_string(SSL *ssl);
 const char *SSL_rstate_string_long(SSL *ssl);

DESCRIPTION

_S_S_L___r_s_t_a_t_e___s_t_r_i_n_g_(_) returns a 2 letter string indicating the current read state of the SSL object ssssll.

_S_S_L___r_s_t_a_t_e___s_t_r_i_n_g___l_o_n_g_(_) returns a string indicating the current read state of the SSL object ssssll.

NOTES

When performing a read operation, the SSL/TLS engine must parse the record, consisting of header and body. When working in a blocking environment, SSL_rstate_string[_long]() should always return "RD"/"read done".

This function should only seldom be needed in applications.

RETURN VALUES

_S_S_L___r_s_t_a_t_e___s_t_r_i_n_g_(_) and _S_S_L___r_s_t_a_t_e___s_t_r_i_n_g___l_o_n_g_(_) can return the following values:
"RH"/"read header" The header of the record is being evaluated.
"RB"/"read body" The body of the record is being evaluated.
"RD"/"read done" The record has been completely processed.
"unknown"/"unknown" The read state is unknown. This should never happen.

SEE ALSO

_s_s_l(3)