9078d759f5890492bcdfc513a7435bbc9584e10d
[openssl.git] / ssl / ssl_sess.c
1 /* ssl/ssl_sess.c */
2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
3  * All rights reserved.
4  *
5  * This package is an SSL implementation written
6  * by Eric Young (eay@cryptsoft.com).
7  * The implementation was written so as to conform with Netscapes SSL.
8  * 
9  * This library is free for commercial and non-commercial use as long as
10  * the following conditions are aheared to.  The following conditions
11  * apply to all code found in this distribution, be it the RC4, RSA,
12  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
13  * included with this distribution is covered by the same copyright terms
14  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
15  * 
16  * Copyright remains Eric Young's, and as such any Copyright notices in
17  * the code are not to be removed.
18  * If this package is used in a product, Eric Young should be given attribution
19  * as the author of the parts of the library used.
20  * This can be in the form of a textual message at program startup or
21  * in documentation (online or textual) provided with the package.
22  * 
23  * Redistribution and use in source and binary forms, with or without
24  * modification, are permitted provided that the following conditions
25  * are met:
26  * 1. Redistributions of source code must retain the copyright
27  *    notice, this list of conditions and the following disclaimer.
28  * 2. Redistributions in binary form must reproduce the above copyright
29  *    notice, this list of conditions and the following disclaimer in the
30  *    documentation and/or other materials provided with the distribution.
31  * 3. All advertising materials mentioning features or use of this software
32  *    must display the following acknowledgement:
33  *    "This product includes cryptographic software written by
34  *     Eric Young (eay@cryptsoft.com)"
35  *    The word 'cryptographic' can be left out if the rouines from the library
36  *    being used are not cryptographic related :-).
37  * 4. If you include any Windows specific code (or a derivative thereof) from 
38  *    the apps directory (application code) you must include an acknowledgement:
39  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
40  * 
41  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51  * SUCH DAMAGE.
52  * 
53  * The licence and distribution terms for any publically available version or
54  * derivative of this code cannot be changed.  i.e. this code cannot simply be
55  * copied and put under another distribution licence
56  * [including the GNU Public Licence.]
57  */
58
59 #include <stdio.h>
60 #include <openssl/lhash.h>
61 #include <openssl/rand.h>
62 #include "ssl_locl.h"
63
64 static void SSL_SESSION_list_remove(SSL_CTX *ctx, SSL_SESSION *s);
65 static void SSL_SESSION_list_add(SSL_CTX *ctx,SSL_SESSION *s);
66 static int remove_session_lock(SSL_CTX *ctx, SSL_SESSION *c, int lck);
67
68 SSL_SESSION *SSL_get_session(SSL *ssl)
69 /* aka SSL_get0_session; gets 0 objects, just returns a copy of the pointer */
70         {
71         return(ssl->session);
72         }
73
74 SSL_SESSION *SSL_get1_session(SSL *ssl)
75 /* variant of SSL_get_session: caller really gets something */
76         {
77         SSL_SESSION *sess;
78         /* Need to lock this all up rather than just use CRYPTO_add so that
79          * somebody doesn't free ssl->session between when we check it's
80          * non-null and when we up the reference count. */
81         CRYPTO_r_lock(CRYPTO_LOCK_SSL_SESSION);
82         sess = ssl->session;
83         if(sess)
84                 sess->references++;
85         CRYPTO_r_unlock(CRYPTO_LOCK_SSL_SESSION);
86         return(sess);
87         }
88
89 int SSL_SESSION_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
90              CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func)
91         {
92         return CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_SSL_SESSION, argl, argp,
93                         new_func, dup_func, free_func);
94         }
95
96 int SSL_SESSION_set_ex_data(SSL_SESSION *s, int idx, void *arg)
97         {
98         return(CRYPTO_set_ex_data(&s->ex_data,idx,arg));
99         }
100
101 void *SSL_SESSION_get_ex_data(SSL_SESSION *s, int idx)
102         {
103         return(CRYPTO_get_ex_data(&s->ex_data,idx));
104         }
105
106 SSL_SESSION *SSL_SESSION_new(void)
107         {
108         SSL_SESSION *ss;
109
110         ss=(SSL_SESSION *)OPENSSL_malloc(sizeof(SSL_SESSION));
111         if (ss == NULL)
112                 {
113                 SSLerr(SSL_F_SSL_SESSION_NEW,ERR_R_MALLOC_FAILURE);
114                 return(0);
115                 }
116         memset(ss,0,sizeof(SSL_SESSION));
117
118         ss->verify_result = 1; /* avoid 0 (= X509_V_OK) just in case */
119         ss->references=1;
120         ss->timeout=60*5+4; /* 5 minute timeout by default */
121         ss->time=time(NULL);
122         ss->prev=NULL;
123         ss->next=NULL;
124         ss->compress_meth=0;
125         CRYPTO_new_ex_data(CRYPTO_EX_INDEX_SSL_SESSION, ss, &ss->ex_data);
126         return(ss);
127         }
128
129 /* Even with SSLv2, we have 16 bytes (128 bits) of session ID space. SSLv3/TLSv1
130  * has 32 bytes (256 bits). As such, filling the ID with random gunk repeatedly
131  * until we have no conflict is going to complete in one iteration pretty much
132  * "most" of the time (btw: understatement). So, if it takes us 10 iterations
133  * and we still can't avoid a conflict - well that's a reasonable point to call
134  * it quits. Either the RAND code is broken or someone is trying to open roughly
135  * very close to 2^128 (or 2^256) SSL sessions to our server. How you might
136  * store that many sessions is perhaps a more interesting question ... */
137
138 #define MAX_SESS_ID_ATTEMPTS 10
139 static int def_generate_session_id(const SSL *ssl, unsigned char *id,
140                                 unsigned int *id_len)
141 {
142         unsigned int retry = 0;
143         do
144                 RAND_pseudo_bytes(id, *id_len);
145         while(SSL_has_matching_session_id(ssl, id, *id_len) &&
146                 (++retry < MAX_SESS_ID_ATTEMPTS));
147         if(retry < MAX_SESS_ID_ATTEMPTS)
148                 return 1;
149         /* else - woops a session_id match */
150         /* XXX We should also check the external cache --
151          * but the probability of a collision is negligible, and
152          * we could not prevent the concurrent creation of sessions
153          * with identical IDs since we currently don't have means
154          * to atomically check whether a session ID already exists
155          * and make a reservation for it if it does not
156          * (this problem applies to the internal cache as well).
157          */
158         return 0;
159 }
160
161 int ssl_get_new_session(SSL *s, int session)
162         {
163         /* This gets used by clients and servers. */
164
165         unsigned int tmp;
166         SSL_SESSION *ss=NULL;
167         GEN_SESSION_CB cb = def_generate_session_id;
168
169         if ((ss=SSL_SESSION_new()) == NULL) return(0);
170
171         /* If the context has a default timeout, use it */
172         if (s->ctx->session_timeout == 0)
173                 ss->timeout=SSL_get_default_timeout(s);
174         else
175                 ss->timeout=s->ctx->session_timeout;
176
177         if (s->session != NULL)
178                 {
179                 SSL_SESSION_free(s->session);
180                 s->session=NULL;
181                 }
182
183         if (session)
184                 {
185                 if (s->version == SSL2_VERSION)
186                         {
187                         ss->ssl_version=SSL2_VERSION;
188                         ss->session_id_length=SSL2_SSL_SESSION_ID_LENGTH;
189                         }
190                 else if (s->version == SSL3_VERSION)
191                         {
192                         ss->ssl_version=SSL3_VERSION;
193                         ss->session_id_length=SSL3_SSL_SESSION_ID_LENGTH;
194                         }
195                 else if (s->version == TLS1_VERSION)
196                         {
197                         ss->ssl_version=TLS1_VERSION;
198                         ss->session_id_length=SSL3_SSL_SESSION_ID_LENGTH;
199                         }
200                 else
201                         {
202                         SSLerr(SSL_F_SSL_GET_NEW_SESSION,SSL_R_UNSUPPORTED_SSL_VERSION);
203                         SSL_SESSION_free(ss);
204                         return(0);
205                         }
206                 /* Choose which callback will set the session ID */
207                 CRYPTO_r_lock(CRYPTO_LOCK_SSL_CTX);
208                 if(s->generate_session_id)
209                         cb = s->generate_session_id;
210                 else if(s->ctx->generate_session_id)
211                         cb = s->ctx->generate_session_id;
212                 CRYPTO_r_unlock(CRYPTO_LOCK_SSL_CTX);
213                 /* Choose a session ID */
214                 tmp = ss->session_id_length;
215                 if(!cb(s, ss->session_id, &tmp))
216                         {
217                         /* The callback failed */
218                         SSLerr(SSL_F_SSL_GET_NEW_SESSION,
219                                 SSL_R_SSL_SESSION_ID_CALLBACK_FAILED);
220                         SSL_SESSION_free(ss);
221                         return(0);
222                         }
223                 /* Don't allow the callback to set the session length to zero.
224                  * nor set it higher than it was. */
225                 if(!tmp || (tmp > ss->session_id_length))
226                         {
227                         /* The callback set an illegal length */
228                         SSLerr(SSL_F_SSL_GET_NEW_SESSION,
229                                 SSL_R_SSL_SESSION_ID_HAS_BAD_LENGTH);
230                         SSL_SESSION_free(ss);
231                         return(0);
232                         }
233                 /* If the session length was shrunk and we're SSLv2, pad it */
234                 if((tmp < ss->session_id_length) && (s->version == SSL2_VERSION))
235                         memset(ss->session_id + tmp, 0, ss->session_id_length - tmp);
236                 else
237                         ss->session_id_length = tmp;
238                 /* Finally, check for a conflict */
239                 if(SSL_has_matching_session_id(s, ss->session_id,
240                                                 ss->session_id_length))
241                         {
242                         SSLerr(SSL_F_SSL_GET_NEW_SESSION,
243                                 SSL_R_SSL_SESSION_ID_CONFLICT);
244                         SSL_SESSION_free(ss);
245                         return(0);
246                         }
247                 }
248         else
249                 {
250                 ss->session_id_length=0;
251                 }
252
253         memcpy(ss->sid_ctx,s->sid_ctx,s->sid_ctx_length);
254         ss->sid_ctx_length=s->sid_ctx_length;
255         s->session=ss;
256         ss->ssl_version=s->version;
257         ss->verify_result = X509_V_OK;
258
259         return(1);
260         }
261
262 int ssl_get_prev_session(SSL *s, unsigned char *session_id, int len)
263         {
264         /* This is used only by servers. */
265
266         SSL_SESSION *ret=NULL,data;
267         int fatal = 0;
268
269         data.ssl_version=s->version;
270         data.session_id_length=len;
271         if (len > SSL_MAX_SSL_SESSION_ID_LENGTH)
272                 goto err;
273         memcpy(data.session_id,session_id,len);
274
275         if (!(s->ctx->session_cache_mode & SSL_SESS_CACHE_NO_INTERNAL_LOOKUP))
276                 {
277                 CRYPTO_r_lock(CRYPTO_LOCK_SSL_CTX);
278                 ret=(SSL_SESSION *)lh_retrieve(s->ctx->sessions,&data);
279                 if (ret != NULL)
280                     /* don't allow other threads to steal it: */
281                     CRYPTO_add(&ret->references,1,CRYPTO_LOCK_SSL_SESSION);
282                 CRYPTO_r_unlock(CRYPTO_LOCK_SSL_CTX);
283                 }
284
285         if (ret == NULL)
286                 {
287                 int copy=1;
288         
289                 s->ctx->stats.sess_miss++;
290                 ret=NULL;
291                 if (s->ctx->get_session_cb != NULL
292                     && (ret=s->ctx->get_session_cb(s,session_id,len,&copy))
293                        != NULL)
294                         {
295                         s->ctx->stats.sess_cb_hit++;
296
297                         /* Increment reference count now if the session callback
298                          * asks us to do so (note that if the session structures
299                          * returned by the callback are shared between threads,
300                          * it must handle the reference count itself [i.e. copy == 0],
301                          * or things won't be thread-safe). */
302                         if (copy)
303                                 CRYPTO_add(&ret->references,1,CRYPTO_LOCK_SSL_SESSION);
304
305                         /* The following should not return 1, otherwise,
306                          * things are very strange */
307                         SSL_CTX_add_session(s->ctx,ret);
308                         }
309                 if (ret == NULL)
310                         goto err;
311                 }
312
313         /* Now ret is non-NULL, and we own one of its reference counts. */
314
315         if((s->verify_mode&SSL_VERIFY_PEER)
316            && (!s->sid_ctx_length || ret->sid_ctx_length != s->sid_ctx_length
317                || memcmp(ret->sid_ctx,s->sid_ctx,ret->sid_ctx_length)))
318             {
319                 /* We've found the session named by the client, but we don't
320                  * want to use it in this context. */
321                 
322                 if (s->sid_ctx_length == 0)
323                         {
324                         /* application should have used SSL[_CTX]_set_session_id_context
325                          * -- we could tolerate this and just pretend we never heard
326                          * of this session, but then applications could effectively
327                          * disable the session cache by accident without anyone noticing */
328
329                         SSLerr(SSL_F_SSL_GET_PREV_SESSION,SSL_R_SESSION_ID_CONTEXT_UNINITIALIZED);
330                         fatal = 1;
331                         goto err;
332                         }
333                 else
334                         {
335 #if 0 /* The client cannot always know when a session is not appropriate,
336            * so we shouldn't generate an error message. */
337
338                         SSLerr(SSL_F_SSL_GET_PREV_SESSION,SSL_R_ATTEMPT_TO_REUSE_SESSION_IN_DIFFERENT_CONTEXT);
339 #endif
340                         goto err; /* treat like cache miss */
341                         }
342                 }
343
344         if (ret->cipher == NULL)
345                 {
346                 unsigned char buf[5],*p;
347                 unsigned long l;
348
349                 p=buf;
350                 l=ret->cipher_id;
351                 l2n(l,p);
352                 if ((ret->ssl_version>>8) == SSL3_VERSION_MAJOR)
353                         ret->cipher=ssl_get_cipher_by_char(s,&(buf[2]));
354                 else 
355                         ret->cipher=ssl_get_cipher_by_char(s,&(buf[1]));
356                 if (ret->cipher == NULL)
357                         goto err;
358                 }
359
360
361 #if 0 /* This is way too late. */
362
363         /* If a thread got the session, then 'swaped', and another got
364          * it and then due to a time-out decided to 'OPENSSL_free' it we could
365          * be in trouble.  So I'll increment it now, then double decrement
366          * later - am I speaking rubbish?. */
367         CRYPTO_add(&ret->references,1,CRYPTO_LOCK_SSL_SESSION);
368 #endif
369
370         if ((long)(ret->time+ret->timeout) < (long)time(NULL)) /* timeout */
371                 {
372                 s->ctx->stats.sess_timeout++;
373                 /* remove it from the cache */
374                 SSL_CTX_remove_session(s->ctx,ret);
375                 goto err;
376                 }
377
378         s->ctx->stats.sess_hit++;
379
380         /* ret->time=time(NULL); */ /* rezero timeout? */
381         /* again, just leave the session 
382          * if it is the same session, we have just incremented and
383          * then decremented the reference count :-) */
384         if (s->session != NULL)
385                 SSL_SESSION_free(s->session);
386         s->session=ret;
387         s->verify_result = s->session->verify_result;
388         return(1);
389
390  err:
391         if (ret != NULL)
392                 SSL_SESSION_free(ret);
393         if (fatal)
394                 return -1;
395         else
396                 return 0;
397         }
398
399 int SSL_CTX_add_session(SSL_CTX *ctx, SSL_SESSION *c)
400         {
401         int ret=0;
402         SSL_SESSION *s;
403
404         /* add just 1 reference count for the SSL_CTX's session cache
405          * even though it has two ways of access: each session is in a
406          * doubly linked list and an lhash */
407         CRYPTO_add(&c->references,1,CRYPTO_LOCK_SSL_SESSION);
408         /* if session c is in already in cache, we take back the increment later */
409
410         CRYPTO_w_lock(CRYPTO_LOCK_SSL_CTX);
411         s=(SSL_SESSION *)lh_insert(ctx->sessions,c);
412         
413         /* s != NULL iff we already had a session with the given PID.
414          * In this case, s == c should hold (then we did not really modify
415          * ctx->sessions), or we're in trouble. */
416         if (s != NULL && s != c)
417                 {
418                 /* We *are* in trouble ... */
419                 SSL_SESSION_list_remove(ctx,s);
420                 SSL_SESSION_free(s);
421                 /* ... so pretend the other session did not exist in cache
422                  * (we cannot handle two SSL_SESSION structures with identical
423                  * session ID in the same cache, which could happen e.g. when
424                  * two threads concurrently obtain the same session from an external
425                  * cache) */
426                 s = NULL;
427                 }
428
429         /* Put at the head of the queue unless it is already in the cache */
430         if (s == NULL)
431                 SSL_SESSION_list_add(ctx,c);
432
433         if (s != NULL)
434                 {
435                 /* existing cache entry -- decrement previously incremented reference
436                  * count because it already takes into account the cache */
437
438                 SSL_SESSION_free(s); /* s == c */
439                 ret=0;
440                 }
441         else
442                 {
443                 /* new cache entry -- remove old ones if cache has become too large */
444                 
445                 ret=1;
446
447                 if (SSL_CTX_sess_get_cache_size(ctx) > 0)
448                         {
449                         while (SSL_CTX_sess_number(ctx) >
450                                 SSL_CTX_sess_get_cache_size(ctx))
451                                 {
452                                 if (!remove_session_lock(ctx,
453                                         ctx->session_cache_tail, 0))
454                                         break;
455                                 else
456                                         ctx->stats.sess_cache_full++;
457                                 }
458                         }
459                 }
460         CRYPTO_w_unlock(CRYPTO_LOCK_SSL_CTX);
461         return(ret);
462         }
463
464 int SSL_CTX_remove_session(SSL_CTX *ctx, SSL_SESSION *c)
465 {
466         return remove_session_lock(ctx, c, 1);
467 }
468
469 static int remove_session_lock(SSL_CTX *ctx, SSL_SESSION *c, int lck)
470         {
471         SSL_SESSION *r;
472         int ret=0;
473
474         if ((c != NULL) && (c->session_id_length != 0))
475                 {
476                 if(lck) CRYPTO_w_lock(CRYPTO_LOCK_SSL_CTX);
477                 r=(SSL_SESSION *)lh_delete(ctx->sessions,c);
478                 if (r != NULL)
479                         {
480                         ret=1;
481                         SSL_SESSION_list_remove(ctx,c);
482                         }
483
484                 if(lck) CRYPTO_w_unlock(CRYPTO_LOCK_SSL_CTX);
485
486                 if (ret)
487                         {
488                         r->not_resumable=1;
489                         if (ctx->remove_session_cb != NULL)
490                                 ctx->remove_session_cb(ctx,r);
491                         SSL_SESSION_free(r);
492                         }
493                 }
494         else
495                 ret=0;
496         return(ret);
497         }
498
499 void SSL_SESSION_free(SSL_SESSION *ss)
500         {
501         int i;
502
503         if(ss == NULL)
504             return;
505
506         i=CRYPTO_add(&ss->references,-1,CRYPTO_LOCK_SSL_SESSION);
507 #ifdef REF_PRINT
508         REF_PRINT("SSL_SESSION",ss);
509 #endif
510         if (i > 0) return;
511 #ifdef REF_CHECK
512         if (i < 0)
513                 {
514                 fprintf(stderr,"SSL_SESSION_free, bad reference count\n");
515                 abort(); /* ok */
516                 }
517 #endif
518
519         CRYPTO_free_ex_data(CRYPTO_EX_INDEX_SSL_SESSION, ss, &ss->ex_data);
520
521         memset(ss->key_arg,0,SSL_MAX_KEY_ARG_LENGTH);
522         memset(ss->master_key,0,SSL_MAX_MASTER_KEY_LENGTH);
523         memset(ss->session_id,0,SSL_MAX_SSL_SESSION_ID_LENGTH);
524         if (ss->sess_cert != NULL) ssl_sess_cert_free(ss->sess_cert);
525         if (ss->peer != NULL) X509_free(ss->peer);
526         if (ss->ciphers != NULL) sk_SSL_CIPHER_free(ss->ciphers);
527         memset(ss,0,sizeof(*ss));
528         OPENSSL_free(ss);
529         }
530
531 int SSL_set_session(SSL *s, SSL_SESSION *session)
532         {
533         int ret=0;
534         SSL_METHOD *meth;
535
536         if (session != NULL)
537                 {
538                 meth=s->ctx->method->get_ssl_method(session->ssl_version);
539                 if (meth == NULL)
540                         meth=s->method->get_ssl_method(session->ssl_version);
541                 if (meth == NULL)
542                         {
543                         SSLerr(SSL_F_SSL_SET_SESSION,SSL_R_UNABLE_TO_FIND_SSL_METHOD);
544                         return(0);
545                         }
546
547                 if (meth != s->method)
548                         {
549                         if (!SSL_set_ssl_method(s,meth))
550                                 return(0);
551                         if (s->ctx->session_timeout == 0)
552                                 session->timeout=SSL_get_default_timeout(s);
553                         else
554                                 session->timeout=s->ctx->session_timeout;
555                         }
556
557 #ifndef OPENSSL_NO_KRB5
558                 if (s->kssl_ctx && !s->kssl_ctx->client_princ &&
559                     session->krb5_client_princ_len > 0)
560                 {
561                     s->kssl_ctx->client_princ = (char *)malloc(session->krb5_client_princ_len + 1);
562                     memcpy(s->kssl_ctx->client_princ,session->krb5_client_princ,
563                             session->krb5_client_princ_len);
564                     s->kssl_ctx->client_princ[session->krb5_client_princ_len] = '\0';
565                 }
566 #endif /* OPENSSL_NO_KRB5 */
567
568                 /* CRYPTO_w_lock(CRYPTO_LOCK_SSL);*/
569                 CRYPTO_add(&session->references,1,CRYPTO_LOCK_SSL_SESSION);
570                 if (s->session != NULL)
571                         SSL_SESSION_free(s->session);
572                 s->session=session;
573                 s->verify_result = s->session->verify_result;
574                 /* CRYPTO_w_unlock(CRYPTO_LOCK_SSL);*/
575                 ret=1;
576                 }
577         else
578                 {
579                 if (s->session != NULL)
580                         {
581                         SSL_SESSION_free(s->session);
582                         s->session=NULL;
583                         }
584
585                 meth=s->ctx->method;
586                 if (meth != s->method)
587                         {
588                         if (!SSL_set_ssl_method(s,meth))
589                                 return(0);
590                         }
591                 ret=1;
592                 }
593         return(ret);
594         }
595
596 long SSL_SESSION_set_timeout(SSL_SESSION *s, long t)
597         {
598         if (s == NULL) return(0);
599         s->timeout=t;
600         return(1);
601         }
602
603 long SSL_SESSION_get_timeout(SSL_SESSION *s)
604         {
605         if (s == NULL) return(0);
606         return(s->timeout);
607         }
608
609 long SSL_SESSION_get_time(SSL_SESSION *s)
610         {
611         if (s == NULL) return(0);
612         return(s->time);
613         }
614
615 long SSL_SESSION_set_time(SSL_SESSION *s, long t)
616         {
617         if (s == NULL) return(0);
618         s->time=t;
619         return(t);
620         }
621
622 long SSL_CTX_set_timeout(SSL_CTX *s, long t)
623         {
624         long l;
625         if (s == NULL) return(0);
626         l=s->session_timeout;
627         s->session_timeout=t;
628         return(l);
629         }
630
631 long SSL_CTX_get_timeout(SSL_CTX *s)
632         {
633         if (s == NULL) return(0);
634         return(s->session_timeout);
635         }
636
637 typedef struct timeout_param_st
638         {
639         SSL_CTX *ctx;
640         long time;
641         LHASH *cache;
642         } TIMEOUT_PARAM;
643
644 static void timeout(SSL_SESSION *s, TIMEOUT_PARAM *p)
645         {
646         if ((p->time == 0) || (p->time > (s->time+s->timeout))) /* timeout */
647                 {
648                 /* The reason we don't call SSL_CTX_remove_session() is to
649                  * save on locking overhead */
650                 lh_delete(p->cache,s);
651                 SSL_SESSION_list_remove(p->ctx,s);
652                 s->not_resumable=1;
653                 if (p->ctx->remove_session_cb != NULL)
654                         p->ctx->remove_session_cb(p->ctx,s);
655                 SSL_SESSION_free(s);
656                 }
657         }
658
659 static IMPLEMENT_LHASH_DOALL_ARG_FN(timeout, SSL_SESSION *, TIMEOUT_PARAM *)
660
661 void SSL_CTX_flush_sessions(SSL_CTX *s, long t)
662         {
663         unsigned long i;
664         TIMEOUT_PARAM tp;
665
666         tp.ctx=s;
667         tp.cache=s->sessions;
668         if (tp.cache == NULL) return;
669         tp.time=t;
670         CRYPTO_w_lock(CRYPTO_LOCK_SSL_CTX);
671         i=tp.cache->down_load;
672         tp.cache->down_load=0;
673         lh_doall_arg(tp.cache, LHASH_DOALL_ARG_FN(timeout), &tp);
674         tp.cache->down_load=i;
675         CRYPTO_w_unlock(CRYPTO_LOCK_SSL_CTX);
676         }
677
678 int ssl_clear_bad_session(SSL *s)
679         {
680         if (    (s->session != NULL) &&
681                 !(s->shutdown & SSL_SENT_SHUTDOWN) &&
682                 !(SSL_in_init(s) || SSL_in_before(s)))
683                 {
684                 SSL_CTX_remove_session(s->ctx,s->session);
685                 return(1);
686                 }
687         else
688                 return(0);
689         }
690
691 /* locked by SSL_CTX in the calling function */
692 static void SSL_SESSION_list_remove(SSL_CTX *ctx, SSL_SESSION *s)
693         {
694         if ((s->next == NULL) || (s->prev == NULL)) return;
695
696         if (s->next == (SSL_SESSION *)&(ctx->session_cache_tail))
697                 { /* last element in list */
698                 if (s->prev == (SSL_SESSION *)&(ctx->session_cache_head))
699                         { /* only one element in list */
700                         ctx->session_cache_head=NULL;
701                         ctx->session_cache_tail=NULL;
702                         }
703                 else
704                         {
705                         ctx->session_cache_tail=s->prev;
706                         s->prev->next=(SSL_SESSION *)&(ctx->session_cache_tail);
707                         }
708                 }
709         else
710                 {
711                 if (s->prev == (SSL_SESSION *)&(ctx->session_cache_head))
712                         { /* first element in list */
713                         ctx->session_cache_head=s->next;
714                         s->next->prev=(SSL_SESSION *)&(ctx->session_cache_head);
715                         }
716                 else
717                         { /* middle of list */
718                         s->next->prev=s->prev;
719                         s->prev->next=s->next;
720                         }
721                 }
722         s->prev=s->next=NULL;
723         }
724
725 static void SSL_SESSION_list_add(SSL_CTX *ctx, SSL_SESSION *s)
726         {
727         if ((s->next != NULL) && (s->prev != NULL))
728                 SSL_SESSION_list_remove(ctx,s);
729
730         if (ctx->session_cache_head == NULL)
731                 {
732                 ctx->session_cache_head=s;
733                 ctx->session_cache_tail=s;
734                 s->prev=(SSL_SESSION *)&(ctx->session_cache_head);
735                 s->next=(SSL_SESSION *)&(ctx->session_cache_tail);
736                 }
737         else
738                 {
739                 s->next=ctx->session_cache_head;
740                 s->next->prev=s;
741                 s->prev=(SSL_SESSION *)&(ctx->session_cache_head);
742                 ctx->session_cache_head=s;
743                 }
744         }
745