Add an ability to set the SSL read buffer size
[openssl.git] / ssl / ssl_lib.c
1 /*
2  * ! \file ssl/ssl_lib.c \brief Version independent SSL functions.
3  */
4 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
5  * All rights reserved.
6  *
7  * This package is an SSL implementation written
8  * by Eric Young (eay@cryptsoft.com).
9  * The implementation was written so as to conform with Netscapes SSL.
10  *
11  * This library is free for commercial and non-commercial use as long as
12  * the following conditions are aheared to.  The following conditions
13  * apply to all code found in this distribution, be it the RC4, RSA,
14  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
15  * included with this distribution is covered by the same copyright terms
16  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
17  *
18  * Copyright remains Eric Young's, and as such any Copyright notices in
19  * the code are not to be removed.
20  * If this package is used in a product, Eric Young should be given attribution
21  * as the author of the parts of the library used.
22  * This can be in the form of a textual message at program startup or
23  * in documentation (online or textual) provided with the package.
24  *
25  * Redistribution and use in source and binary forms, with or without
26  * modification, are permitted provided that the following conditions
27  * are met:
28  * 1. Redistributions of source code must retain the copyright
29  *    notice, this list of conditions and the following disclaimer.
30  * 2. Redistributions in binary form must reproduce the above copyright
31  *    notice, this list of conditions and the following disclaimer in the
32  *    documentation and/or other materials provided with the distribution.
33  * 3. All advertising materials mentioning features or use of this software
34  *    must display the following acknowledgement:
35  *    "This product includes cryptographic software written by
36  *     Eric Young (eay@cryptsoft.com)"
37  *    The word 'cryptographic' can be left out if the rouines from the library
38  *    being used are not cryptographic related :-).
39  * 4. If you include any Windows specific code (or a derivative thereof) from
40  *    the apps directory (application code) you must include an acknowledgement:
41  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
42  *
43  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
44  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
47  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
48  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
49  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
50  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
51  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
52  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
53  * SUCH DAMAGE.
54  *
55  * The licence and distribution terms for any publically available version or
56  * derivative of this code cannot be changed.  i.e. this code cannot simply be
57  * copied and put under another distribution licence
58  * [including the GNU Public Licence.]
59  */
60 /* ====================================================================
61  * Copyright (c) 1998-2007 The OpenSSL Project.  All rights reserved.
62  *
63  * Redistribution and use in source and binary forms, with or without
64  * modification, are permitted provided that the following conditions
65  * are met:
66  *
67  * 1. Redistributions of source code must retain the above copyright
68  *    notice, this list of conditions and the following disclaimer.
69  *
70  * 2. Redistributions in binary form must reproduce the above copyright
71  *    notice, this list of conditions and the following disclaimer in
72  *    the documentation and/or other materials provided with the
73  *    distribution.
74  *
75  * 3. All advertising materials mentioning features or use of this
76  *    software must display the following acknowledgment:
77  *    "This product includes software developed by the OpenSSL Project
78  *    for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
79  *
80  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
81  *    endorse or promote products derived from this software without
82  *    prior written permission. For written permission, please contact
83  *    openssl-core@openssl.org.
84  *
85  * 5. Products derived from this software may not be called "OpenSSL"
86  *    nor may "OpenSSL" appear in their names without prior written
87  *    permission of the OpenSSL Project.
88  *
89  * 6. Redistributions of any form whatsoever must retain the following
90  *    acknowledgment:
91  *    "This product includes software developed by the OpenSSL Project
92  *    for use in the OpenSSL Toolkit (http://www.openssl.org/)"
93  *
94  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
95  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
96  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
97  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
98  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
99  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
100  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
101  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
102  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
103  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
104  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
105  * OF THE POSSIBILITY OF SUCH DAMAGE.
106  * ====================================================================
107  *
108  * This product includes cryptographic software written by Eric Young
109  * (eay@cryptsoft.com).  This product includes software written by Tim
110  * Hudson (tjh@cryptsoft.com).
111  *
112  */
113 /* ====================================================================
114  * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
115  * ECC cipher suite support in OpenSSL originally developed by
116  * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project.
117  */
118 /* ====================================================================
119  * Copyright 2005 Nokia. All rights reserved.
120  *
121  * The portions of the attached software ("Contribution") is developed by
122  * Nokia Corporation and is licensed pursuant to the OpenSSL open source
123  * license.
124  *
125  * The Contribution, originally written by Mika Kousa and Pasi Eronen of
126  * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
127  * support (see RFC 4279) to OpenSSL.
128  *
129  * No patent licenses or other rights except those expressly stated in
130  * the OpenSSL open source license shall be deemed granted or received
131  * expressly, by implication, estoppel, or otherwise.
132  *
133  * No assurances are provided by Nokia that the Contribution does not
134  * infringe the patent or other intellectual property rights of any third
135  * party or that the license provides you with all the necessary rights
136  * to make use of the Contribution.
137  *
138  * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
139  * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
140  * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
141  * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
142  * OTHERWISE.
143  */
144
145 #ifdef REF_DEBUG
146 # include <assert.h>
147 #endif
148 #include <stdio.h>
149 #include "ssl_locl.h"
150 #include <openssl/objects.h>
151 #include <openssl/lhash.h>
152 #include <openssl/x509v3.h>
153 #include <openssl/rand.h>
154 #include <openssl/ocsp.h>
155 #ifndef OPENSSL_NO_DH
156 # include <openssl/dh.h>
157 #endif
158 #ifndef OPENSSL_NO_ENGINE
159 # include <openssl/engine.h>
160 #endif
161 #include <openssl/async.h>
162 #ifndef OPENSSL_NO_CT
163 # include <openssl/ct.h>
164 #endif
165
166 const char SSL_version_str[] = OPENSSL_VERSION_TEXT;
167
168 SSL3_ENC_METHOD ssl3_undef_enc_method = {
169     /*
170      * evil casts, but these functions are only called if there's a library
171      * bug
172      */
173     (int (*)(SSL *, SSL3_RECORD *, unsigned int, int))ssl_undefined_function,
174     (int (*)(SSL *, SSL3_RECORD *, unsigned char *, int))ssl_undefined_function,
175     ssl_undefined_function,
176     (int (*)(SSL *, unsigned char *, unsigned char *, int))
177         ssl_undefined_function,
178     (int (*)(SSL *, int))ssl_undefined_function,
179     (int (*)(SSL *, const char *, int, unsigned char *))
180         ssl_undefined_function,
181     0,                          /* finish_mac_length */
182     NULL,                       /* client_finished_label */
183     0,                          /* client_finished_label_len */
184     NULL,                       /* server_finished_label */
185     0,                          /* server_finished_label_len */
186     (int (*)(int))ssl_undefined_function,
187     (int (*)(SSL *, unsigned char *, size_t, const char *,
188              size_t, const unsigned char *, size_t,
189              int use_context))ssl_undefined_function,
190 };
191
192 struct ssl_async_args {
193     SSL *s;
194     void *buf;
195     int num;
196     enum { READFUNC, WRITEFUNC,  OTHERFUNC} type;
197     union {
198         int (*func_read)(SSL *, void *, int);
199         int (*func_write)(SSL *, const void *, int);
200         int (*func_other)(SSL *);
201     } f;
202 };
203
204 static const struct {
205     uint8_t mtype;
206     uint8_t ord;
207     int     nid;
208 } dane_mds[] = {
209     { DANETLS_MATCHING_FULL, 0, NID_undef },
210     { DANETLS_MATCHING_2256, 1, NID_sha256 },
211     { DANETLS_MATCHING_2512, 2, NID_sha512 },
212 };
213
214 static int dane_ctx_enable(struct dane_ctx_st *dctx)
215 {
216     const EVP_MD **mdevp;
217     uint8_t *mdord;
218     uint8_t mdmax = DANETLS_MATCHING_LAST;
219     int n = ((int) mdmax) + 1;          /* int to handle PrivMatch(255) */
220     size_t i;
221
222     mdevp = OPENSSL_zalloc(n * sizeof(*mdevp));
223     mdord = OPENSSL_zalloc(n * sizeof(*mdord));
224
225     if (mdord == NULL || mdevp == NULL) {
226         OPENSSL_free(mdevp);
227         SSLerr(SSL_F_DANE_CTX_ENABLE, ERR_R_MALLOC_FAILURE);
228         return 0;
229     }
230
231     /* Install default entries */
232     for (i = 0; i < OSSL_NELEM(dane_mds); ++i) {
233         const EVP_MD *md;
234
235         if (dane_mds[i].nid == NID_undef ||
236             (md = EVP_get_digestbynid(dane_mds[i].nid)) == NULL)
237             continue;
238         mdevp[dane_mds[i].mtype] = md;
239         mdord[dane_mds[i].mtype] = dane_mds[i].ord;
240     }
241
242     dctx->mdevp = mdevp;
243     dctx->mdord = mdord;
244     dctx->mdmax = mdmax;
245
246     return 1;
247 }
248
249 static void dane_ctx_final(struct dane_ctx_st *dctx)
250 {
251     OPENSSL_free(dctx->mdevp);
252     dctx->mdevp = NULL;
253
254     OPENSSL_free(dctx->mdord);
255     dctx->mdord = NULL;
256     dctx->mdmax = 0;
257 }
258
259 static void tlsa_free(danetls_record *t)
260 {
261     if (t == NULL)
262         return;
263     OPENSSL_free(t->data);
264     EVP_PKEY_free(t->spki);
265     OPENSSL_free(t);
266 }
267
268 static void dane_final(struct dane_st *dane)
269 {
270     sk_danetls_record_pop_free(dane->trecs, tlsa_free);
271     dane->trecs = NULL;
272
273     sk_X509_pop_free(dane->certs, X509_free);
274     dane->certs = NULL;
275
276     X509_free(dane->mcert);
277     dane->mcert = NULL;
278     dane->mtlsa = NULL;
279     dane->mdpth = -1;
280     dane->pdpth = -1;
281 }
282
283 /*
284  * dane_copy - Copy dane configuration, sans verification state.
285  */
286 static int ssl_dane_dup(SSL *to, SSL *from)
287 {
288     int num;
289     int i;
290
291     if (!DANETLS_ENABLED(&from->dane))
292         return 1;
293
294     dane_final(&to->dane);
295
296     num  = sk_danetls_record_num(from->dane.trecs);
297     for (i = 0; i < num; ++i) {
298         danetls_record *t = sk_danetls_record_value(from->dane.trecs, i);
299         if (SSL_dane_tlsa_add(to, t->usage, t->selector, t->mtype,
300                               t->data, t->dlen) <= 0)
301             return 0;
302     }
303     return 1;
304 }
305
306 static int dane_mtype_set(
307     struct dane_ctx_st *dctx,
308     const EVP_MD *md,
309     uint8_t mtype,
310     uint8_t ord)
311 {
312     int i;
313
314     if (mtype == DANETLS_MATCHING_FULL && md != NULL) {
315         SSLerr(SSL_F_DANE_MTYPE_SET,
316                 SSL_R_DANE_CANNOT_OVERRIDE_MTYPE_FULL);
317         return 0;
318     }
319
320     if (mtype > dctx->mdmax) {
321         const EVP_MD **mdevp;
322         uint8_t *mdord;
323         int n = ((int) mtype) + 1;
324
325         mdevp = OPENSSL_realloc(dctx->mdevp, n * sizeof(*mdevp));
326         if (mdevp == NULL) {
327             SSLerr(SSL_F_DANE_MTYPE_SET, ERR_R_MALLOC_FAILURE);
328             return -1;
329         }
330         dctx->mdevp = mdevp;
331
332         mdord = OPENSSL_realloc(dctx->mdord, n * sizeof(*mdord));
333         if (mdord == NULL) {
334             SSLerr(SSL_F_DANE_MTYPE_SET, ERR_R_MALLOC_FAILURE);
335             return -1;
336         }
337         dctx->mdord = mdord;
338
339         /* Zero-fill any gaps */
340         for (i = dctx->mdmax+1; i < mtype; ++i) {
341             mdevp[i] = NULL;
342             mdord[i] = 0;
343         }
344
345         dctx->mdmax = mtype;
346     }
347
348     dctx->mdevp[mtype] = md;
349     /* Coerce ordinal of disabled matching types to 0 */
350     dctx->mdord[mtype] = (md == NULL) ? 0 : ord;
351
352     return 1;
353 }
354
355 static const EVP_MD *tlsa_md_get(struct dane_st *dane, uint8_t mtype)
356 {
357     if (mtype > dane->dctx->mdmax)
358         return NULL;
359     return dane->dctx->mdevp[mtype];
360 }
361
362 static int dane_tlsa_add(
363     struct dane_st *dane,
364     uint8_t usage,
365     uint8_t selector,
366     uint8_t mtype,
367     unsigned char *data,
368     size_t dlen)
369 {
370     danetls_record *t;
371     const EVP_MD *md = NULL;
372     int ilen = (int)dlen;
373     int i;
374
375     if (dane->trecs == NULL) {
376         SSLerr(SSL_F_DANE_TLSA_ADD, SSL_R_DANE_NOT_ENABLED);
377         return -1;
378     }
379
380     if (ilen < 0 || dlen != (size_t)ilen) {
381         SSLerr(SSL_F_DANE_TLSA_ADD, SSL_R_DANE_TLSA_BAD_DATA_LENGTH);
382         return 0;
383     }
384
385     if (usage > DANETLS_USAGE_LAST) {
386         SSLerr(SSL_F_DANE_TLSA_ADD, SSL_R_DANE_TLSA_BAD_CERTIFICATE_USAGE);
387         return 0;
388     }
389
390     if (selector > DANETLS_SELECTOR_LAST) {
391         SSLerr(SSL_F_DANE_TLSA_ADD, SSL_R_DANE_TLSA_BAD_SELECTOR);
392         return 0;
393     }
394
395     if (mtype != DANETLS_MATCHING_FULL) {
396         md = tlsa_md_get(dane, mtype);
397         if (md == NULL) {
398             SSLerr(SSL_F_DANE_TLSA_ADD, SSL_R_DANE_TLSA_BAD_MATCHING_TYPE);
399             return 0;
400         }
401     }
402
403     if (md != NULL && dlen != (size_t)EVP_MD_size(md)) {
404         SSLerr(SSL_F_DANE_TLSA_ADD, SSL_R_DANE_TLSA_BAD_DIGEST_LENGTH);
405         return 0;
406     }
407     if (!data) {
408         SSLerr(SSL_F_DANE_TLSA_ADD, SSL_R_DANE_TLSA_NULL_DATA);
409         return 0;
410     }
411
412     if ((t = OPENSSL_zalloc(sizeof(*t))) == NULL) {
413         SSLerr(SSL_F_DANE_TLSA_ADD, ERR_R_MALLOC_FAILURE);
414         return -1;
415     }
416
417     t->usage = usage;
418     t->selector = selector;
419     t->mtype = mtype;
420     t->data = OPENSSL_malloc(ilen);
421     if (t->data == NULL) {
422         tlsa_free(t);
423         SSLerr(SSL_F_DANE_TLSA_ADD, ERR_R_MALLOC_FAILURE);
424         return -1;
425     }
426     memcpy(t->data, data, ilen);
427     t->dlen = ilen;
428
429     /* Validate and cache full certificate or public key */
430     if (mtype == DANETLS_MATCHING_FULL) {
431         const unsigned char *p = data;
432         X509 *cert = NULL;
433         EVP_PKEY *pkey = NULL;
434
435         switch (selector) {
436         case DANETLS_SELECTOR_CERT:
437             if (!d2i_X509(&cert, &p, dlen) || p < data ||
438                 dlen != (size_t)(p - data)) {
439                 tlsa_free(t);
440                 SSLerr(SSL_F_DANE_TLSA_ADD, SSL_R_DANE_TLSA_BAD_CERTIFICATE);
441                 return 0;
442             }
443             if (X509_get0_pubkey(cert) == NULL) {
444                 tlsa_free(t);
445                 SSLerr(SSL_F_DANE_TLSA_ADD, SSL_R_DANE_TLSA_BAD_CERTIFICATE);
446                 return 0;
447             }
448
449             if ((DANETLS_USAGE_BIT(usage) & DANETLS_TA_MASK) == 0) {
450                 X509_free(cert);
451                 break;
452             }
453
454             /*
455              * For usage DANE-TA(2), we support authentication via "2 0 0" TLSA
456              * records that contain full certificates of trust-anchors that are
457              * not present in the wire chain.  For usage PKIX-TA(0), we augment
458              * the chain with untrusted Full(0) certificates from DNS, in case
459              * they are missing from the chain.
460              */
461             if ((dane->certs == NULL &&
462                  (dane->certs = sk_X509_new_null()) == NULL) ||
463                 !sk_X509_push(dane->certs, cert)) {
464                 SSLerr(SSL_F_DANE_TLSA_ADD, ERR_R_MALLOC_FAILURE);
465                 X509_free(cert);
466                 tlsa_free(t);
467                 return -1;
468             }
469             break;
470
471         case DANETLS_SELECTOR_SPKI:
472             if (!d2i_PUBKEY(&pkey, &p, dlen) || p < data ||
473                 dlen != (size_t)(p - data)) {
474                 tlsa_free(t);
475                 SSLerr(SSL_F_DANE_TLSA_ADD, SSL_R_DANE_TLSA_BAD_PUBLIC_KEY);
476                 return 0;
477             }
478
479             /*
480              * For usage DANE-TA(2), we support authentication via "2 1 0" TLSA
481              * records that contain full bare keys of trust-anchors that are
482              * not present in the wire chain.
483              */
484             if (usage == DANETLS_USAGE_DANE_TA)
485                 t->spki = pkey;
486             else
487                 EVP_PKEY_free(pkey);
488             break;
489         }
490     }
491
492     /*-
493      * Find the right insertion point for the new record.
494      *
495      * See crypto/x509/x509_vfy.c.  We sort DANE-EE(3) records first, so that
496      * they can be processed first, as they require no chain building, and no
497      * expiration or hostname checks.  Because DANE-EE(3) is numerically
498      * largest, this is accomplished via descending sort by "usage".
499      *
500      * We also sort in descending order by matching ordinal to simplify
501      * the implementation of digest agility in the verification code.
502      *
503      * The choice of order for the selector is not significant, so we
504      * use the same descending order for consistency.
505      */
506     for (i = 0; i < sk_danetls_record_num(dane->trecs); ++i) {
507         danetls_record *rec = sk_danetls_record_value(dane->trecs, i);
508         if (rec->usage > usage)
509             continue;
510         if (rec->usage < usage)
511             break;
512         if (rec->selector > selector)
513             continue;
514         if (rec->selector < selector)
515             break;
516         if (dane->dctx->mdord[rec->mtype] > dane->dctx->mdord[mtype])
517             continue;
518         break;
519     }
520
521     if (!sk_danetls_record_insert(dane->trecs, t, i)) {
522         tlsa_free(t);
523         SSLerr(SSL_F_DANE_TLSA_ADD, ERR_R_MALLOC_FAILURE);
524         return -1;
525     }
526     dane->umask |= DANETLS_USAGE_BIT(usage);
527
528     return 1;
529 }
530
531 static void clear_ciphers(SSL *s)
532 {
533     /* clear the current cipher */
534     ssl_clear_cipher_ctx(s);
535     ssl_clear_hash_ctx(&s->read_hash);
536     ssl_clear_hash_ctx(&s->write_hash);
537 }
538
539 int SSL_clear(SSL *s)
540 {
541     if (s->method == NULL) {
542         SSLerr(SSL_F_SSL_CLEAR, SSL_R_NO_METHOD_SPECIFIED);
543         return (0);
544     }
545
546     if (ssl_clear_bad_session(s)) {
547         SSL_SESSION_free(s->session);
548         s->session = NULL;
549     }
550
551     s->error = 0;
552     s->hit = 0;
553     s->shutdown = 0;
554
555     if (s->renegotiate) {
556         SSLerr(SSL_F_SSL_CLEAR, ERR_R_INTERNAL_ERROR);
557         return 0;
558     }
559
560     ossl_statem_clear(s);
561
562     s->version = s->method->version;
563     s->client_version = s->version;
564     s->rwstate = SSL_NOTHING;
565
566     BUF_MEM_free(s->init_buf);
567     s->init_buf = NULL;
568     clear_ciphers(s);
569     s->first_packet = 0;
570
571     /* Reset DANE verification result state */
572     s->dane.mdpth = -1;
573     s->dane.pdpth = -1;
574     X509_free(s->dane.mcert);
575     s->dane.mcert = NULL;
576     s->dane.mtlsa = NULL;
577
578     /* Clear the verification result peername */
579     X509_VERIFY_PARAM_move_peername(s->param, NULL);
580
581     /*
582      * Check to see if we were changed into a different method, if so, revert
583      * back if we are not doing session-id reuse.
584      */
585     if (!ossl_statem_get_in_handshake(s) && (s->session == NULL)
586         && (s->method != s->ctx->method)) {
587         s->method->ssl_free(s);
588         s->method = s->ctx->method;
589         if (!s->method->ssl_new(s))
590             return (0);
591     } else
592         s->method->ssl_clear(s);
593
594     RECORD_LAYER_clear(&s->rlayer);
595
596     return (1);
597 }
598
599 /** Used to change an SSL_CTXs default SSL method type */
600 int SSL_CTX_set_ssl_version(SSL_CTX *ctx, const SSL_METHOD *meth)
601 {
602     STACK_OF(SSL_CIPHER) *sk;
603
604     ctx->method = meth;
605
606     sk = ssl_create_cipher_list(ctx->method, &(ctx->cipher_list),
607                                 &(ctx->cipher_list_by_id),
608                                 SSL_DEFAULT_CIPHER_LIST, ctx->cert);
609     if ((sk == NULL) || (sk_SSL_CIPHER_num(sk) <= 0)) {
610         SSLerr(SSL_F_SSL_CTX_SET_SSL_VERSION,
611                SSL_R_SSL_LIBRARY_HAS_NO_CIPHERS);
612         return (0);
613     }
614     return (1);
615 }
616
617 SSL *SSL_new(SSL_CTX *ctx)
618 {
619     SSL *s;
620
621     if (ctx == NULL) {
622         SSLerr(SSL_F_SSL_NEW, SSL_R_NULL_SSL_CTX);
623         return (NULL);
624     }
625     if (ctx->method == NULL) {
626         SSLerr(SSL_F_SSL_NEW, SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION);
627         return (NULL);
628     }
629
630     s = OPENSSL_zalloc(sizeof(*s));
631     if (s == NULL)
632         goto err;
633
634     RECORD_LAYER_init(&s->rlayer, s);
635
636     s->options = ctx->options;
637     s->min_proto_version = ctx->min_proto_version;
638     s->max_proto_version = ctx->max_proto_version;
639     s->mode = ctx->mode;
640     s->max_cert_list = ctx->max_cert_list;
641     s->references = 1;
642
643     /*
644      * Earlier library versions used to copy the pointer to the CERT, not
645      * its contents; only when setting new parameters for the per-SSL
646      * copy, ssl_cert_new would be called (and the direct reference to
647      * the per-SSL_CTX settings would be lost, but those still were
648      * indirectly accessed for various purposes, and for that reason they
649      * used to be known as s->ctx->default_cert). Now we don't look at the
650      * SSL_CTX's CERT after having duplicated it once.
651      */
652     s->cert = ssl_cert_dup(ctx->cert);
653     if (s->cert == NULL)
654         goto err;
655
656     RECORD_LAYER_set_read_ahead(&s->rlayer, ctx->read_ahead);
657     s->msg_callback = ctx->msg_callback;
658     s->msg_callback_arg = ctx->msg_callback_arg;
659     s->verify_mode = ctx->verify_mode;
660     s->not_resumable_session_cb = ctx->not_resumable_session_cb;
661     s->sid_ctx_length = ctx->sid_ctx_length;
662     OPENSSL_assert(s->sid_ctx_length <= sizeof s->sid_ctx);
663     memcpy(&s->sid_ctx, &ctx->sid_ctx, sizeof(s->sid_ctx));
664     s->verify_callback = ctx->default_verify_callback;
665     s->generate_session_id = ctx->generate_session_id;
666
667     s->param = X509_VERIFY_PARAM_new();
668     if (s->param == NULL)
669         goto err;
670     X509_VERIFY_PARAM_inherit(s->param, ctx->param);
671     s->quiet_shutdown = ctx->quiet_shutdown;
672     s->max_send_fragment = ctx->max_send_fragment;
673     s->split_send_fragment = ctx->split_send_fragment;
674     s->max_pipelines = ctx->max_pipelines;
675     if (s->max_pipelines > 1)
676         RECORD_LAYER_set_read_ahead(&s->rlayer, 1);
677     if (ctx->default_read_buf_len > 0)
678         SSL_set_default_read_buffer_len(s, ctx->default_read_buf_len);
679
680     CRYPTO_add(&ctx->references, 1, CRYPTO_LOCK_SSL_CTX);
681     s->ctx = ctx;
682     s->tlsext_debug_cb = 0;
683     s->tlsext_debug_arg = NULL;
684     s->tlsext_ticket_expected = 0;
685     s->tlsext_status_type = -1;
686     s->tlsext_status_expected = 0;
687     s->tlsext_ocsp_ids = NULL;
688     s->tlsext_ocsp_exts = NULL;
689     s->tlsext_ocsp_resp = NULL;
690     s->tlsext_ocsp_resplen = -1;
691     CRYPTO_add(&ctx->references, 1, CRYPTO_LOCK_SSL_CTX);
692     s->initial_ctx = ctx;
693 # ifndef OPENSSL_NO_EC
694     if (ctx->tlsext_ecpointformatlist) {
695         s->tlsext_ecpointformatlist =
696             OPENSSL_memdup(ctx->tlsext_ecpointformatlist,
697                            ctx->tlsext_ecpointformatlist_length);
698         if (!s->tlsext_ecpointformatlist)
699             goto err;
700         s->tlsext_ecpointformatlist_length =
701             ctx->tlsext_ecpointformatlist_length;
702     }
703     if (ctx->tlsext_ellipticcurvelist) {
704         s->tlsext_ellipticcurvelist =
705             OPENSSL_memdup(ctx->tlsext_ellipticcurvelist,
706                            ctx->tlsext_ellipticcurvelist_length);
707         if (!s->tlsext_ellipticcurvelist)
708             goto err;
709         s->tlsext_ellipticcurvelist_length =
710             ctx->tlsext_ellipticcurvelist_length;
711     }
712 # endif
713 # ifndef OPENSSL_NO_NEXTPROTONEG
714     s->next_proto_negotiated = NULL;
715 # endif
716
717     if (s->ctx->alpn_client_proto_list) {
718         s->alpn_client_proto_list =
719             OPENSSL_malloc(s->ctx->alpn_client_proto_list_len);
720         if (s->alpn_client_proto_list == NULL)
721             goto err;
722         memcpy(s->alpn_client_proto_list, s->ctx->alpn_client_proto_list,
723                s->ctx->alpn_client_proto_list_len);
724         s->alpn_client_proto_list_len = s->ctx->alpn_client_proto_list_len;
725     }
726
727     s->verified_chain = NULL;
728     s->verify_result = X509_V_OK;
729
730     s->default_passwd_callback = ctx->default_passwd_callback;
731     s->default_passwd_callback_userdata = ctx->default_passwd_callback_userdata;
732
733     s->method = ctx->method;
734
735     if (!s->method->ssl_new(s))
736         goto err;
737
738     s->server = (ctx->method->ssl_accept == ssl_undefined_function) ? 0 : 1;
739
740     if (!SSL_clear(s))
741         goto err;
742
743     CRYPTO_new_ex_data(CRYPTO_EX_INDEX_SSL, s, &s->ex_data);
744
745 #ifndef OPENSSL_NO_PSK
746     s->psk_client_callback = ctx->psk_client_callback;
747     s->psk_server_callback = ctx->psk_server_callback;
748 #endif
749
750     s->job = NULL;
751
752 #ifndef OPENSSL_NO_CT
753     if (!SSL_set_ct_validation_callback(s, ctx->ct_validation_callback,
754             ctx->ct_validation_callback_arg))
755         goto err;
756 #endif
757
758     return (s);
759  err:
760     SSL_free(s);
761     SSLerr(SSL_F_SSL_NEW, ERR_R_MALLOC_FAILURE);
762     return (NULL);
763 }
764
765 void SSL_up_ref(SSL *s)
766 {
767     CRYPTO_add(&s->references, 1, CRYPTO_LOCK_SSL);
768 }
769
770 int SSL_CTX_set_session_id_context(SSL_CTX *ctx, const unsigned char *sid_ctx,
771                                    unsigned int sid_ctx_len)
772 {
773     if (sid_ctx_len > sizeof ctx->sid_ctx) {
774         SSLerr(SSL_F_SSL_CTX_SET_SESSION_ID_CONTEXT,
775                SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
776         return 0;
777     }
778     ctx->sid_ctx_length = sid_ctx_len;
779     memcpy(ctx->sid_ctx, sid_ctx, sid_ctx_len);
780
781     return 1;
782 }
783
784 int SSL_set_session_id_context(SSL *ssl, const unsigned char *sid_ctx,
785                                unsigned int sid_ctx_len)
786 {
787     if (sid_ctx_len > SSL_MAX_SID_CTX_LENGTH) {
788         SSLerr(SSL_F_SSL_SET_SESSION_ID_CONTEXT,
789                SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
790         return 0;
791     }
792     ssl->sid_ctx_length = sid_ctx_len;
793     memcpy(ssl->sid_ctx, sid_ctx, sid_ctx_len);
794
795     return 1;
796 }
797
798 int SSL_CTX_set_generate_session_id(SSL_CTX *ctx, GEN_SESSION_CB cb)
799 {
800     CRYPTO_w_lock(CRYPTO_LOCK_SSL_CTX);
801     ctx->generate_session_id = cb;
802     CRYPTO_w_unlock(CRYPTO_LOCK_SSL_CTX);
803     return 1;
804 }
805
806 int SSL_set_generate_session_id(SSL *ssl, GEN_SESSION_CB cb)
807 {
808     CRYPTO_w_lock(CRYPTO_LOCK_SSL);
809     ssl->generate_session_id = cb;
810     CRYPTO_w_unlock(CRYPTO_LOCK_SSL);
811     return 1;
812 }
813
814 int SSL_has_matching_session_id(const SSL *ssl, const unsigned char *id,
815                                 unsigned int id_len)
816 {
817     /*
818      * A quick examination of SSL_SESSION_hash and SSL_SESSION_cmp shows how
819      * we can "construct" a session to give us the desired check - ie. to
820      * find if there's a session in the hash table that would conflict with
821      * any new session built out of this id/id_len and the ssl_version in use
822      * by this SSL.
823      */
824     SSL_SESSION r, *p;
825
826     if (id_len > sizeof r.session_id)
827         return 0;
828
829     r.ssl_version = ssl->version;
830     r.session_id_length = id_len;
831     memcpy(r.session_id, id, id_len);
832
833     CRYPTO_r_lock(CRYPTO_LOCK_SSL_CTX);
834     p = lh_SSL_SESSION_retrieve(ssl->ctx->sessions, &r);
835     CRYPTO_r_unlock(CRYPTO_LOCK_SSL_CTX);
836     return (p != NULL);
837 }
838
839 int SSL_CTX_set_purpose(SSL_CTX *s, int purpose)
840 {
841     return X509_VERIFY_PARAM_set_purpose(s->param, purpose);
842 }
843
844 int SSL_set_purpose(SSL *s, int purpose)
845 {
846     return X509_VERIFY_PARAM_set_purpose(s->param, purpose);
847 }
848
849 int SSL_CTX_set_trust(SSL_CTX *s, int trust)
850 {
851     return X509_VERIFY_PARAM_set_trust(s->param, trust);
852 }
853
854 int SSL_set_trust(SSL *s, int trust)
855 {
856     return X509_VERIFY_PARAM_set_trust(s->param, trust);
857 }
858
859 int SSL_set1_host(SSL *s, const char *hostname)
860 {
861     return X509_VERIFY_PARAM_set1_host(s->param, hostname, 0);
862 }
863
864 int SSL_add1_host(SSL *s, const char *hostname)
865 {
866     return X509_VERIFY_PARAM_add1_host(s->param, hostname, 0);
867 }
868
869 void SSL_set_hostflags(SSL *s, unsigned int flags)
870 {
871     X509_VERIFY_PARAM_set_hostflags(s->param, flags);
872 }
873
874 const char *SSL_get0_peername(SSL *s)
875 {
876     return X509_VERIFY_PARAM_get0_peername(s->param);
877 }
878
879 int SSL_CTX_dane_enable(SSL_CTX *ctx)
880 {
881     return dane_ctx_enable(&ctx->dane);
882 }
883
884 int SSL_dane_enable(SSL *s, const char *basedomain)
885 {
886     struct dane_st *dane = &s->dane;
887
888     if (s->ctx->dane.mdmax == 0) {
889         SSLerr(SSL_F_SSL_DANE_ENABLE, SSL_R_CONTEXT_NOT_DANE_ENABLED);
890         return 0;
891     }
892     if (dane->trecs != NULL) {
893         SSLerr(SSL_F_SSL_DANE_ENABLE, SSL_R_DANE_ALREADY_ENABLED);
894         return 0;
895     }
896
897     /*
898      * Default SNI name.  This rejects empty names, while set1_host below
899      * accepts them and disables host name checks.  To avoid side-effects with
900      * invalid input, set the SNI name first.
901      */
902     if (s->tlsext_hostname == NULL) {
903         if (!SSL_set_tlsext_host_name(s, basedomain)) {
904             SSLerr(SSL_F_SSL_DANE_ENABLE, SSL_R_ERROR_SETTING_TLSA_BASE_DOMAIN);
905             return -1;
906         }
907     }
908
909     /* Primary RFC6125 reference identifier */
910     if (!X509_VERIFY_PARAM_set1_host(s->param, basedomain, 0)) {
911         SSLerr(SSL_F_SSL_DANE_ENABLE, SSL_R_ERROR_SETTING_TLSA_BASE_DOMAIN);
912         return -1;
913     }
914
915     dane->mdpth = -1;
916     dane->pdpth = -1;
917     dane->dctx = &s->ctx->dane;
918     dane->trecs = sk_danetls_record_new_null();
919
920     if (dane->trecs == NULL) {
921         SSLerr(SSL_F_SSL_DANE_ENABLE, ERR_R_MALLOC_FAILURE);
922         return -1;
923     }
924     return 1;
925 }
926
927 int SSL_get0_dane_authority(SSL *s, X509 **mcert, EVP_PKEY **mspki)
928 {
929     struct dane_st *dane = &s->dane;
930
931     if (!DANETLS_ENABLED(dane) || s->verify_result != X509_V_OK)
932         return -1;
933     if (dane->mtlsa) {
934         if (mcert)
935             *mcert = dane->mcert;
936         if (mspki)
937             *mspki = (dane->mcert == NULL) ? dane->mtlsa->spki : NULL;
938     }
939     return dane->mdpth;
940 }
941
942 int SSL_get0_dane_tlsa(SSL *s, uint8_t *usage, uint8_t *selector,
943                        uint8_t *mtype, unsigned const char **data, size_t *dlen)
944 {
945     struct dane_st *dane = &s->dane;
946
947     if (!DANETLS_ENABLED(dane) || s->verify_result != X509_V_OK)
948         return -1;
949     if (dane->mtlsa) {
950         if (usage)
951             *usage = dane->mtlsa->usage;
952         if (selector)
953             *selector = dane->mtlsa->selector;
954         if (mtype)
955             *mtype = dane->mtlsa->mtype;
956         if (data)
957             *data = dane->mtlsa->data;
958         if (dlen)
959             *dlen = dane->mtlsa->dlen;
960     }
961     return dane->mdpth;
962 }
963
964 struct dane_st *SSL_get0_dane(SSL *s)
965 {
966     return &s->dane;
967 }
968
969 int SSL_dane_tlsa_add(SSL *s, uint8_t usage, uint8_t selector,
970                       uint8_t mtype, unsigned char *data, size_t dlen)
971 {
972     return dane_tlsa_add(&s->dane, usage, selector, mtype, data, dlen);
973 }
974
975 int SSL_CTX_dane_mtype_set(SSL_CTX *ctx, const EVP_MD *md, uint8_t mtype, uint8_t ord)
976 {
977     return dane_mtype_set(&ctx->dane, md, mtype, ord);
978 }
979
980 int SSL_CTX_set1_param(SSL_CTX *ctx, X509_VERIFY_PARAM *vpm)
981 {
982     return X509_VERIFY_PARAM_set1(ctx->param, vpm);
983 }
984
985 int SSL_set1_param(SSL *ssl, X509_VERIFY_PARAM *vpm)
986 {
987     return X509_VERIFY_PARAM_set1(ssl->param, vpm);
988 }
989
990 X509_VERIFY_PARAM *SSL_CTX_get0_param(SSL_CTX *ctx)
991 {
992     return ctx->param;
993 }
994
995 X509_VERIFY_PARAM *SSL_get0_param(SSL *ssl)
996 {
997     return ssl->param;
998 }
999
1000 void SSL_certs_clear(SSL *s)
1001 {
1002     ssl_cert_clear_certs(s->cert);
1003 }
1004
1005 void SSL_free(SSL *s)
1006 {
1007     int i;
1008
1009     if (s == NULL)
1010         return;
1011
1012     i = CRYPTO_add(&s->references, -1, CRYPTO_LOCK_SSL);
1013     REF_PRINT_COUNT("SSL", s);
1014     if (i > 0)
1015         return;
1016     REF_ASSERT_ISNT(i < 0);
1017
1018     X509_VERIFY_PARAM_free(s->param);
1019     dane_final(&s->dane);
1020     CRYPTO_free_ex_data(CRYPTO_EX_INDEX_SSL, s, &s->ex_data);
1021
1022     if (s->bbio != NULL) {
1023         /* If the buffering BIO is in place, pop it off */
1024         if (s->bbio == s->wbio) {
1025             s->wbio = BIO_pop(s->wbio);
1026         }
1027         BIO_free(s->bbio);
1028         s->bbio = NULL;
1029     }
1030     BIO_free_all(s->rbio);
1031     if (s->wbio != s->rbio)
1032         BIO_free_all(s->wbio);
1033
1034     BUF_MEM_free(s->init_buf);
1035
1036     /* add extra stuff */
1037     sk_SSL_CIPHER_free(s->cipher_list);
1038     sk_SSL_CIPHER_free(s->cipher_list_by_id);
1039
1040     /* Make the next call work :-) */
1041     if (s->session != NULL) {
1042         ssl_clear_bad_session(s);
1043         SSL_SESSION_free(s->session);
1044     }
1045
1046     clear_ciphers(s);
1047
1048     ssl_cert_free(s->cert);
1049     /* Free up if allocated */
1050
1051     OPENSSL_free(s->tlsext_hostname);
1052     SSL_CTX_free(s->initial_ctx);
1053 #ifndef OPENSSL_NO_EC
1054     OPENSSL_free(s->tlsext_ecpointformatlist);
1055     OPENSSL_free(s->tlsext_ellipticcurvelist);
1056 #endif                         /* OPENSSL_NO_EC */
1057     sk_X509_EXTENSION_pop_free(s->tlsext_ocsp_exts, X509_EXTENSION_free);
1058     sk_OCSP_RESPID_pop_free(s->tlsext_ocsp_ids, OCSP_RESPID_free);
1059 #ifndef OPENSSL_NO_CT
1060     SCT_LIST_free(s->scts);
1061     OPENSSL_free(s->tlsext_scts);
1062 #endif
1063     OPENSSL_free(s->tlsext_ocsp_resp);
1064     OPENSSL_free(s->alpn_client_proto_list);
1065
1066     sk_X509_NAME_pop_free(s->client_CA, X509_NAME_free);
1067
1068     sk_X509_pop_free(s->verified_chain, X509_free);
1069
1070     if (s->method != NULL)
1071         s->method->ssl_free(s);
1072
1073     RECORD_LAYER_release(&s->rlayer);
1074
1075     SSL_CTX_free(s->ctx);
1076
1077     ASYNC_WAIT_CTX_free(s->waitctx);
1078
1079 #if !defined(OPENSSL_NO_NEXTPROTONEG)
1080     OPENSSL_free(s->next_proto_negotiated);
1081 #endif
1082
1083 #ifndef OPENSSL_NO_SRTP
1084     sk_SRTP_PROTECTION_PROFILE_free(s->srtp_profiles);
1085 #endif
1086
1087     OPENSSL_free(s);
1088 }
1089
1090 void SSL_set_rbio(SSL *s, BIO *rbio)
1091 {
1092     if (s->rbio != rbio)
1093         BIO_free_all(s->rbio);
1094     s->rbio = rbio;
1095 }
1096
1097 void SSL_set_wbio(SSL *s, BIO *wbio)
1098 {
1099     /*
1100      * If the output buffering BIO is still in place, remove it
1101      */
1102     if (s->bbio != NULL) {
1103         if (s->wbio == s->bbio) {
1104             s->wbio = s->wbio->next_bio;
1105             s->bbio->next_bio = NULL;
1106         }
1107     }
1108     if (s->wbio != wbio && s->rbio != s->wbio)
1109         BIO_free_all(s->wbio);
1110     s->wbio = wbio;
1111 }
1112
1113 void SSL_set_bio(SSL *s, BIO *rbio, BIO *wbio)
1114 {
1115     SSL_set_wbio(s, wbio);
1116     SSL_set_rbio(s, rbio);
1117 }
1118
1119 BIO *SSL_get_rbio(const SSL *s)
1120 {
1121     return (s->rbio);
1122 }
1123
1124 BIO *SSL_get_wbio(const SSL *s)
1125 {
1126     return (s->wbio);
1127 }
1128
1129 int SSL_get_fd(const SSL *s)
1130 {
1131     return (SSL_get_rfd(s));
1132 }
1133
1134 int SSL_get_rfd(const SSL *s)
1135 {
1136     int ret = -1;
1137     BIO *b, *r;
1138
1139     b = SSL_get_rbio(s);
1140     r = BIO_find_type(b, BIO_TYPE_DESCRIPTOR);
1141     if (r != NULL)
1142         BIO_get_fd(r, &ret);
1143     return (ret);
1144 }
1145
1146 int SSL_get_wfd(const SSL *s)
1147 {
1148     int ret = -1;
1149     BIO *b, *r;
1150
1151     b = SSL_get_wbio(s);
1152     r = BIO_find_type(b, BIO_TYPE_DESCRIPTOR);
1153     if (r != NULL)
1154         BIO_get_fd(r, &ret);
1155     return (ret);
1156 }
1157
1158 #ifndef OPENSSL_NO_SOCK
1159 int SSL_set_fd(SSL *s, int fd)
1160 {
1161     int ret = 0;
1162     BIO *bio = NULL;
1163
1164     bio = BIO_new(BIO_s_socket());
1165
1166     if (bio == NULL) {
1167         SSLerr(SSL_F_SSL_SET_FD, ERR_R_BUF_LIB);
1168         goto err;
1169     }
1170     BIO_set_fd(bio, fd, BIO_NOCLOSE);
1171     SSL_set_bio(s, bio, bio);
1172     ret = 1;
1173  err:
1174     return (ret);
1175 }
1176
1177 int SSL_set_wfd(SSL *s, int fd)
1178 {
1179     int ret = 0;
1180     BIO *bio = NULL;
1181
1182     if ((s->rbio == NULL) || (BIO_method_type(s->rbio) != BIO_TYPE_SOCKET)
1183         || ((int)BIO_get_fd(s->rbio, NULL) != fd)) {
1184         bio = BIO_new(BIO_s_socket());
1185
1186         if (bio == NULL) {
1187             SSLerr(SSL_F_SSL_SET_WFD, ERR_R_BUF_LIB);
1188             goto err;
1189         }
1190         BIO_set_fd(bio, fd, BIO_NOCLOSE);
1191         SSL_set_bio(s, SSL_get_rbio(s), bio);
1192     } else
1193         SSL_set_bio(s, SSL_get_rbio(s), SSL_get_rbio(s));
1194     ret = 1;
1195  err:
1196     return (ret);
1197 }
1198
1199 int SSL_set_rfd(SSL *s, int fd)
1200 {
1201     int ret = 0;
1202     BIO *bio = NULL;
1203
1204     if ((s->wbio == NULL) || (BIO_method_type(s->wbio) != BIO_TYPE_SOCKET)
1205         || ((int)BIO_get_fd(s->wbio, NULL) != fd)) {
1206         bio = BIO_new(BIO_s_socket());
1207
1208         if (bio == NULL) {
1209             SSLerr(SSL_F_SSL_SET_RFD, ERR_R_BUF_LIB);
1210             goto err;
1211         }
1212         BIO_set_fd(bio, fd, BIO_NOCLOSE);
1213         SSL_set_bio(s, bio, SSL_get_wbio(s));
1214     } else
1215         SSL_set_bio(s, SSL_get_wbio(s), SSL_get_wbio(s));
1216     ret = 1;
1217  err:
1218     return (ret);
1219 }
1220 #endif
1221
1222 /* return length of latest Finished message we sent, copy to 'buf' */
1223 size_t SSL_get_finished(const SSL *s, void *buf, size_t count)
1224 {
1225     size_t ret = 0;
1226
1227     if (s->s3 != NULL) {
1228         ret = s->s3->tmp.finish_md_len;
1229         if (count > ret)
1230             count = ret;
1231         memcpy(buf, s->s3->tmp.finish_md, count);
1232     }
1233     return ret;
1234 }
1235
1236 /* return length of latest Finished message we expected, copy to 'buf' */
1237 size_t SSL_get_peer_finished(const SSL *s, void *buf, size_t count)
1238 {
1239     size_t ret = 0;
1240
1241     if (s->s3 != NULL) {
1242         ret = s->s3->tmp.peer_finish_md_len;
1243         if (count > ret)
1244             count = ret;
1245         memcpy(buf, s->s3->tmp.peer_finish_md, count);
1246     }
1247     return ret;
1248 }
1249
1250 int SSL_get_verify_mode(const SSL *s)
1251 {
1252     return (s->verify_mode);
1253 }
1254
1255 int SSL_get_verify_depth(const SSL *s)
1256 {
1257     return X509_VERIFY_PARAM_get_depth(s->param);
1258 }
1259
1260 int (*SSL_get_verify_callback(const SSL *s)) (int, X509_STORE_CTX *) {
1261     return (s->verify_callback);
1262 }
1263
1264 int SSL_CTX_get_verify_mode(const SSL_CTX *ctx)
1265 {
1266     return (ctx->verify_mode);
1267 }
1268
1269 int SSL_CTX_get_verify_depth(const SSL_CTX *ctx)
1270 {
1271     return X509_VERIFY_PARAM_get_depth(ctx->param);
1272 }
1273
1274 int (*SSL_CTX_get_verify_callback(const SSL_CTX *ctx)) (int, X509_STORE_CTX *) {
1275     return (ctx->default_verify_callback);
1276 }
1277
1278 void SSL_set_verify(SSL *s, int mode,
1279                     int (*callback) (int ok, X509_STORE_CTX *ctx))
1280 {
1281     s->verify_mode = mode;
1282     if (callback != NULL)
1283         s->verify_callback = callback;
1284 }
1285
1286 void SSL_set_verify_depth(SSL *s, int depth)
1287 {
1288     X509_VERIFY_PARAM_set_depth(s->param, depth);
1289 }
1290
1291 void SSL_set_read_ahead(SSL *s, int yes)
1292 {
1293     RECORD_LAYER_set_read_ahead(&s->rlayer, yes);
1294 }
1295
1296 int SSL_get_read_ahead(const SSL *s)
1297 {
1298     return RECORD_LAYER_get_read_ahead(&s->rlayer);
1299 }
1300
1301 int SSL_pending(const SSL *s)
1302 {
1303     /*
1304      * SSL_pending cannot work properly if read-ahead is enabled
1305      * (SSL_[CTX_]ctrl(..., SSL_CTRL_SET_READ_AHEAD, 1, NULL)), and it is
1306      * impossible to fix since SSL_pending cannot report errors that may be
1307      * observed while scanning the new data. (Note that SSL_pending() is
1308      * often used as a boolean value, so we'd better not return -1.)
1309      */
1310     return (s->method->ssl_pending(s));
1311 }
1312
1313 X509 *SSL_get_peer_certificate(const SSL *s)
1314 {
1315     X509 *r;
1316
1317     if ((s == NULL) || (s->session == NULL))
1318         r = NULL;
1319     else
1320         r = s->session->peer;
1321
1322     if (r == NULL)
1323         return (r);
1324
1325     X509_up_ref(r);
1326
1327     return (r);
1328 }
1329
1330 STACK_OF(X509) *SSL_get_peer_cert_chain(const SSL *s)
1331 {
1332     STACK_OF(X509) *r;
1333
1334     if ((s == NULL) || (s->session == NULL))
1335         r = NULL;
1336     else
1337         r = s->session->peer_chain;
1338
1339     /*
1340      * If we are a client, cert_chain includes the peer's own certificate; if
1341      * we are a server, it does not.
1342      */
1343
1344     return (r);
1345 }
1346
1347 /*
1348  * Now in theory, since the calling process own 't' it should be safe to
1349  * modify.  We need to be able to read f without being hassled
1350  */
1351 int SSL_copy_session_id(SSL *t, const SSL *f)
1352 {
1353     /* Do we need to to SSL locking? */
1354     if (!SSL_set_session(t, SSL_get_session(f))) {
1355         return 0;
1356     }
1357
1358     /*
1359      * what if we are setup for one protocol version but want to talk another
1360      */
1361     if (t->method != f->method) {
1362         t->method->ssl_free(t);
1363         t->method = f->method;
1364         if (t->method->ssl_new(t) == 0)
1365             return 0;
1366     }
1367
1368     CRYPTO_add(&f->cert->references, 1, CRYPTO_LOCK_SSL_CERT);
1369     ssl_cert_free(t->cert);
1370     t->cert = f->cert;
1371     if (!SSL_set_session_id_context(t, f->sid_ctx, f->sid_ctx_length)) {
1372         return 0;
1373     }
1374
1375     return 1;
1376 }
1377
1378 /* Fix this so it checks all the valid key/cert options */
1379 int SSL_CTX_check_private_key(const SSL_CTX *ctx)
1380 {
1381     if ((ctx == NULL) ||
1382         (ctx->cert->key->x509 == NULL)) {
1383         SSLerr(SSL_F_SSL_CTX_CHECK_PRIVATE_KEY,
1384                SSL_R_NO_CERTIFICATE_ASSIGNED);
1385         return (0);
1386     }
1387     if (ctx->cert->key->privatekey == NULL) {
1388         SSLerr(SSL_F_SSL_CTX_CHECK_PRIVATE_KEY,
1389                SSL_R_NO_PRIVATE_KEY_ASSIGNED);
1390         return (0);
1391     }
1392     return (X509_check_private_key
1393             (ctx->cert->key->x509, ctx->cert->key->privatekey));
1394 }
1395
1396 /* Fix this function so that it takes an optional type parameter */
1397 int SSL_check_private_key(const SSL *ssl)
1398 {
1399     if (ssl == NULL) {
1400         SSLerr(SSL_F_SSL_CHECK_PRIVATE_KEY, ERR_R_PASSED_NULL_PARAMETER);
1401         return (0);
1402     }
1403     if (ssl->cert->key->x509 == NULL) {
1404         SSLerr(SSL_F_SSL_CHECK_PRIVATE_KEY, SSL_R_NO_CERTIFICATE_ASSIGNED);
1405         return (0);
1406     }
1407     if (ssl->cert->key->privatekey == NULL) {
1408         SSLerr(SSL_F_SSL_CHECK_PRIVATE_KEY, SSL_R_NO_PRIVATE_KEY_ASSIGNED);
1409         return (0);
1410     }
1411     return (X509_check_private_key(ssl->cert->key->x509,
1412                                    ssl->cert->key->privatekey));
1413 }
1414
1415 int SSL_waiting_for_async(SSL *s)
1416 {
1417     if(s->job)
1418         return 1;
1419
1420     return 0;
1421 }
1422
1423 int SSL_get_all_async_fds(SSL *s, OSSL_ASYNC_FD *fds, size_t *numfds)
1424 {
1425     ASYNC_WAIT_CTX *ctx = s->waitctx;
1426
1427     if (ctx == NULL)
1428         return 0;
1429     return ASYNC_WAIT_CTX_get_all_fds(ctx, fds, numfds);
1430 }
1431
1432 int SSL_get_changed_async_fds(SSL *s, OSSL_ASYNC_FD *addfd, size_t *numaddfds,
1433                               OSSL_ASYNC_FD *delfd, size_t *numdelfds)
1434 {
1435     ASYNC_WAIT_CTX *ctx = s->waitctx;
1436
1437     if (ctx == NULL)
1438         return 0;
1439     return ASYNC_WAIT_CTX_get_changed_fds(ctx, addfd, numaddfds, delfd,
1440                                           numdelfds);
1441 }
1442
1443 int SSL_accept(SSL *s)
1444 {
1445     if (s->handshake_func == NULL) {
1446         /* Not properly initialized yet */
1447         SSL_set_accept_state(s);
1448     }
1449
1450     return SSL_do_handshake(s);
1451 }
1452
1453 int SSL_connect(SSL *s)
1454 {
1455     if (s->handshake_func == NULL) {
1456         /* Not properly initialized yet */
1457         SSL_set_connect_state(s);
1458     }
1459
1460     return SSL_do_handshake(s);
1461 }
1462
1463 long SSL_get_default_timeout(const SSL *s)
1464 {
1465     return (s->method->get_timeout());
1466 }
1467
1468 static int ssl_start_async_job(SSL *s, struct ssl_async_args *args,
1469                           int (*func)(void *)) {
1470     int ret;
1471     if (s->waitctx == NULL) {
1472         s->waitctx = ASYNC_WAIT_CTX_new();
1473         if (s->waitctx == NULL)
1474             return -1;
1475     }
1476     switch(ASYNC_start_job(&s->job, s->waitctx, &ret, func, args,
1477         sizeof(struct ssl_async_args))) {
1478     case ASYNC_ERR:
1479         s->rwstate = SSL_NOTHING;
1480         SSLerr(SSL_F_SSL_START_ASYNC_JOB, SSL_R_FAILED_TO_INIT_ASYNC);
1481         return -1;
1482     case ASYNC_PAUSE:
1483         s->rwstate = SSL_ASYNC_PAUSED;
1484         return -1;
1485     case ASYNC_FINISH:
1486         s->job = NULL;
1487         return ret;
1488     default:
1489         s->rwstate = SSL_NOTHING;
1490         SSLerr(SSL_F_SSL_START_ASYNC_JOB, ERR_R_INTERNAL_ERROR);
1491         /* Shouldn't happen */
1492         return -1;
1493     }
1494 }
1495
1496 static int ssl_io_intern(void *vargs)
1497 {
1498     struct ssl_async_args *args;
1499     SSL *s;
1500     void *buf;
1501     int num;
1502
1503     args = (struct ssl_async_args *)vargs;
1504     s = args->s;
1505     buf = args->buf;
1506     num = args->num;
1507     switch (args->type) {
1508     case READFUNC:
1509         return args->f.func_read(s, buf, num);
1510     case WRITEFUNC:
1511         return args->f.func_write(s, buf, num);
1512     case OTHERFUNC:
1513         return args->f.func_other(s);
1514     }
1515     return -1;
1516 }
1517
1518 int SSL_read(SSL *s, void *buf, int num)
1519 {
1520     if (s->handshake_func == NULL) {
1521         SSLerr(SSL_F_SSL_READ, SSL_R_UNINITIALIZED);
1522         return -1;
1523     }
1524
1525     if (s->shutdown & SSL_RECEIVED_SHUTDOWN) {
1526         s->rwstate = SSL_NOTHING;
1527         return (0);
1528     }
1529
1530     if((s->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
1531         struct ssl_async_args args;
1532
1533         args.s = s;
1534         args.buf = buf;
1535         args.num = num;
1536         args.type = READFUNC;
1537         args.f.func_read = s->method->ssl_read;
1538
1539         return ssl_start_async_job(s, &args, ssl_io_intern);
1540     } else {
1541         return s->method->ssl_read(s, buf, num);
1542     }
1543 }
1544
1545 int SSL_peek(SSL *s, void *buf, int num)
1546 {
1547     if (s->handshake_func == NULL) {
1548         SSLerr(SSL_F_SSL_PEEK, SSL_R_UNINITIALIZED);
1549         return -1;
1550     }
1551
1552     if (s->shutdown & SSL_RECEIVED_SHUTDOWN) {
1553         return (0);
1554     }
1555     if((s->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
1556         struct ssl_async_args args;
1557
1558         args.s = s;
1559         args.buf = buf;
1560         args.num = num;
1561         args.type = READFUNC;
1562         args.f.func_read = s->method->ssl_peek;
1563
1564         return ssl_start_async_job(s, &args, ssl_io_intern);
1565     } else {
1566         return s->method->ssl_peek(s, buf, num);
1567     }
1568 }
1569
1570 int SSL_write(SSL *s, const void *buf, int num)
1571 {
1572     if (s->handshake_func == NULL) {
1573         SSLerr(SSL_F_SSL_WRITE, SSL_R_UNINITIALIZED);
1574         return -1;
1575     }
1576
1577     if (s->shutdown & SSL_SENT_SHUTDOWN) {
1578         s->rwstate = SSL_NOTHING;
1579         SSLerr(SSL_F_SSL_WRITE, SSL_R_PROTOCOL_IS_SHUTDOWN);
1580         return (-1);
1581     }
1582
1583     if((s->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
1584         struct ssl_async_args args;
1585
1586         args.s = s;
1587         args.buf = (void *)buf;
1588         args.num = num;
1589         args.type = WRITEFUNC;
1590         args.f.func_write = s->method->ssl_write;
1591
1592         return ssl_start_async_job(s, &args, ssl_io_intern);
1593     } else {
1594         return s->method->ssl_write(s, buf, num);
1595     }
1596 }
1597
1598 int SSL_shutdown(SSL *s)
1599 {
1600     /*
1601      * Note that this function behaves differently from what one might
1602      * expect.  Return values are 0 for no success (yet), 1 for success; but
1603      * calling it once is usually not enough, even if blocking I/O is used
1604      * (see ssl3_shutdown).
1605      */
1606
1607     if (s->handshake_func == NULL) {
1608         SSLerr(SSL_F_SSL_SHUTDOWN, SSL_R_UNINITIALIZED);
1609         return -1;
1610     }
1611
1612     if (!SSL_in_init(s)) {
1613         if((s->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
1614             struct ssl_async_args args;
1615
1616             args.s = s;
1617             args.type = OTHERFUNC;
1618             args.f.func_other = s->method->ssl_shutdown;
1619
1620             return ssl_start_async_job(s, &args, ssl_io_intern);
1621         } else {
1622             return s->method->ssl_shutdown(s);
1623         }
1624     } else {
1625         SSLerr(SSL_F_SSL_SHUTDOWN, SSL_R_SHUTDOWN_WHILE_IN_INIT);
1626         return -1;
1627     }
1628 }
1629
1630 int SSL_renegotiate(SSL *s)
1631 {
1632     if (s->renegotiate == 0)
1633         s->renegotiate = 1;
1634
1635     s->new_session = 1;
1636
1637     return (s->method->ssl_renegotiate(s));
1638 }
1639
1640 int SSL_renegotiate_abbreviated(SSL *s)
1641 {
1642     if (s->renegotiate == 0)
1643         s->renegotiate = 1;
1644
1645     s->new_session = 0;
1646
1647     return (s->method->ssl_renegotiate(s));
1648 }
1649
1650 int SSL_renegotiate_pending(SSL *s)
1651 {
1652     /*
1653      * becomes true when negotiation is requested; false again once a
1654      * handshake has finished
1655      */
1656     return (s->renegotiate != 0);
1657 }
1658
1659 long SSL_ctrl(SSL *s, int cmd, long larg, void *parg)
1660 {
1661     long l;
1662
1663     switch (cmd) {
1664     case SSL_CTRL_GET_READ_AHEAD:
1665         return (RECORD_LAYER_get_read_ahead(&s->rlayer));
1666     case SSL_CTRL_SET_READ_AHEAD:
1667         l = RECORD_LAYER_get_read_ahead(&s->rlayer);
1668         RECORD_LAYER_set_read_ahead(&s->rlayer, larg);
1669         return (l);
1670
1671     case SSL_CTRL_SET_MSG_CALLBACK_ARG:
1672         s->msg_callback_arg = parg;
1673         return 1;
1674
1675     case SSL_CTRL_MODE:
1676         return (s->mode |= larg);
1677     case SSL_CTRL_CLEAR_MODE:
1678         return (s->mode &= ~larg);
1679     case SSL_CTRL_GET_MAX_CERT_LIST:
1680         return (s->max_cert_list);
1681     case SSL_CTRL_SET_MAX_CERT_LIST:
1682         l = s->max_cert_list;
1683         s->max_cert_list = larg;
1684         return (l);
1685     case SSL_CTRL_SET_MAX_SEND_FRAGMENT:
1686         if (larg < 512 || larg > SSL3_RT_MAX_PLAIN_LENGTH)
1687             return 0;
1688         s->max_send_fragment = larg;
1689         if (s->max_send_fragment < s->split_send_fragment)
1690             s->split_send_fragment = s->max_send_fragment;
1691         return 1;
1692     case SSL_CTRL_SET_SPLIT_SEND_FRAGMENT:
1693         if (larg > s->max_send_fragment || larg == 0)
1694             return 0;
1695         s->split_send_fragment = larg;
1696         return 1;
1697     case SSL_CTRL_SET_MAX_PIPELINES:
1698         if (larg < 1 || larg > SSL_MAX_PIPELINES)
1699             return 0;
1700         s->max_pipelines = larg;
1701         if (larg > 1)
1702             RECORD_LAYER_set_read_ahead(&s->rlayer, 1);
1703     case SSL_CTRL_GET_RI_SUPPORT:
1704         if (s->s3)
1705             return s->s3->send_connection_binding;
1706         else
1707             return 0;
1708     case SSL_CTRL_CERT_FLAGS:
1709         return (s->cert->cert_flags |= larg);
1710     case SSL_CTRL_CLEAR_CERT_FLAGS:
1711         return (s->cert->cert_flags &= ~larg);
1712
1713     case SSL_CTRL_GET_RAW_CIPHERLIST:
1714         if (parg) {
1715             if (s->s3->tmp.ciphers_raw == NULL)
1716                 return 0;
1717             *(unsigned char **)parg = s->s3->tmp.ciphers_raw;
1718             return (int)s->s3->tmp.ciphers_rawlen;
1719         } else {
1720             return TLS_CIPHER_LEN;
1721         }
1722     case SSL_CTRL_GET_EXTMS_SUPPORT:
1723         if (!s->session || SSL_in_init(s) || ossl_statem_get_in_handshake(s))
1724                 return -1;
1725         if (s->session->flags & SSL_SESS_FLAG_EXTMS)
1726             return 1;
1727         else
1728             return 0;
1729     case SSL_CTRL_SET_MIN_PROTO_VERSION:
1730         return ssl_set_version_bound(s->ctx->method->version, (int)larg,
1731                                      &s->min_proto_version);
1732     case SSL_CTRL_SET_MAX_PROTO_VERSION:
1733         return ssl_set_version_bound(s->ctx->method->version, (int)larg,
1734                                      &s->max_proto_version);
1735     default:
1736         return (s->method->ssl_ctrl(s, cmd, larg, parg));
1737     }
1738 }
1739
1740 long SSL_callback_ctrl(SSL *s, int cmd, void (*fp) (void))
1741 {
1742     switch (cmd) {
1743     case SSL_CTRL_SET_MSG_CALLBACK:
1744         s->msg_callback = (void (*)
1745                            (int write_p, int version, int content_type,
1746                             const void *buf, size_t len, SSL *ssl,
1747                             void *arg))(fp);
1748         return 1;
1749
1750     default:
1751         return (s->method->ssl_callback_ctrl(s, cmd, fp));
1752     }
1753 }
1754
1755 LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx)
1756 {
1757     return ctx->sessions;
1758 }
1759
1760 long SSL_CTX_ctrl(SSL_CTX *ctx, int cmd, long larg, void *parg)
1761 {
1762     long l;
1763     /* For some cases with ctx == NULL perform syntax checks */
1764     if (ctx == NULL) {
1765         switch (cmd) {
1766 #ifndef OPENSSL_NO_EC
1767         case SSL_CTRL_SET_CURVES_LIST:
1768             return tls1_set_curves_list(NULL, NULL, parg);
1769 #endif
1770         case SSL_CTRL_SET_SIGALGS_LIST:
1771         case SSL_CTRL_SET_CLIENT_SIGALGS_LIST:
1772             return tls1_set_sigalgs_list(NULL, parg, 0);
1773         default:
1774             return 0;
1775         }
1776     }
1777
1778     switch (cmd) {
1779     case SSL_CTRL_GET_READ_AHEAD:
1780         return (ctx->read_ahead);
1781     case SSL_CTRL_SET_READ_AHEAD:
1782         l = ctx->read_ahead;
1783         ctx->read_ahead = larg;
1784         return (l);
1785
1786     case SSL_CTRL_SET_MSG_CALLBACK_ARG:
1787         ctx->msg_callback_arg = parg;
1788         return 1;
1789
1790     case SSL_CTRL_GET_MAX_CERT_LIST:
1791         return (ctx->max_cert_list);
1792     case SSL_CTRL_SET_MAX_CERT_LIST:
1793         l = ctx->max_cert_list;
1794         ctx->max_cert_list = larg;
1795         return (l);
1796
1797     case SSL_CTRL_SET_SESS_CACHE_SIZE:
1798         l = ctx->session_cache_size;
1799         ctx->session_cache_size = larg;
1800         return (l);
1801     case SSL_CTRL_GET_SESS_CACHE_SIZE:
1802         return (ctx->session_cache_size);
1803     case SSL_CTRL_SET_SESS_CACHE_MODE:
1804         l = ctx->session_cache_mode;
1805         ctx->session_cache_mode = larg;
1806         return (l);
1807     case SSL_CTRL_GET_SESS_CACHE_MODE:
1808         return (ctx->session_cache_mode);
1809
1810     case SSL_CTRL_SESS_NUMBER:
1811         return (lh_SSL_SESSION_num_items(ctx->sessions));
1812     case SSL_CTRL_SESS_CONNECT:
1813         return (ctx->stats.sess_connect);
1814     case SSL_CTRL_SESS_CONNECT_GOOD:
1815         return (ctx->stats.sess_connect_good);
1816     case SSL_CTRL_SESS_CONNECT_RENEGOTIATE:
1817         return (ctx->stats.sess_connect_renegotiate);
1818     case SSL_CTRL_SESS_ACCEPT:
1819         return (ctx->stats.sess_accept);
1820     case SSL_CTRL_SESS_ACCEPT_GOOD:
1821         return (ctx->stats.sess_accept_good);
1822     case SSL_CTRL_SESS_ACCEPT_RENEGOTIATE:
1823         return (ctx->stats.sess_accept_renegotiate);
1824     case SSL_CTRL_SESS_HIT:
1825         return (ctx->stats.sess_hit);
1826     case SSL_CTRL_SESS_CB_HIT:
1827         return (ctx->stats.sess_cb_hit);
1828     case SSL_CTRL_SESS_MISSES:
1829         return (ctx->stats.sess_miss);
1830     case SSL_CTRL_SESS_TIMEOUTS:
1831         return (ctx->stats.sess_timeout);
1832     case SSL_CTRL_SESS_CACHE_FULL:
1833         return (ctx->stats.sess_cache_full);
1834     case SSL_CTRL_MODE:
1835         return (ctx->mode |= larg);
1836     case SSL_CTRL_CLEAR_MODE:
1837         return (ctx->mode &= ~larg);
1838     case SSL_CTRL_SET_MAX_SEND_FRAGMENT:
1839         if (larg < 512 || larg > SSL3_RT_MAX_PLAIN_LENGTH)
1840             return 0;
1841         ctx->max_send_fragment = larg;
1842         if (ctx->max_send_fragment < ctx->split_send_fragment)
1843             ctx->split_send_fragment = ctx->split_send_fragment;
1844         return 1;
1845     case SSL_CTRL_SET_SPLIT_SEND_FRAGMENT:
1846         if (larg > ctx->max_send_fragment || larg == 0)
1847             return 0;
1848         ctx->split_send_fragment = larg;
1849         return 1;
1850     case SSL_CTRL_SET_MAX_PIPELINES:
1851         if (larg < 1 || larg > SSL_MAX_PIPELINES)
1852             return 0;
1853         ctx->max_pipelines = larg;
1854     case SSL_CTRL_CERT_FLAGS:
1855         return (ctx->cert->cert_flags |= larg);
1856     case SSL_CTRL_CLEAR_CERT_FLAGS:
1857         return (ctx->cert->cert_flags &= ~larg);
1858     case SSL_CTRL_SET_MIN_PROTO_VERSION:
1859         return ssl_set_version_bound(ctx->method->version, (int)larg,
1860                                      &ctx->min_proto_version);
1861     case SSL_CTRL_SET_MAX_PROTO_VERSION:
1862         return ssl_set_version_bound(ctx->method->version, (int)larg,
1863                                      &ctx->max_proto_version);
1864     default:
1865         return (ctx->method->ssl_ctx_ctrl(ctx, cmd, larg, parg));
1866     }
1867 }
1868
1869 long SSL_CTX_callback_ctrl(SSL_CTX *ctx, int cmd, void (*fp) (void))
1870 {
1871     switch (cmd) {
1872     case SSL_CTRL_SET_MSG_CALLBACK:
1873         ctx->msg_callback = (void (*)
1874                              (int write_p, int version, int content_type,
1875                               const void *buf, size_t len, SSL *ssl,
1876                               void *arg))(fp);
1877         return 1;
1878
1879     default:
1880         return (ctx->method->ssl_ctx_callback_ctrl(ctx, cmd, fp));
1881     }
1882 }
1883
1884 int ssl_cipher_id_cmp(const SSL_CIPHER *a, const SSL_CIPHER *b)
1885 {
1886     if (a->id > b->id)
1887         return 1;
1888     if (a->id < b->id)
1889         return -1;
1890     return 0;
1891 }
1892
1893 int ssl_cipher_ptr_id_cmp(const SSL_CIPHER *const *ap,
1894                           const SSL_CIPHER *const *bp)
1895 {
1896     if ((*ap)->id > (*bp)->id)
1897         return 1;
1898     if ((*ap)->id < (*bp)->id)
1899         return -1;
1900     return 0;
1901 }
1902
1903 /** return a STACK of the ciphers available for the SSL and in order of
1904  * preference */
1905 STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *s)
1906 {
1907     if (s != NULL) {
1908         if (s->cipher_list != NULL) {
1909             return (s->cipher_list);
1910         } else if ((s->ctx != NULL) && (s->ctx->cipher_list != NULL)) {
1911             return (s->ctx->cipher_list);
1912         }
1913     }
1914     return (NULL);
1915 }
1916
1917 STACK_OF(SSL_CIPHER) *SSL_get_client_ciphers(const SSL *s)
1918 {
1919     if ((s == NULL) || (s->session == NULL) || !s->server)
1920         return NULL;
1921     return s->session->ciphers;
1922 }
1923
1924 STACK_OF(SSL_CIPHER) *SSL_get1_supported_ciphers(SSL *s)
1925 {
1926     STACK_OF(SSL_CIPHER) *sk = NULL, *ciphers;
1927     int i;
1928     ciphers = SSL_get_ciphers(s);
1929     if (!ciphers)
1930         return NULL;
1931     ssl_set_client_disabled(s);
1932     for (i = 0; i < sk_SSL_CIPHER_num(ciphers); i++) {
1933         const SSL_CIPHER *c = sk_SSL_CIPHER_value(ciphers, i);
1934         if (!ssl_cipher_disabled(s, c, SSL_SECOP_CIPHER_SUPPORTED)) {
1935             if (!sk)
1936                 sk = sk_SSL_CIPHER_new_null();
1937             if (!sk)
1938                 return NULL;
1939             if (!sk_SSL_CIPHER_push(sk, c)) {
1940                 sk_SSL_CIPHER_free(sk);
1941                 return NULL;
1942             }
1943         }
1944     }
1945     return sk;
1946 }
1947
1948 /** return a STACK of the ciphers available for the SSL and in order of
1949  * algorithm id */
1950 STACK_OF(SSL_CIPHER) *ssl_get_ciphers_by_id(SSL *s)
1951 {
1952     if (s != NULL) {
1953         if (s->cipher_list_by_id != NULL) {
1954             return (s->cipher_list_by_id);
1955         } else if ((s->ctx != NULL) && (s->ctx->cipher_list_by_id != NULL)) {
1956             return (s->ctx->cipher_list_by_id);
1957         }
1958     }
1959     return (NULL);
1960 }
1961
1962 /** The old interface to get the same thing as SSL_get_ciphers() */
1963 const char *SSL_get_cipher_list(const SSL *s, int n)
1964 {
1965     const SSL_CIPHER *c;
1966     STACK_OF(SSL_CIPHER) *sk;
1967
1968     if (s == NULL)
1969         return (NULL);
1970     sk = SSL_get_ciphers(s);
1971     if ((sk == NULL) || (sk_SSL_CIPHER_num(sk) <= n))
1972         return (NULL);
1973     c = sk_SSL_CIPHER_value(sk, n);
1974     if (c == NULL)
1975         return (NULL);
1976     return (c->name);
1977 }
1978
1979 /** specify the ciphers to be used by default by the SSL_CTX */
1980 int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str)
1981 {
1982     STACK_OF(SSL_CIPHER) *sk;
1983
1984     sk = ssl_create_cipher_list(ctx->method, &ctx->cipher_list,
1985                                 &ctx->cipher_list_by_id, str, ctx->cert);
1986     /*
1987      * ssl_create_cipher_list may return an empty stack if it was unable to
1988      * find a cipher matching the given rule string (for example if the rule
1989      * string specifies a cipher which has been disabled). This is not an
1990      * error as far as ssl_create_cipher_list is concerned, and hence
1991      * ctx->cipher_list and ctx->cipher_list_by_id has been updated.
1992      */
1993     if (sk == NULL)
1994         return 0;
1995     else if (sk_SSL_CIPHER_num(sk) == 0) {
1996         SSLerr(SSL_F_SSL_CTX_SET_CIPHER_LIST, SSL_R_NO_CIPHER_MATCH);
1997         return 0;
1998     }
1999     return 1;
2000 }
2001
2002 /** specify the ciphers to be used by the SSL */
2003 int SSL_set_cipher_list(SSL *s, const char *str)
2004 {
2005     STACK_OF(SSL_CIPHER) *sk;
2006
2007     sk = ssl_create_cipher_list(s->ctx->method, &s->cipher_list,
2008                                 &s->cipher_list_by_id, str, s->cert);
2009     /* see comment in SSL_CTX_set_cipher_list */
2010     if (sk == NULL)
2011         return 0;
2012     else if (sk_SSL_CIPHER_num(sk) == 0) {
2013         SSLerr(SSL_F_SSL_SET_CIPHER_LIST, SSL_R_NO_CIPHER_MATCH);
2014         return 0;
2015     }
2016     return 1;
2017 }
2018
2019 char *SSL_get_shared_ciphers(const SSL *s, char *buf, int len)
2020 {
2021     char *p;
2022     STACK_OF(SSL_CIPHER) *sk;
2023     const SSL_CIPHER *c;
2024     int i;
2025
2026     if ((s->session == NULL) || (s->session->ciphers == NULL) || (len < 2))
2027         return (NULL);
2028
2029     p = buf;
2030     sk = s->session->ciphers;
2031
2032     if (sk_SSL_CIPHER_num(sk) == 0)
2033         return NULL;
2034
2035     for (i = 0; i < sk_SSL_CIPHER_num(sk); i++) {
2036         int n;
2037
2038         c = sk_SSL_CIPHER_value(sk, i);
2039         n = strlen(c->name);
2040         if (n + 1 > len) {
2041             if (p != buf)
2042                 --p;
2043             *p = '\0';
2044             return buf;
2045         }
2046         memcpy(p, c->name, n + 1);
2047         p += n;
2048         *(p++) = ':';
2049         len -= n + 1;
2050     }
2051     p[-1] = '\0';
2052     return (buf);
2053 }
2054
2055 /** return a servername extension value if provided in Client Hello, or NULL.
2056  * So far, only host_name types are defined (RFC 3546).
2057  */
2058
2059 const char *SSL_get_servername(const SSL *s, const int type)
2060 {
2061     if (type != TLSEXT_NAMETYPE_host_name)
2062         return NULL;
2063
2064     return s->session && !s->tlsext_hostname ?
2065         s->session->tlsext_hostname : s->tlsext_hostname;
2066 }
2067
2068 int SSL_get_servername_type(const SSL *s)
2069 {
2070     if (s->session
2071         && (!s->tlsext_hostname ? s->session->
2072             tlsext_hostname : s->tlsext_hostname))
2073         return TLSEXT_NAMETYPE_host_name;
2074     return -1;
2075 }
2076
2077 /*
2078  * SSL_select_next_proto implements the standard protocol selection. It is
2079  * expected that this function is called from the callback set by
2080  * SSL_CTX_set_next_proto_select_cb. The protocol data is assumed to be a
2081  * vector of 8-bit, length prefixed byte strings. The length byte itself is
2082  * not included in the length. A byte string of length 0 is invalid. No byte
2083  * string may be truncated. The current, but experimental algorithm for
2084  * selecting the protocol is: 1) If the server doesn't support NPN then this
2085  * is indicated to the callback. In this case, the client application has to
2086  * abort the connection or have a default application level protocol. 2) If
2087  * the server supports NPN, but advertises an empty list then the client
2088  * selects the first protcol in its list, but indicates via the API that this
2089  * fallback case was enacted. 3) Otherwise, the client finds the first
2090  * protocol in the server's list that it supports and selects this protocol.
2091  * This is because it's assumed that the server has better information about
2092  * which protocol a client should use. 4) If the client doesn't support any
2093  * of the server's advertised protocols, then this is treated the same as
2094  * case 2. It returns either OPENSSL_NPN_NEGOTIATED if a common protocol was
2095  * found, or OPENSSL_NPN_NO_OVERLAP if the fallback case was reached.
2096  */
2097 int SSL_select_next_proto(unsigned char **out, unsigned char *outlen,
2098                           const unsigned char *server,
2099                           unsigned int server_len,
2100                           const unsigned char *client,
2101                           unsigned int client_len)
2102 {
2103     unsigned int i, j;
2104     const unsigned char *result;
2105     int status = OPENSSL_NPN_UNSUPPORTED;
2106
2107     /*
2108      * For each protocol in server preference order, see if we support it.
2109      */
2110     for (i = 0; i < server_len;) {
2111         for (j = 0; j < client_len;) {
2112             if (server[i] == client[j] &&
2113                 memcmp(&server[i + 1], &client[j + 1], server[i]) == 0) {
2114                 /* We found a match */
2115                 result = &server[i];
2116                 status = OPENSSL_NPN_NEGOTIATED;
2117                 goto found;
2118             }
2119             j += client[j];
2120             j++;
2121         }
2122         i += server[i];
2123         i++;
2124     }
2125
2126     /* There's no overlap between our protocols and the server's list. */
2127     result = client;
2128     status = OPENSSL_NPN_NO_OVERLAP;
2129
2130  found:
2131     *out = (unsigned char *)result + 1;
2132     *outlen = result[0];
2133     return status;
2134 }
2135
2136 #ifndef OPENSSL_NO_NEXTPROTONEG
2137 /*
2138  * SSL_get0_next_proto_negotiated sets *data and *len to point to the
2139  * client's requested protocol for this connection and returns 0. If the
2140  * client didn't request any protocol, then *data is set to NULL. Note that
2141  * the client can request any protocol it chooses. The value returned from
2142  * this function need not be a member of the list of supported protocols
2143  * provided by the callback.
2144  */
2145 void SSL_get0_next_proto_negotiated(const SSL *s, const unsigned char **data,
2146                                     unsigned *len)
2147 {
2148     *data = s->next_proto_negotiated;
2149     if (!*data) {
2150         *len = 0;
2151     } else {
2152         *len = s->next_proto_negotiated_len;
2153     }
2154 }
2155
2156 /*
2157  * SSL_CTX_set_next_protos_advertised_cb sets a callback that is called when
2158  * a TLS server needs a list of supported protocols for Next Protocol
2159  * Negotiation. The returned list must be in wire format.  The list is
2160  * returned by setting |out| to point to it and |outlen| to its length. This
2161  * memory will not be modified, but one should assume that the SSL* keeps a
2162  * reference to it. The callback should return SSL_TLSEXT_ERR_OK if it
2163  * wishes to advertise. Otherwise, no such extension will be included in the
2164  * ServerHello.
2165  */
2166 void SSL_CTX_set_next_protos_advertised_cb(SSL_CTX *ctx,
2167                                            int (*cb) (SSL *ssl,
2168                                                       const unsigned char
2169                                                       **out,
2170                                                       unsigned int *outlen,
2171                                                       void *arg), void *arg)
2172 {
2173     ctx->next_protos_advertised_cb = cb;
2174     ctx->next_protos_advertised_cb_arg = arg;
2175 }
2176
2177 /*
2178  * SSL_CTX_set_next_proto_select_cb sets a callback that is called when a
2179  * client needs to select a protocol from the server's provided list. |out|
2180  * must be set to point to the selected protocol (which may be within |in|).
2181  * The length of the protocol name must be written into |outlen|. The
2182  * server's advertised protocols are provided in |in| and |inlen|. The
2183  * callback can assume that |in| is syntactically valid. The client must
2184  * select a protocol. It is fatal to the connection if this callback returns
2185  * a value other than SSL_TLSEXT_ERR_OK.
2186  */
2187 void SSL_CTX_set_next_proto_select_cb(SSL_CTX *ctx,
2188                                       int (*cb) (SSL *s, unsigned char **out,
2189                                                  unsigned char *outlen,
2190                                                  const unsigned char *in,
2191                                                  unsigned int inlen,
2192                                                  void *arg), void *arg)
2193 {
2194     ctx->next_proto_select_cb = cb;
2195     ctx->next_proto_select_cb_arg = arg;
2196 }
2197 #endif
2198
2199 /*
2200  * SSL_CTX_set_alpn_protos sets the ALPN protocol list on |ctx| to |protos|.
2201  * |protos| must be in wire-format (i.e. a series of non-empty, 8-bit
2202  * length-prefixed strings). Returns 0 on success.
2203  */
2204 int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const unsigned char *protos,
2205                             unsigned protos_len)
2206 {
2207     OPENSSL_free(ctx->alpn_client_proto_list);
2208     ctx->alpn_client_proto_list = OPENSSL_malloc(protos_len);
2209     if (ctx->alpn_client_proto_list == NULL) {
2210         SSLerr(SSL_F_SSL_CTX_SET_ALPN_PROTOS, ERR_R_MALLOC_FAILURE);
2211         return 1;
2212     }
2213     memcpy(ctx->alpn_client_proto_list, protos, protos_len);
2214     ctx->alpn_client_proto_list_len = protos_len;
2215
2216     return 0;
2217 }
2218
2219 /*
2220  * SSL_set_alpn_protos sets the ALPN protocol list on |ssl| to |protos|.
2221  * |protos| must be in wire-format (i.e. a series of non-empty, 8-bit
2222  * length-prefixed strings). Returns 0 on success.
2223  */
2224 int SSL_set_alpn_protos(SSL *ssl, const unsigned char *protos,
2225                         unsigned protos_len)
2226 {
2227     OPENSSL_free(ssl->alpn_client_proto_list);
2228     ssl->alpn_client_proto_list = OPENSSL_malloc(protos_len);
2229     if (ssl->alpn_client_proto_list == NULL) {
2230         SSLerr(SSL_F_SSL_SET_ALPN_PROTOS, ERR_R_MALLOC_FAILURE);
2231         return 1;
2232     }
2233     memcpy(ssl->alpn_client_proto_list, protos, protos_len);
2234     ssl->alpn_client_proto_list_len = protos_len;
2235
2236     return 0;
2237 }
2238
2239 /*
2240  * SSL_CTX_set_alpn_select_cb sets a callback function on |ctx| that is
2241  * called during ClientHello processing in order to select an ALPN protocol
2242  * from the client's list of offered protocols.
2243  */
2244 void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,
2245                                 int (*cb) (SSL *ssl,
2246                                            const unsigned char **out,
2247                                            unsigned char *outlen,
2248                                            const unsigned char *in,
2249                                            unsigned int inlen,
2250                                            void *arg), void *arg)
2251 {
2252     ctx->alpn_select_cb = cb;
2253     ctx->alpn_select_cb_arg = arg;
2254 }
2255
2256 /*
2257  * SSL_get0_alpn_selected gets the selected ALPN protocol (if any) from
2258  * |ssl|. On return it sets |*data| to point to |*len| bytes of protocol name
2259  * (not including the leading length-prefix byte). If the server didn't
2260  * respond with a negotiated protocol then |*len| will be zero.
2261  */
2262 void SSL_get0_alpn_selected(const SSL *ssl, const unsigned char **data,
2263                             unsigned *len)
2264 {
2265     *data = NULL;
2266     if (ssl->s3)
2267         *data = ssl->s3->alpn_selected;
2268     if (*data == NULL)
2269         *len = 0;
2270     else
2271         *len = ssl->s3->alpn_selected_len;
2272 }
2273
2274
2275 int SSL_export_keying_material(SSL *s, unsigned char *out, size_t olen,
2276                                const char *label, size_t llen,
2277                                const unsigned char *p, size_t plen,
2278                                int use_context)
2279 {
2280     if (s->version < TLS1_VERSION)
2281         return -1;
2282
2283     return s->method->ssl3_enc->export_keying_material(s, out, olen, label,
2284                                                        llen, p, plen,
2285                                                        use_context);
2286 }
2287
2288 static unsigned long ssl_session_hash(const SSL_SESSION *a)
2289 {
2290     unsigned long l;
2291
2292     l = (unsigned long)
2293         ((unsigned int)a->session_id[0]) |
2294         ((unsigned int)a->session_id[1] << 8L) |
2295         ((unsigned long)a->session_id[2] << 16L) |
2296         ((unsigned long)a->session_id[3] << 24L);
2297     return (l);
2298 }
2299
2300 /*
2301  * NB: If this function (or indeed the hash function which uses a sort of
2302  * coarser function than this one) is changed, ensure
2303  * SSL_CTX_has_matching_session_id() is checked accordingly. It relies on
2304  * being able to construct an SSL_SESSION that will collide with any existing
2305  * session with a matching session ID.
2306  */
2307 static int ssl_session_cmp(const SSL_SESSION *a, const SSL_SESSION *b)
2308 {
2309     if (a->ssl_version != b->ssl_version)
2310         return (1);
2311     if (a->session_id_length != b->session_id_length)
2312         return (1);
2313     return (memcmp(a->session_id, b->session_id, a->session_id_length));
2314 }
2315
2316 /*
2317  * These wrapper functions should remain rather than redeclaring
2318  * SSL_SESSION_hash and SSL_SESSION_cmp for void* types and casting each
2319  * variable. The reason is that the functions aren't static, they're exposed
2320  * via ssl.h.
2321  */
2322
2323 SSL_CTX *SSL_CTX_new(const SSL_METHOD *meth)
2324 {
2325     SSL_CTX *ret = NULL;
2326
2327     if (meth == NULL) {
2328         SSLerr(SSL_F_SSL_CTX_NEW, SSL_R_NULL_SSL_METHOD_PASSED);
2329         return (NULL);
2330     }
2331
2332     if (!OPENSSL_init_ssl(OPENSSL_INIT_LOAD_SSL_STRINGS, NULL))
2333         return NULL;
2334
2335     if (FIPS_mode() && (meth->version < TLS1_VERSION)) {
2336         SSLerr(SSL_F_SSL_CTX_NEW, SSL_R_AT_LEAST_TLS_1_0_NEEDED_IN_FIPS_MODE);
2337         return NULL;
2338     }
2339
2340     if (SSL_get_ex_data_X509_STORE_CTX_idx() < 0) {
2341         SSLerr(SSL_F_SSL_CTX_NEW, SSL_R_X509_VERIFICATION_SETUP_PROBLEMS);
2342         goto err;
2343     }
2344     ret = OPENSSL_zalloc(sizeof(*ret));
2345     if (ret == NULL)
2346         goto err;
2347
2348     ret->method = meth;
2349     ret->min_proto_version = 0;
2350     ret->max_proto_version = 0;
2351     ret->session_cache_mode = SSL_SESS_CACHE_SERVER;
2352     ret->session_cache_size = SSL_SESSION_CACHE_MAX_SIZE_DEFAULT;
2353     /* We take the system default. */
2354     ret->session_timeout = meth->get_timeout();
2355     ret->references = 1;
2356     ret->max_cert_list = SSL_MAX_CERT_LIST_DEFAULT;
2357     ret->verify_mode = SSL_VERIFY_NONE;
2358     if ((ret->cert = ssl_cert_new()) == NULL)
2359         goto err;
2360
2361     ret->sessions = lh_SSL_SESSION_new(ssl_session_hash, ssl_session_cmp);
2362     if (ret->sessions == NULL)
2363         goto err;
2364     ret->cert_store = X509_STORE_new();
2365     if (ret->cert_store == NULL)
2366         goto err;
2367 #ifndef OPENSSL_NO_CT
2368     ret->ctlog_store = CTLOG_STORE_new();
2369     if (ret->ctlog_store == NULL)
2370         goto err;
2371 #endif
2372     if (!ssl_create_cipher_list(ret->method,
2373                            &ret->cipher_list, &ret->cipher_list_by_id,
2374                            SSL_DEFAULT_CIPHER_LIST, ret->cert)
2375        || sk_SSL_CIPHER_num(ret->cipher_list) <= 0) {
2376         SSLerr(SSL_F_SSL_CTX_NEW, SSL_R_LIBRARY_HAS_NO_CIPHERS);
2377         goto err2;
2378     }
2379
2380     ret->param = X509_VERIFY_PARAM_new();
2381     if (ret->param == NULL)
2382         goto err;
2383
2384     if ((ret->md5 = EVP_get_digestbyname("ssl3-md5")) == NULL) {
2385         SSLerr(SSL_F_SSL_CTX_NEW, SSL_R_UNABLE_TO_LOAD_SSL3_MD5_ROUTINES);
2386         goto err2;
2387     }
2388     if ((ret->sha1 = EVP_get_digestbyname("ssl3-sha1")) == NULL) {
2389         SSLerr(SSL_F_SSL_CTX_NEW, SSL_R_UNABLE_TO_LOAD_SSL3_SHA1_ROUTINES);
2390         goto err2;
2391     }
2392
2393     if ((ret->client_CA = sk_X509_NAME_new_null()) == NULL)
2394         goto err;
2395
2396     CRYPTO_new_ex_data(CRYPTO_EX_INDEX_SSL_CTX, ret, &ret->ex_data);
2397
2398     /* No compression for DTLS */
2399     if (!(meth->ssl3_enc->enc_flags & SSL_ENC_FLAG_DTLS))
2400         ret->comp_methods = SSL_COMP_get_compression_methods();
2401
2402     ret->max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
2403     ret->split_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
2404
2405     /* Setup RFC4507 ticket keys */
2406     if ((RAND_bytes(ret->tlsext_tick_key_name, 16) <= 0)
2407         || (RAND_bytes(ret->tlsext_tick_hmac_key, 16) <= 0)
2408         || (RAND_bytes(ret->tlsext_tick_aes_key, 16) <= 0))
2409         ret->options |= SSL_OP_NO_TICKET;
2410
2411 #ifndef OPENSSL_NO_SRP
2412     if (!SSL_CTX_SRP_CTX_init(ret))
2413         goto err;
2414 #endif
2415 #ifndef OPENSSL_NO_ENGINE
2416 # ifdef OPENSSL_SSL_CLIENT_ENGINE_AUTO
2417 #  define eng_strx(x)     #x
2418 #  define eng_str(x)      eng_strx(x)
2419     /* Use specific client engine automatically... ignore errors */
2420     {
2421         ENGINE *eng;
2422         eng = ENGINE_by_id(eng_str(OPENSSL_SSL_CLIENT_ENGINE_AUTO));
2423         if (!eng) {
2424             ERR_clear_error();
2425             ENGINE_load_builtin_engines();
2426             eng = ENGINE_by_id(eng_str(OPENSSL_SSL_CLIENT_ENGINE_AUTO));
2427         }
2428         if (!eng || !SSL_CTX_set_client_cert_engine(ret, eng))
2429             ERR_clear_error();
2430     }
2431 # endif
2432 #endif
2433     /*
2434      * Default is to connect to non-RI servers. When RI is more widely
2435      * deployed might change this.
2436      */
2437     ret->options |= SSL_OP_LEGACY_SERVER_CONNECT;
2438     /*
2439      * Disable compression by default to prevent CRIME. Applications can
2440      * re-enable compression by configuring
2441      * SSL_CTX_clear_options(ctx, SSL_OP_NO_COMPRESSION);
2442      * or by using the SSL_CONF library.
2443      */
2444     ret->options |= SSL_OP_NO_COMPRESSION;
2445
2446     return (ret);
2447  err:
2448     SSLerr(SSL_F_SSL_CTX_NEW, ERR_R_MALLOC_FAILURE);
2449  err2:
2450     SSL_CTX_free(ret);
2451     return (NULL);
2452 }
2453
2454 void SSL_CTX_up_ref(SSL_CTX *ctx)
2455 {
2456     CRYPTO_add(&ctx->references, 1, CRYPTO_LOCK_SSL_CTX);
2457 }
2458
2459 void SSL_CTX_free(SSL_CTX *a)
2460 {
2461     int i;
2462
2463     if (a == NULL)
2464         return;
2465
2466     i = CRYPTO_add(&a->references, -1, CRYPTO_LOCK_SSL_CTX);
2467     REF_PRINT_COUNT("SSL_CTX", a);
2468     if (i > 0)
2469         return;
2470     REF_ASSERT_ISNT(i < 0);
2471
2472     X509_VERIFY_PARAM_free(a->param);
2473     dane_ctx_final(&a->dane);
2474
2475     /*
2476      * Free internal session cache. However: the remove_cb() may reference
2477      * the ex_data of SSL_CTX, thus the ex_data store can only be removed
2478      * after the sessions were flushed.
2479      * As the ex_data handling routines might also touch the session cache,
2480      * the most secure solution seems to be: empty (flush) the cache, then
2481      * free ex_data, then finally free the cache.
2482      * (See ticket [openssl.org #212].)
2483      */
2484     if (a->sessions != NULL)
2485         SSL_CTX_flush_sessions(a, 0);
2486
2487     CRYPTO_free_ex_data(CRYPTO_EX_INDEX_SSL_CTX, a, &a->ex_data);
2488     lh_SSL_SESSION_free(a->sessions);
2489     X509_STORE_free(a->cert_store);
2490 #ifndef OPENSSL_NO_CT
2491     CTLOG_STORE_free(a->ctlog_store);
2492 #endif
2493     sk_SSL_CIPHER_free(a->cipher_list);
2494     sk_SSL_CIPHER_free(a->cipher_list_by_id);
2495     ssl_cert_free(a->cert);
2496     sk_X509_NAME_pop_free(a->client_CA, X509_NAME_free);
2497     sk_X509_pop_free(a->extra_certs, X509_free);
2498     a->comp_methods = NULL;
2499 #ifndef OPENSSL_NO_SRTP
2500     sk_SRTP_PROTECTION_PROFILE_free(a->srtp_profiles);
2501 #endif
2502 #ifndef OPENSSL_NO_SRP
2503     SSL_CTX_SRP_CTX_free(a);
2504 #endif
2505 #ifndef OPENSSL_NO_ENGINE
2506     ENGINE_finish(a->client_cert_engine);
2507 #endif
2508
2509 #ifndef OPENSSL_NO_EC
2510     OPENSSL_free(a->tlsext_ecpointformatlist);
2511     OPENSSL_free(a->tlsext_ellipticcurvelist);
2512 #endif
2513     OPENSSL_free(a->alpn_client_proto_list);
2514
2515     OPENSSL_free(a);
2516 }
2517
2518 void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, pem_password_cb *cb)
2519 {
2520     ctx->default_passwd_callback = cb;
2521 }
2522
2523 void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx, void *u)
2524 {
2525     ctx->default_passwd_callback_userdata = u;
2526 }
2527
2528 pem_password_cb *SSL_CTX_get_default_passwd_cb(SSL_CTX *ctx)
2529 {
2530     return ctx->default_passwd_callback;
2531 }
2532
2533 void *SSL_CTX_get_default_passwd_cb_userdata(SSL_CTX *ctx)
2534 {
2535     return ctx->default_passwd_callback_userdata;
2536 }
2537
2538 void SSL_set_default_passwd_cb(SSL *s, pem_password_cb *cb)
2539 {
2540     s->default_passwd_callback = cb;
2541 }
2542
2543 void SSL_set_default_passwd_cb_userdata(SSL *s, void *u)
2544 {
2545     s->default_passwd_callback_userdata = u;
2546 }
2547
2548 pem_password_cb *SSL_get_default_passwd_cb(SSL *s)
2549 {
2550     return s->default_passwd_callback;
2551 }
2552
2553 void *SSL_get_default_passwd_cb_userdata(SSL *s)
2554 {
2555     return s->default_passwd_callback_userdata;
2556 }
2557
2558 void SSL_CTX_set_cert_verify_callback(SSL_CTX *ctx,
2559                                       int (*cb) (X509_STORE_CTX *, void *),
2560                                       void *arg)
2561 {
2562     ctx->app_verify_callback = cb;
2563     ctx->app_verify_arg = arg;
2564 }
2565
2566 void SSL_CTX_set_verify(SSL_CTX *ctx, int mode,
2567                         int (*cb) (int, X509_STORE_CTX *))
2568 {
2569     ctx->verify_mode = mode;
2570     ctx->default_verify_callback = cb;
2571 }
2572
2573 void SSL_CTX_set_verify_depth(SSL_CTX *ctx, int depth)
2574 {
2575     X509_VERIFY_PARAM_set_depth(ctx->param, depth);
2576 }
2577
2578 void SSL_CTX_set_cert_cb(SSL_CTX *c, int (*cb) (SSL *ssl, void *arg),
2579                          void *arg)
2580 {
2581     ssl_cert_set_cert_cb(c->cert, cb, arg);
2582 }
2583
2584 void SSL_set_cert_cb(SSL *s, int (*cb) (SSL *ssl, void *arg), void *arg)
2585 {
2586     ssl_cert_set_cert_cb(s->cert, cb, arg);
2587 }
2588
2589 void ssl_set_masks(SSL *s)
2590 {
2591 #if !defined(OPENSSL_NO_EC) || !defined(OPENSSL_NO_GOST)
2592     CERT_PKEY *cpk;
2593 #endif
2594     CERT *c = s->cert;
2595     uint32_t *pvalid = s->s3->tmp.valid_flags;
2596     int rsa_enc, rsa_sign, dh_tmp, dsa_sign;
2597     unsigned long mask_k, mask_a;
2598 #ifndef OPENSSL_NO_EC
2599     int have_ecc_cert, ecdsa_ok;
2600     X509 *x = NULL;
2601 #endif
2602     if (c == NULL)
2603         return;
2604
2605 #ifndef OPENSSL_NO_DH
2606     dh_tmp = (c->dh_tmp != NULL || c->dh_tmp_cb != NULL || c->dh_tmp_auto);
2607 #else
2608     dh_tmp = 0;
2609 #endif
2610
2611     rsa_enc = pvalid[SSL_PKEY_RSA_ENC] & CERT_PKEY_VALID;
2612     rsa_sign = pvalid[SSL_PKEY_RSA_SIGN] & CERT_PKEY_SIGN;
2613     dsa_sign = pvalid[SSL_PKEY_DSA_SIGN] & CERT_PKEY_SIGN;
2614 #ifndef OPENSSL_NO_EC
2615     have_ecc_cert = pvalid[SSL_PKEY_ECC] & CERT_PKEY_VALID;
2616 #endif
2617     mask_k = 0;
2618     mask_a = 0;
2619
2620 #ifdef CIPHER_DEBUG
2621     fprintf(stderr, "dht=%d re=%d rs=%d ds=%d\n",
2622             dh_tmp, rsa_enc, rsa_sign, dsa_sign);
2623 #endif
2624
2625 #ifndef OPENSSL_NO_GOST
2626     cpk = &(c->pkeys[SSL_PKEY_GOST12_512]);
2627     if (cpk->x509 != NULL && cpk->privatekey != NULL) {
2628         mask_k |= SSL_kGOST;
2629         mask_a |= SSL_aGOST12;
2630     }
2631     cpk = &(c->pkeys[SSL_PKEY_GOST12_256]);
2632     if (cpk->x509 != NULL && cpk->privatekey != NULL) {
2633         mask_k |= SSL_kGOST;
2634         mask_a |= SSL_aGOST12;
2635     }
2636     cpk = &(c->pkeys[SSL_PKEY_GOST01]);
2637     if (cpk->x509 != NULL && cpk->privatekey != NULL) {
2638         mask_k |= SSL_kGOST;
2639         mask_a |= SSL_aGOST01;
2640     }
2641 #endif
2642
2643     if (rsa_enc)
2644         mask_k |= SSL_kRSA;
2645
2646     if (dh_tmp)
2647         mask_k |= SSL_kDHE;
2648
2649     if (rsa_enc || rsa_sign) {
2650         mask_a |= SSL_aRSA;
2651     }
2652
2653     if (dsa_sign) {
2654         mask_a |= SSL_aDSS;
2655     }
2656
2657     mask_a |= SSL_aNULL;
2658
2659     /*
2660      * An ECC certificate may be usable for ECDH and/or ECDSA cipher suites
2661      * depending on the key usage extension.
2662      */
2663 #ifndef OPENSSL_NO_EC
2664     if (have_ecc_cert) {
2665         uint32_t ex_kusage;
2666         cpk = &c->pkeys[SSL_PKEY_ECC];
2667         x = cpk->x509;
2668         ex_kusage = X509_get_key_usage(x);
2669         ecdsa_ok = ex_kusage & X509v3_KU_DIGITAL_SIGNATURE;
2670         if (!(pvalid[SSL_PKEY_ECC] & CERT_PKEY_SIGN))
2671             ecdsa_ok = 0;
2672         if (ecdsa_ok)
2673             mask_a |= SSL_aECDSA;
2674     }
2675 #endif
2676
2677 #ifndef OPENSSL_NO_EC
2678     mask_k |= SSL_kECDHE;
2679 #endif
2680
2681 #ifndef OPENSSL_NO_PSK
2682     mask_k |= SSL_kPSK;
2683     mask_a |= SSL_aPSK;
2684     if (mask_k & SSL_kRSA)
2685         mask_k |= SSL_kRSAPSK;
2686     if (mask_k & SSL_kDHE)
2687         mask_k |= SSL_kDHEPSK;
2688     if (mask_k & SSL_kECDHE)
2689         mask_k |= SSL_kECDHEPSK;
2690 #endif
2691
2692     s->s3->tmp.mask_k = mask_k;
2693     s->s3->tmp.mask_a = mask_a;
2694 }
2695
2696 #ifndef OPENSSL_NO_EC
2697
2698 int ssl_check_srvr_ecc_cert_and_alg(X509 *x, SSL *s)
2699 {
2700     if (s->s3->tmp.new_cipher->algorithm_auth & SSL_aECDSA) {
2701         /* key usage, if present, must allow signing */
2702         if (!(X509_get_key_usage(x) & X509v3_KU_DIGITAL_SIGNATURE)) {
2703             SSLerr(SSL_F_SSL_CHECK_SRVR_ECC_CERT_AND_ALG,
2704                    SSL_R_ECC_CERT_NOT_FOR_SIGNING);
2705             return 0;
2706         }
2707     }
2708     return 1;                   /* all checks are ok */
2709 }
2710
2711 #endif
2712
2713 static int ssl_get_server_cert_index(const SSL *s)
2714 {
2715     int idx;
2716     idx = ssl_cipher_get_cert_index(s->s3->tmp.new_cipher);
2717     if (idx == SSL_PKEY_RSA_ENC && !s->cert->pkeys[SSL_PKEY_RSA_ENC].x509)
2718         idx = SSL_PKEY_RSA_SIGN;
2719     if (idx == SSL_PKEY_GOST_EC) {
2720         if (s->cert->pkeys[SSL_PKEY_GOST12_512].x509)
2721             idx = SSL_PKEY_GOST12_512;
2722         else if (s->cert->pkeys[SSL_PKEY_GOST12_256].x509)
2723             idx = SSL_PKEY_GOST12_256;
2724         else if (s->cert->pkeys[SSL_PKEY_GOST01].x509)
2725             idx = SSL_PKEY_GOST01;
2726         else
2727             idx = -1;
2728     }
2729     if (idx == -1)
2730         SSLerr(SSL_F_SSL_GET_SERVER_CERT_INDEX, ERR_R_INTERNAL_ERROR);
2731     return idx;
2732 }
2733
2734 CERT_PKEY *ssl_get_server_send_pkey(SSL *s)
2735 {
2736     CERT *c;
2737     int i;
2738
2739     c = s->cert;
2740     if (!s->s3 || !s->s3->tmp.new_cipher)
2741         return NULL;
2742     ssl_set_masks(s);
2743
2744     i = ssl_get_server_cert_index(s);
2745
2746     /* This may or may not be an error. */
2747     if (i < 0)
2748         return NULL;
2749
2750     /* May be NULL. */
2751     return &c->pkeys[i];
2752 }
2753
2754 EVP_PKEY *ssl_get_sign_pkey(SSL *s, const SSL_CIPHER *cipher,
2755                             const EVP_MD **pmd)
2756 {
2757     unsigned long alg_a;
2758     CERT *c;
2759     int idx = -1;
2760
2761     alg_a = cipher->algorithm_auth;
2762     c = s->cert;
2763
2764     if ((alg_a & SSL_aDSS) &&
2765             (c->pkeys[SSL_PKEY_DSA_SIGN].privatekey != NULL))
2766         idx = SSL_PKEY_DSA_SIGN;
2767     else if (alg_a & SSL_aRSA) {
2768         if (c->pkeys[SSL_PKEY_RSA_SIGN].privatekey != NULL)
2769             idx = SSL_PKEY_RSA_SIGN;
2770         else if (c->pkeys[SSL_PKEY_RSA_ENC].privatekey != NULL)
2771             idx = SSL_PKEY_RSA_ENC;
2772     } else if ((alg_a & SSL_aECDSA) &&
2773                (c->pkeys[SSL_PKEY_ECC].privatekey != NULL))
2774         idx = SSL_PKEY_ECC;
2775     if (idx == -1) {
2776         SSLerr(SSL_F_SSL_GET_SIGN_PKEY, ERR_R_INTERNAL_ERROR);
2777         return (NULL);
2778     }
2779     if (pmd)
2780         *pmd = s->s3->tmp.md[idx];
2781     return c->pkeys[idx].privatekey;
2782 }
2783
2784 int ssl_get_server_cert_serverinfo(SSL *s, const unsigned char **serverinfo,
2785                                    size_t *serverinfo_length)
2786 {
2787     CERT *c = NULL;
2788     int i = 0;
2789     *serverinfo_length = 0;
2790
2791     c = s->cert;
2792     i = ssl_get_server_cert_index(s);
2793
2794     if (i == -1)
2795         return 0;
2796     if (c->pkeys[i].serverinfo == NULL)
2797         return 0;
2798
2799     *serverinfo = c->pkeys[i].serverinfo;
2800     *serverinfo_length = c->pkeys[i].serverinfo_length;
2801     return 1;
2802 }
2803
2804 void ssl_update_cache(SSL *s, int mode)
2805 {
2806     int i;
2807
2808     /*
2809      * If the session_id_length is 0, we are not supposed to cache it, and it
2810      * would be rather hard to do anyway :-)
2811      */
2812     if (s->session->session_id_length == 0)
2813         return;
2814
2815     i = s->session_ctx->session_cache_mode;
2816     if ((i & mode) && (!s->hit)
2817         && ((i & SSL_SESS_CACHE_NO_INTERNAL_STORE)
2818             || SSL_CTX_add_session(s->session_ctx, s->session))
2819         && (s->session_ctx->new_session_cb != NULL)) {
2820         CRYPTO_add(&s->session->references, 1, CRYPTO_LOCK_SSL_SESSION);
2821         if (!s->session_ctx->new_session_cb(s, s->session))
2822             SSL_SESSION_free(s->session);
2823     }
2824
2825     /* auto flush every 255 connections */
2826     if ((!(i & SSL_SESS_CACHE_NO_AUTO_CLEAR)) && ((i & mode) == mode)) {
2827         if ((((mode & SSL_SESS_CACHE_CLIENT)
2828               ? s->session_ctx->stats.sess_connect_good
2829               : s->session_ctx->stats.sess_accept_good) & 0xff) == 0xff) {
2830             SSL_CTX_flush_sessions(s->session_ctx, (unsigned long)time(NULL));
2831         }
2832     }
2833 }
2834
2835 const SSL_METHOD *SSL_CTX_get_ssl_method(SSL_CTX *ctx)
2836 {
2837     return ctx->method;
2838 }
2839
2840 const SSL_METHOD *SSL_get_ssl_method(SSL *s)
2841 {
2842     return (s->method);
2843 }
2844
2845 int SSL_set_ssl_method(SSL *s, const SSL_METHOD *meth)
2846 {
2847     int ret = 1;
2848
2849     if (s->method != meth) {
2850         const SSL_METHOD *sm = s->method;
2851         int (*hf)(SSL *) = s->handshake_func;
2852
2853         if (sm->version == meth->version)
2854             s->method = meth;
2855         else {
2856             sm->ssl_free(s);
2857             s->method = meth;
2858             ret = s->method->ssl_new(s);
2859         }
2860
2861         if (hf == sm->ssl_connect)
2862             s->handshake_func = meth->ssl_connect;
2863         else if (hf == sm->ssl_accept)
2864             s->handshake_func = meth->ssl_accept;
2865     }
2866     return (ret);
2867 }
2868
2869 int SSL_get_error(const SSL *s, int i)
2870 {
2871     int reason;
2872     unsigned long l;
2873     BIO *bio;
2874
2875     if (i > 0)
2876         return (SSL_ERROR_NONE);
2877
2878     /*
2879      * Make things return SSL_ERROR_SYSCALL when doing SSL_do_handshake etc,
2880      * where we do encode the error
2881      */
2882     if ((l = ERR_peek_error()) != 0) {
2883         if (ERR_GET_LIB(l) == ERR_LIB_SYS)
2884             return (SSL_ERROR_SYSCALL);
2885         else
2886             return (SSL_ERROR_SSL);
2887     }
2888
2889     if ((i < 0) && SSL_want_read(s)) {
2890         bio = SSL_get_rbio(s);
2891         if (BIO_should_read(bio))
2892             return (SSL_ERROR_WANT_READ);
2893         else if (BIO_should_write(bio))
2894             /*
2895              * This one doesn't make too much sense ... We never try to write
2896              * to the rbio, and an application program where rbio and wbio
2897              * are separate couldn't even know what it should wait for.
2898              * However if we ever set s->rwstate incorrectly (so that we have
2899              * SSL_want_read(s) instead of SSL_want_write(s)) and rbio and
2900              * wbio *are* the same, this test works around that bug; so it
2901              * might be safer to keep it.
2902              */
2903             return (SSL_ERROR_WANT_WRITE);
2904         else if (BIO_should_io_special(bio)) {
2905             reason = BIO_get_retry_reason(bio);
2906             if (reason == BIO_RR_CONNECT)
2907                 return (SSL_ERROR_WANT_CONNECT);
2908             else if (reason == BIO_RR_ACCEPT)
2909                 return (SSL_ERROR_WANT_ACCEPT);
2910             else
2911                 return (SSL_ERROR_SYSCALL); /* unknown */
2912         }
2913     }
2914
2915     if ((i < 0) && SSL_want_write(s)) {
2916         bio = SSL_get_wbio(s);
2917         if (BIO_should_write(bio))
2918             return (SSL_ERROR_WANT_WRITE);
2919         else if (BIO_should_read(bio))
2920             /*
2921              * See above (SSL_want_read(s) with BIO_should_write(bio))
2922              */
2923             return (SSL_ERROR_WANT_READ);
2924         else if (BIO_should_io_special(bio)) {
2925             reason = BIO_get_retry_reason(bio);
2926             if (reason == BIO_RR_CONNECT)
2927                 return (SSL_ERROR_WANT_CONNECT);
2928             else if (reason == BIO_RR_ACCEPT)
2929                 return (SSL_ERROR_WANT_ACCEPT);
2930             else
2931                 return (SSL_ERROR_SYSCALL);
2932         }
2933     }
2934     if ((i < 0) && SSL_want_x509_lookup(s)) {
2935         return (SSL_ERROR_WANT_X509_LOOKUP);
2936     }
2937     if ((i < 0) && SSL_want_async(s)) {
2938         return SSL_ERROR_WANT_ASYNC;
2939     }
2940
2941     if (i == 0) {
2942         if ((s->shutdown & SSL_RECEIVED_SHUTDOWN) &&
2943             (s->s3->warn_alert == SSL_AD_CLOSE_NOTIFY))
2944             return (SSL_ERROR_ZERO_RETURN);
2945     }
2946     return (SSL_ERROR_SYSCALL);
2947 }
2948
2949 static int ssl_do_handshake_intern(void *vargs)
2950 {
2951     struct ssl_async_args *args;
2952     SSL *s;
2953
2954     args = (struct ssl_async_args *)vargs;
2955     s = args->s;
2956
2957     return s->handshake_func(s);
2958 }
2959
2960 int SSL_do_handshake(SSL *s)
2961 {
2962     int ret = 1;
2963
2964     if (s->handshake_func == NULL) {
2965         SSLerr(SSL_F_SSL_DO_HANDSHAKE, SSL_R_CONNECTION_TYPE_NOT_SET);
2966         return -1;
2967     }
2968
2969     s->method->ssl_renegotiate_check(s);
2970
2971     if (SSL_in_init(s) || SSL_in_before(s)) {
2972         if((s->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
2973             struct ssl_async_args args;
2974
2975             args.s = s;
2976
2977             ret = ssl_start_async_job(s, &args, ssl_do_handshake_intern);
2978         } else {
2979             ret = s->handshake_func(s);
2980         }
2981     }
2982     return ret;
2983 }
2984
2985 void SSL_set_accept_state(SSL *s)
2986 {
2987     s->server = 1;
2988     s->shutdown = 0;
2989     ossl_statem_clear(s);
2990     s->handshake_func = s->method->ssl_accept;
2991     clear_ciphers(s);
2992 }
2993
2994 void SSL_set_connect_state(SSL *s)
2995 {
2996     s->server = 0;
2997     s->shutdown = 0;
2998     ossl_statem_clear(s);
2999     s->handshake_func = s->method->ssl_connect;
3000     clear_ciphers(s);
3001 }
3002
3003 int ssl_undefined_function(SSL *s)
3004 {
3005     SSLerr(SSL_F_SSL_UNDEFINED_FUNCTION, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
3006     return (0);
3007 }
3008
3009 int ssl_undefined_void_function(void)
3010 {
3011     SSLerr(SSL_F_SSL_UNDEFINED_VOID_FUNCTION,
3012            ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
3013     return (0);
3014 }
3015
3016 int ssl_undefined_const_function(const SSL *s)
3017 {
3018     return (0);
3019 }
3020
3021 SSL_METHOD *ssl_bad_method(int ver)
3022 {
3023     SSLerr(SSL_F_SSL_BAD_METHOD, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
3024     return (NULL);
3025 }
3026
3027 const char *SSL_get_version(const SSL *s)
3028 {
3029     if (s->version == TLS1_2_VERSION)
3030         return ("TLSv1.2");
3031     else if (s->version == TLS1_1_VERSION)
3032         return ("TLSv1.1");
3033     else if (s->version == TLS1_VERSION)
3034         return ("TLSv1");
3035     else if (s->version == SSL3_VERSION)
3036         return ("SSLv3");
3037     else if (s->version == DTLS1_BAD_VER)
3038         return ("DTLSv0.9");
3039     else if (s->version == DTLS1_VERSION)
3040         return ("DTLSv1");
3041     else if (s->version == DTLS1_2_VERSION)
3042         return ("DTLSv1.2");
3043     else
3044         return ("unknown");
3045 }
3046
3047 SSL *SSL_dup(SSL *s)
3048 {
3049     STACK_OF(X509_NAME) *sk;
3050     X509_NAME *xn;
3051     SSL *ret;
3052     int i;
3053
3054     /* If we're not quiescent, just up_ref! */
3055     if (!SSL_in_init(s) || !SSL_in_before(s)) {
3056         CRYPTO_add(&s->references, 1, CRYPTO_LOCK_SSL);
3057         return s;
3058     }
3059
3060     /*
3061      * Otherwise, copy configuration state, and session if set.
3062      */
3063     if ((ret = SSL_new(SSL_get_SSL_CTX(s))) == NULL)
3064         return (NULL);
3065
3066     if (s->session != NULL) {
3067         /*
3068          * Arranges to share the same session via up_ref.  This "copies"
3069          * session-id, SSL_METHOD, sid_ctx, and 'cert'
3070          */
3071         if (!SSL_copy_session_id(ret, s))
3072             goto err;
3073     } else {
3074         /*
3075          * No session has been established yet, so we have to expect that
3076          * s->cert or ret->cert will be changed later -- they should not both
3077          * point to the same object, and thus we can't use
3078          * SSL_copy_session_id.
3079          */
3080         if (!SSL_set_ssl_method(ret, s->method))
3081             goto err;
3082
3083         if (s->cert != NULL) {
3084             ssl_cert_free(ret->cert);
3085             ret->cert = ssl_cert_dup(s->cert);
3086             if (ret->cert == NULL)
3087                 goto err;
3088         }
3089
3090         if (!SSL_set_session_id_context(ret, s->sid_ctx, s->sid_ctx_length))
3091             goto err;
3092     }
3093
3094     ssl_dane_dup(ret, s);
3095     ret->version = s->version;
3096     ret->options = s->options;
3097     ret->mode = s->mode;
3098     SSL_set_max_cert_list(ret, SSL_get_max_cert_list(s));
3099     SSL_set_read_ahead(ret, SSL_get_read_ahead(s));
3100     ret->msg_callback = s->msg_callback;
3101     ret->msg_callback_arg = s->msg_callback_arg;
3102     SSL_set_verify(ret, SSL_get_verify_mode(s), SSL_get_verify_callback(s));
3103     SSL_set_verify_depth(ret, SSL_get_verify_depth(s));
3104     ret->generate_session_id = s->generate_session_id;
3105
3106     SSL_set_info_callback(ret, SSL_get_info_callback(s));
3107
3108     /* copy app data, a little dangerous perhaps */
3109     if (!CRYPTO_dup_ex_data(CRYPTO_EX_INDEX_SSL, &ret->ex_data, &s->ex_data))
3110         goto err;
3111
3112     /* setup rbio, and wbio */
3113     if (s->rbio != NULL) {
3114         if (!BIO_dup_state(s->rbio, (char *)&ret->rbio))
3115             goto err;
3116     }
3117     if (s->wbio != NULL) {
3118         if (s->wbio != s->rbio) {
3119             if (!BIO_dup_state(s->wbio, (char *)&ret->wbio))
3120                 goto err;
3121         } else
3122             ret->wbio = ret->rbio;
3123     }
3124
3125     ret->server = s->server;
3126     if (s->handshake_func) {
3127         if (s->server)
3128             SSL_set_accept_state(ret);
3129         else
3130             SSL_set_connect_state(ret);
3131     }
3132     ret->shutdown = s->shutdown;
3133     ret->hit = s->hit;
3134
3135     ret->default_passwd_callback = s->default_passwd_callback;
3136     ret->default_passwd_callback_userdata = s->default_passwd_callback_userdata;
3137
3138     X509_VERIFY_PARAM_inherit(ret->param, s->param);
3139
3140     /* dup the cipher_list and cipher_list_by_id stacks */
3141     if (s->cipher_list != NULL) {
3142         if ((ret->cipher_list = sk_SSL_CIPHER_dup(s->cipher_list)) == NULL)
3143             goto err;
3144     }
3145     if (s->cipher_list_by_id != NULL)
3146         if ((ret->cipher_list_by_id = sk_SSL_CIPHER_dup(s->cipher_list_by_id))
3147             == NULL)
3148             goto err;
3149
3150     /* Dup the client_CA list */
3151     if (s->client_CA != NULL) {
3152         if ((sk = sk_X509_NAME_dup(s->client_CA)) == NULL)
3153             goto err;
3154         ret->client_CA = sk;
3155         for (i = 0; i < sk_X509_NAME_num(sk); i++) {
3156             xn = sk_X509_NAME_value(sk, i);
3157             if (sk_X509_NAME_set(sk, i, X509_NAME_dup(xn)) == NULL) {
3158                 X509_NAME_free(xn);
3159                 goto err;
3160             }
3161         }
3162     }
3163     return ret;
3164
3165  err:
3166     SSL_free(ret);
3167     return NULL;
3168 }
3169
3170 void ssl_clear_cipher_ctx(SSL *s)
3171 {
3172     if (s->enc_read_ctx != NULL) {
3173         EVP_CIPHER_CTX_free(s->enc_read_ctx);
3174         s->enc_read_ctx = NULL;
3175     }
3176     if (s->enc_write_ctx != NULL) {
3177         EVP_CIPHER_CTX_free(s->enc_write_ctx);
3178         s->enc_write_ctx = NULL;
3179     }
3180 #ifndef OPENSSL_NO_COMP
3181     COMP_CTX_free(s->expand);
3182     s->expand = NULL;
3183     COMP_CTX_free(s->compress);
3184     s->compress = NULL;
3185 #endif
3186 }
3187
3188 X509 *SSL_get_certificate(const SSL *s)
3189 {
3190     if (s->cert != NULL)
3191         return (s->cert->key->x509);
3192     else
3193         return (NULL);
3194 }
3195
3196 EVP_PKEY *SSL_get_privatekey(const SSL *s)
3197 {
3198     if (s->cert != NULL)
3199         return (s->cert->key->privatekey);
3200     else
3201         return (NULL);
3202 }
3203
3204 X509 *SSL_CTX_get0_certificate(const SSL_CTX *ctx)
3205 {
3206     if (ctx->cert != NULL)
3207         return ctx->cert->key->x509;
3208     else
3209         return NULL;
3210 }
3211
3212 EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx)
3213 {
3214     if (ctx->cert != NULL)
3215         return ctx->cert->key->privatekey;
3216     else
3217         return NULL;
3218 }
3219
3220 const SSL_CIPHER *SSL_get_current_cipher(const SSL *s)
3221 {
3222     if ((s->session != NULL) && (s->session->cipher != NULL))
3223         return (s->session->cipher);
3224     return (NULL);
3225 }
3226
3227 const COMP_METHOD *SSL_get_current_compression(SSL *s)
3228 {
3229 #ifndef OPENSSL_NO_COMP
3230     return s->compress ? COMP_CTX_get_method(s->compress) : NULL;
3231 #else
3232     return NULL;
3233 #endif
3234 }
3235
3236 const COMP_METHOD *SSL_get_current_expansion(SSL *s)
3237 {
3238 #ifndef OPENSSL_NO_COMP
3239     return s->expand ? COMP_CTX_get_method(s->expand) : NULL;
3240 #else
3241     return NULL;
3242 #endif
3243 }
3244
3245 int ssl_init_wbio_buffer(SSL *s, int push)
3246 {
3247     BIO *bbio;
3248
3249     if (s->bbio == NULL) {
3250         bbio = BIO_new(BIO_f_buffer());
3251         if (bbio == NULL)
3252             return (0);
3253         s->bbio = bbio;
3254     } else {
3255         bbio = s->bbio;
3256         if (s->bbio == s->wbio)
3257             s->wbio = BIO_pop(s->wbio);
3258     }
3259     (void)BIO_reset(bbio);
3260 /*      if (!BIO_set_write_buffer_size(bbio,16*1024)) */
3261     if (!BIO_set_read_buffer_size(bbio, 1)) {
3262         SSLerr(SSL_F_SSL_INIT_WBIO_BUFFER, ERR_R_BUF_LIB);
3263         return (0);
3264     }
3265     if (push) {
3266         if (s->wbio != bbio)
3267             s->wbio = BIO_push(bbio, s->wbio);
3268     } else {
3269         if (s->wbio == bbio)
3270             s->wbio = BIO_pop(bbio);
3271     }
3272     return (1);
3273 }
3274
3275 void ssl_free_wbio_buffer(SSL *s)
3276 {
3277     /* callers ensure s is never null */
3278     if (s->bbio == NULL)
3279         return;
3280
3281     if (s->bbio == s->wbio) {
3282         /* remove buffering */
3283         s->wbio = BIO_pop(s->wbio);
3284 #ifdef REF_DEBUG
3285         /*
3286          * not the usual REF_DEBUG, but this avoids
3287          * adding one more preprocessor symbol
3288          */
3289         assert(s->wbio != NULL);
3290 #endif
3291     }
3292     BIO_free(s->bbio);
3293     s->bbio = NULL;
3294 }
3295
3296 void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode)
3297 {
3298     ctx->quiet_shutdown = mode;
3299 }
3300
3301 int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx)
3302 {
3303     return (ctx->quiet_shutdown);
3304 }
3305
3306 void SSL_set_quiet_shutdown(SSL *s, int mode)
3307 {
3308     s->quiet_shutdown = mode;
3309 }
3310
3311 int SSL_get_quiet_shutdown(const SSL *s)
3312 {
3313     return (s->quiet_shutdown);
3314 }
3315
3316 void SSL_set_shutdown(SSL *s, int mode)
3317 {
3318     s->shutdown = mode;
3319 }
3320
3321 int SSL_get_shutdown(const SSL *s)
3322 {
3323     return (s->shutdown);
3324 }
3325
3326 int SSL_version(const SSL *s)
3327 {
3328     return (s->version);
3329 }
3330
3331 SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl)
3332 {
3333     return (ssl->ctx);
3334 }
3335
3336 SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx)
3337 {
3338     CERT *new_cert;
3339     if (ssl->ctx == ctx)
3340         return ssl->ctx;
3341     if (ctx == NULL)
3342         ctx = ssl->initial_ctx;
3343     new_cert = ssl_cert_dup(ctx->cert);
3344     if (new_cert == NULL) {
3345         return NULL;
3346     }
3347     ssl_cert_free(ssl->cert);
3348     ssl->cert = new_cert;
3349
3350     /*
3351      * Program invariant: |sid_ctx| has fixed size (SSL_MAX_SID_CTX_LENGTH),
3352      * so setter APIs must prevent invalid lengths from entering the system.
3353      */
3354     OPENSSL_assert(ssl->sid_ctx_length <= sizeof(ssl->sid_ctx));
3355
3356     /*
3357      * If the session ID context matches that of the parent SSL_CTX,
3358      * inherit it from the new SSL_CTX as well. If however the context does
3359      * not match (i.e., it was set per-ssl with SSL_set_session_id_context),
3360      * leave it unchanged.
3361      */
3362     if ((ssl->ctx != NULL) &&
3363         (ssl->sid_ctx_length == ssl->ctx->sid_ctx_length) &&
3364         (memcmp(ssl->sid_ctx, ssl->ctx->sid_ctx, ssl->sid_ctx_length) == 0)) {
3365         ssl->sid_ctx_length = ctx->sid_ctx_length;
3366         memcpy(&ssl->sid_ctx, &ctx->sid_ctx, sizeof(ssl->sid_ctx));
3367     }
3368
3369     CRYPTO_add(&ctx->references, 1, CRYPTO_LOCK_SSL_CTX);
3370     SSL_CTX_free(ssl->ctx); /* decrement reference count */
3371     ssl->ctx = ctx;
3372
3373     return (ssl->ctx);
3374 }
3375
3376 int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx)
3377 {
3378     return (X509_STORE_set_default_paths(ctx->cert_store));
3379 }
3380
3381 int SSL_CTX_set_default_verify_dir(SSL_CTX *ctx)
3382 {
3383     X509_LOOKUP *lookup;
3384
3385     lookup = X509_STORE_add_lookup(ctx->cert_store, X509_LOOKUP_hash_dir());
3386     if (lookup == NULL)
3387         return 0;
3388     X509_LOOKUP_add_dir(lookup, NULL, X509_FILETYPE_DEFAULT);
3389
3390     /* Clear any errors if the default directory does not exist */
3391     ERR_clear_error();
3392
3393     return 1;
3394 }
3395
3396 int SSL_CTX_set_default_verify_file(SSL_CTX *ctx)
3397 {
3398     X509_LOOKUP *lookup;
3399
3400     lookup = X509_STORE_add_lookup(ctx->cert_store, X509_LOOKUP_file());
3401     if (lookup == NULL)
3402         return 0;
3403
3404     X509_LOOKUP_load_file(lookup, NULL, X509_FILETYPE_DEFAULT);
3405
3406     /* Clear any errors if the default file does not exist */
3407     ERR_clear_error();
3408
3409     return 1;
3410 }
3411
3412 int SSL_CTX_load_verify_locations(SSL_CTX *ctx, const char *CAfile,
3413                                   const char *CApath)
3414 {
3415     return (X509_STORE_load_locations(ctx->cert_store, CAfile, CApath));
3416 }
3417
3418 void SSL_set_info_callback(SSL *ssl,
3419                            void (*cb) (const SSL *ssl, int type, int val))
3420 {
3421     ssl->info_callback = cb;
3422 }
3423
3424 /*
3425  * One compiler (Diab DCC) doesn't like argument names in returned function
3426  * pointer.
3427  */
3428 void (*SSL_get_info_callback(const SSL *ssl)) (const SSL * /* ssl */ ,
3429                                                int /* type */ ,
3430                                                int /* val */ ) {
3431     return ssl->info_callback;
3432 }
3433
3434 void SSL_set_verify_result(SSL *ssl, long arg)
3435 {
3436     ssl->verify_result = arg;
3437 }
3438
3439 long SSL_get_verify_result(const SSL *ssl)
3440 {
3441     return (ssl->verify_result);
3442 }
3443
3444 size_t SSL_get_client_random(const SSL *ssl, unsigned char *out, size_t outlen)
3445 {
3446     if (outlen == 0)
3447         return sizeof(ssl->s3->client_random);
3448     if (outlen > sizeof(ssl->s3->client_random))
3449         outlen = sizeof(ssl->s3->client_random);
3450     memcpy(out, ssl->s3->client_random, outlen);
3451     return outlen;
3452 }
3453
3454 size_t SSL_get_server_random(const SSL *ssl, unsigned char *out, size_t outlen)
3455 {
3456     if (outlen == 0)
3457         return sizeof(ssl->s3->server_random);
3458     if (outlen > sizeof(ssl->s3->server_random))
3459         outlen = sizeof(ssl->s3->server_random);
3460     memcpy(out, ssl->s3->server_random, outlen);
3461     return outlen;
3462 }
3463
3464 size_t SSL_SESSION_get_master_key(const SSL_SESSION *session,
3465                                unsigned char *out, size_t outlen)
3466 {
3467     if (session->master_key_length < 0) {
3468         /* Should never happen */
3469         return 0;
3470     }
3471     if (outlen == 0)
3472         return session->master_key_length;
3473     if (outlen > (size_t)session->master_key_length)
3474         outlen = session->master_key_length;
3475     memcpy(out, session->master_key, outlen);
3476     return outlen;
3477 }
3478
3479 int SSL_set_ex_data(SSL *s, int idx, void *arg)
3480 {
3481     return (CRYPTO_set_ex_data(&s->ex_data, idx, arg));
3482 }
3483
3484 void *SSL_get_ex_data(const SSL *s, int idx)
3485 {
3486     return (CRYPTO_get_ex_data(&s->ex_data, idx));
3487 }
3488
3489 int SSL_CTX_set_ex_data(SSL_CTX *s, int idx, void *arg)
3490 {
3491     return (CRYPTO_set_ex_data(&s->ex_data, idx, arg));
3492 }
3493
3494 void *SSL_CTX_get_ex_data(const SSL_CTX *s, int idx)
3495 {
3496     return (CRYPTO_get_ex_data(&s->ex_data, idx));
3497 }
3498
3499 int ssl_ok(SSL *s)
3500 {
3501     return (1);
3502 }
3503
3504 X509_STORE *SSL_CTX_get_cert_store(const SSL_CTX *ctx)
3505 {
3506     return (ctx->cert_store);
3507 }
3508
3509 void SSL_CTX_set_cert_store(SSL_CTX *ctx, X509_STORE *store)
3510 {
3511     X509_STORE_free(ctx->cert_store);
3512     ctx->cert_store = store;
3513 }
3514
3515 int SSL_want(const SSL *s)
3516 {
3517     return (s->rwstate);
3518 }
3519
3520 /**
3521  * \brief Set the callback for generating temporary DH keys.
3522  * \param ctx the SSL context.
3523  * \param dh the callback
3524  */
3525
3526 #ifndef OPENSSL_NO_DH
3527 void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
3528                                  DH *(*dh) (SSL *ssl, int is_export,
3529                                             int keylength))
3530 {
3531     SSL_CTX_callback_ctrl(ctx, SSL_CTRL_SET_TMP_DH_CB, (void (*)(void))dh);
3532 }
3533
3534 void SSL_set_tmp_dh_callback(SSL *ssl, DH *(*dh) (SSL *ssl, int is_export,
3535                                                   int keylength))
3536 {
3537     SSL_callback_ctrl(ssl, SSL_CTRL_SET_TMP_DH_CB, (void (*)(void))dh);
3538 }
3539 #endif
3540
3541 #ifndef OPENSSL_NO_PSK
3542 int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint)
3543 {
3544     if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
3545         SSLerr(SSL_F_SSL_CTX_USE_PSK_IDENTITY_HINT,
3546                SSL_R_DATA_LENGTH_TOO_LONG);
3547         return 0;
3548     }
3549     OPENSSL_free(ctx->cert->psk_identity_hint);
3550     if (identity_hint != NULL) {
3551         ctx->cert->psk_identity_hint = OPENSSL_strdup(identity_hint);
3552         if (ctx->cert->psk_identity_hint == NULL)
3553             return 0;
3554     } else
3555         ctx->cert->psk_identity_hint = NULL;
3556     return 1;
3557 }
3558
3559 int SSL_use_psk_identity_hint(SSL *s, const char *identity_hint)
3560 {
3561     if (s == NULL)
3562         return 0;
3563
3564     if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
3565         SSLerr(SSL_F_SSL_USE_PSK_IDENTITY_HINT, SSL_R_DATA_LENGTH_TOO_LONG);
3566         return 0;
3567     }
3568     OPENSSL_free(s->cert->psk_identity_hint);
3569     if (identity_hint != NULL) {
3570         s->cert->psk_identity_hint = OPENSSL_strdup(identity_hint);
3571         if (s->cert->psk_identity_hint == NULL)
3572             return 0;
3573     } else
3574         s->cert->psk_identity_hint = NULL;
3575     return 1;
3576 }
3577
3578 const char *SSL_get_psk_identity_hint(const SSL *s)
3579 {
3580     if (s == NULL || s->session == NULL)
3581         return NULL;
3582     return (s->session->psk_identity_hint);
3583 }
3584
3585 const char *SSL_get_psk_identity(const SSL *s)
3586 {
3587     if (s == NULL || s->session == NULL)
3588         return NULL;
3589     return (s->session->psk_identity);
3590 }
3591
3592 void SSL_set_psk_client_callback(SSL *s,
3593                                  unsigned int (*cb) (SSL *ssl,
3594                                                      const char *hint,
3595                                                      char *identity,
3596                                                      unsigned int
3597                                                      max_identity_len,
3598                                                      unsigned char *psk,
3599                                                      unsigned int
3600                                                      max_psk_len))
3601 {
3602     s->psk_client_callback = cb;
3603 }
3604
3605 void SSL_CTX_set_psk_client_callback(SSL_CTX *ctx,
3606                                      unsigned int (*cb) (SSL *ssl,
3607                                                          const char *hint,
3608                                                          char *identity,
3609                                                          unsigned int
3610                                                          max_identity_len,
3611                                                          unsigned char *psk,
3612                                                          unsigned int
3613                                                          max_psk_len))
3614 {
3615     ctx->psk_client_callback = cb;
3616 }
3617
3618 void SSL_set_psk_server_callback(SSL *s,
3619                                  unsigned int (*cb) (SSL *ssl,
3620                                                      const char *identity,
3621                                                      unsigned char *psk,
3622                                                      unsigned int
3623                                                      max_psk_len))
3624 {
3625     s->psk_server_callback = cb;
3626 }
3627
3628 void SSL_CTX_set_psk_server_callback(SSL_CTX *ctx,
3629                                      unsigned int (*cb) (SSL *ssl,
3630                                                          const char *identity,
3631                                                          unsigned char *psk,
3632                                                          unsigned int
3633                                                          max_psk_len))
3634 {
3635     ctx->psk_server_callback = cb;
3636 }
3637 #endif
3638
3639 void SSL_CTX_set_msg_callback(SSL_CTX *ctx,
3640                               void (*cb) (int write_p, int version,
3641                                           int content_type, const void *buf,
3642                                           size_t len, SSL *ssl, void *arg))
3643 {
3644     SSL_CTX_callback_ctrl(ctx, SSL_CTRL_SET_MSG_CALLBACK, (void (*)(void))cb);
3645 }
3646
3647 void SSL_set_msg_callback(SSL *ssl,
3648                           void (*cb) (int write_p, int version,
3649                                       int content_type, const void *buf,
3650                                       size_t len, SSL *ssl, void *arg))
3651 {
3652     SSL_callback_ctrl(ssl, SSL_CTRL_SET_MSG_CALLBACK, (void (*)(void))cb);
3653 }
3654
3655 void SSL_CTX_set_not_resumable_session_callback(SSL_CTX *ctx,
3656                                                 int (*cb) (SSL *ssl,
3657                                                            int
3658                                                            is_forward_secure))
3659 {
3660     SSL_CTX_callback_ctrl(ctx, SSL_CTRL_SET_NOT_RESUMABLE_SESS_CB,
3661                           (void (*)(void))cb);
3662 }
3663
3664 void SSL_set_not_resumable_session_callback(SSL *ssl,
3665                                             int (*cb) (SSL *ssl,
3666                                                        int is_forward_secure))
3667 {
3668     SSL_callback_ctrl(ssl, SSL_CTRL_SET_NOT_RESUMABLE_SESS_CB,
3669                       (void (*)(void))cb);
3670 }
3671
3672 /*
3673  * Allocates new EVP_MD_CTX and sets pointer to it into given pointer
3674  * vairable, freeing EVP_MD_CTX previously stored in that variable, if any.
3675  * If EVP_MD pointer is passed, initializes ctx with this md Returns newly
3676  * allocated ctx;
3677  */
3678
3679 EVP_MD_CTX *ssl_replace_hash(EVP_MD_CTX **hash, const EVP_MD *md)
3680 {
3681     ssl_clear_hash_ctx(hash);
3682     *hash = EVP_MD_CTX_new();
3683     if (*hash == NULL || (md && EVP_DigestInit_ex(*hash, md, NULL) <= 0)) {
3684         EVP_MD_CTX_free(*hash);
3685         *hash = NULL;
3686         return NULL;
3687     }
3688     return *hash;
3689 }
3690
3691 void ssl_clear_hash_ctx(EVP_MD_CTX **hash)
3692 {
3693
3694     if (*hash)
3695         EVP_MD_CTX_free(*hash);
3696     *hash = NULL;
3697 }
3698
3699 /* Retrieve handshake hashes */
3700 int ssl_handshake_hash(SSL *s, unsigned char *out, int outlen)
3701 {
3702     EVP_MD_CTX *ctx = NULL;
3703     EVP_MD_CTX *hdgst = s->s3->handshake_dgst;
3704     int ret = EVP_MD_CTX_size(hdgst);
3705     if (ret < 0 || ret > outlen) {
3706         ret = 0;
3707         goto err;
3708     }
3709     ctx = EVP_MD_CTX_new();
3710     if (ctx == NULL) {
3711         ret = 0;
3712         goto err;
3713     }
3714     if (!EVP_MD_CTX_copy_ex(ctx, hdgst)
3715         || EVP_DigestFinal_ex(ctx, out, NULL) <= 0)
3716         ret = 0;
3717  err:
3718     EVP_MD_CTX_free(ctx);
3719     return ret;
3720 }
3721
3722 int SSL_session_reused(SSL *s)
3723 {
3724     return s->hit;
3725 }
3726
3727 int SSL_is_server(SSL *s)
3728 {
3729     return s->server;
3730 }
3731
3732 #if OPENSSL_API_COMPAT < 0x10100000L
3733 void SSL_set_debug(SSL *s, int debug)
3734 {
3735     /* Old function was do-nothing anyway... */
3736     (void)s;
3737     (void)debug;
3738 }
3739 #endif
3740
3741
3742 void SSL_set_security_level(SSL *s, int level)
3743 {
3744     s->cert->sec_level = level;
3745 }
3746
3747 int SSL_get_security_level(const SSL *s)
3748 {
3749     return s->cert->sec_level;
3750 }
3751
3752 void SSL_set_security_callback(SSL *s,
3753                                int (*cb) (SSL *s, SSL_CTX *ctx, int op,
3754                                           int bits, int nid, void *other,
3755                                           void *ex))
3756 {
3757     s->cert->sec_cb = cb;
3758 }
3759
3760 int (*SSL_get_security_callback(const SSL *s)) (SSL *s, SSL_CTX *ctx, int op,
3761                                                 int bits, int nid,
3762                                                 void *other, void *ex) {
3763     return s->cert->sec_cb;
3764 }
3765
3766 void SSL_set0_security_ex_data(SSL *s, void *ex)
3767 {
3768     s->cert->sec_ex = ex;
3769 }
3770
3771 void *SSL_get0_security_ex_data(const SSL *s)
3772 {
3773     return s->cert->sec_ex;
3774 }
3775
3776 void SSL_CTX_set_security_level(SSL_CTX *ctx, int level)
3777 {
3778     ctx->cert->sec_level = level;
3779 }
3780
3781 int SSL_CTX_get_security_level(const SSL_CTX *ctx)
3782 {
3783     return ctx->cert->sec_level;
3784 }
3785
3786 void SSL_CTX_set_security_callback(SSL_CTX *ctx,
3787                                    int (*cb) (SSL *s, SSL_CTX *ctx, int op,
3788                                               int bits, int nid, void *other,
3789                                               void *ex))
3790 {
3791     ctx->cert->sec_cb = cb;
3792 }
3793
3794 int (*SSL_CTX_get_security_callback(const SSL_CTX *ctx)) (SSL *s,
3795                                                           SSL_CTX *ctx,
3796                                                           int op, int bits,
3797                                                           int nid,
3798                                                           void *other,
3799                                                           void *ex) {
3800     return ctx->cert->sec_cb;
3801 }
3802
3803 void SSL_CTX_set0_security_ex_data(SSL_CTX *ctx, void *ex)
3804 {
3805     ctx->cert->sec_ex = ex;
3806 }
3807
3808 void *SSL_CTX_get0_security_ex_data(const SSL_CTX *ctx)
3809 {
3810     return ctx->cert->sec_ex;
3811 }
3812
3813
3814 /*
3815  * Get/Set/Clear options in SSL_CTX or SSL, formerly macros, now functions that
3816  * can return unsigned long, instead of the generic long return value from the
3817  * control interface.
3818  */
3819 unsigned long SSL_CTX_get_options(const SSL_CTX *ctx)
3820 {
3821     return ctx->options;
3822 }
3823 unsigned long SSL_get_options(const SSL* s)
3824 {
3825     return s->options;
3826 }
3827 unsigned long SSL_CTX_set_options(SSL_CTX *ctx, unsigned long op)
3828 {
3829     return ctx->options |= op;
3830 }
3831 unsigned long SSL_set_options(SSL *s, unsigned long op)
3832 {
3833     return s->options |= op;
3834 }
3835 unsigned long SSL_CTX_clear_options(SSL_CTX *ctx, unsigned long op)
3836 {
3837     return ctx->options &= ~op;
3838 }
3839 unsigned long SSL_clear_options(SSL *s, unsigned long op)
3840 {
3841     return s->options &= ~op;
3842 }