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