1 .\" Automatically generated by Pod::Man version 1.15
2 .\" Tue Jul 30 09:22:29 2002
5 .\" ======================================================================
6 .de Sh \" Subsection heading
14 .de Sp \" Vertical space (when we can't use .PP)
20 .ie \\n(.$>=3 .ne \\$3
24 .de Vb \" Begin verbatim text
29 .de Ve \" End verbatim text
34 .\" Set up some character translations and predefined strings. \*(-- will
35 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
36 .\" double quote, and \*(R" will give a right double quote. | will give a
37 .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
38 .\" to do unbreakable dashes and therefore won't be available. \*(C` and
39 .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
41 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
45 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
46 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
59 .\" If the F register is turned on, we'll generate index entries on stderr
60 .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
61 .\" index entries marked with X<> in POD. Of course, you'll have to process
62 .\" the output yourself in some meaningful fashion.
65 . tm Index:\\$1\t\\n%\t"\\$2"
71 .\" For nroff, turn off justification. Always turn off hyphenation; it
72 .\" makes way too many mistakes in technical documents.
76 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
77 .\" Fear. Run. Save yourself. No user-serviceable parts.
79 . \" fudge factors for nroff and troff
88 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
94 . \" simple accents for nroff and troff
104 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
105 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
106 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
107 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
108 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
109 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
111 . \" troff and (daisy-wheel) nroff accents
112 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
113 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
114 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
115 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
116 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
117 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
118 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
119 .ds ae a\h'-(\w'a'u*4/10)'e
120 .ds Ae A\h'-(\w'A'u*4/10)'E
121 . \" corrections for vroff
122 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
123 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
124 . \" for low resolution devices (crt and lpr)
125 .if \n(.H>23 .if \n(.V>19 \
138 .\" ======================================================================
140 .IX Title "SSL_CTX_set_timeout 3"
141 .TH SSL_CTX_set_timeout 3 "0.9.6e" "2002-01-26" "OpenSSL"
144 SSL_CTX_set_timeout, SSL_CTX_get_timeout \- manipulate timeout values for session caching
146 .IX Header "SYNOPSIS"
148 \& #include <openssl/ssl.h>
151 \& long SSL_CTX_set_timeout(SSL_CTX *ctx, long t);
152 \& long SSL_CTX_get_timeout(SSL_CTX *ctx);
155 .IX Header "DESCRIPTION"
156 \&\fISSL_CTX_set_timeout()\fR sets the timeout for newly created sessions for
157 \&\fBctx\fR to \fBt\fR. The timeout value \fBt\fR must be given in seconds.
159 \&\fISSL_CTX_get_timeout()\fR returns the currently set timeout value for \fBctx\fR.
162 Whenever a new session is created, it is assigned a maximum lifetime. This
163 lifetime is specified by storing the creation time of the session and the
164 timeout value valid at this time. If the actual time is later than creation
165 time plus timeout, the session is not reused.
167 Due to this realization, all sessions behave according to the timeout value
168 valid at the time of the session negotiation. Changes of the timeout value
169 do not affect already established sessions.
171 The expiration time of a single session can be modified using the
172 SSL_SESSION_get_time(3) family of functions.
174 Expired sessions are removed from the internal session cache, whenever
175 SSL_CTX_flush_sessions(3) is called, either
176 directly by the application or automatically (see
177 SSL_CTX_set_session_cache_mode(3))
179 The default value for session timeout is decided on a per protocol
180 basis, see SSL_get_default_timeout(3).
181 All currently supported protocols have the same default timeout value
184 .IX Header "RETURN VALUES"
185 \&\fISSL_CTX_set_timeout()\fR returns the previously set timeout value.
187 \&\fISSL_CTX_get_timeout()\fR returns the currently set timeout value.
189 .IX Header "SEE ALSO"
191 SSL_CTX_set_session_cache_mode(3),
192 SSL_SESSION_get_time(3),
193 SSL_CTX_flush_sessions(3),
194 SSL_get_default_timeout(3)