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->early_data_state != SSL_EARLY_DATA_NONE
1549             && s->early_data_state != SSL_EARLY_DATA_FINISHED_WRITING
1550             && s->early_data_state != SSL_EARLY_DATA_FINISHED_READING
1551             && s->early_data_state != SSL_EARLY_DATA_READING) {
1552         SSLerr(SSL_F_SSL_READ_INTERNAL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1553         return 0;
1554     }
1555
1556     if ((s->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
1557         struct ssl_async_args args;
1558         int ret;
1559
1560         args.s = s;
1561         args.buf = buf;
1562         args.num = num;
1563         args.type = READFUNC;
1564         args.f.func_read = s->method->ssl_read;
1565
1566         ret = ssl_start_async_job(s, &args, ssl_io_intern);
1567         *readbytes = s->asyncrw;
1568         return ret;
1569     } else {
1570         return s->method->ssl_read(s, buf, num, readbytes);
1571     }
1572 }
1573
1574 int SSL_read(SSL *s, void *buf, int num)
1575 {
1576     int ret;
1577     size_t readbytes;
1578
1579     if (num < 0) {
1580         SSLerr(SSL_F_SSL_READ, SSL_R_BAD_LENGTH);
1581         return -1;
1582     }
1583
1584     ret = ssl_read_internal(s, buf, (size_t)num, &readbytes);
1585
1586     /*
1587      * The cast is safe here because ret should be <= INT_MAX because num is
1588      * <= INT_MAX
1589      */
1590     if (ret > 0)
1591         ret = (int)readbytes;
1592
1593     return ret;
1594 }
1595
1596 int SSL_read_ex(SSL *s, void *buf, size_t num, size_t *readbytes)
1597 {
1598     int ret = ssl_read_internal(s, buf, num, readbytes);
1599
1600     if (ret < 0)
1601         ret = 0;
1602     return ret;
1603 }
1604
1605 int SSL_read_early(SSL *s, void *buf, size_t num, size_t *readbytes)
1606 {
1607     int ret;
1608
1609     if (!s->server) {
1610         SSLerr(SSL_F_SSL_READ_EARLY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1611         return SSL_READ_EARLY_ERROR;
1612     }
1613
1614     switch (s->early_data_state) {
1615     case SSL_EARLY_DATA_NONE:
1616         if (!SSL_in_before(s)) {
1617             SSLerr(SSL_F_SSL_READ_EARLY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1618             return SSL_READ_EARLY_ERROR;
1619         }
1620         /* fall through */
1621
1622     case SSL_EARLY_DATA_ACCEPT_RETRY:
1623         s->early_data_state = SSL_EARLY_DATA_ACCEPTING;
1624         ret = SSL_accept(s);
1625         if (ret <= 0) {
1626             /* NBIO or error */
1627             s->early_data_state = SSL_EARLY_DATA_ACCEPT_RETRY;
1628             return SSL_READ_EARLY_ERROR;
1629         }
1630         /* fall through */
1631
1632     case SSL_EARLY_DATA_READ_RETRY:
1633         if (s->ext.early_data == SSL_EARLY_DATA_ACCEPTED) {
1634             s->early_data_state = SSL_EARLY_DATA_READING;
1635             ret = SSL_read_ex(s, buf, num, readbytes);
1636             /*
1637              * Record layer will call ssl_end_of_early_data_seen() if we see
1638              * that alert - which updates the early_data_state to
1639              * SSL_EARLY_DATA_FINISHED_READING
1640              */
1641             if (ret > 0 || (ret <= 0 && s->early_data_state
1642                                         != SSL_EARLY_DATA_FINISHED_READING)) {
1643                 s->early_data_state = SSL_EARLY_DATA_READ_RETRY;
1644                 return ret > 0 ? SSL_READ_EARLY_SUCCESS : SSL_READ_EARLY_ERROR;
1645             }
1646         } else {
1647             s->early_data_state = SSL_EARLY_DATA_FINISHED_READING;
1648         }
1649         *readbytes = 0;
1650         ossl_statem_set_in_init(s, 1);
1651         return SSL_READ_EARLY_FINISH;
1652
1653     default:
1654         SSLerr(SSL_F_SSL_READ_EARLY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1655         return SSL_READ_EARLY_ERROR;
1656     }
1657 }
1658
1659 int ssl_end_of_early_data_seen(SSL *s)
1660 {
1661     if (s->early_data_state == SSL_EARLY_DATA_READING) {
1662         s->early_data_state = SSL_EARLY_DATA_FINISHED_READING;
1663         ossl_statem_finish_early_data(s);
1664         return 1;
1665     }
1666
1667     return 0;
1668 }
1669
1670 int SSL_get_early_data_status(const SSL *s)
1671 {
1672     return s->ext.early_data;
1673 }
1674
1675 static int ssl_peek_internal(SSL *s, void *buf, size_t num, size_t *readbytes)
1676 {
1677     if (s->handshake_func == NULL) {
1678         SSLerr(SSL_F_SSL_PEEK_INTERNAL, SSL_R_UNINITIALIZED);
1679         return -1;
1680     }
1681
1682     if (s->shutdown & SSL_RECEIVED_SHUTDOWN) {
1683         return 0;
1684     }
1685     if ((s->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
1686         struct ssl_async_args args;
1687         int ret;
1688
1689         args.s = s;
1690         args.buf = buf;
1691         args.num = num;
1692         args.type = READFUNC;
1693         args.f.func_read = s->method->ssl_peek;
1694
1695         ret = ssl_start_async_job(s, &args, ssl_io_intern);
1696         *readbytes = s->asyncrw;
1697         return ret;
1698     } else {
1699         return s->method->ssl_peek(s, buf, num, readbytes);
1700     }
1701 }
1702
1703 int SSL_peek(SSL *s, void *buf, int num)
1704 {
1705     int ret;
1706     size_t readbytes;
1707
1708     if (num < 0) {
1709         SSLerr(SSL_F_SSL_PEEK, SSL_R_BAD_LENGTH);
1710         return -1;
1711     }
1712
1713     ret = ssl_peek_internal(s, buf, (size_t)num, &readbytes);
1714
1715     /*
1716      * The cast is safe here because ret should be <= INT_MAX because num is
1717      * <= INT_MAX
1718      */
1719     if (ret > 0)
1720         ret = (int)readbytes;
1721
1722     return ret;
1723 }
1724
1725
1726 int SSL_peek_ex(SSL *s, void *buf, size_t num, size_t *readbytes)
1727 {
1728     int ret = ssl_peek_internal(s, buf, num, readbytes);
1729
1730     if (ret < 0)
1731         ret = 0;
1732     return ret;
1733 }
1734
1735 int ssl_write_internal(SSL *s, const void *buf, size_t num, size_t *written)
1736 {
1737     if (s->handshake_func == NULL) {
1738         SSLerr(SSL_F_SSL_WRITE_INTERNAL, SSL_R_UNINITIALIZED);
1739         return -1;
1740     }
1741
1742     if (s->shutdown & SSL_SENT_SHUTDOWN) {
1743         s->rwstate = SSL_NOTHING;
1744         SSLerr(SSL_F_SSL_WRITE_INTERNAL, SSL_R_PROTOCOL_IS_SHUTDOWN);
1745         return -1;
1746     }
1747
1748     if (s->early_data_state != SSL_EARLY_DATA_NONE
1749             && s->early_data_state != SSL_EARLY_DATA_FINISHED_WRITING
1750             && s->early_data_state != SSL_EARLY_DATA_FINISHED_READING
1751             && s->early_data_state != SSL_EARLY_DATA_WRITING) {
1752         SSLerr(SSL_F_SSL_WRITE_INTERNAL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1753         return 0;
1754     }
1755
1756     if ((s->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
1757         int ret;
1758         struct ssl_async_args args;
1759
1760         args.s = s;
1761         args.buf = (void *)buf;
1762         args.num = num;
1763         args.type = WRITEFUNC;
1764         args.f.func_write = s->method->ssl_write;
1765
1766         ret = ssl_start_async_job(s, &args, ssl_io_intern);
1767         *written = s->asyncrw;
1768         return ret;
1769     } else {
1770         return s->method->ssl_write(s, buf, num, written);
1771     }
1772 }
1773
1774 int SSL_write(SSL *s, const void *buf, int num)
1775 {
1776     int ret;
1777     size_t written;
1778
1779     if (num < 0) {
1780         SSLerr(SSL_F_SSL_WRITE, SSL_R_BAD_LENGTH);
1781         return -1;
1782     }
1783
1784     ret = ssl_write_internal(s, buf, (size_t)num, &written);
1785
1786     /*
1787      * The cast is safe here because ret should be <= INT_MAX because num is
1788      * <= INT_MAX
1789      */
1790     if (ret > 0)
1791         ret = (int)written;
1792
1793     return ret;
1794 }
1795
1796 int SSL_write_ex(SSL *s, const void *buf, size_t num, size_t *written)
1797 {
1798     int ret = ssl_write_internal(s, buf, num, written);
1799
1800     if (ret < 0)
1801         ret = 0;
1802     return ret;
1803 }
1804
1805 int SSL_write_early(SSL *s, const void *buf, size_t num, size_t *written)
1806 {
1807     int ret;
1808
1809     if (s->server) {
1810         SSLerr(SSL_F_SSL_WRITE_EARLY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1811         return 0;
1812     }
1813
1814     switch (s->early_data_state) {
1815     case SSL_EARLY_DATA_NONE:
1816         if (!SSL_in_before(s)
1817                 || s->session == NULL
1818                 || s->session->ext.max_early_data == 0) {
1819             SSLerr(SSL_F_SSL_WRITE_EARLY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1820             return 0;
1821         }
1822         /* fall through */
1823
1824     case SSL_EARLY_DATA_CONNECT_RETRY:
1825         s->early_data_state = SSL_EARLY_DATA_CONNECTING;
1826         ret = SSL_connect(s);
1827         if (ret <= 0) {
1828             /* NBIO or error */
1829             s->early_data_state = SSL_EARLY_DATA_CONNECT_RETRY;
1830             return 0;
1831         }
1832         /* fall through */
1833
1834     case SSL_EARLY_DATA_WRITE_RETRY:
1835         s->early_data_state = SSL_EARLY_DATA_WRITING;
1836         ret = SSL_write_ex(s, buf, num, written);
1837         s->early_data_state = SSL_EARLY_DATA_WRITE_RETRY;
1838         return ret;
1839
1840     default:
1841         SSLerr(SSL_F_SSL_WRITE_EARLY, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1842         return 0;
1843     }
1844 }
1845
1846 int SSL_write_early_finish(SSL *s)
1847 {
1848     int ret;
1849
1850     if (s->early_data_state != SSL_EARLY_DATA_WRITE_RETRY) {
1851         SSLerr(SSL_F_SSL_WRITE_EARLY_FINISH, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1852         return 0;
1853     }
1854
1855     s->early_data_state = SSL_EARLY_DATA_WRITING;
1856     ret = ssl3_send_alert(s, SSL3_AL_WARNING, SSL_AD_END_OF_EARLY_DATA);
1857     if (ret <= 0) {
1858         s->early_data_state = SSL_EARLY_DATA_WRITE_RETRY;
1859         return 0;
1860     }
1861     s->early_data_state = SSL_EARLY_DATA_FINISHED_WRITING;
1862     /*
1863      * We set the enc_write_ctx back to NULL because we may end up writing
1864      * in cleartext again if we get a HelloRetryRequest from the server.
1865      */
1866     EVP_CIPHER_CTX_free(s->enc_write_ctx);
1867     s->enc_write_ctx = NULL;
1868     ossl_statem_set_in_init(s, 1);
1869     return 1;
1870 }
1871
1872 int SSL_shutdown(SSL *s)
1873 {
1874     /*
1875      * Note that this function behaves differently from what one might
1876      * expect.  Return values are 0 for no success (yet), 1 for success; but
1877      * calling it once is usually not enough, even if blocking I/O is used
1878      * (see ssl3_shutdown).
1879      */
1880
1881     if (s->handshake_func == NULL) {
1882         SSLerr(SSL_F_SSL_SHUTDOWN, SSL_R_UNINITIALIZED);
1883         return -1;
1884     }
1885
1886     if (!SSL_in_init(s)) {
1887         if ((s->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
1888             struct ssl_async_args args;
1889
1890             args.s = s;
1891             args.type = OTHERFUNC;
1892             args.f.func_other = s->method->ssl_shutdown;
1893
1894             return ssl_start_async_job(s, &args, ssl_io_intern);
1895         } else {
1896             return s->method->ssl_shutdown(s);
1897         }
1898     } else {
1899         SSLerr(SSL_F_SSL_SHUTDOWN, SSL_R_SHUTDOWN_WHILE_IN_INIT);
1900         return -1;
1901     }
1902 }
1903
1904 int SSL_key_update(SSL *s, int updatetype)
1905 {
1906     /*
1907      * TODO(TLS1.3): How will applications know whether TLSv1.3 has been
1908      * negotiated, and that it is appropriate to call SSL_key_update() instead
1909      * of SSL_renegotiate().
1910      */
1911     if (!SSL_IS_TLS13(s)) {
1912         SSLerr(SSL_F_SSL_KEY_UPDATE, SSL_R_WRONG_SSL_VERSION);
1913         return 0;
1914     }
1915
1916     if (updatetype != SSL_KEY_UPDATE_NOT_REQUESTED
1917             && updatetype != SSL_KEY_UPDATE_REQUESTED) {
1918         SSLerr(SSL_F_SSL_KEY_UPDATE, SSL_R_INVALID_KEY_UPDATE_TYPE);
1919         return 0;
1920     }
1921
1922     if (!SSL_is_init_finished(s)) {
1923         SSLerr(SSL_F_SSL_KEY_UPDATE, SSL_R_STILL_IN_INIT);
1924         return 0;
1925     }
1926
1927     ossl_statem_set_in_init(s, 1);
1928     s->key_update = updatetype;
1929     return 1;
1930 }
1931
1932 int SSL_get_key_update_type(SSL *s)
1933 {
1934     return s->key_update;
1935 }
1936
1937 int SSL_renegotiate(SSL *s)
1938 {
1939     if (SSL_IS_TLS13(s)) {
1940         SSLerr(SSL_F_SSL_RENEGOTIATE, SSL_R_WRONG_SSL_VERSION);
1941         return 0;
1942     }
1943
1944     if (s->renegotiate == 0)
1945         s->renegotiate = 1;
1946
1947     s->new_session = 1;
1948
1949     return (s->method->ssl_renegotiate(s));
1950 }
1951
1952 int SSL_renegotiate_abbreviated(SSL *s)
1953 {
1954     if (SSL_IS_TLS13(s))
1955         return 0;
1956
1957     if (s->renegotiate == 0)
1958         s->renegotiate = 1;
1959
1960     s->new_session = 0;
1961
1962     return (s->method->ssl_renegotiate(s));
1963 }
1964
1965 int SSL_renegotiate_pending(SSL *s)
1966 {
1967     /*
1968      * becomes true when negotiation is requested; false again once a
1969      * handshake has finished
1970      */
1971     return (s->renegotiate != 0);
1972 }
1973
1974 long SSL_ctrl(SSL *s, int cmd, long larg, void *parg)
1975 {
1976     long l;
1977
1978     switch (cmd) {
1979     case SSL_CTRL_GET_READ_AHEAD:
1980         return (RECORD_LAYER_get_read_ahead(&s->rlayer));
1981     case SSL_CTRL_SET_READ_AHEAD:
1982         l = RECORD_LAYER_get_read_ahead(&s->rlayer);
1983         RECORD_LAYER_set_read_ahead(&s->rlayer, larg);
1984         return (l);
1985
1986     case SSL_CTRL_SET_MSG_CALLBACK_ARG:
1987         s->msg_callback_arg = parg;
1988         return 1;
1989
1990     case SSL_CTRL_MODE:
1991         return (s->mode |= larg);
1992     case SSL_CTRL_CLEAR_MODE:
1993         return (s->mode &= ~larg);
1994     case SSL_CTRL_GET_MAX_CERT_LIST:
1995         return (long)(s->max_cert_list);
1996     case SSL_CTRL_SET_MAX_CERT_LIST:
1997         if (larg < 0)
1998             return 0;
1999         l = (long)s->max_cert_list;
2000         s->max_cert_list = (size_t)larg;
2001         return l;
2002     case SSL_CTRL_SET_MAX_SEND_FRAGMENT:
2003         if (larg < 512 || larg > SSL3_RT_MAX_PLAIN_LENGTH)
2004             return 0;
2005         s->max_send_fragment = larg;
2006         if (s->max_send_fragment < s->split_send_fragment)
2007             s->split_send_fragment = s->max_send_fragment;
2008         return 1;
2009     case SSL_CTRL_SET_SPLIT_SEND_FRAGMENT:
2010         if ((size_t)larg > s->max_send_fragment || larg == 0)
2011             return 0;
2012         s->split_send_fragment = larg;
2013         return 1;
2014     case SSL_CTRL_SET_MAX_PIPELINES:
2015         if (larg < 1 || larg > SSL_MAX_PIPELINES)
2016             return 0;
2017         s->max_pipelines = larg;
2018         if (larg > 1)
2019             RECORD_LAYER_set_read_ahead(&s->rlayer, 1);
2020         return 1;
2021     case SSL_CTRL_GET_RI_SUPPORT:
2022         if (s->s3)
2023             return s->s3->send_connection_binding;
2024         else
2025             return 0;
2026     case SSL_CTRL_CERT_FLAGS:
2027         return (s->cert->cert_flags |= larg);
2028     case SSL_CTRL_CLEAR_CERT_FLAGS:
2029         return (s->cert->cert_flags &= ~larg);
2030
2031     case SSL_CTRL_GET_RAW_CIPHERLIST:
2032         if (parg) {
2033             if (s->s3->tmp.ciphers_raw == NULL)
2034                 return 0;
2035             *(unsigned char **)parg = s->s3->tmp.ciphers_raw;
2036             return (int)s->s3->tmp.ciphers_rawlen;
2037         } else {
2038             return TLS_CIPHER_LEN;
2039         }
2040     case SSL_CTRL_GET_EXTMS_SUPPORT:
2041         if (!s->session || SSL_in_init(s) || ossl_statem_get_in_handshake(s))
2042             return -1;
2043         if (s->session->flags & SSL_SESS_FLAG_EXTMS)
2044             return 1;
2045         else
2046             return 0;
2047     case SSL_CTRL_SET_MIN_PROTO_VERSION:
2048         return ssl_set_version_bound(s->ctx->method->version, (int)larg,
2049                                      &s->min_proto_version);
2050     case SSL_CTRL_SET_MAX_PROTO_VERSION:
2051         return ssl_set_version_bound(s->ctx->method->version, (int)larg,
2052                                      &s->max_proto_version);
2053     default:
2054         return (s->method->ssl_ctrl(s, cmd, larg, parg));
2055     }
2056 }
2057
2058 long SSL_callback_ctrl(SSL *s, int cmd, void (*fp) (void))
2059 {
2060     switch (cmd) {
2061     case SSL_CTRL_SET_MSG_CALLBACK:
2062         s->msg_callback = (void (*)
2063                            (int write_p, int version, int content_type,
2064                             const void *buf, size_t len, SSL *ssl,
2065                             void *arg))(fp);
2066         return 1;
2067
2068     default:
2069         return (s->method->ssl_callback_ctrl(s, cmd, fp));
2070     }
2071 }
2072
2073 LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx)
2074 {
2075     return ctx->sessions;
2076 }
2077
2078 long SSL_CTX_ctrl(SSL_CTX *ctx, int cmd, long larg, void *parg)
2079 {
2080     long l;
2081     /* For some cases with ctx == NULL perform syntax checks */
2082     if (ctx == NULL) {
2083         switch (cmd) {
2084 #ifndef OPENSSL_NO_EC
2085         case SSL_CTRL_SET_GROUPS_LIST:
2086             return tls1_set_groups_list(NULL, NULL, parg);
2087 #endif
2088         case SSL_CTRL_SET_SIGALGS_LIST:
2089         case SSL_CTRL_SET_CLIENT_SIGALGS_LIST:
2090             return tls1_set_sigalgs_list(NULL, parg, 0);
2091         default:
2092             return 0;
2093         }
2094     }
2095
2096     switch (cmd) {
2097     case SSL_CTRL_GET_READ_AHEAD:
2098         return (ctx->read_ahead);
2099     case SSL_CTRL_SET_READ_AHEAD:
2100         l = ctx->read_ahead;
2101         ctx->read_ahead = larg;
2102         return (l);
2103
2104     case SSL_CTRL_SET_MSG_CALLBACK_ARG:
2105         ctx->msg_callback_arg = parg;
2106         return 1;
2107
2108     case SSL_CTRL_GET_MAX_CERT_LIST:
2109         return (long)(ctx->max_cert_list);
2110     case SSL_CTRL_SET_MAX_CERT_LIST:
2111         if (larg < 0)
2112             return 0;
2113         l = (long)ctx->max_cert_list;
2114         ctx->max_cert_list = (size_t)larg;
2115         return l;
2116
2117     case SSL_CTRL_SET_SESS_CACHE_SIZE:
2118         if (larg < 0)
2119             return 0;
2120         l = (long)ctx->session_cache_size;
2121         ctx->session_cache_size = (size_t)larg;
2122         return l;
2123     case SSL_CTRL_GET_SESS_CACHE_SIZE:
2124         return (long)(ctx->session_cache_size);
2125     case SSL_CTRL_SET_SESS_CACHE_MODE:
2126         l = ctx->session_cache_mode;
2127         ctx->session_cache_mode = larg;
2128         return (l);
2129     case SSL_CTRL_GET_SESS_CACHE_MODE:
2130         return (ctx->session_cache_mode);
2131
2132     case SSL_CTRL_SESS_NUMBER:
2133         return (lh_SSL_SESSION_num_items(ctx->sessions));
2134     case SSL_CTRL_SESS_CONNECT:
2135         return (ctx->stats.sess_connect);
2136     case SSL_CTRL_SESS_CONNECT_GOOD:
2137         return (ctx->stats.sess_connect_good);
2138     case SSL_CTRL_SESS_CONNECT_RENEGOTIATE:
2139         return (ctx->stats.sess_connect_renegotiate);
2140     case SSL_CTRL_SESS_ACCEPT:
2141         return (ctx->stats.sess_accept);
2142     case SSL_CTRL_SESS_ACCEPT_GOOD:
2143         return (ctx->stats.sess_accept_good);
2144     case SSL_CTRL_SESS_ACCEPT_RENEGOTIATE:
2145         return (ctx->stats.sess_accept_renegotiate);
2146     case SSL_CTRL_SESS_HIT:
2147         return (ctx->stats.sess_hit);
2148     case SSL_CTRL_SESS_CB_HIT:
2149         return (ctx->stats.sess_cb_hit);
2150     case SSL_CTRL_SESS_MISSES:
2151         return (ctx->stats.sess_miss);
2152     case SSL_CTRL_SESS_TIMEOUTS:
2153         return (ctx->stats.sess_timeout);
2154     case SSL_CTRL_SESS_CACHE_FULL:
2155         return (ctx->stats.sess_cache_full);
2156     case SSL_CTRL_MODE:
2157         return (ctx->mode |= larg);
2158     case SSL_CTRL_CLEAR_MODE:
2159         return (ctx->mode &= ~larg);
2160     case SSL_CTRL_SET_MAX_SEND_FRAGMENT:
2161         if (larg < 512 || larg > SSL3_RT_MAX_PLAIN_LENGTH)
2162             return 0;
2163         ctx->max_send_fragment = larg;
2164         if (ctx->max_send_fragment < ctx->split_send_fragment)
2165             ctx->split_send_fragment = ctx->max_send_fragment;
2166         return 1;
2167     case SSL_CTRL_SET_SPLIT_SEND_FRAGMENT:
2168         if ((size_t)larg > ctx->max_send_fragment || larg == 0)
2169             return 0;
2170         ctx->split_send_fragment = larg;
2171         return 1;
2172     case SSL_CTRL_SET_MAX_PIPELINES:
2173         if (larg < 1 || larg > SSL_MAX_PIPELINES)
2174             return 0;
2175         ctx->max_pipelines = larg;
2176         return 1;
2177     case SSL_CTRL_CERT_FLAGS:
2178         return (ctx->cert->cert_flags |= larg);
2179     case SSL_CTRL_CLEAR_CERT_FLAGS:
2180         return (ctx->cert->cert_flags &= ~larg);
2181     case SSL_CTRL_SET_MIN_PROTO_VERSION:
2182         return ssl_set_version_bound(ctx->method->version, (int)larg,
2183                                      &ctx->min_proto_version);
2184     case SSL_CTRL_SET_MAX_PROTO_VERSION:
2185         return ssl_set_version_bound(ctx->method->version, (int)larg,
2186                                      &ctx->max_proto_version);
2187     default:
2188         return (ctx->method->ssl_ctx_ctrl(ctx, cmd, larg, parg));
2189     }
2190 }
2191
2192 long SSL_CTX_callback_ctrl(SSL_CTX *ctx, int cmd, void (*fp) (void))
2193 {
2194     switch (cmd) {
2195     case SSL_CTRL_SET_MSG_CALLBACK:
2196         ctx->msg_callback = (void (*)
2197                              (int write_p, int version, int content_type,
2198                               const void *buf, size_t len, SSL *ssl,
2199                               void *arg))(fp);
2200         return 1;
2201
2202     default:
2203         return (ctx->method->ssl_ctx_callback_ctrl(ctx, cmd, fp));
2204     }
2205 }
2206
2207 int ssl_cipher_id_cmp(const SSL_CIPHER *a, const SSL_CIPHER *b)
2208 {
2209     if (a->id > b->id)
2210         return 1;
2211     if (a->id < b->id)
2212         return -1;
2213     return 0;
2214 }
2215
2216 int ssl_cipher_ptr_id_cmp(const SSL_CIPHER *const *ap,
2217                           const SSL_CIPHER *const *bp)
2218 {
2219     if ((*ap)->id > (*bp)->id)
2220         return 1;
2221     if ((*ap)->id < (*bp)->id)
2222         return -1;
2223     return 0;
2224 }
2225
2226 /** return a STACK of the ciphers available for the SSL and in order of
2227  * preference */
2228 STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *s)
2229 {
2230     if (s != NULL) {
2231         if (s->cipher_list != NULL) {
2232             return (s->cipher_list);
2233         } else if ((s->ctx != NULL) && (s->ctx->cipher_list != NULL)) {
2234             return (s->ctx->cipher_list);
2235         }
2236     }
2237     return (NULL);
2238 }
2239
2240 STACK_OF(SSL_CIPHER) *SSL_get_client_ciphers(const SSL *s)
2241 {
2242     if ((s == NULL) || (s->session == NULL) || !s->server)
2243         return NULL;
2244     return s->session->ciphers;
2245 }
2246
2247 STACK_OF(SSL_CIPHER) *SSL_get1_supported_ciphers(SSL *s)
2248 {
2249     STACK_OF(SSL_CIPHER) *sk = NULL, *ciphers;
2250     int i;
2251     ciphers = SSL_get_ciphers(s);
2252     if (!ciphers)
2253         return NULL;
2254     ssl_set_client_disabled(s);
2255     for (i = 0; i < sk_SSL_CIPHER_num(ciphers); i++) {
2256         const SSL_CIPHER *c = sk_SSL_CIPHER_value(ciphers, i);
2257         if (!ssl_cipher_disabled(s, c, SSL_SECOP_CIPHER_SUPPORTED)) {
2258             if (!sk)
2259                 sk = sk_SSL_CIPHER_new_null();
2260             if (!sk)
2261                 return NULL;
2262             if (!sk_SSL_CIPHER_push(sk, c)) {
2263                 sk_SSL_CIPHER_free(sk);
2264                 return NULL;
2265             }
2266         }
2267     }
2268     return sk;
2269 }
2270
2271 /** return a STACK of the ciphers available for the SSL and in order of
2272  * algorithm id */
2273 STACK_OF(SSL_CIPHER) *ssl_get_ciphers_by_id(SSL *s)
2274 {
2275     if (s != NULL) {
2276         if (s->cipher_list_by_id != NULL) {
2277             return (s->cipher_list_by_id);
2278         } else if ((s->ctx != NULL) && (s->ctx->cipher_list_by_id != NULL)) {
2279             return (s->ctx->cipher_list_by_id);
2280         }
2281     }
2282     return (NULL);
2283 }
2284
2285 /** The old interface to get the same thing as SSL_get_ciphers() */
2286 const char *SSL_get_cipher_list(const SSL *s, int n)
2287 {
2288     const SSL_CIPHER *c;
2289     STACK_OF(SSL_CIPHER) *sk;
2290
2291     if (s == NULL)
2292         return (NULL);
2293     sk = SSL_get_ciphers(s);
2294     if ((sk == NULL) || (sk_SSL_CIPHER_num(sk) <= n))
2295         return (NULL);
2296     c = sk_SSL_CIPHER_value(sk, n);
2297     if (c == NULL)
2298         return (NULL);
2299     return (c->name);
2300 }
2301
2302 /** return a STACK of the ciphers available for the SSL_CTX and in order of
2303  * preference */
2304 STACK_OF(SSL_CIPHER) *SSL_CTX_get_ciphers(const SSL_CTX *ctx)
2305 {
2306     if (ctx != NULL)
2307         return ctx->cipher_list;
2308     return NULL;
2309 }
2310
2311 /** specify the ciphers to be used by default by the SSL_CTX */
2312 int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str)
2313 {
2314     STACK_OF(SSL_CIPHER) *sk;
2315
2316     sk = ssl_create_cipher_list(ctx->method, &ctx->cipher_list,
2317                                 &ctx->cipher_list_by_id, str, ctx->cert);
2318     /*
2319      * ssl_create_cipher_list may return an empty stack if it was unable to
2320      * find a cipher matching the given rule string (for example if the rule
2321      * string specifies a cipher which has been disabled). This is not an
2322      * error as far as ssl_create_cipher_list is concerned, and hence
2323      * ctx->cipher_list and ctx->cipher_list_by_id has been updated.
2324      */
2325     if (sk == NULL)
2326         return 0;
2327     else if (sk_SSL_CIPHER_num(sk) == 0) {
2328         SSLerr(SSL_F_SSL_CTX_SET_CIPHER_LIST, SSL_R_NO_CIPHER_MATCH);
2329         return 0;
2330     }
2331     return 1;
2332 }
2333
2334 /** specify the ciphers to be used by the SSL */
2335 int SSL_set_cipher_list(SSL *s, const char *str)
2336 {
2337     STACK_OF(SSL_CIPHER) *sk;
2338
2339     sk = ssl_create_cipher_list(s->ctx->method, &s->cipher_list,
2340                                 &s->cipher_list_by_id, str, s->cert);
2341     /* see comment in SSL_CTX_set_cipher_list */
2342     if (sk == NULL)
2343         return 0;
2344     else if (sk_SSL_CIPHER_num(sk) == 0) {
2345         SSLerr(SSL_F_SSL_SET_CIPHER_LIST, SSL_R_NO_CIPHER_MATCH);
2346         return 0;
2347     }
2348     return 1;
2349 }
2350
2351 char *SSL_get_shared_ciphers(const SSL *s, char *buf, int len)
2352 {
2353     char *p;
2354     STACK_OF(SSL_CIPHER) *sk;
2355     const SSL_CIPHER *c;
2356     int i;
2357
2358     if ((s->session == NULL) || (s->session->ciphers == NULL) || (len < 2))
2359         return (NULL);
2360
2361     p = buf;
2362     sk = s->session->ciphers;
2363
2364     if (sk_SSL_CIPHER_num(sk) == 0)
2365         return NULL;
2366
2367     for (i = 0; i < sk_SSL_CIPHER_num(sk); i++) {
2368         int n;
2369
2370         c = sk_SSL_CIPHER_value(sk, i);
2371         n = strlen(c->name);
2372         if (n + 1 > len) {
2373             if (p != buf)
2374                 --p;
2375             *p = '\0';
2376             return buf;
2377         }
2378         memcpy(p, c->name, n + 1);
2379         p += n;
2380         *(p++) = ':';
2381         len -= n + 1;
2382     }
2383     p[-1] = '\0';
2384     return (buf);
2385 }
2386
2387 /** return a servername extension value if provided in Client Hello, or NULL.
2388  * So far, only host_name types are defined (RFC 3546).
2389  */
2390
2391 const char *SSL_get_servername(const SSL *s, const int type)
2392 {
2393     if (type != TLSEXT_NAMETYPE_host_name)
2394         return NULL;
2395
2396     return s->session && !s->ext.hostname ?
2397         s->session->ext.hostname : s->ext.hostname;
2398 }
2399
2400 int SSL_get_servername_type(const SSL *s)
2401 {
2402     if (s->session
2403         && (!s->ext.hostname ? s->session->
2404             ext.hostname : s->ext.hostname))
2405         return TLSEXT_NAMETYPE_host_name;
2406     return -1;
2407 }
2408
2409 /*
2410  * SSL_select_next_proto implements the standard protocol selection. It is
2411  * expected that this function is called from the callback set by
2412  * SSL_CTX_set_next_proto_select_cb. The protocol data is assumed to be a
2413  * vector of 8-bit, length prefixed byte strings. The length byte itself is
2414  * not included in the length. A byte string of length 0 is invalid. No byte
2415  * string may be truncated. The current, but experimental algorithm for
2416  * selecting the protocol is: 1) If the server doesn't support NPN then this
2417  * is indicated to the callback. In this case, the client application has to
2418  * abort the connection or have a default application level protocol. 2) If
2419  * the server supports NPN, but advertises an empty list then the client
2420  * selects the first protocol in its list, but indicates via the API that this
2421  * fallback case was enacted. 3) Otherwise, the client finds the first
2422  * protocol in the server's list that it supports and selects this protocol.
2423  * This is because it's assumed that the server has better information about
2424  * which protocol a client should use. 4) If the client doesn't support any
2425  * of the server's advertised protocols, then this is treated the same as
2426  * case 2. It returns either OPENSSL_NPN_NEGOTIATED if a common protocol was
2427  * found, or OPENSSL_NPN_NO_OVERLAP if the fallback case was reached.
2428  */
2429 int SSL_select_next_proto(unsigned char **out, unsigned char *outlen,
2430                           const unsigned char *server,
2431                           unsigned int server_len,
2432                           const unsigned char *client, unsigned int client_len)
2433 {
2434     unsigned int i, j;
2435     const unsigned char *result;
2436     int status = OPENSSL_NPN_UNSUPPORTED;
2437
2438     /*
2439      * For each protocol in server preference order, see if we support it.
2440      */
2441     for (i = 0; i < server_len;) {
2442         for (j = 0; j < client_len;) {
2443             if (server[i] == client[j] &&
2444                 memcmp(&server[i + 1], &client[j + 1], server[i]) == 0) {
2445                 /* We found a match */
2446                 result = &server[i];
2447                 status = OPENSSL_NPN_NEGOTIATED;
2448                 goto found;
2449             }
2450             j += client[j];
2451             j++;
2452         }
2453         i += server[i];
2454         i++;
2455     }
2456
2457     /* There's no overlap between our protocols and the server's list. */
2458     result = client;
2459     status = OPENSSL_NPN_NO_OVERLAP;
2460
2461  found:
2462     *out = (unsigned char *)result + 1;
2463     *outlen = result[0];
2464     return status;
2465 }
2466
2467 #ifndef OPENSSL_NO_NEXTPROTONEG
2468 /*
2469  * SSL_get0_next_proto_negotiated sets *data and *len to point to the
2470  * client's requested protocol for this connection and returns 0. If the
2471  * client didn't request any protocol, then *data is set to NULL. Note that
2472  * the client can request any protocol it chooses. The value returned from
2473  * this function need not be a member of the list of supported protocols
2474  * provided by the callback.
2475  */
2476 void SSL_get0_next_proto_negotiated(const SSL *s, const unsigned char **data,
2477                                     unsigned *len)
2478 {
2479     *data = s->ext.npn;
2480     if (!*data) {
2481         *len = 0;
2482     } else {
2483         *len = (unsigned int)s->ext.npn_len;
2484     }
2485 }
2486
2487 /*
2488  * SSL_CTX_set_npn_advertised_cb sets a callback that is called when
2489  * a TLS server needs a list of supported protocols for Next Protocol
2490  * Negotiation. The returned list must be in wire format.  The list is
2491  * returned by setting |out| to point to it and |outlen| to its length. This
2492  * memory will not be modified, but one should assume that the SSL* keeps a
2493  * reference to it. The callback should return SSL_TLSEXT_ERR_OK if it
2494  * wishes to advertise. Otherwise, no such extension will be included in the
2495  * ServerHello.
2496  */
2497 void SSL_CTX_set_npn_advertised_cb(SSL_CTX *ctx,
2498                                    SSL_CTX_npn_advertised_cb_func cb,
2499                                    void *arg)
2500 {
2501     ctx->ext.npn_advertised_cb = cb;
2502     ctx->ext.npn_advertised_cb_arg = arg;
2503 }
2504
2505 /*
2506  * SSL_CTX_set_next_proto_select_cb sets a callback that is called when a
2507  * client needs to select a protocol from the server's provided list. |out|
2508  * must be set to point to the selected protocol (which may be within |in|).
2509  * The length of the protocol name must be written into |outlen|. The
2510  * server's advertised protocols are provided in |in| and |inlen|. The
2511  * callback can assume that |in| is syntactically valid. The client must
2512  * select a protocol. It is fatal to the connection if this callback returns
2513  * a value other than SSL_TLSEXT_ERR_OK.
2514  */
2515 void SSL_CTX_set_npn_select_cb(SSL_CTX *ctx,
2516                                SSL_CTX_npn_select_cb_func cb,
2517                                void *arg)
2518 {
2519     ctx->ext.npn_select_cb = cb;
2520     ctx->ext.npn_select_cb_arg = arg;
2521 }
2522 #endif
2523
2524 /*
2525  * SSL_CTX_set_alpn_protos sets the ALPN protocol list on |ctx| to |protos|.
2526  * |protos| must be in wire-format (i.e. a series of non-empty, 8-bit
2527  * length-prefixed strings). Returns 0 on success.
2528  */
2529 int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const unsigned char *protos,
2530                             unsigned int protos_len)
2531 {
2532     OPENSSL_free(ctx->ext.alpn);
2533     ctx->ext.alpn = OPENSSL_memdup(protos, protos_len);
2534     if (ctx->ext.alpn == NULL) {
2535         SSLerr(SSL_F_SSL_CTX_SET_ALPN_PROTOS, ERR_R_MALLOC_FAILURE);
2536         return 1;
2537     }
2538     ctx->ext.alpn_len = protos_len;
2539
2540     return 0;
2541 }
2542
2543 /*
2544  * SSL_set_alpn_protos sets the ALPN protocol list on |ssl| to |protos|.
2545  * |protos| must be in wire-format (i.e. a series of non-empty, 8-bit
2546  * length-prefixed strings). Returns 0 on success.
2547  */
2548 int SSL_set_alpn_protos(SSL *ssl, const unsigned char *protos,
2549                         unsigned int protos_len)
2550 {
2551     OPENSSL_free(ssl->ext.alpn);
2552     ssl->ext.alpn = OPENSSL_memdup(protos, protos_len);
2553     if (ssl->ext.alpn == NULL) {
2554         SSLerr(SSL_F_SSL_SET_ALPN_PROTOS, ERR_R_MALLOC_FAILURE);
2555         return 1;
2556     }
2557     ssl->ext.alpn_len = protos_len;
2558
2559     return 0;
2560 }
2561
2562 /*
2563  * SSL_CTX_set_alpn_select_cb sets a callback function on |ctx| that is
2564  * called during ClientHello processing in order to select an ALPN protocol
2565  * from the client's list of offered protocols.
2566  */
2567 void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,
2568                                 SSL_CTX_alpn_select_cb_func cb,
2569                                 void *arg)
2570 {
2571     ctx->ext.alpn_select_cb = cb;
2572     ctx->ext.alpn_select_cb_arg = arg;
2573 }
2574
2575 /*
2576  * SSL_get0_alpn_selected gets the selected ALPN protocol (if any) from
2577  * |ssl|. On return it sets |*data| to point to |*len| bytes of protocol name
2578  * (not including the leading length-prefix byte). If the server didn't
2579  * respond with a negotiated protocol then |*len| will be zero.
2580  */
2581 void SSL_get0_alpn_selected(const SSL *ssl, const unsigned char **data,
2582                             unsigned int *len)
2583 {
2584     *data = NULL;
2585     if (ssl->s3)
2586         *data = ssl->s3->alpn_selected;
2587     if (*data == NULL)
2588         *len = 0;
2589     else
2590         *len = (unsigned int)ssl->s3->alpn_selected_len;
2591 }
2592
2593 int SSL_export_keying_material(SSL *s, unsigned char *out, size_t olen,
2594                                const char *label, size_t llen,
2595                                const unsigned char *p, size_t plen,
2596                                int use_context)
2597 {
2598     if (s->version < TLS1_VERSION && s->version != DTLS1_BAD_VER)
2599         return -1;
2600
2601     return s->method->ssl3_enc->export_keying_material(s, out, olen, label,
2602                                                        llen, p, plen,
2603                                                        use_context);
2604 }
2605
2606 static unsigned long ssl_session_hash(const SSL_SESSION *a)
2607 {
2608     const unsigned char *session_id = a->session_id;
2609     unsigned long l;
2610     unsigned char tmp_storage[4];
2611
2612     if (a->session_id_length < sizeof(tmp_storage)) {
2613         memset(tmp_storage, 0, sizeof(tmp_storage));
2614         memcpy(tmp_storage, a->session_id, a->session_id_length);
2615         session_id = tmp_storage;
2616     }
2617
2618     l = (unsigned long)
2619         ((unsigned long)session_id[0]) |
2620         ((unsigned long)session_id[1] << 8L) |
2621         ((unsigned long)session_id[2] << 16L) |
2622         ((unsigned long)session_id[3] << 24L);
2623     return (l);
2624 }
2625
2626 /*
2627  * NB: If this function (or indeed the hash function which uses a sort of
2628  * coarser function than this one) is changed, ensure
2629  * SSL_CTX_has_matching_session_id() is checked accordingly. It relies on
2630  * being able to construct an SSL_SESSION that will collide with any existing
2631  * session with a matching session ID.
2632  */
2633 static int ssl_session_cmp(const SSL_SESSION *a, const SSL_SESSION *b)
2634 {
2635     if (a->ssl_version != b->ssl_version)
2636         return (1);
2637     if (a->session_id_length != b->session_id_length)
2638         return (1);
2639     return (memcmp(a->session_id, b->session_id, a->session_id_length));
2640 }
2641
2642 /*
2643  * These wrapper functions should remain rather than redeclaring
2644  * SSL_SESSION_hash and SSL_SESSION_cmp for void* types and casting each
2645  * variable. The reason is that the functions aren't static, they're exposed
2646  * via ssl.h.
2647  */
2648
2649 SSL_CTX *SSL_CTX_new(const SSL_METHOD *meth)
2650 {
2651     SSL_CTX *ret = NULL;
2652
2653     if (meth == NULL) {
2654         SSLerr(SSL_F_SSL_CTX_NEW, SSL_R_NULL_SSL_METHOD_PASSED);
2655         return (NULL);
2656     }
2657
2658     if (!OPENSSL_init_ssl(OPENSSL_INIT_LOAD_SSL_STRINGS, NULL))
2659         return NULL;
2660
2661     if (SSL_get_ex_data_X509_STORE_CTX_idx() < 0) {
2662         SSLerr(SSL_F_SSL_CTX_NEW, SSL_R_X509_VERIFICATION_SETUP_PROBLEMS);
2663         goto err;
2664     }
2665     ret = OPENSSL_zalloc(sizeof(*ret));
2666     if (ret == NULL)
2667         goto err;
2668
2669     ret->method = meth;
2670     ret->min_proto_version = 0;
2671     ret->max_proto_version = 0;
2672     ret->session_cache_mode = SSL_SESS_CACHE_SERVER;
2673     ret->session_cache_size = SSL_SESSION_CACHE_MAX_SIZE_DEFAULT;
2674     /* We take the system default. */
2675     ret->session_timeout = meth->get_timeout();
2676     ret->references = 1;
2677     ret->lock = CRYPTO_THREAD_lock_new();
2678     if (ret->lock == NULL) {
2679         SSLerr(SSL_F_SSL_CTX_NEW, ERR_R_MALLOC_FAILURE);
2680         OPENSSL_free(ret);
2681         return NULL;
2682     }
2683     ret->max_cert_list = SSL_MAX_CERT_LIST_DEFAULT;
2684     ret->verify_mode = SSL_VERIFY_NONE;
2685     if ((ret->cert = ssl_cert_new()) == NULL)
2686         goto err;
2687
2688     ret->sessions = lh_SSL_SESSION_new(ssl_session_hash, ssl_session_cmp);
2689     if (ret->sessions == NULL)
2690         goto err;
2691     ret->cert_store = X509_STORE_new();
2692     if (ret->cert_store == NULL)
2693         goto err;
2694 #ifndef OPENSSL_NO_CT
2695     ret->ctlog_store = CTLOG_STORE_new();
2696     if (ret->ctlog_store == NULL)
2697         goto err;
2698 #endif
2699     if (!ssl_create_cipher_list(ret->method,
2700                                 &ret->cipher_list, &ret->cipher_list_by_id,
2701                                 SSL_DEFAULT_CIPHER_LIST, ret->cert)
2702         || sk_SSL_CIPHER_num(ret->cipher_list) <= 0) {
2703         SSLerr(SSL_F_SSL_CTX_NEW, SSL_R_LIBRARY_HAS_NO_CIPHERS);
2704         goto err2;
2705     }
2706
2707     ret->param = X509_VERIFY_PARAM_new();
2708     if (ret->param == NULL)
2709         goto err;
2710
2711     if ((ret->md5 = EVP_get_digestbyname("ssl3-md5")) == NULL) {
2712         SSLerr(SSL_F_SSL_CTX_NEW, SSL_R_UNABLE_TO_LOAD_SSL3_MD5_ROUTINES);
2713         goto err2;
2714     }
2715     if ((ret->sha1 = EVP_get_digestbyname("ssl3-sha1")) == NULL) {
2716         SSLerr(SSL_F_SSL_CTX_NEW, SSL_R_UNABLE_TO_LOAD_SSL3_SHA1_ROUTINES);
2717         goto err2;
2718     }
2719
2720     if ((ret->client_CA = sk_X509_NAME_new_null()) == NULL)
2721         goto err;
2722
2723     if (!CRYPTO_new_ex_data(CRYPTO_EX_INDEX_SSL_CTX, ret, &ret->ex_data))
2724         goto err;
2725
2726     /* No compression for DTLS */
2727     if (!(meth->ssl3_enc->enc_flags & SSL_ENC_FLAG_DTLS))
2728         ret->comp_methods = SSL_COMP_get_compression_methods();
2729
2730     ret->max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
2731     ret->split_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
2732
2733     /* Setup RFC5077 ticket keys */
2734     if ((RAND_bytes(ret->ext.tick_key_name,
2735                     sizeof(ret->ext.tick_key_name)) <= 0)
2736         || (RAND_bytes(ret->ext.tick_hmac_key,
2737                        sizeof(ret->ext.tick_hmac_key)) <= 0)
2738         || (RAND_bytes(ret->ext.tick_aes_key,
2739                        sizeof(ret->ext.tick_aes_key)) <= 0))
2740         ret->options |= SSL_OP_NO_TICKET;
2741
2742 #ifndef OPENSSL_NO_SRP
2743     if (!SSL_CTX_SRP_CTX_init(ret))
2744         goto err;
2745 #endif
2746 #ifndef OPENSSL_NO_ENGINE
2747 # ifdef OPENSSL_SSL_CLIENT_ENGINE_AUTO
2748 #  define eng_strx(x)     #x
2749 #  define eng_str(x)      eng_strx(x)
2750     /* Use specific client engine automatically... ignore errors */
2751     {
2752         ENGINE *eng;
2753         eng = ENGINE_by_id(eng_str(OPENSSL_SSL_CLIENT_ENGINE_AUTO));
2754         if (!eng) {
2755             ERR_clear_error();
2756             ENGINE_load_builtin_engines();
2757             eng = ENGINE_by_id(eng_str(OPENSSL_SSL_CLIENT_ENGINE_AUTO));
2758         }
2759         if (!eng || !SSL_CTX_set_client_cert_engine(ret, eng))
2760             ERR_clear_error();
2761     }
2762 # endif
2763 #endif
2764     /*
2765      * Default is to connect to non-RI servers. When RI is more widely
2766      * deployed might change this.
2767      */
2768     ret->options |= SSL_OP_LEGACY_SERVER_CONNECT;
2769     /*
2770      * Disable compression by default to prevent CRIME. Applications can
2771      * re-enable compression by configuring
2772      * SSL_CTX_clear_options(ctx, SSL_OP_NO_COMPRESSION);
2773      * or by using the SSL_CONF library.
2774      */
2775     ret->options |= SSL_OP_NO_COMPRESSION;
2776
2777     ret->ext.status_type = TLSEXT_STATUSTYPE_nothing;
2778
2779     /*
2780      * Default max early data is a fully loaded single record. Could be split
2781      * across multiple records in practice
2782      */
2783     ret->max_early_data = SSL3_RT_MAX_PLAIN_LENGTH;
2784
2785     return ret;
2786  err:
2787     SSLerr(SSL_F_SSL_CTX_NEW, ERR_R_MALLOC_FAILURE);
2788  err2:
2789     SSL_CTX_free(ret);
2790     return NULL;
2791 }
2792
2793 int SSL_CTX_up_ref(SSL_CTX *ctx)
2794 {
2795     int i;
2796
2797     if (CRYPTO_UP_REF(&ctx->references, &i, ctx->lock) <= 0)
2798         return 0;
2799
2800     REF_PRINT_COUNT("SSL_CTX", ctx);
2801     REF_ASSERT_ISNT(i < 2);
2802     return ((i > 1) ? 1 : 0);
2803 }
2804
2805 void SSL_CTX_free(SSL_CTX *a)
2806 {
2807     int i;
2808
2809     if (a == NULL)
2810         return;
2811
2812     CRYPTO_DOWN_REF(&a->references, &i, a->lock);
2813     REF_PRINT_COUNT("SSL_CTX", a);
2814     if (i > 0)
2815         return;
2816     REF_ASSERT_ISNT(i < 0);
2817
2818     X509_VERIFY_PARAM_free(a->param);
2819     dane_ctx_final(&a->dane);
2820
2821     /*
2822      * Free internal session cache. However: the remove_cb() may reference
2823      * the ex_data of SSL_CTX, thus the ex_data store can only be removed
2824      * after the sessions were flushed.
2825      * As the ex_data handling routines might also touch the session cache,
2826      * the most secure solution seems to be: empty (flush) the cache, then
2827      * free ex_data, then finally free the cache.
2828      * (See ticket [openssl.org #212].)
2829      */
2830     if (a->sessions != NULL)
2831         SSL_CTX_flush_sessions(a, 0);
2832
2833     CRYPTO_free_ex_data(CRYPTO_EX_INDEX_SSL_CTX, a, &a->ex_data);
2834     lh_SSL_SESSION_free(a->sessions);
2835     X509_STORE_free(a->cert_store);
2836 #ifndef OPENSSL_NO_CT
2837     CTLOG_STORE_free(a->ctlog_store);
2838 #endif
2839     sk_SSL_CIPHER_free(a->cipher_list);
2840     sk_SSL_CIPHER_free(a->cipher_list_by_id);
2841     ssl_cert_free(a->cert);
2842     sk_X509_NAME_pop_free(a->client_CA, X509_NAME_free);
2843     sk_X509_pop_free(a->extra_certs, X509_free);
2844     a->comp_methods = NULL;
2845 #ifndef OPENSSL_NO_SRTP
2846     sk_SRTP_PROTECTION_PROFILE_free(a->srtp_profiles);
2847 #endif
2848 #ifndef OPENSSL_NO_SRP
2849     SSL_CTX_SRP_CTX_free(a);
2850 #endif
2851 #ifndef OPENSSL_NO_ENGINE
2852     ENGINE_finish(a->client_cert_engine);
2853 #endif
2854
2855 #ifndef OPENSSL_NO_EC
2856     OPENSSL_free(a->ext.ecpointformats);
2857     OPENSSL_free(a->ext.supportedgroups);
2858 #endif
2859     OPENSSL_free(a->ext.alpn);
2860
2861     CRYPTO_THREAD_lock_free(a->lock);
2862
2863     OPENSSL_free(a);
2864 }
2865
2866 void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, pem_password_cb *cb)
2867 {
2868     ctx->default_passwd_callback = cb;
2869 }
2870
2871 void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx, void *u)
2872 {
2873     ctx->default_passwd_callback_userdata = u;
2874 }
2875
2876 pem_password_cb *SSL_CTX_get_default_passwd_cb(SSL_CTX *ctx)
2877 {
2878     return ctx->default_passwd_callback;
2879 }
2880
2881 void *SSL_CTX_get_default_passwd_cb_userdata(SSL_CTX *ctx)
2882 {
2883     return ctx->default_passwd_callback_userdata;
2884 }
2885
2886 void SSL_set_default_passwd_cb(SSL *s, pem_password_cb *cb)
2887 {
2888     s->default_passwd_callback = cb;
2889 }
2890
2891 void SSL_set_default_passwd_cb_userdata(SSL *s, void *u)
2892 {
2893     s->default_passwd_callback_userdata = u;
2894 }
2895
2896 pem_password_cb *SSL_get_default_passwd_cb(SSL *s)
2897 {
2898     return s->default_passwd_callback;
2899 }
2900
2901 void *SSL_get_default_passwd_cb_userdata(SSL *s)
2902 {
2903     return s->default_passwd_callback_userdata;
2904 }
2905
2906 void SSL_CTX_set_cert_verify_callback(SSL_CTX *ctx,
2907                                       int (*cb) (X509_STORE_CTX *, void *),
2908                                       void *arg)
2909 {
2910     ctx->app_verify_callback = cb;
2911     ctx->app_verify_arg = arg;
2912 }
2913
2914 void SSL_CTX_set_verify(SSL_CTX *ctx, int mode,
2915                         int (*cb) (int, X509_STORE_CTX *))
2916 {
2917     ctx->verify_mode = mode;
2918     ctx->default_verify_callback = cb;
2919 }
2920
2921 void SSL_CTX_set_verify_depth(SSL_CTX *ctx, int depth)
2922 {
2923     X509_VERIFY_PARAM_set_depth(ctx->param, depth);
2924 }
2925
2926 void SSL_CTX_set_cert_cb(SSL_CTX *c, int (*cb) (SSL *ssl, void *arg), void *arg)
2927 {
2928     ssl_cert_set_cert_cb(c->cert, cb, arg);
2929 }
2930
2931 void SSL_set_cert_cb(SSL *s, int (*cb) (SSL *ssl, void *arg), void *arg)
2932 {
2933     ssl_cert_set_cert_cb(s->cert, cb, arg);
2934 }
2935
2936 void ssl_set_masks(SSL *s)
2937 {
2938     CERT *c = s->cert;
2939     uint32_t *pvalid = s->s3->tmp.valid_flags;
2940     int rsa_enc, rsa_sign, dh_tmp, dsa_sign;
2941     unsigned long mask_k, mask_a;
2942 #ifndef OPENSSL_NO_EC
2943     int have_ecc_cert, ecdsa_ok;
2944 #endif
2945     if (c == NULL)
2946         return;
2947
2948 #ifndef OPENSSL_NO_DH
2949     dh_tmp = (c->dh_tmp != NULL || c->dh_tmp_cb != NULL || c->dh_tmp_auto);
2950 #else
2951     dh_tmp = 0;
2952 #endif
2953
2954     rsa_enc = pvalid[SSL_PKEY_RSA] & CERT_PKEY_VALID;
2955     rsa_sign = pvalid[SSL_PKEY_RSA] & CERT_PKEY_VALID;
2956     dsa_sign = pvalid[SSL_PKEY_DSA_SIGN] & CERT_PKEY_VALID;
2957 #ifndef OPENSSL_NO_EC
2958     have_ecc_cert = pvalid[SSL_PKEY_ECC] & CERT_PKEY_VALID;
2959 #endif
2960     mask_k = 0;
2961     mask_a = 0;
2962
2963 #ifdef CIPHER_DEBUG
2964     fprintf(stderr, "dht=%d re=%d rs=%d ds=%d\n",
2965             dh_tmp, rsa_enc, rsa_sign, dsa_sign);
2966 #endif
2967
2968 #ifndef OPENSSL_NO_GOST
2969     if (ssl_has_cert(s, SSL_PKEY_GOST12_512)) {
2970         mask_k |= SSL_kGOST;
2971         mask_a |= SSL_aGOST12;
2972     }
2973     if (ssl_has_cert(s, SSL_PKEY_GOST12_256)) {
2974         mask_k |= SSL_kGOST;
2975         mask_a |= SSL_aGOST12;
2976     }
2977     if (ssl_has_cert(s, SSL_PKEY_GOST01)) {
2978         mask_k |= SSL_kGOST;
2979         mask_a |= SSL_aGOST01;
2980     }
2981 #endif
2982
2983     if (rsa_enc)
2984         mask_k |= SSL_kRSA;
2985
2986     if (dh_tmp)
2987         mask_k |= SSL_kDHE;
2988
2989     if (rsa_enc || rsa_sign) {
2990         mask_a |= SSL_aRSA;
2991     }
2992
2993     if (dsa_sign) {
2994         mask_a |= SSL_aDSS;
2995     }
2996
2997     mask_a |= SSL_aNULL;
2998
2999     /*
3000      * An ECC certificate may be usable for ECDH and/or ECDSA cipher suites
3001      * depending on the key usage extension.
3002      */
3003 #ifndef OPENSSL_NO_EC
3004     if (have_ecc_cert) {
3005         uint32_t ex_kusage;
3006         ex_kusage = X509_get_key_usage(c->pkeys[SSL_PKEY_ECC].x509);
3007         ecdsa_ok = ex_kusage & X509v3_KU_DIGITAL_SIGNATURE;
3008         if (!(pvalid[SSL_PKEY_ECC] & CERT_PKEY_SIGN))
3009             ecdsa_ok = 0;
3010         if (ecdsa_ok)
3011             mask_a |= SSL_aECDSA;
3012     }
3013 #endif
3014
3015 #ifndef OPENSSL_NO_EC
3016     mask_k |= SSL_kECDHE;
3017 #endif
3018
3019 #ifndef OPENSSL_NO_PSK
3020     mask_k |= SSL_kPSK;
3021     mask_a |= SSL_aPSK;
3022     if (mask_k & SSL_kRSA)
3023         mask_k |= SSL_kRSAPSK;
3024     if (mask_k & SSL_kDHE)
3025         mask_k |= SSL_kDHEPSK;
3026     if (mask_k & SSL_kECDHE)
3027         mask_k |= SSL_kECDHEPSK;
3028 #endif
3029
3030     s->s3->tmp.mask_k = mask_k;
3031     s->s3->tmp.mask_a = mask_a;
3032 }
3033
3034 #ifndef OPENSSL_NO_EC
3035
3036 int ssl_check_srvr_ecc_cert_and_alg(X509 *x, SSL *s)
3037 {
3038     if (s->s3->tmp.new_cipher->algorithm_auth & SSL_aECDSA) {
3039         /* key usage, if present, must allow signing */
3040         if (!(X509_get_key_usage(x) & X509v3_KU_DIGITAL_SIGNATURE)) {
3041             SSLerr(SSL_F_SSL_CHECK_SRVR_ECC_CERT_AND_ALG,
3042                    SSL_R_ECC_CERT_NOT_FOR_SIGNING);
3043             return 0;
3044         }
3045     }
3046     return 1;                   /* all checks are ok */
3047 }
3048
3049 #endif
3050
3051 int ssl_get_server_cert_serverinfo(SSL *s, const unsigned char **serverinfo,
3052                                    size_t *serverinfo_length)
3053 {
3054     CERT_PKEY *cpk = s->s3->tmp.cert;
3055     *serverinfo_length = 0;
3056
3057     if (cpk == NULL || cpk->serverinfo == NULL)
3058         return 0;
3059
3060     *serverinfo = cpk->serverinfo;
3061     *serverinfo_length = cpk->serverinfo_length;
3062     return 1;
3063 }
3064
3065 void ssl_update_cache(SSL *s, int mode)
3066 {
3067     int i;
3068
3069     /*
3070      * If the session_id_length is 0, we are not supposed to cache it, and it
3071      * would be rather hard to do anyway :-)
3072      */
3073     if (s->session->session_id_length == 0)
3074         return;
3075
3076     i = s->session_ctx->session_cache_mode;
3077     if ((i & mode) && (!s->hit)
3078         && ((i & SSL_SESS_CACHE_NO_INTERNAL_STORE)
3079             || SSL_CTX_add_session(s->session_ctx, s->session))
3080         && (s->session_ctx->new_session_cb != NULL)) {
3081         SSL_SESSION_up_ref(s->session);
3082         if (!s->session_ctx->new_session_cb(s, s->session))
3083             SSL_SESSION_free(s->session);
3084     }
3085
3086     /* auto flush every 255 connections */
3087     if ((!(i & SSL_SESS_CACHE_NO_AUTO_CLEAR)) && ((i & mode) == mode)) {
3088         if ((((mode & SSL_SESS_CACHE_CLIENT)
3089               ? s->session_ctx->stats.sess_connect_good
3090               : s->session_ctx->stats.sess_accept_good) & 0xff) == 0xff) {
3091             SSL_CTX_flush_sessions(s->session_ctx, (unsigned long)time(NULL));
3092         }
3093     }
3094 }
3095
3096 const SSL_METHOD *SSL_CTX_get_ssl_method(SSL_CTX *ctx)
3097 {
3098     return ctx->method;
3099 }
3100
3101 const SSL_METHOD *SSL_get_ssl_method(SSL *s)
3102 {
3103     return (s->method);
3104 }
3105
3106 int SSL_set_ssl_method(SSL *s, const SSL_METHOD *meth)
3107 {
3108     int ret = 1;
3109
3110     if (s->method != meth) {
3111         const SSL_METHOD *sm = s->method;
3112         int (*hf) (SSL *) = s->handshake_func;
3113
3114         if (sm->version == meth->version)
3115             s->method = meth;
3116         else {
3117             sm->ssl_free(s);
3118             s->method = meth;
3119             ret = s->method->ssl_new(s);
3120         }
3121
3122         if (hf == sm->ssl_connect)
3123             s->handshake_func = meth->ssl_connect;
3124         else if (hf == sm->ssl_accept)
3125             s->handshake_func = meth->ssl_accept;
3126     }
3127     return (ret);
3128 }
3129
3130 int SSL_get_error(const SSL *s, int i)
3131 {
3132     int reason;
3133     unsigned long l;
3134     BIO *bio;
3135
3136     if (i > 0)
3137         return (SSL_ERROR_NONE);
3138
3139     /*
3140      * Make things return SSL_ERROR_SYSCALL when doing SSL_do_handshake etc,
3141      * where we do encode the error
3142      */
3143     if ((l = ERR_peek_error()) != 0) {
3144         if (ERR_GET_LIB(l) == ERR_LIB_SYS)
3145             return (SSL_ERROR_SYSCALL);
3146         else
3147             return (SSL_ERROR_SSL);
3148     }
3149
3150     if (SSL_want_read(s)) {
3151         bio = SSL_get_rbio(s);
3152         if (BIO_should_read(bio))
3153             return (SSL_ERROR_WANT_READ);
3154         else if (BIO_should_write(bio))
3155             /*
3156              * This one doesn't make too much sense ... We never try to write
3157              * to the rbio, and an application program where rbio and wbio
3158              * are separate couldn't even know what it should wait for.
3159              * However if we ever set s->rwstate incorrectly (so that we have
3160              * SSL_want_read(s) instead of SSL_want_write(s)) and rbio and
3161              * wbio *are* the same, this test works around that bug; so it
3162              * might be safer to keep it.
3163              */
3164             return (SSL_ERROR_WANT_WRITE);
3165         else if (BIO_should_io_special(bio)) {
3166             reason = BIO_get_retry_reason(bio);
3167             if (reason == BIO_RR_CONNECT)
3168                 return (SSL_ERROR_WANT_CONNECT);
3169             else if (reason == BIO_RR_ACCEPT)
3170                 return (SSL_ERROR_WANT_ACCEPT);
3171             else
3172                 return (SSL_ERROR_SYSCALL); /* unknown */
3173         }
3174     }
3175
3176     if (SSL_want_write(s)) {
3177         /*
3178          * Access wbio directly - in order to use the buffered bio if
3179          * present
3180          */
3181         bio = s->wbio;
3182         if (BIO_should_write(bio))
3183             return (SSL_ERROR_WANT_WRITE);
3184         else if (BIO_should_read(bio))
3185             /*
3186              * See above (SSL_want_read(s) with BIO_should_write(bio))
3187              */
3188             return (SSL_ERROR_WANT_READ);
3189         else if (BIO_should_io_special(bio)) {
3190             reason = BIO_get_retry_reason(bio);
3191             if (reason == BIO_RR_CONNECT)
3192                 return (SSL_ERROR_WANT_CONNECT);
3193             else if (reason == BIO_RR_ACCEPT)
3194                 return (SSL_ERROR_WANT_ACCEPT);
3195             else
3196                 return (SSL_ERROR_SYSCALL);
3197         }
3198     }
3199     if (SSL_want_x509_lookup(s))
3200         return (SSL_ERROR_WANT_X509_LOOKUP);
3201     if (SSL_want_async(s))
3202         return SSL_ERROR_WANT_ASYNC;
3203     if (SSL_want_async_job(s))
3204         return SSL_ERROR_WANT_ASYNC_JOB;
3205     if (SSL_want_early(s))
3206         return SSL_ERROR_WANT_EARLY;
3207
3208     if ((s->shutdown & SSL_RECEIVED_SHUTDOWN) &&
3209         (s->s3->warn_alert == SSL_AD_CLOSE_NOTIFY))
3210         return (SSL_ERROR_ZERO_RETURN);
3211
3212     return (SSL_ERROR_SYSCALL);
3213 }
3214
3215 static int ssl_do_handshake_intern(void *vargs)
3216 {
3217     struct ssl_async_args *args;
3218     SSL *s;
3219
3220     args = (struct ssl_async_args *)vargs;
3221     s = args->s;
3222
3223     return s->handshake_func(s);
3224 }
3225
3226 int SSL_do_handshake(SSL *s)
3227 {
3228     int ret = 1;
3229
3230     if (s->handshake_func == NULL) {
3231         SSLerr(SSL_F_SSL_DO_HANDSHAKE, SSL_R_CONNECTION_TYPE_NOT_SET);
3232         return -1;
3233     }
3234
3235     if (s->early_data_state != SSL_EARLY_DATA_NONE
3236             && s->early_data_state != SSL_EARLY_DATA_FINISHED_WRITING
3237             && s->early_data_state != SSL_EARLY_DATA_FINISHED_READING
3238             && s->early_data_state != SSL_EARLY_DATA_ACCEPTING
3239             && s->early_data_state != SSL_EARLY_DATA_CONNECTING) {
3240         SSLerr(SSL_F_SSL_WRITE_INTERNAL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
3241         return 0;
3242     }
3243
3244
3245     s->method->ssl_renegotiate_check(s, 0);
3246
3247     if (SSL_in_init(s) || SSL_in_before(s)) {
3248         if ((s->mode & SSL_MODE_ASYNC) && ASYNC_get_current_job() == NULL) {
3249             struct ssl_async_args args;
3250
3251             args.s = s;
3252
3253             ret = ssl_start_async_job(s, &args, ssl_do_handshake_intern);
3254         } else {
3255             ret = s->handshake_func(s);
3256         }
3257     }
3258     return ret;
3259 }
3260
3261 void SSL_set_accept_state(SSL *s)
3262 {
3263     s->server = 1;
3264     s->shutdown = 0;
3265     ossl_statem_clear(s);
3266     s->handshake_func = s->method->ssl_accept;
3267     clear_ciphers(s);
3268 }
3269
3270 void SSL_set_connect_state(SSL *s)
3271 {
3272     s->server = 0;
3273     s->shutdown = 0;
3274     ossl_statem_clear(s);
3275     s->handshake_func = s->method->ssl_connect;
3276     clear_ciphers(s);
3277 }
3278
3279 int ssl_undefined_function(SSL *s)
3280 {
3281     SSLerr(SSL_F_SSL_UNDEFINED_FUNCTION, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
3282     return (0);
3283 }
3284
3285 int ssl_undefined_void_function(void)
3286 {
3287     SSLerr(SSL_F_SSL_UNDEFINED_VOID_FUNCTION,
3288            ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
3289     return (0);
3290 }
3291
3292 int ssl_undefined_const_function(const SSL *s)
3293 {
3294     return (0);
3295 }
3296
3297 const SSL_METHOD *ssl_bad_method(int ver)
3298 {
3299     SSLerr(SSL_F_SSL_BAD_METHOD, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
3300     return (NULL);
3301 }
3302
3303 const char *ssl_protocol_to_string(int version)
3304 {
3305     switch(version)
3306     {
3307     case TLS1_3_VERSION:
3308         return "TLSv1.3";
3309
3310     case TLS1_2_VERSION:
3311         return "TLSv1.2";
3312
3313     case TLS1_1_VERSION:
3314         return "TLSv1.1";
3315
3316     case TLS1_VERSION:
3317         return "TLSv1";
3318
3319     case SSL3_VERSION:
3320         return "SSLv3";
3321
3322     case DTLS1_BAD_VER:
3323         return "DTLSv0.9";
3324
3325     case DTLS1_VERSION:
3326         return "DTLSv1";
3327
3328     case DTLS1_2_VERSION:
3329         return "DTLSv1.2";
3330
3331     default:
3332         return "unknown";
3333     }
3334 }
3335
3336 const char *SSL_get_version(const SSL *s)
3337 {
3338     return ssl_protocol_to_string(s->version);
3339 }
3340
3341 SSL *SSL_dup(SSL *s)
3342 {
3343     STACK_OF(X509_NAME) *sk;
3344     X509_NAME *xn;
3345     SSL *ret;
3346     int i;
3347
3348     /* If we're not quiescent, just up_ref! */
3349     if (!SSL_in_init(s) || !SSL_in_before(s)) {
3350         CRYPTO_UP_REF(&s->references, &i, s->lock);
3351         return s;
3352     }
3353
3354     /*
3355      * Otherwise, copy configuration state, and session if set.
3356      */
3357     if ((ret = SSL_new(SSL_get_SSL_CTX(s))) == NULL)
3358         return (NULL);
3359
3360     if (s->session != NULL) {
3361         /*
3362          * Arranges to share the same session via up_ref.  This "copies"
3363          * session-id, SSL_METHOD, sid_ctx, and 'cert'
3364          */
3365         if (!SSL_copy_session_id(ret, s))
3366             goto err;
3367     } else {
3368         /*
3369          * No session has been established yet, so we have to expect that
3370          * s->cert or ret->cert will be changed later -- they should not both
3371          * point to the same object, and thus we can't use
3372          * SSL_copy_session_id.
3373          */
3374         if (!SSL_set_ssl_method(ret, s->method))
3375             goto err;
3376
3377         if (s->cert != NULL) {
3378             ssl_cert_free(ret->cert);
3379             ret->cert = ssl_cert_dup(s->cert);
3380             if (ret->cert == NULL)
3381                 goto err;
3382         }
3383
3384         if (!SSL_set_session_id_context(ret, s->sid_ctx,
3385                                         (int)s->sid_ctx_length))
3386             goto err;
3387     }
3388
3389     if (!ssl_dane_dup(ret, s))
3390         goto err;
3391     ret->version = s->version;
3392     ret->options = s->options;
3393     ret->mode = s->mode;
3394     SSL_set_max_cert_list(ret, SSL_get_max_cert_list(s));
3395     SSL_set_read_ahead(ret, SSL_get_read_ahead(s));
3396     ret->msg_callback = s->msg_callback;
3397     ret->msg_callback_arg = s->msg_callback_arg;
3398     SSL_set_verify(ret, SSL_get_verify_mode(s), SSL_get_verify_callback(s));
3399     SSL_set_verify_depth(ret, SSL_get_verify_depth(s));
3400     ret->generate_session_id = s->generate_session_id;
3401
3402     SSL_set_info_callback(ret, SSL_get_info_callback(s));
3403
3404     /* copy app data, a little dangerous perhaps */
3405     if (!CRYPTO_dup_ex_data(CRYPTO_EX_INDEX_SSL, &ret->ex_data, &s->ex_data))
3406         goto err;
3407
3408     /* setup rbio, and wbio */
3409     if (s->rbio != NULL) {
3410         if (!BIO_dup_state(s->rbio, (char *)&ret->rbio))
3411             goto err;
3412     }
3413     if (s->wbio != NULL) {
3414         if (s->wbio != s->rbio) {
3415             if (!BIO_dup_state(s->wbio, (char *)&ret->wbio))
3416                 goto err;
3417         } else {
3418             BIO_up_ref(ret->rbio);
3419             ret->wbio = ret->rbio;
3420         }
3421     }
3422
3423     ret->server = s->server;
3424     if (s->handshake_func) {
3425         if (s->server)
3426             SSL_set_accept_state(ret);
3427         else
3428             SSL_set_connect_state(ret);
3429     }
3430     ret->shutdown = s->shutdown;
3431     ret->hit = s->hit;
3432
3433     ret->default_passwd_callback = s->default_passwd_callback;
3434     ret->default_passwd_callback_userdata = s->default_passwd_callback_userdata;
3435
3436     X509_VERIFY_PARAM_inherit(ret->param, s->param);
3437
3438     /* dup the cipher_list and cipher_list_by_id stacks */
3439     if (s->cipher_list != NULL) {
3440         if ((ret->cipher_list = sk_SSL_CIPHER_dup(s->cipher_list)) == NULL)
3441             goto err;
3442     }
3443     if (s->cipher_list_by_id != NULL)
3444         if ((ret->cipher_list_by_id = sk_SSL_CIPHER_dup(s->cipher_list_by_id))
3445             == NULL)
3446             goto err;
3447
3448     /* Dup the client_CA list */
3449     if (s->client_CA != NULL) {
3450         if ((sk = sk_X509_NAME_dup(s->client_CA)) == NULL)
3451             goto err;
3452         ret->client_CA = sk;
3453         for (i = 0; i < sk_X509_NAME_num(sk); i++) {
3454             xn = sk_X509_NAME_value(sk, i);
3455             if (sk_X509_NAME_set(sk, i, X509_NAME_dup(xn)) == NULL) {
3456                 X509_NAME_free(xn);
3457                 goto err;
3458             }
3459         }
3460     }
3461     return ret;
3462
3463  err:
3464     SSL_free(ret);
3465     return NULL;
3466 }
3467
3468 void ssl_clear_cipher_ctx(SSL *s)
3469 {
3470     if (s->enc_read_ctx != NULL) {
3471         EVP_CIPHER_CTX_free(s->enc_read_ctx);
3472         s->enc_read_ctx = NULL;
3473     }
3474     if (s->enc_write_ctx != NULL) {
3475         EVP_CIPHER_CTX_free(s->enc_write_ctx);
3476         s->enc_write_ctx = NULL;
3477     }
3478 #ifndef OPENSSL_NO_COMP
3479     COMP_CTX_free(s->expand);
3480     s->expand = NULL;
3481     COMP_CTX_free(s->compress);
3482     s->compress = NULL;
3483 #endif
3484 }
3485
3486 X509 *SSL_get_certificate(const SSL *s)
3487 {
3488     if (s->cert != NULL)
3489         return (s->cert->key->x509);
3490     else
3491         return (NULL);
3492 }
3493
3494 EVP_PKEY *SSL_get_privatekey(const SSL *s)
3495 {
3496     if (s->cert != NULL)
3497         return (s->cert->key->privatekey);
3498     else
3499         return (NULL);
3500 }
3501
3502 X509 *SSL_CTX_get0_certificate(const SSL_CTX *ctx)
3503 {
3504     if (ctx->cert != NULL)
3505         return ctx->cert->key->x509;
3506     else
3507         return NULL;
3508 }
3509
3510 EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx)
3511 {
3512     if (ctx->cert != NULL)
3513         return ctx->cert->key->privatekey;
3514     else
3515         return NULL;
3516 }
3517
3518 const SSL_CIPHER *SSL_get_current_cipher(const SSL *s)
3519 {
3520     if ((s->session != NULL) && (s->session->cipher != NULL))
3521         return (s->session->cipher);
3522     return (NULL);
3523 }
3524
3525 const COMP_METHOD *SSL_get_current_compression(SSL *s)
3526 {
3527 #ifndef OPENSSL_NO_COMP
3528     return s->compress ? COMP_CTX_get_method(s->compress) : NULL;
3529 #else
3530     return NULL;
3531 #endif
3532 }
3533
3534 const COMP_METHOD *SSL_get_current_expansion(SSL *s)
3535 {
3536 #ifndef OPENSSL_NO_COMP
3537     return s->expand ? COMP_CTX_get_method(s->expand) : NULL;
3538 #else
3539     return NULL;
3540 #endif
3541 }
3542
3543 int ssl_init_wbio_buffer(SSL *s)
3544 {
3545     BIO *bbio;
3546
3547     if (s->bbio != NULL) {
3548         /* Already buffered. */
3549         return 1;
3550     }
3551
3552     bbio = BIO_new(BIO_f_buffer());
3553     if (bbio == NULL || !BIO_set_read_buffer_size(bbio, 1)) {
3554         BIO_free(bbio);
3555         SSLerr(SSL_F_SSL_INIT_WBIO_BUFFER, ERR_R_BUF_LIB);
3556         return 0;
3557     }
3558     s->bbio = bbio;
3559     s->wbio = BIO_push(bbio, s->wbio);
3560
3561     return 1;
3562 }
3563
3564 void ssl_free_wbio_buffer(SSL *s)
3565 {
3566     /* callers ensure s is never null */
3567     if (s->bbio == NULL)
3568         return;
3569
3570     s->wbio = BIO_pop(s->wbio);
3571     assert(s->wbio != NULL);
3572     BIO_free(s->bbio);
3573     s->bbio = NULL;
3574 }
3575
3576 void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode)
3577 {
3578     ctx->quiet_shutdown = mode;
3579 }
3580
3581 int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx)
3582 {
3583     return (ctx->quiet_shutdown);
3584 }
3585
3586 void SSL_set_quiet_shutdown(SSL *s, int mode)
3587 {
3588     s->quiet_shutdown = mode;
3589 }
3590
3591 int SSL_get_quiet_shutdown(const SSL *s)
3592 {
3593     return (s->quiet_shutdown);
3594 }
3595
3596 void SSL_set_shutdown(SSL *s, int mode)
3597 {
3598     s->shutdown = mode;
3599 }
3600
3601 int SSL_get_shutdown(const SSL *s)
3602 {
3603     return s->shutdown;
3604 }
3605
3606 int SSL_version(const SSL *s)
3607 {
3608     return s->version;
3609 }
3610
3611 int SSL_client_version(const SSL *s)
3612 {
3613     return s->client_version;
3614 }
3615
3616 SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl)
3617 {
3618     return ssl->ctx;
3619 }
3620
3621 SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx)
3622 {
3623     CERT *new_cert;
3624     if (ssl->ctx == ctx)
3625         return ssl->ctx;
3626     if (ctx == NULL)
3627         ctx = ssl->session_ctx;
3628     new_cert = ssl_cert_dup(ctx->cert);
3629     if (new_cert == NULL) {
3630         return NULL;
3631     }
3632     ssl_cert_free(ssl->cert);
3633     ssl->cert = new_cert;
3634
3635     /*
3636      * Program invariant: |sid_ctx| has fixed size (SSL_MAX_SID_CTX_LENGTH),
3637      * so setter APIs must prevent invalid lengths from entering the system.
3638      */
3639     OPENSSL_assert(ssl->sid_ctx_length <= sizeof(ssl->sid_ctx));
3640
3641     /*
3642      * If the session ID context matches that of the parent SSL_CTX,
3643      * inherit it from the new SSL_CTX as well. If however the context does
3644      * not match (i.e., it was set per-ssl with SSL_set_session_id_context),
3645      * leave it unchanged.
3646      */
3647     if ((ssl->ctx != NULL) &&
3648         (ssl->sid_ctx_length == ssl->ctx->sid_ctx_length) &&
3649         (memcmp(ssl->sid_ctx, ssl->ctx->sid_ctx, ssl->sid_ctx_length) == 0)) {
3650         ssl->sid_ctx_length = ctx->sid_ctx_length;
3651         memcpy(&ssl->sid_ctx, &ctx->sid_ctx, sizeof(ssl->sid_ctx));
3652     }
3653
3654     SSL_CTX_up_ref(ctx);
3655     SSL_CTX_free(ssl->ctx);     /* decrement reference count */
3656     ssl->ctx = ctx;
3657
3658     return ssl->ctx;
3659 }
3660
3661 int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx)
3662 {
3663     return (X509_STORE_set_default_paths(ctx->cert_store));
3664 }
3665
3666 int SSL_CTX_set_default_verify_dir(SSL_CTX *ctx)
3667 {
3668     X509_LOOKUP *lookup;
3669
3670     lookup = X509_STORE_add_lookup(ctx->cert_store, X509_LOOKUP_hash_dir());
3671     if (lookup == NULL)
3672         return 0;
3673     X509_LOOKUP_add_dir(lookup, NULL, X509_FILETYPE_DEFAULT);
3674
3675     /* Clear any errors if the default directory does not exist */
3676     ERR_clear_error();
3677
3678     return 1;
3679 }
3680
3681 int SSL_CTX_set_default_verify_file(SSL_CTX *ctx)
3682 {
3683     X509_LOOKUP *lookup;
3684
3685     lookup = X509_STORE_add_lookup(ctx->cert_store, X509_LOOKUP_file());
3686     if (lookup == NULL)
3687         return 0;
3688
3689     X509_LOOKUP_load_file(lookup, NULL, X509_FILETYPE_DEFAULT);
3690
3691     /* Clear any errors if the default file does not exist */
3692     ERR_clear_error();
3693
3694     return 1;
3695 }
3696
3697 int SSL_CTX_load_verify_locations(SSL_CTX *ctx, const char *CAfile,
3698                                   const char *CApath)
3699 {
3700     return (X509_STORE_load_locations(ctx->cert_store, CAfile, CApath));
3701 }
3702
3703 void SSL_set_info_callback(SSL *ssl,
3704                            void (*cb) (const SSL *ssl, int type, int val))
3705 {
3706     ssl->info_callback = cb;
3707 }
3708
3709 /*
3710  * One compiler (Diab DCC) doesn't like argument names in returned function
3711  * pointer.
3712  */
3713 void (*SSL_get_info_callback(const SSL *ssl)) (const SSL * /* ssl */ ,
3714                                                int /* type */ ,
3715                                                int /* val */ ) {
3716     return ssl->info_callback;
3717 }
3718
3719 void SSL_set_verify_result(SSL *ssl, long arg)
3720 {
3721     ssl->verify_result = arg;
3722 }
3723
3724 long SSL_get_verify_result(const SSL *ssl)
3725 {
3726     return (ssl->verify_result);
3727 }
3728
3729 size_t SSL_get_client_random(const SSL *ssl, unsigned char *out, size_t outlen)
3730 {
3731     if (outlen == 0)
3732         return sizeof(ssl->s3->client_random);
3733     if (outlen > sizeof(ssl->s3->client_random))
3734         outlen = sizeof(ssl->s3->client_random);
3735     memcpy(out, ssl->s3->client_random, outlen);
3736     return outlen;
3737 }
3738
3739 size_t SSL_get_server_random(const SSL *ssl, unsigned char *out, size_t outlen)
3740 {
3741     if (outlen == 0)
3742         return sizeof(ssl->s3->server_random);
3743     if (outlen > sizeof(ssl->s3->server_random))
3744         outlen = sizeof(ssl->s3->server_random);
3745     memcpy(out, ssl->s3->server_random, outlen);
3746     return outlen;
3747 }
3748
3749 size_t SSL_SESSION_get_master_key(const SSL_SESSION *session,
3750                                   unsigned char *out, size_t outlen)
3751 {
3752     if (outlen == 0)
3753         return session->master_key_length;
3754     if (outlen > session->master_key_length)
3755         outlen = session->master_key_length;
3756     memcpy(out, session->master_key, outlen);
3757     return outlen;
3758 }
3759
3760 int SSL_set_ex_data(SSL *s, int idx, void *arg)
3761 {
3762     return (CRYPTO_set_ex_data(&s->ex_data, idx, arg));
3763 }
3764
3765 void *SSL_get_ex_data(const SSL *s, int idx)
3766 {
3767     return (CRYPTO_get_ex_data(&s->ex_data, idx));
3768 }
3769
3770 int SSL_CTX_set_ex_data(SSL_CTX *s, int idx, void *arg)
3771 {
3772     return (CRYPTO_set_ex_data(&s->ex_data, idx, arg));
3773 }
3774
3775 void *SSL_CTX_get_ex_data(const SSL_CTX *s, int idx)
3776 {
3777     return (CRYPTO_get_ex_data(&s->ex_data, idx));
3778 }
3779
3780 X509_STORE *SSL_CTX_get_cert_store(const SSL_CTX *ctx)
3781 {
3782     return (ctx->cert_store);
3783 }
3784
3785 void SSL_CTX_set_cert_store(SSL_CTX *ctx, X509_STORE *store)
3786 {
3787     X509_STORE_free(ctx->cert_store);
3788     ctx->cert_store = store;
3789 }
3790
3791 void SSL_CTX_set1_cert_store(SSL_CTX *ctx, X509_STORE *store)
3792 {
3793     if (store != NULL)
3794         X509_STORE_up_ref(store);
3795     SSL_CTX_set_cert_store(ctx, store);
3796 }
3797
3798 int SSL_want(const SSL *s)
3799 {
3800     return (s->rwstate);
3801 }
3802
3803 /**
3804  * \brief Set the callback for generating temporary DH keys.
3805  * \param ctx the SSL context.
3806  * \param dh the callback
3807  */
3808
3809 #ifndef OPENSSL_NO_DH
3810 void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
3811                                  DH *(*dh) (SSL *ssl, int is_export,
3812                                             int keylength))
3813 {
3814     SSL_CTX_callback_ctrl(ctx, SSL_CTRL_SET_TMP_DH_CB, (void (*)(void))dh);
3815 }
3816
3817 void SSL_set_tmp_dh_callback(SSL *ssl, DH *(*dh) (SSL *ssl, int is_export,
3818                                                   int keylength))
3819 {
3820     SSL_callback_ctrl(ssl, SSL_CTRL_SET_TMP_DH_CB, (void (*)(void))dh);
3821 }
3822 #endif
3823
3824 #ifndef OPENSSL_NO_PSK
3825 int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint)
3826 {
3827     if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
3828         SSLerr(SSL_F_SSL_CTX_USE_PSK_IDENTITY_HINT, SSL_R_DATA_LENGTH_TOO_LONG);
3829         return 0;
3830     }
3831     OPENSSL_free(ctx->cert->psk_identity_hint);
3832     if (identity_hint != NULL) {
3833         ctx->cert->psk_identity_hint = OPENSSL_strdup(identity_hint);
3834         if (ctx->cert->psk_identity_hint == NULL)
3835             return 0;
3836     } else
3837         ctx->cert->psk_identity_hint = NULL;
3838     return 1;
3839 }
3840
3841 int SSL_use_psk_identity_hint(SSL *s, const char *identity_hint)
3842 {
3843     if (s == NULL)
3844         return 0;
3845
3846     if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
3847         SSLerr(SSL_F_SSL_USE_PSK_IDENTITY_HINT, SSL_R_DATA_LENGTH_TOO_LONG);
3848         return 0;
3849     }
3850     OPENSSL_free(s->cert->psk_identity_hint);
3851     if (identity_hint != NULL) {
3852         s->cert->psk_identity_hint = OPENSSL_strdup(identity_hint);
3853         if (s->cert->psk_identity_hint == NULL)
3854             return 0;
3855     } else
3856         s->cert->psk_identity_hint = NULL;
3857     return 1;
3858 }
3859
3860 const char *SSL_get_psk_identity_hint(const SSL *s)
3861 {
3862     if (s == NULL || s->session == NULL)
3863         return NULL;
3864     return (s->session->psk_identity_hint);
3865 }
3866
3867 const char *SSL_get_psk_identity(const SSL *s)
3868 {
3869     if (s == NULL || s->session == NULL)
3870         return NULL;
3871     return (s->session->psk_identity);
3872 }
3873
3874 void SSL_set_psk_client_callback(SSL *s, SSL_psk_client_cb_func cb)
3875 {
3876     s->psk_client_callback = cb;
3877 }
3878
3879 void SSL_CTX_set_psk_client_callback(SSL_CTX *ctx, SSL_psk_client_cb_func cb)
3880 {
3881     ctx->psk_client_callback = cb;
3882 }
3883
3884 void SSL_set_psk_server_callback(SSL *s, SSL_psk_server_cb_func cb)
3885 {
3886     s->psk_server_callback = cb;
3887 }
3888
3889 void SSL_CTX_set_psk_server_callback(SSL_CTX *ctx, SSL_psk_server_cb_func cb)
3890 {
3891     ctx->psk_server_callback = cb;
3892 }
3893 #endif
3894
3895 void SSL_CTX_set_msg_callback(SSL_CTX *ctx,
3896                               void (*cb) (int write_p, int version,
3897                                           int content_type, const void *buf,
3898                                           size_t len, SSL *ssl, void *arg))
3899 {
3900     SSL_CTX_callback_ctrl(ctx, SSL_CTRL_SET_MSG_CALLBACK, (void (*)(void))cb);
3901 }
3902
3903 void SSL_set_msg_callback(SSL *ssl,
3904                           void (*cb) (int write_p, int version,
3905                                       int content_type, const void *buf,
3906                                       size_t len, SSL *ssl, void *arg))
3907 {
3908     SSL_callback_ctrl(ssl, SSL_CTRL_SET_MSG_CALLBACK, (void (*)(void))cb);
3909 }
3910
3911 void SSL_CTX_set_not_resumable_session_callback(SSL_CTX *ctx,
3912                                                 int (*cb) (SSL *ssl,
3913                                                            int
3914                                                            is_forward_secure))
3915 {
3916     SSL_CTX_callback_ctrl(ctx, SSL_CTRL_SET_NOT_RESUMABLE_SESS_CB,
3917                           (void (*)(void))cb);
3918 }
3919
3920 void SSL_set_not_resumable_session_callback(SSL *ssl,
3921                                             int (*cb) (SSL *ssl,
3922                                                        int is_forward_secure))
3923 {
3924     SSL_callback_ctrl(ssl, SSL_CTRL_SET_NOT_RESUMABLE_SESS_CB,
3925                       (void (*)(void))cb);
3926 }
3927
3928 /*
3929  * Allocates new EVP_MD_CTX and sets pointer to it into given pointer
3930  * variable, freeing EVP_MD_CTX previously stored in that variable, if any.
3931  * If EVP_MD pointer is passed, initializes ctx with this md.
3932  * Returns the newly allocated ctx;
3933  */
3934
3935 EVP_MD_CTX *ssl_replace_hash(EVP_MD_CTX **hash, const EVP_MD *md)
3936 {
3937     ssl_clear_hash_ctx(hash);
3938     *hash = EVP_MD_CTX_new();
3939     if (*hash == NULL || (md && EVP_DigestInit_ex(*hash, md, NULL) <= 0)) {
3940         EVP_MD_CTX_free(*hash);
3941         *hash = NULL;
3942         return NULL;
3943     }
3944     return *hash;
3945 }
3946
3947 void ssl_clear_hash_ctx(EVP_MD_CTX **hash)
3948 {
3949
3950     EVP_MD_CTX_free(*hash);
3951     *hash = NULL;
3952 }
3953
3954 /* Retrieve handshake hashes */
3955 int ssl_handshake_hash(SSL *s, unsigned char *out, size_t outlen,
3956                        size_t *hashlen)
3957 {
3958     EVP_MD_CTX *ctx = NULL;
3959     EVP_MD_CTX *hdgst = s->s3->handshake_dgst;
3960     int hashleni = EVP_MD_CTX_size(hdgst);
3961     int ret = 0;
3962
3963     if (hashleni < 0 || (size_t)hashleni > outlen)
3964         goto err;
3965
3966     ctx = EVP_MD_CTX_new();
3967     if (ctx == NULL)
3968         goto err;
3969
3970     if (!EVP_MD_CTX_copy_ex(ctx, hdgst)
3971         || EVP_DigestFinal_ex(ctx, out, NULL) <= 0)
3972         goto err;
3973
3974     *hashlen = hashleni;
3975
3976     ret = 1;
3977  err:
3978     EVP_MD_CTX_free(ctx);
3979     return ret;
3980 }
3981
3982 int SSL_session_reused(SSL *s)
3983 {
3984     return s->hit;
3985 }
3986
3987 int SSL_is_server(SSL *s)
3988 {
3989     return s->server;
3990 }
3991
3992 #if OPENSSL_API_COMPAT < 0x10100000L
3993 void SSL_set_debug(SSL *s, int debug)
3994 {
3995     /* Old function was do-nothing anyway... */
3996     (void)s;
3997     (void)debug;
3998 }
3999 #endif
4000
4001 void SSL_set_security_level(SSL *s, int level)
4002 {
4003     s->cert->sec_level = level;
4004 }
4005
4006 int SSL_get_security_level(const SSL *s)
4007 {
4008     return s->cert->sec_level;
4009 }
4010
4011 void SSL_set_security_callback(SSL *s,
4012                                int (*cb) (const SSL