xref: /onnv-gate/usr/src/common/openssl/doc/ssl/SSL_CTX_sessions.pod (revision 2175:b0b2f052a486)
1*2175Sjp161948=pod
2*2175Sjp161948
3*2175Sjp161948=head1 NAME
4*2175Sjp161948
5*2175Sjp161948SSL_CTX_sessions - access internal session cache
6*2175Sjp161948
7*2175Sjp161948=head1 SYNOPSIS
8*2175Sjp161948
9*2175Sjp161948 #include <openssl/ssl.h>
10*2175Sjp161948
11*2175Sjp161948 struct lhash_st *SSL_CTX_sessions(SSL_CTX *ctx);
12*2175Sjp161948
13*2175Sjp161948=head1 DESCRIPTION
14*2175Sjp161948
15*2175Sjp161948SSL_CTX_sessions() returns a pointer to the lhash databases containing the
16*2175Sjp161948internal session cache for B<ctx>.
17*2175Sjp161948
18*2175Sjp161948=head1 NOTES
19*2175Sjp161948
20*2175Sjp161948The sessions in the internal session cache are kept in an
21*2175Sjp161948L<lhash(3)|lhash(3)> type database. It is possible to directly
22*2175Sjp161948access this database e.g. for searching. In parallel, the sessions
23*2175Sjp161948form a linked list which is maintained separately from the
24*2175Sjp161948L<lhash(3)|lhash(3)> operations, so that the database must not be
25*2175Sjp161948modified directly but by using the
26*2175Sjp161948L<SSL_CTX_add_session(3)|SSL_CTX_add_session(3)> family of functions.
27*2175Sjp161948
28*2175Sjp161948=head1 SEE ALSO
29*2175Sjp161948
30*2175Sjp161948L<ssl(3)|ssl(3)>, L<lhash(3)|lhash(3)>,
31*2175Sjp161948L<SSL_CTX_add_session(3)|SSL_CTX_add_session(3)>,
32*2175Sjp161948L<SSL_CTX_set_session_cache_mode(3)|SSL_CTX_set_session_cache_mode(3)>
33*2175Sjp161948
34*2175Sjp161948=cut
35