176866Skris=pod 276866Skris 376866Skris=head1 NAME 476866Skris 576866SkrisSSL_CTX_sess_number, SSL_CTX_sess_connect, SSL_CTX_sess_connect_good, SSL_CTX_sess_connect_renegotiate, SSL_CTX_sess_accept, SSL_CTX_sess_accept_good, SSL_CTX_sess_accept_renegotiate, SSL_CTX_sess_hits, SSL_CTX_sess_cb_hits, SSL_CTX_sess_misses, SSL_CTX_sess_timeouts, SSL_CTX_sess_cache_full - obtain session cache statistics 676866Skris 776866Skris=head1 SYNOPSIS 876866Skris 976866Skris #include <openssl/ssl.h> 1076866Skris 1176866Skris long SSL_CTX_sess_number(SSL_CTX *ctx); 1276866Skris long SSL_CTX_sess_connect(SSL_CTX *ctx); 1376866Skris long SSL_CTX_sess_connect_good(SSL_CTX *ctx); 1476866Skris long SSL_CTX_sess_connect_renegotiate(SSL_CTX *ctx); 1576866Skris long SSL_CTX_sess_accept(SSL_CTX *ctx); 1676866Skris long SSL_CTX_sess_accept_good(SSL_CTX *ctx); 1776866Skris long SSL_CTX_sess_accept_renegotiate(SSL_CTX *ctx); 1876866Skris long SSL_CTX_sess_hits(SSL_CTX *ctx); 1976866Skris long SSL_CTX_sess_cb_hits(SSL_CTX *ctx); 2076866Skris long SSL_CTX_sess_misses(SSL_CTX *ctx); 2176866Skris long SSL_CTX_sess_timeouts(SSL_CTX *ctx); 2276866Skris long SSL_CTX_sess_cache_full(SSL_CTX *ctx); 2376866Skris 2476866Skris=head1 DESCRIPTION 2576866Skris 2676866SkrisSSL_CTX_sess_number() returns the current number of sessions in the internal 2776866Skrissession cache. 2876866Skris 2976866SkrisSSL_CTX_sess_connect() returns the number of started SSL/TLS handshakes in 3076866Skrisclient mode. 3176866Skris 3276866SkrisSSL_CTX_sess_connect_good() returns the number of successfully established 3376866SkrisSSL/TLS sessions in client mode. 3476866Skris 3576866SkrisSSL_CTX_sess_connect_renegotiate() returns the number of start renegotiations 3676866Skrisin client mode. 3776866Skris 3876866SkrisSSL_CTX_sess_accept() returns the number of started SSL/TLS handshakes in 3976866Skrisserver mode. 4076866Skris 4176866SkrisSSL_CTX_sess_accept_good() returns the number of successfully established 4276866SkrisSSL/TLS sessions in server mode. 4376866Skris 4476866SkrisSSL_CTX_sess_accept_renegotiate() returns the number of start renegotiations 4576866Skrisin server mode. 4676866Skris 4776866SkrisSSL_CTX_sess_hits() returns the number of successfully reused sessions. 4876866SkrisIn client mode a session set with L<SSL_set_session(3)|SSL_set_session(3)> 4976866Skrissuccessfully reused is counted as a hit. In server mode a session successfully 5076866Skrisretrieved from internal or external cache is counted as a hit. 5176866Skris 5276866SkrisSSL_CTX_sess_cb_hits() returns the number of successfully retrieved sessions 5376866Skrisfrom the external session cache in server mode. 5476866Skris 5576866SkrisSSL_CTX_sess_misses() returns the number of sessions proposed by clients 5676866Skristhat were not found in the internal session cache in server mode. 5776866Skris 5876866SkrisSSL_CTX_sess_timeouts() returns the number of sessions proposed by clients 5976866Skrisand either found in the internal or external session cache in server mode, 6076866Skris but that were invalid due to timeout. These sessions are not included in 6176866Skristhe SSL_CTX_sess_hits() count. 6276866Skris 6376866SkrisSSL_CTX_sess_cache_full() returns the number of sessions that were removed 6476866Skrisbecause the maximum session cache size was exceeded. 6576866Skris 6676866Skris=head1 RETURN VALUES 6776866Skris 6876866SkrisThe functions return the values indicated in the DESCRIPTION section. 6976866Skris 7076866Skris=head1 SEE ALSO 7176866Skris 7276866SkrisL<ssl(3)|ssl(3)>, L<SSL_set_session(3)|SSL_set_session(3)>, 7376866SkrisL<SSL_CTX_set_session_cache_mode(3)|SSL_CTX_set_session_cache_mode(3)> 7476866SkrisL<SSL_CTX_sess_set_cache_size(3)|SSL_CTX_sess_set_cache_size(3)> 7576866Skris 7676866Skris=cut 77