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