SSL_CTX_SESS_NUMBER(3ossl)

💖 SSL_CTX_SESS_NUMBER 💖

okay bestie, so this is a page from the OpenSSL manual — third section (3ossl), the library-calls girlies. and no cap, this one is just reading the vibes of your session cache 🎀

It's the home of SSL_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, and SSL_CTX_sess_cache_full — a whole little friend group whose entire job is obtaining session cache statistics ✨

---

✨ SYNOPSIS ✨

#include <openssl/ssl.h>

long SSL_CTX_sess_number(SSL_CTX *ctx);
long SSL_CTX_sess_connect(SSL_CTX *ctx);
long SSL_CTX_sess_connect_good(SSL_CTX *ctx);
long SSL_CTX_sess_connect_renegotiate(SSL_CTX *ctx);
long SSL_CTX_sess_accept(SSL_CTX *ctx);
long SSL_CTX_sess_accept_good(SSL_CTX *ctx);
long SSL_CTX_sess_accept_renegotiate(SSL_CTX *ctx);
long SSL_CTX_sess_hits(SSL_CTX *ctx);
long SSL_CTX_sess_cb_hits(SSL_CTX *ctx);
long SSL_CTX_sess_misses(SSL_CTX *ctx);
long SSL_CTX_sess_timeouts(SSL_CTX *ctx);
long SSL_CTX_sess_cache_full(SSL_CTX *ctx);

like, every single one of them takes your SSL_CTX *ctx and hands you back a long. that's it. no drama 💅

---

🦋 DESCRIPTION 🦋

okay so here's the tea on each one, one by one, no skipping 🍓

• SSL_CTX_sess_number() — returns the current number of sessions chillin' in the internal session cache.
• SSL_CTX_sess_connect() — returns the number of SSL/TLS handshakes that got started in client mode.
• SSL_CTX_sess_connect_good() — returns the number of SSL/TLS sessions that were successfully established in client mode. the success stories 💚
• SSL_CTX_sess_connect_renegotiate() — returns the number of renegotiations that got started in client mode.
• SSL_CTX_sess_accept() — returns the number of SSL/TLS handshakes that got started in server mode.
• SSL_CTX_sess_accept_good() — returns the number of SSL/TLS sessions successfully established in server mode.
• SSL_CTX_sess_accept_renegotiate() — returns the number of renegotiations that got started in server mode.
• SSL_CTX_sess_hits() — returns the number of successfully reused sessions. two flavours, bestie:
  • in client mode, a session that was set with SSL_set_session(3) and then successfully reused counts as a hit 🎯
  • in server mode, a session successfully retrieved from the internal or external cache counts as a hit 🎯
• SSL_CTX_sess_cb_hits() — returns the number of successfully retrieved sessions from the external session cache in server mode.
• SSL_CTX_sess_misses() — returns the number of sessions proposed by clients that were not found in the internal session cache in server mode. the flops 😭
• SSL_CTX_sess_timeouts() — returns the number of sessions proposed by clients, and either found in the internal or external session cache in server mode, that were invalid due to timeout. and listen — these sessions are not included in the SSL_CTX_sess_hits() count. don't double-count, that's not the vibe 🙈
• SSL_CTX_sess_cache_full() — returns the number of sessions that got removed because the maximum session cache size was exceeded. evicted, literally.

---

🌸 RETURN VALUES 🌸

the functions return the values indicated in the DESCRIPTION section. yeah. that's the whole section. they just return what we already said. iconic honestly 💜

---

👑 SEE ALSO 👑

• ssl(7)
• SSL_set_session(3)
• SSL_CTX_set_session_cache_mode(3)
• SSL_CTX_sess_set_cache_size(3)

---

💅 COPYRIGHT 💅

Copyright 2001-2016 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License"). You may not use this file except in compliance with the License. You can obtain a copy in the file LICENSE in the source distribution or at <https://www.openssl.org/source/license.html>.

---

and that's the whole page, bestie!! go forth and count your sessions 🫶✨

OpenSSL 3.5.9 · 2026-09-29 · mwah, love u, bye 💖🎀🦋