xref: /freebsd/crypto/openssl/doc/man3/SSL_CTX_sessions.pod (revision a25896ca1270e25b657ceaa8d47d5699515f5c25)
1=pod
2
3=head1 NAME
4
5SSL_CTX_sessions - access internal session cache
6
7=head1 SYNOPSIS
8
9 #include <openssl/ssl.h>
10
11 struct lhash_st *SSL_CTX_sessions(SSL_CTX *ctx);
12
13=head1 DESCRIPTION
14
15SSL_CTX_sessions() returns a pointer to the lhash databases containing the
16internal session cache for B<ctx>.
17
18=head1 NOTES
19
20The sessions in the internal session cache are kept in an
21L<LHASH(3)> type database. It is possible to directly
22access this database e.g. for searching. In parallel, the sessions
23form a linked list which is maintained separately from the
24L<LHASH(3)> operations, so that the database must not be
25modified directly but by using the
26L<SSL_CTX_add_session(3)> family of functions.
27
28=head1 RETURN VALUES
29
30SSL_CTX_sessions() returns a pointer to the lhash of B<SSL_SESSION>.
31
32=head1 SEE ALSO
33
34L<ssl(7)>, L<LHASH(3)>,
35L<SSL_CTX_add_session(3)>,
36L<SSL_CTX_set_session_cache_mode(3)>
37
38=head1 COPYRIGHT
39
40Copyright 2001-2018 The OpenSSL Project Authors. All Rights Reserved.
41
42Licensed under the OpenSSL license (the "License").  You may not use
43this file except in compliance with the License.  You can obtain a copy
44in the file LICENSE in the source distribution or at
45L<https://www.openssl.org/source/license.html>.
46
47=cut
48