---
name: "SSL_CTX_sessions"
section: "3ssl"
platform: "linux"
package: "openssl"
version: "3.6.5-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/SSL_CTX_sessions"
---

# SSL\_CTX\_sessions(3ssl)

access internal session cache

## NAME

SSL\_CTX\_sessions - access internal session cache

## SYNOPSIS

```
 #include <openssl/ssl.h>
 LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx);
```

## DESCRIPTION

**SSL\_CTX\_sessions()** returns a pointer to the lhash databases containing the internal session cache for **ctx**.

## NOTES

The sessions in the internal session cache are kept in an **LHASH**(3) type database. It is possible to directly access this database e.g. for searching. In parallel, the sessions form a linked list which is maintained separately from the **LHASH**(3) operations, so that the database must not be modified directly but by using the **SSL\_CTX\_add\_session**(3) family of functions.

## RETURN VALUES

**SSL\_CTX\_sessions()** returns a pointer to the lhash of **SSL\_SESSION**.

## SEE ALSO

[**ssl**(7)](/ssl/7.md), **LHASH**(3), **SSL\_CTX\_add\_session**(3), **SSL\_CTX\_set\_session\_cache\_mode**(3)

## COPYRIGHT

Copyright 2001-2021 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\>.