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