2 ''' $RCSfile$$Revision$$Date$
20 .ie \\n(.$>=3 .ne \\$3
36 ''' Set up \*(-- to give an unbreakable dash;
37 ''' string Tr holds user defined translation string.
38 ''' Bell System Logo is used as a dummy character.
44 .if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
45 .if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
48 ''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
49 ''' \*(L" and \*(R", except that they are used on ".xx" lines,
50 ''' such as .IP and .SH, which do another additional levels of
51 ''' double-quote interpretation
80 .\" If the F register is turned on, we'll generate
81 .\" index entries out stderr for the following things:
86 .\" X<> Xref (embedded
87 .\" Of course, you have to process the output yourself
88 .\" in some meaninful fashion.
91 .tm Index:\\$1\t\\n%\t"\\$2"
96 .TH SSL_CTX_sess_number 3 "0.9.7d" "2/Sep/2004" "OpenSSL"
100 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
101 .de CQ \" put $1 in typewriter font
107 \\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
110 .\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
111 . \" AM - accent mark definitions
113 . \" fudge factors for nroff and troff
122 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
128 . \" simple accents for nroff and troff
141 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
142 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
143 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
144 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
145 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
146 . ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
147 . ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
148 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
149 . ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
151 . \" troff and (daisy-wheel) nroff accents
152 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
153 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
154 .ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
155 .ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
156 .ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
157 .ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
158 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
159 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
160 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
161 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
162 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
163 .ds ae a\h'-(\w'a'u*4/10)'e
164 .ds Ae A\h'-(\w'A'u*4/10)'E
165 .ds oe o\h'-(\w'o'u*4/10)'e
166 .ds Oe O\h'-(\w'O'u*4/10)'E
167 . \" corrections for vroff
168 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
169 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
170 . \" for low resolution devices (crt and lpr)
171 .if \n(.H>23 .if \n(.V>19 \
175 . ds v \h'-1'\o'\(aa\(ga'
191 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, SSL_CTX_sess_cache_full \- obtain session cache statistics
195 \& #include <openssl/ssl.h>
198 \& long SSL_CTX_sess_number(SSL_CTX *ctx);
199 \& long SSL_CTX_sess_connect(SSL_CTX *ctx);
200 \& long SSL_CTX_sess_connect_good(SSL_CTX *ctx);
201 \& long SSL_CTX_sess_connect_renegotiate(SSL_CTX *ctx);
202 \& long SSL_CTX_sess_accept(SSL_CTX *ctx);
203 \& long SSL_CTX_sess_accept_good(SSL_CTX *ctx);
204 \& long SSL_CTX_sess_accept_renegotiate(SSL_CTX *ctx);
205 \& long SSL_CTX_sess_hits(SSL_CTX *ctx);
206 \& long SSL_CTX_sess_cb_hits(SSL_CTX *ctx);
207 \& long SSL_CTX_sess_misses(SSL_CTX *ctx);
208 \& long SSL_CTX_sess_timeouts(SSL_CTX *ctx);
209 \& long SSL_CTX_sess_cache_full(SSL_CTX *ctx);
212 \fISSL_CTX_sess_number()\fR returns the current number of sessions in the internal
215 \fISSL_CTX_sess_connect()\fR returns the number of started SSL/TLS handshakes in
218 \fISSL_CTX_sess_connect_good()\fR returns the number of successfully established
219 SSL/TLS sessions in client mode.
221 \fISSL_CTX_sess_connect_renegotiate()\fR returns the number of start renegotiations
224 \fISSL_CTX_sess_accept()\fR returns the number of started SSL/TLS handshakes in
227 \fISSL_CTX_sess_accept_good()\fR returns the number of successfully established
228 SSL/TLS sessions in server mode.
230 \fISSL_CTX_sess_accept_renegotiate()\fR returns the number of start renegotiations
233 \fISSL_CTX_sess_hits()\fR returns the number of successfully reused sessions.
234 In client mode a session set with SSL_set_session(3)
235 successfully reused is counted as a hit. In server mode a session successfully
236 retrieved from internal or external cache is counted as a hit.
238 \fISSL_CTX_sess_cb_hits()\fR returns the number of successfully retrieved sessions
239 from the external session cache in server mode.
241 \fISSL_CTX_sess_misses()\fR returns the number of sessions proposed by clients
242 that were not found in the internal session cache in server mode.
244 \fISSL_CTX_sess_timeouts()\fR returns the number of sessions proposed by clients
245 and either found in the internal or external session cache in server mode,
246 but that were invalid due to timeout. These sessions are not included in
247 the \fISSL_CTX_sess_hits()\fR count.
249 \fISSL_CTX_sess_cache_full()\fR returns the number of sessions that were removed
250 because the maximum session cache size was exceeded.
252 The functions return the values indicated in the DESCRIPTION section.
254 ssl(3), SSL_set_session(3),
255 SSL_CTX_set_session_cache_mode(3)
256 SSL_CTX_sess_set_cache_size(3)
259 .IX Title "SSL_CTX_sess_number 3"
260 .IX Name "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, SSL_CTX_sess_cache_full - obtain session cache statistics"
264 .IX Header "SYNOPSIS"
266 .IX Header "DESCRIPTION"
268 .IX Header "RETURN VALUES"
270 .IX Header "SEE ALSO"