ssl/ssl_lib.c

   1 /*! \file ssl/ssl_lib.c
   2  *  \brief Version independent SSL functions.
   3  */
   4 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
   5  * All rights reserved.
   6  *
   7  * This package is an SSL implementation written
   8  * by Eric Young (eay@cryptsoft.com).
   9  * The implementation was written so as to conform with Netscapes SSL.
  10  *
  11  * This library is free for commercial and non-commercial use as long as
  12  * the following conditions are aheared to.  The following conditions
  13  * apply to all code found in this distribution, be it the RC4, RSA,
  14  * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
  15  * included with this distribution is covered by the same copyright terms
  16  * except that the holder is Tim Hudson (tjh@cryptsoft.com).
  17  *
  18  * Copyright remains Eric Young's, and as such any Copyright notices in
  19  * the code are not to be removed.
  20  * If this package is used in a product, Eric Young should be given attribution
  21  * as the author of the parts of the library used.
  22  * This can be in the form of a textual message at program startup or
  23  * in documentation (online or textual) provided with the package.
  24  *
  25  * Redistribution and use in source and binary forms, with or without
  26  * modification, are permitted provided that the following conditions
  27  * are met:
  28  * 1. Redistributions of source code must retain the copyright
  29  *    notice, this list of conditions and the following disclaimer.
  30  * 2. Redistributions in binary form must reproduce the above copyright
  31  *    notice, this list of conditions and the following disclaimer in the
  32  *    documentation and/or other materials provided with the distribution.
  33  * 3. All advertising materials mentioning features or use of this software
  34  *    must display the following acknowledgement:
  35  *    "This product includes cryptographic software written by
  36  *     Eric Young (eay@cryptsoft.com)"
  37  *    The word 'cryptographic' can be left out if the rouines from the library
  38  *    being used are not cryptographic related :-).
  39  * 4. If you include any Windows specific code (or a derivative thereof) from
  40  *    the apps directory (application code) you must include an acknowledgement:
  41  *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
  42  *
  43  * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
  44  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  45  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  46  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  47  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  48  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  49  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  50  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  51  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  52  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  53  * SUCH DAMAGE.
  54  *
  55  * The licence and distribution terms for any publically available version or
  56  * derivative of this code cannot be changed.  i.e. this code cannot simply be
  57  * copied and put under another distribution licence
  58  * [including the GNU Public Licence.]
  59  */
  60 /* ====================================================================
  61  * Copyright (c) 1998-2001 The OpenSSL Project.  All rights reserved.
  62  *
  63  * Redistribution and use in source and binary forms, with or without
  64  * modification, are permitted provided that the following conditions
  65  * are met:
  66  *
  67  * 1. Redistributions of source code must retain the above copyright
  68  *    notice, this list of conditions and the following disclaimer.
  69  *
  70  * 2. Redistributions in binary form must reproduce the above copyright
  71  *    notice, this list of conditions and the following disclaimer in
  72  *    the documentation and/or other materials provided with the
  73  *    distribution.
  74  *
  75  * 3. All advertising materials mentioning features or use of this
  76  *    software must display the following acknowledgment:
  77  *    "This product includes software developed by the OpenSSL Project
  78  *    for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
  79  *
  80  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  81  *    endorse or promote products derived from this software without
  82  *    prior written permission. For written permission, please contact
  83  *    openssl-core@openssl.org.
  84  *
  85  * 5. Products derived from this software may not be called "OpenSSL"
  86  *    nor may "OpenSSL" appear in their names without prior written
  87  *    permission of the OpenSSL Project.
  88  *
  89  * 6. Redistributions of any form whatsoever must retain the following
  90  *    acknowledgment:
  91  *    "This product includes software developed by the OpenSSL Project
  92  *    for use in the OpenSSL Toolkit (http://www.openssl.org/)"
  93  *
  94  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  95  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  96  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  97  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
  98  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  99  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 100  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 101  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 102  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
 103  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 104  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 105  * OF THE POSSIBILITY OF SUCH DAMAGE.
 106  * ====================================================================
 107  *
 108  * This product includes cryptographic software written by Eric Young
 109  * (eay@cryptsoft.com).  This product includes software written by Tim
 110  * Hudson (tjh@cryptsoft.com).
 111  *
 112  */
 113 /* ====================================================================
 114  * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
 115  * ECC cipher suite support in OpenSSL originally developed by
 116  * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project.
 117  */
 118
 119 #ifdef REF_CHECK
 120 #  include <assert.h>
 121 #endif
 122 #include <stdio.h>
 123 #include "ssl_locl.h"
 124 #include "kssl_lcl.h"
 125 #include <openssl/objects.h>
 126 #include <openssl/lhash.h>
 127 #include <openssl/x509v3.h>
 128 #include <openssl/dh.h>
 129
 130 const char *SSL_version_str=OPENSSL_VERSION_TEXT;
 131
 132 SSL3_ENC_METHOD ssl3_undef_enc_method={
 133         /* evil casts, but these functions are only called if there's a library bug */
 134         (int (*)(SSL *,int))ssl_undefined_function,
 135         (int (*)(SSL *, unsigned char *, int))ssl_undefined_function,
 136         ssl_undefined_function,
 137         (int (*)(SSL *, unsigned char *, unsigned char *, int))ssl_undefined_function,
 138         (int (*)(SSL*, int))ssl_undefined_function,
 139         (int (*)(SSL *, EVP_MD_CTX *, EVP_MD_CTX *, const char*, int, unsigned char *))ssl_undefined_function
 140         };
 141
 142 int SSL_clear(SSL *s)
 143         {
 144
 145         if (s->method == NULL)
 146                 {
 147                 SSLerr(SSL_F_SSL_CLEAR,SSL_R_NO_METHOD_SPECIFIED);
 148                 return(0);
 149                 }
 150
 151         if (ssl_clear_bad_session(s))
 152                 {
 153                 SSL_SESSION_free(s->session);
 154                 s->session=NULL;
 155                 }
 156
 157         s->error=0;
 158         s->hit=0;
 159         s->shutdown=0;
 160
 161 #if 0 /* Disabled since version 1.10 of this file (early return not
 162        * needed because SSL_clear is not called when doing renegotiation) */
 163         /* This is set if we are doing dynamic renegotiation so keep
 164          * the old cipher.  It is sort of a SSL_clear_lite :-) */
 165         if (s->new_session) return(1);
 166 #else
 167         if (s->new_session)
 168                 {
 169                 SSLerr(SSL_F_SSL_CLEAR,ERR_R_INTERNAL_ERROR);
 170                 return 0;
 171                 }
 172 #endif
 173
 174         s->type=0;
 175
 176         s->state=SSL_ST_BEFORE|((s->server)?SSL_ST_ACCEPT:SSL_ST_CONNECT);
 177
 178         s->version=s->method->version;
 179         s->client_version=s->version;
 180         s->rwstate=SSL_NOTHING;
 181         s->rstate=SSL_ST_READ_HEADER;
 182 #if 0
 183         s->read_ahead=s->ctx->read_ahead;
 184 #endif
 185
 186         if (s->init_buf != NULL)
 187                 {
 188                 BUF_MEM_free(s->init_buf);
 189                 s->init_buf=NULL;
 190                 }
 191
 192         ssl_clear_cipher_ctx(s);
 193
 194         s->first_packet=0;
 195
 196 #if 1
 197         /* Check to see if we were changed into a different method, if
 198          * so, revert back if we are not doing session-id reuse. */
 199         if (!s->in_handshake && (s->session == NULL) && (s->method != s->ctx->method))
 200                 {
 201                 s->method->ssl_free(s);
 202                 s->method=s->ctx->method;
 203                 if (!s->method->ssl_new(s))
 204                         return(0);
 205                 }
 206         else
 207 #endif
 208                 s->method->ssl_clear(s);
 209         return(1);
 210         }
 211
 212 /** Used to change an SSL_CTXs default SSL method type */
 213 int SSL_CTX_set_ssl_version(SSL_CTX *ctx,SSL_METHOD *meth)
 214         {
 215         STACK_OF(SSL_CIPHER) *sk;
 216
 217         ctx->method=meth;
 218
 219         sk=ssl_create_cipher_list(ctx->method,&(ctx->cipher_list),
 220                 &(ctx->cipher_list_by_id),SSL_DEFAULT_CIPHER_LIST);
 221         if ((sk == NULL) || (sk_SSL_CIPHER_num(sk) <= 0))
 222                 {
 223                 SSLerr(SSL_F_SSL_CTX_SET_SSL_VERSION,SSL_R_SSL_LIBRARY_HAS_NO_CIPHERS);
 224                 return(0);
 225                 }
 226         return(1);
 227         }
 228
 229 SSL *SSL_new(SSL_CTX *ctx)
 230         {
 231         SSL *s;
 232
 233         if (ctx == NULL)
 234                 {
 235                 SSLerr(SSL_F_SSL_NEW,SSL_R_NULL_SSL_CTX);
 236                 return(NULL);
 237                 }
 238         if (ctx->method == NULL)
 239                 {
 240                 SSLerr(SSL_F_SSL_NEW,SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION);
 241                 return(NULL);
 242                 }
 243
 244         s=(SSL *)OPENSSL_malloc(sizeof(SSL));
 245         if (s == NULL) goto err;
 246         memset(s,0,sizeof(SSL));
 247
 248 #ifndef OPENSSL_NO_KRB5
 249         s->kssl_ctx = kssl_ctx_new();
 250 #endif  /* OPENSSL_NO_KRB5 */
 251
 252         s->options=ctx->options;
 253         s->mode=ctx->mode;
 254         s->max_cert_list=ctx->max_cert_list;
 255
 256         if (ctx->cert != NULL)
 257                 {
 258                 /* Earlier library versions used to copy the pointer to
 259                  * the CERT, not its contents; only when setting new
 260                  * parameters for the per-SSL copy, ssl_cert_new would be
 261                  * called (and the direct reference to the per-SSL_CTX
 262                  * settings would be lost, but those still were indirectly
 263                  * accessed for various purposes, and for that reason they
 264                  * used to be known as s->ctx->default_cert).
 265                  * Now we don't look at the SSL_CTX's CERT after having
 266                  * duplicated it once. */
 267
 268                 s->cert = ssl_cert_dup(ctx->cert);
 269                 if (s->cert == NULL)
 270                         goto err;
 271                 }
 272         else
 273                 s->cert=NULL; /* Cannot really happen (see SSL_CTX_new) */
 274
 275         s->read_ahead=ctx->read_ahead;
 276         s->msg_callback=ctx->msg_callback;
 277         s->msg_callback_arg=ctx->msg_callback_arg;
 278         s->verify_mode=ctx->verify_mode;
 279 #if 0
 280         s->verify_depth=ctx->verify_depth;
 281 #endif
 282         s->sid_ctx_length=ctx->sid_ctx_length;
 283         OPENSSL_assert(s->sid_ctx_length <= sizeof s->sid_ctx);
 284         memcpy(&s->sid_ctx,&ctx->sid_ctx,sizeof(s->sid_ctx));
 285         s->verify_callback=ctx->default_verify_callback;
 286         s->generate_session_id=ctx->generate_session_id;
 287
 288         s->param = X509_VERIFY_PARAM_new();
 289         if (!s->param)
 290                 goto err;
 291         X509_VERIFY_PARAM_inherit(s->param, ctx->param);
 292 #if 0
 293         s->purpose = ctx->purpose;
 294         s->trust = ctx->trust;
 295 #endif
 296         s->quiet_shutdown=ctx->quiet_shutdown;
 297
 298         CRYPTO_add(&ctx->references,1,CRYPTO_LOCK_SSL_CTX);
 299         s->ctx=ctx;
 300
 301         s->verify_result=X509_V_OK;
 302
 303         s->method=ctx->method;
 304
 305         if (!s->method->ssl_new(s))
 306                 goto err;
 307
 308         s->references=1;
 309         s->server=(ctx->method->ssl_accept == ssl_undefined_function)?0:1;
 310
 311         SSL_clear(s);
 312
 313         CRYPTO_new_ex_data(CRYPTO_EX_INDEX_SSL, s, &s->ex_data);
 314
 315         return(s);
 316 err:
 317         if (s != NULL)
 318                 {
 319                 if (s->cert != NULL)
 320                         ssl_cert_free(s->cert);
 321                 if (s->ctx != NULL)
 322                         SSL_CTX_free(s->ctx); /* decrement reference count */
 323                 OPENSSL_free(s);
 324                 }
 325         SSLerr(SSL_F_SSL_NEW,ERR_R_MALLOC_FAILURE);
 326         return(NULL);
 327         }
 328
 329 int SSL_CTX_set_session_id_context(SSL_CTX *ctx,const unsigned char *sid_ctx,
 330                                    unsigned int sid_ctx_len)
 331     {
 332     if(sid_ctx_len > sizeof ctx->sid_ctx)
 333         {
 334         SSLerr(SSL_F_SSL_CTX_SET_SESSION_ID_CONTEXT,SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
 335         return 0;
 336         }
 337     ctx->sid_ctx_length=sid_ctx_len;
 338     memcpy(ctx->sid_ctx,sid_ctx,sid_ctx_len);
 339
 340     return 1;
 341     }
 342
 343 int SSL_set_session_id_context(SSL *ssl,const unsigned char *sid_ctx,
 344                                unsigned int sid_ctx_len)
 345     {
 346     if(sid_ctx_len > SSL_MAX_SID_CTX_LENGTH)
 347         {
 348         SSLerr(SSL_F_SSL_SET_SESSION_ID_CONTEXT,SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
 349         return 0;
 350         }
 351     ssl->sid_ctx_length=sid_ctx_len;
 352     memcpy(ssl->sid_ctx,sid_ctx,sid_ctx_len);
 353
 354     return 1;
 355     }
 356
 357 int SSL_CTX_set_generate_session_id(SSL_CTX *ctx, GEN_SESSION_CB cb)
 358         {
 359         CRYPTO_w_lock(CRYPTO_LOCK_SSL_CTX);
 360         ctx->generate_session_id = cb;
 361         CRYPTO_w_unlock(CRYPTO_LOCK_SSL_CTX);
 362         return 1;
 363         }
 364
 365 int SSL_set_generate_session_id(SSL *ssl, GEN_SESSION_CB cb)
 366         {
 367         CRYPTO_w_lock(CRYPTO_LOCK_SSL);
 368         ssl->generate_session_id = cb;
 369         CRYPTO_w_unlock(CRYPTO_LOCK_SSL);
 370         return 1;
 371         }
 372
 373 int SSL_has_matching_session_id(const SSL *ssl, const unsigned char *id,
 374                                 unsigned int id_len)
 375         {
 376         /* A quick examination of SSL_SESSION_hash and SSL_SESSION_cmp shows how
 377          * we can "construct" a session to give us the desired check - ie. to
 378          * find if there's a session in the hash table that would conflict with
 379          * any new session built out of this id/id_len and the ssl_version in
 380          * use by this SSL. */
 381         SSL_SESSION r, *p;
 382
 383         if(id_len > sizeof r.session_id)
 384                 return 0;
 385
 386         r.ssl_version = ssl->version;
 387         r.session_id_length = id_len;
 388         memcpy(r.session_id, id, id_len);
 389         /* NB: SSLv2 always uses a fixed 16-byte session ID, so even if a
 390          * callback is calling us to check the uniqueness of a shorter ID, it
 391          * must be compared as a padded-out ID because that is what it will be
 392          * converted to when the callback has finished choosing it. */
 393         if((r.ssl_version == SSL2_VERSION) &&
 394                         (id_len < SSL2_SSL_SESSION_ID_LENGTH))
 395                 {
 396                 memset(r.session_id + id_len, 0,
 397                         SSL2_SSL_SESSION_ID_LENGTH - id_len);
 398                 r.session_id_length = SSL2_SSL_SESSION_ID_LENGTH;
 399                 }
 400
 401         CRYPTO_r_lock(CRYPTO_LOCK_SSL_CTX);
 402         p = (SSL_SESSION *)lh_retrieve(ssl->ctx->sessions, &r);
 403         CRYPTO_r_unlock(CRYPTO_LOCK_SSL_CTX);
 404         return (p != NULL);
 405         }
 406
 407 int SSL_CTX_set_purpose(SSL_CTX *s, int purpose)
 408         {
 409         return X509_VERIFY_PARAM_set_purpose(s->param, purpose);
 410         }
 411
 412 int SSL_set_purpose(SSL *s, int purpose)
 413         {
 414         return X509_VERIFY_PARAM_set_purpose(s->param, purpose);
 415         }
 416
 417 int SSL_CTX_set_trust(SSL_CTX *s, int trust)
 418         {
 419         return X509_VERIFY_PARAM_set_trust(s->param, trust);
 420         }
 421
 422 int SSL_set_trust(SSL *s, int trust)
 423         {
 424         return X509_VERIFY_PARAM_set_trust(s->param, trust);
 425         }
 426
 427 void SSL_free(SSL *s)
 428         {
 429         int i;
 430
 431         if(s == NULL)
 432             return;
 433
 434         i=CRYPTO_add(&s->references,-1,CRYPTO_LOCK_SSL);
 435 #ifdef REF_PRINT
 436         REF_PRINT("SSL",s);
 437 #endif
 438         if (i > 0) return;
 439 #ifdef REF_CHECK
 440         if (i < 0)
 441                 {
 442                 fprintf(stderr,"SSL_free, bad reference count\n");
 443                 abort(); /* ok */
 444                 }
 445 #endif
 446
 447         if (s->param)
 448                 X509_VERIFY_PARAM_free(s->param);
 449
 450         CRYPTO_free_ex_data(CRYPTO_EX_INDEX_SSL, s, &s->ex_data);
 451
 452         if (s->bbio != NULL)
 453                 {
 454                 /* If the buffering BIO is in place, pop it off */
 455                 if (s->bbio == s->wbio)
 456                         {
 457                         s->wbio=BIO_pop(s->wbio);
 458                         }
 459                 BIO_free(s->bbio);
 460                 s->bbio=NULL;
 461                 }
 462         if (s->rbio != NULL)
 463                 BIO_free_all(s->rbio);
 464         if ((s->wbio != NULL) && (s->wbio != s->rbio))
 465                 BIO_free_all(s->wbio);
 466
 467         if (s->init_buf != NULL) BUF_MEM_free(s->init_buf);
 468
 469         /* add extra stuff */
 470         if (s->cipher_list != NULL) sk_SSL_CIPHER_free(s->cipher_list);
 471         if (s->cipher_list_by_id != NULL) sk_SSL_CIPHER_free(s->cipher_list_by_id);
 472
 473         /* Make the next call work :-) */
 474         if (s->session != NULL)
 475                 {
 476                 ssl_clear_bad_session(s);
 477                 SSL_SESSION_free(s->session);
 478                 }
 479
 480         ssl_clear_cipher_ctx(s);
 481
 482         if (s->cert != NULL) ssl_cert_free(s->cert);
 483         /* Free up if allocated */
 484
 485         if (s->ctx) SSL_CTX_free(s->ctx);
 486
 487         if (s->client_CA != NULL)
 488                 sk_X509_NAME_pop_free(s->client_CA,X509_NAME_free);
 489
 490         if (s->method != NULL) s->method->ssl_free(s);
 491
 492 #ifndef OPENSSL_NO_KRB5
 493         if (s->kssl_ctx != NULL)
 494                 kssl_ctx_free(s->kssl_ctx);
 495 #endif  /* OPENSSL_NO_KRB5 */
 496
 497         OPENSSL_free(s);
 498         }
 499
 500 void SSL_set_bio(SSL *s,BIO *rbio,BIO *wbio)
 501         {
 502         /* If the output buffering BIO is still in place, remove it
 503          */
 504         if (s->bbio != NULL)
 505                 {
 506                 if (s->wbio == s->bbio)
 507                         {
 508                         s->wbio=s->wbio->next_bio;
 509                         s->bbio->next_bio=NULL;
 510                         }
 511                 }
 512         if ((s->rbio != NULL) && (s->rbio != rbio))
 513                 BIO_free_all(s->rbio);
 514         if ((s->wbio != NULL) && (s->wbio != wbio) && (s->rbio != s->wbio))
 515                 BIO_free_all(s->wbio);
 516         s->rbio=rbio;
 517         s->wbio=wbio;
 518         }
 519
 520 BIO *SSL_get_rbio(const SSL *s)
 521         { return(s->rbio); }
 522
 523 BIO *SSL_get_wbio(const SSL *s)
 524         { return(s->wbio); }
 525
 526 int SSL_get_fd(const SSL *s)
 527         {
 528         return(SSL_get_rfd(s));
 529         }
 530
 531 int SSL_get_rfd(const SSL *s)
 532         {
 533         int ret= -1;
 534         BIO *b,*r;
 535
 536         b=SSL_get_rbio(s);
 537         r=BIO_find_type(b,BIO_TYPE_DESCRIPTOR);
 538         if (r != NULL)
 539                 BIO_get_fd(r,&ret);
 540         return(ret);
 541         }
 542
 543 int SSL_get_wfd(const SSL *s)
 544         {
 545         int ret= -1;
 546         BIO *b,*r;
 547
 548         b=SSL_get_wbio(s);
 549         r=BIO_find_type(b,BIO_TYPE_DESCRIPTOR);
 550         if (r != NULL)
 551                 BIO_get_fd(r,&ret);
 552         return(ret);
 553         }
 554
 555 #ifndef OPENSSL_NO_SOCK
 556 int SSL_set_fd(SSL *s,int fd)
 557         {
 558         int ret=0;
 559         BIO *bio=NULL;
 560
 561         bio=BIO_new(BIO_s_socket());
 562
 563         if (bio == NULL)
 564                 {
 565                 SSLerr(SSL_F_SSL_SET_FD,ERR_R_BUF_LIB);
 566                 goto err;
 567                 }
 568         BIO_set_fd(bio,fd,BIO_NOCLOSE);
 569         SSL_set_bio(s,bio,bio);
 570         ret=1;
 571 err:
 572         return(ret);
 573         }
 574
 575 int SSL_set_wfd(SSL *s,int fd)
 576         {
 577         int ret=0;
 578         BIO *bio=NULL;
 579
 580         if ((s->rbio == NULL) || (BIO_method_type(s->rbio) != BIO_TYPE_SOCKET)
 581                 || ((int)BIO_get_fd(s->rbio,NULL) != fd))
 582                 {
 583                 bio=BIO_new(BIO_s_socket());
 584
 585                 if (bio == NULL)
 586                         { SSLerr(SSL_F_SSL_SET_WFD,ERR_R_BUF_LIB); goto err; }
 587                 BIO_set_fd(bio,fd,BIO_NOCLOSE);
 588                 SSL_set_bio(s,SSL_get_rbio(s),bio);
 589                 }
 590         else
 591                 SSL_set_bio(s,SSL_get_rbio(s),SSL_get_rbio(s));
 592         ret=1;
 593 err:
 594         return(ret);
 595         }
 596
 597 int SSL_set_rfd(SSL *s,int fd)
 598         {
 599         int ret=0;
 600         BIO *bio=NULL;
 601
 602         if ((s->wbio == NULL) || (BIO_method_type(s->wbio) != BIO_TYPE_SOCKET)
 603                 || ((int)BIO_get_fd(s->wbio,NULL) != fd))
 604                 {
 605                 bio=BIO_new(BIO_s_socket());
 606
 607                 if (bio == NULL)
 608                         {
 609                         SSLerr(SSL_F_SSL_SET_RFD,ERR_R_BUF_LIB);
 610                         goto err;
 611                         }
 612                 BIO_set_fd(bio,fd,BIO_NOCLOSE);
 613                 SSL_set_bio(s,bio,SSL_get_wbio(s));
 614                 }
 615         else
 616                 SSL_set_bio(s,SSL_get_wbio(s),SSL_get_wbio(s));
 617         ret=1;
 618 err:
 619         return(ret);
 620         }
 621 #endif
 622
 623
 624 /* return length of latest Finished message we sent, copy to 'buf' */
 625 size_t SSL_get_finished(const SSL *s, void *buf, size_t count)
 626         {
 627         size_t ret = 0;
 628
 629         if (s->s3 != NULL)
 630                 {
 631                 ret = s->s3->tmp.finish_md_len;
 632                 if (count > ret)
 633                         count = ret;
 634                 memcpy(buf, s->s3->tmp.finish_md, count);
 635                 }
 636         return ret;
 637         }
 638
 639 /* return length of latest Finished message we expected, copy to 'buf' */
 640 size_t SSL_get_peer_finished(const SSL *s, void *buf, size_t count)
 641         {
 642         size_t ret = 0;
 643
 644         if (s->s3 != NULL)
 645                 {
 646                 ret = s->s3->tmp.peer_finish_md_len;
 647                 if (count > ret)
 648                         count = ret;
 649                 memcpy(buf, s->s3->tmp.peer_finish_md, count);
 650                 }
 651         return ret;
 652         }
 653
 654
 655 int SSL_get_verify_mode(const SSL *s)
 656         {
 657         return(s->verify_mode);
 658         }
 659
 660 int SSL_get_verify_depth(const SSL *s)
 661         {
 662         return X509_VERIFY_PARAM_get_depth(s->param);
 663         }
 664
 665 int (*SSL_get_verify_callback(const SSL *s))(int,X509_STORE_CTX *)
 666         {
 667         return(s->verify_callback);
 668         }
 669
 670 int SSL_CTX_get_verify_mode(const SSL_CTX *ctx)
 671         {
 672         return(ctx->verify_mode);
 673         }
 674
 675 int SSL_CTX_get_verify_depth(const SSL_CTX *ctx)
 676         {
 677         return X509_VERIFY_PARAM_get_depth(ctx->param);
 678         }
 679
 680 int (*SSL_CTX_get_verify_callback(const SSL_CTX *ctx))(int,X509_STORE_CTX *)
 681         {
 682         return(ctx->default_verify_callback);
 683         }
 684
 685 void SSL_set_verify(SSL *s,int mode,
 686                     int (*callback)(int ok,X509_STORE_CTX *ctx))
 687         {
 688         s->verify_mode=mode;
 689         if (callback != NULL)
 690                 s->verify_callback=callback;
 691         }
 692
 693 void SSL_set_verify_depth(SSL *s,int depth)
 694         {
 695         X509_VERIFY_PARAM_set_depth(s->param, depth);
 696         }
 697
 698 void SSL_set_read_ahead(SSL *s,int yes)
 699         {
 700         s->read_ahead=yes;
 701         }
 702
 703 int SSL_get_read_ahead(const SSL *s)
 704         {
 705         return(s->read_ahead);
 706         }
 707
 708 int SSL_pending(const SSL *s)
 709         {
 710         /* SSL_pending cannot work properly if read-ahead is enabled
 711          * (SSL_[CTX_]ctrl(..., SSL_CTRL_SET_READ_AHEAD, 1, NULL)),
 712          * and it is impossible to fix since SSL_pending cannot report
 713          * errors that may be observed while scanning the new data.
 714          * (Note that SSL_pending() is often used as a boolean value,
 715          * so we'd better not return -1.)
 716          */
 717         return(s->method->ssl_pending(s));
 718         }
 719
 720 X509 *SSL_get_peer_certificate(const SSL *s)
 721         {
 722         X509 *r;
 723
 724         if ((s == NULL) || (s->session == NULL))
 725                 r=NULL;
 726         else
 727                 r=s->session->peer;
 728
 729         if (r == NULL) return(r);
 730
 731         CRYPTO_add(&r->references,1,CRYPTO_LOCK_X509);
 732
 733         return(r);
 734         }
 735
 736 STACK_OF(X509) *SSL_get_peer_cert_chain(const SSL *s)
 737         {
 738         STACK_OF(X509) *r;
 739
 740         if ((s == NULL) || (s->session == NULL) || (s->session->sess_cert == NULL))
 741                 r=NULL;
 742         else
 743                 r=s->session->sess_cert->cert_chain;
 744
 745         /* If we are a client, cert_chain includes the peer's own
 746          * certificate; if we are a server, it does not. */
 747
 748         return(r);
 749         }
 750
 751 /* Now in theory, since the calling process own 't' it should be safe to
 752  * modify.  We need to be able to read f without being hassled */
 753 void SSL_copy_session_id(SSL *t,const SSL *f)
 754         {
 755         CERT *tmp;
 756
 757         /* Do we need to to SSL locking? */
 758         SSL_set_session(t,SSL_get_session(f));
 759
 760         /* what if we are setup as SSLv2 but want to talk SSLv3 or
 761          * vice-versa */
 762         if (t->method != f->method)
 763                 {
 764                 t->method->ssl_free(t); /* cleanup current */
 765                 t->method=f->method;    /* change method */
 766                 t->method->ssl_new(t);  /* setup new */
 767                 }
 768
 769         tmp=t->cert;
 770         if (f->cert != NULL)
 771                 {
 772                 CRYPTO_add(&f->cert->references,1,CRYPTO_LOCK_SSL_CERT);
 773                 t->cert=f->cert;
 774                 }
 775         else
 776                 t->cert=NULL;
 777         if (tmp != NULL) ssl_cert_free(tmp);
 778         SSL_set_session_id_context(t,f->sid_ctx,f->sid_ctx_length);
 779         }
 780
 781 /* Fix this so it checks all the valid key/cert options */
 782 int SSL_CTX_check_private_key(const SSL_CTX *ctx)
 783         {
 784         if (    (ctx == NULL) ||
 785                 (ctx->cert == NULL) ||
 786                 (ctx->cert->key->x509 == NULL))
 787                 {
 788                 SSLerr(SSL_F_SSL_CTX_CHECK_PRIVATE_KEY,SSL_R_NO_CERTIFICATE_ASSIGNED);
 789                 return(0);
 790                 }
 791         if      (ctx->cert->key->privatekey == NULL)
 792                 {
 793                 SSLerr(SSL_F_SSL_CTX_CHECK_PRIVATE_KEY,SSL_R_NO_PRIVATE_KEY_ASSIGNED);
 794                 return(0);
 795                 }
 796         return(X509_check_private_key(ctx->cert->key->x509, ctx->cert->key->privatekey));
 797         }
 798
 799 /* Fix this function so that it takes an optional type parameter */
 800 int SSL_check_private_key(const SSL *ssl)
 801         {
 802         if (ssl == NULL)
 803                 {
 804                 SSLerr(SSL_F_SSL_CHECK_PRIVATE_KEY,ERR_R_PASSED_NULL_PARAMETER);
 805                 return(0);
 806                 }
 807         if (ssl->cert == NULL)
 808                 {
 809                 SSLerr(SSL_F_SSL_CHECK_PRIVATE_KEY,SSL_R_NO_CERTIFICATE_ASSIGNED);
 810                 return 0;
 811                 }
 812         if (ssl->cert->key->x509 == NULL)
 813                 {
 814                 SSLerr(SSL_F_SSL_CHECK_PRIVATE_KEY,SSL_R_NO_CERTIFICATE_ASSIGNED);
 815                 return(0);
 816                 }
 817         if (ssl->cert->key->privatekey == NULL)
 818                 {
 819                 SSLerr(SSL_F_SSL_CHECK_PRIVATE_KEY,SSL_R_NO_PRIVATE_KEY_ASSIGNED);
 820                 return(0);
 821                 }
 822         return(X509_check_private_key(ssl->cert->key->x509,
 823                 ssl->cert->key->privatekey));
 824         }
 825
 826 int SSL_accept(SSL *s)
 827         {
 828         if (s->handshake_func == 0)
 829                 /* Not properly initialized yet */
 830                 SSL_set_accept_state(s);
 831
 832         return(s->method->ssl_accept(s));
 833         }
 834
 835 int SSL_connect(SSL *s)
 836         {
 837         if (s->handshake_func == 0)
 838                 /* Not properly initialized yet */
 839                 SSL_set_connect_state(s);
 840
 841         return(s->method->ssl_connect(s));
 842         }
 843
 844 long SSL_get_default_timeout(const SSL *s)
 845         {
 846         return(s->method->get_timeout());
 847         }
 848
 849 int SSL_read(SSL *s,void *buf,int num)
 850         {
 851         if (s->handshake_func == 0)
 852                 {
 853                 SSLerr(SSL_F_SSL_READ, SSL_R_UNINITIALIZED);
 854                 return -1;
 855                 }
 856
 857         if (s->shutdown & SSL_RECEIVED_SHUTDOWN)
 858                 {
 859                 s->rwstate=SSL_NOTHING;
 860                 return(0);
 861                 }
 862         return(s->method->ssl_read(s,buf,num));
 863         }
 864
 865 int SSL_peek(SSL *s,void *buf,int num)
 866         {
 867         if (s->handshake_func == 0)
 868                 {
 869                 SSLerr(SSL_F_SSL_READ, SSL_R_UNINITIALIZED);
 870                 return -1;
 871                 }
 872
 873         if (s->shutdown & SSL_RECEIVED_SHUTDOWN)
 874                 {
 875                 return(0);
 876                 }
 877         return(s->method->ssl_peek(s,buf,num));
 878         }
 879
 880 int SSL_write(SSL *s,const void *buf,int num)
 881         {
 882         if (s->handshake_func == 0)
 883                 {
 884                 SSLerr(SSL_F_SSL_WRITE, SSL_R_UNINITIALIZED);
 885                 return -1;
 886                 }
 887
 888         if (s->shutdown & SSL_SENT_SHUTDOWN)
 889                 {
 890                 s->rwstate=SSL_NOTHING;
 891                 SSLerr(SSL_F_SSL_WRITE,SSL_R_PROTOCOL_IS_SHUTDOWN);
 892                 return(-1);
 893                 }
 894         return(s->method->ssl_write(s,buf,num));
 895         }
 896
 897 int SSL_shutdown(SSL *s)
 898         {
 899         /* Note that this function behaves differently from what one might
 900          * expect.  Return values are 0 for no success (yet),
 901          * 1 for success; but calling it once is usually not enough,
 902          * even if blocking I/O is used (see ssl3_shutdown).
 903          */
 904
 905         if (s->handshake_func == 0)
 906                 {
 907                 SSLerr(SSL_F_SSL_SHUTDOWN, SSL_R_UNINITIALIZED);
 908                 return -1;
 909                 }
 910
 911         if ((s != NULL) && !SSL_in_init(s))
 912                 return(s->method->ssl_shutdown(s));
 913         else
 914                 return(1);
 915         }
 916
 917 int SSL_renegotiate(SSL *s)
 918         {
 919         if (s->new_session == 0)
 920                 {
 921                 s->new_session=1;
 922                 }
 923         return(s->method->ssl_renegotiate(s));
 924         }
 925
 926 int SSL_renegotiate_pending(SSL *s)
 927         {
 928         /* becomes true when negotiation is requested;
 929          * false again once a handshake has finished */
 930         return (s->new_session != 0);
 931         }
 932
 933 long SSL_ctrl(SSL *s,int cmd,long larg,void *parg)
 934         {
 935         long l;
 936
 937         switch (cmd)
 938                 {
 939         case SSL_CTRL_GET_READ_AHEAD:
 940                 return(s->read_ahead);
 941         case SSL_CTRL_SET_READ_AHEAD:
 942                 l=s->read_ahead;
 943                 s->read_ahead=larg;
 944                 return(l);
 945
 946         case SSL_CTRL_SET_MSG_CALLBACK_ARG:
 947                 s->msg_callback_arg = parg;
 948                 return 1;
 949
 950         case SSL_CTRL_OPTIONS:
 951                 return(s->options|=larg);
 952         case SSL_CTRL_MODE:
 953                 return(s->mode|=larg);
 954         case SSL_CTRL_GET_MAX_CERT_LIST:
 955                 return(s->max_cert_list);
 956         case SSL_CTRL_SET_MAX_CERT_LIST:
 957                 l=s->max_cert_list;
 958                 s->max_cert_list=larg;
 959                 return(l);
 960         case SSL_CTRL_SET_MTU:
 961                 if (SSL_version(s) == DTLS1_VERSION)
 962                         {
 963                         s->d1->mtu = larg;
 964                         return larg;
 965                         }
 966                 return 0;
 967         default:
 968                 return(s->method->ssl_ctrl(s,cmd,larg,parg));
 969                 }
 970         }
 971
 972 long SSL_callback_ctrl(SSL *s, int cmd, void (*fp)(void))
 973         {
 974         switch(cmd)
 975                 {
 976         case SSL_CTRL_SET_MSG_CALLBACK:
 977                 s->msg_callback = (void (*)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg))(fp);
 978                 return 1;
 979
 980         default:
 981                 return(s->method->ssl_callback_ctrl(s,cmd,fp));
 982                 }
 983         }
 984
 985 struct lhash_st *SSL_CTX_sessions(SSL_CTX *ctx)
 986         {
 987         return ctx->sessions;
 988         }
 989
 990 long SSL_CTX_ctrl(SSL_CTX *ctx,int cmd,long larg,void *parg)
 991         {
 992         long l;
 993
 994         switch (cmd)
 995                 {
 996         case SSL_CTRL_GET_READ_AHEAD:
 997                 return(ctx->read_ahead);
 998         case SSL_CTRL_SET_READ_AHEAD:
 999                 l=ctx->read_ahead;
1000                 ctx->read_ahead=larg;
1001                 return(l);
1002
1003         case SSL_CTRL_SET_MSG_CALLBACK_ARG:
1004                 ctx->msg_callback_arg = parg;
1005                 return 1;
1006
1007         case SSL_CTRL_GET_MAX_CERT_LIST:
1008                 return(ctx->max_cert_list);
1009         case SSL_CTRL_SET_MAX_CERT_LIST:
1010                 l=ctx->max_cert_list;
1011                 ctx->max_cert_list=larg;
1012                 return(l);
1013
1014         case SSL_CTRL_SET_SESS_CACHE_SIZE:
1015                 l=ctx->session_cache_size;
1016                 ctx->session_cache_size=larg;
1017                 return(l);
1018         case SSL_CTRL_GET_SESS_CACHE_SIZE:
1019                 return(ctx->session_cache_size);
1020         case SSL_CTRL_SET_SESS_CACHE_MODE:
1021                 l=ctx->session_cache_mode;
1022                 ctx->session_cache_mode=larg;
1023                 return(l);
1024         case SSL_CTRL_GET_SESS_CACHE_MODE:
1025                 return(ctx->session_cache_mode);
1026
1027         case SSL_CTRL_SESS_NUMBER:
1028                 return(ctx->sessions->num_items);
1029         case SSL_CTRL_SESS_CONNECT:
1030                 return(ctx->stats.sess_connect);
1031         case SSL_CTRL_SESS_CONNECT_GOOD:
1032                 return(ctx->stats.sess_connect_good);
1033         case SSL_CTRL_SESS_CONNECT_RENEGOTIATE:
1034                 return(ctx->stats.sess_connect_renegotiate);
1035         case SSL_CTRL_SESS_ACCEPT:
1036                 return(ctx->stats.sess_accept);
1037         case SSL_CTRL_SESS_ACCEPT_GOOD:
1038                 return(ctx->stats.sess_accept_good);
1039         case SSL_CTRL_SESS_ACCEPT_RENEGOTIATE:
1040                 return(ctx->stats.sess_accept_renegotiate);
1041         case SSL_CTRL_SESS_HIT:
1042                 return(ctx->stats.sess_hit);
1043         case SSL_CTRL_SESS_CB_HIT:
1044                 return(ctx->stats.sess_cb_hit);
1045         case SSL_CTRL_SESS_MISSES:
1046                 return(ctx->stats.sess_miss);
1047         case SSL_CTRL_SESS_TIMEOUTS:
1048                 return(ctx->stats.sess_timeout);
1049         case SSL_CTRL_SESS_CACHE_FULL:
1050                 return(ctx->stats.sess_cache_full);
1051         case SSL_CTRL_OPTIONS:
1052                 return(ctx->options|=larg);
1053         case SSL_CTRL_MODE:
1054                 return(ctx->mode|=larg);
1055         default:
1056                 return(ctx->method->ssl_ctx_ctrl(ctx,cmd,larg,parg));
1057                 }
1058         }
1059
1060 long SSL_CTX_callback_ctrl(SSL_CTX *ctx, int cmd, void (*fp)(void))
1061         {
1062         switch(cmd)
1063                 {
1064         case SSL_CTRL_SET_MSG_CALLBACK:
1065                 ctx->msg_callback = (void (*)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg))(fp);
1066                 return 1;
1067
1068         default:
1069                 return(ctx->method->ssl_ctx_callback_ctrl(ctx,cmd,fp));
1070                 }
1071         }
1072
1073 int ssl_cipher_id_cmp(const SSL_CIPHER *a, const SSL_CIPHER *b)
1074         {
1075         long l;
1076
1077         l=a->id-b->id;
1078         if (l == 0L)
1079                 return(0);
1080         else
1081                 return((l > 0)?1:-1);
1082         }
1083
1084 int ssl_cipher_ptr_id_cmp(const SSL_CIPHER * const *ap,
1085                         const SSL_CIPHER * const *bp)
1086         {
1087         long l;
1088
1089         l=(*ap)->id-(*bp)->id;
1090         if (l == 0L)
1091                 return(0);
1092         else
1093                 return((l > 0)?1:-1);
1094         }
1095
1096 /** return a STACK of the ciphers available for the SSL and in order of
1097  * preference */
1098 STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *s)
1099         {
1100         if (s != NULL)
1101                 {
1102                 if (s->cipher_list != NULL)
1103                         {
1104                         return(s->cipher_list);
1105                         }
1106                 else if ((s->ctx != NULL) &&
1107                         (s->ctx->cipher_list != NULL))
1108                         {
1109                         return(s->ctx->cipher_list);
1110                         }
1111                 }
1112         return(NULL);
1113         }
1114
1115 /** return a STACK of the ciphers available for the SSL and in order of
1116  * algorithm id */
1117 STACK_OF(SSL_CIPHER) *ssl_get_ciphers_by_id(SSL *s)
1118         {
1119         if (s != NULL)
1120                 {
1121                 if (s->cipher_list_by_id != NULL)
1122                         {
1123                         return(s->cipher_list_by_id);
1124                         }
1125                 else if ((s->ctx != NULL) &&
1126                         (s->ctx->cipher_list_by_id != NULL))
1127                         {
1128                         return(s->ctx->cipher_list_by_id);
1129                         }
1130                 }
1131         return(NULL);
1132         }
1133
1134 /** The old interface to get the same thing as SSL_get_ciphers() */
1135 const char *SSL_get_cipher_list(const SSL *s,int n)
1136         {
1137         SSL_CIPHER *c;
1138         STACK_OF(SSL_CIPHER) *sk;
1139
1140         if (s == NULL) return(NULL);
1141         sk=SSL_get_ciphers(s);
1142         if ((sk == NULL) || (sk_SSL_CIPHER_num(sk) <= n))
1143                 return(NULL);
1144         c=sk_SSL_CIPHER_value(sk,n);
1145         if (c == NULL) return(NULL);
1146         return(c->name);
1147         }
1148
1149 /** specify the ciphers to be used by default by the SSL_CTX */
1150 int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str)
1151         {
1152         STACK_OF(SSL_CIPHER) *sk;
1153
1154         sk=ssl_create_cipher_list(ctx->method,&ctx->cipher_list,
1155                 &ctx->cipher_list_by_id,str);
1156 /* XXXX */
1157         return((sk == NULL)?0:1);
1158         }
1159
1160 /** specify the ciphers to be used by the SSL */
1161 int SSL_set_cipher_list(SSL *s,const char *str)
1162         {
1163         STACK_OF(SSL_CIPHER) *sk;
1164
1165         sk=ssl_create_cipher_list(s->ctx->method,&s->cipher_list,
1166                 &s->cipher_list_by_id,str);
1167 /* XXXX */
1168         return((sk == NULL)?0:1);
1169         }
1170
1171 /* works well for SSLv2, not so good for SSLv3 */
1172 char *SSL_get_shared_ciphers(const SSL *s,char *buf,int len)
1173         {
1174         char *p;
1175         const char *cp;
1176         STACK_OF(SSL_CIPHER) *sk;
1177         SSL_CIPHER *c;
1178         int i;
1179
1180         if ((s->session == NULL) || (s->session->ciphers == NULL) ||
1181                 (len < 2))
1182                 return(NULL);
1183
1184         p=buf;
1185         sk=s->session->ciphers;
1186         for (i=0; i<sk_SSL_CIPHER_num(sk); i++)
1187                 {
1188                 /* Decrement for either the ':' or a '\0' */
1189                 len--;
1190                 c=sk_SSL_CIPHER_value(sk,i);
1191                 for (cp=c->name; *cp; )
1192                         {
1193                         if (len-- == 0)
1194                                 {
1195                                 *p='\0';
1196                                 return(buf);
1197                                 }
1198                         else
1199                                 *(p++)= *(cp++);
1200                         }
1201                 *(p++)=':';
1202                 }
1203         p[-1]='\0';
1204         return(buf);
1205         }
1206
1207 int ssl_cipher_list_to_bytes(SSL *s,STACK_OF(SSL_CIPHER) *sk,unsigned char *p)
1208         {
1209         int i,j=0;
1210         SSL_CIPHER *c;
1211         unsigned char *q;
1212 #ifndef OPENSSL_NO_KRB5
1213         int nokrb5 = !kssl_tgt_is_available(s->kssl_ctx);
1214 #endif /* OPENSSL_NO_KRB5 */
1215
1216         if (sk == NULL) return(0);
1217         q=p;
1218
1219         for (i=0; i<sk_SSL_CIPHER_num(sk); i++)
1220                 {
1221                 c=sk_SSL_CIPHER_value(sk,i);
1222 #ifndef OPENSSL_NO_KRB5
1223                 if ((c->algorithms & SSL_KRB5) && nokrb5)
1224                     continue;
1225 #endif /* OPENSSL_NO_KRB5 */
1226                 j=ssl_put_cipher_by_char(s,c,p);
1227                 p+=j;
1228                 }
1229         return(p-q);
1230         }
1231
1232 STACK_OF(SSL_CIPHER) *ssl_bytes_to_cipher_list(SSL *s,unsigned char *p,int num,
1233                                                STACK_OF(SSL_CIPHER) **skp)
1234         {
1235         SSL_CIPHER *c;
1236         STACK_OF(SSL_CIPHER) *sk;
1237         int i,n;
1238
1239         n=ssl_put_cipher_by_char(s,NULL,NULL);
1240         if ((num%n) != 0)
1241                 {
1242                 SSLerr(SSL_F_SSL_BYTES_TO_CIPHER_LIST,SSL_R_ERROR_IN_RECEIVED_CIPHER_LIST);
1243                 return(NULL);
1244                 }
1245         if ((skp == NULL) || (*skp == NULL))
1246                 sk=sk_SSL_CIPHER_new_null(); /* change perhaps later */
1247         else
1248                 {
1249                 sk= *skp;
1250                 sk_SSL_CIPHER_zero(sk);
1251                 }
1252
1253         for (i=0; i<num; i+=n)
1254                 {
1255                 c=ssl_get_cipher_by_char(s,p);
1256                 p+=n;
1257                 if (c != NULL)
1258                         {
1259                         if (!sk_SSL_CIPHER_push(sk,c))
1260                                 {
1261                                 SSLerr(SSL_F_SSL_BYTES_TO_CIPHER_LIST,ERR_R_MALLOC_FAILURE);
1262                                 goto err;
1263                                 }
1264                         }
1265                 }
1266
1267         if (skp != NULL)
1268                 *skp=sk;
1269         return(sk);
1270 err:
1271         if ((skp == NULL) || (*skp == NULL))
1272                 sk_SSL_CIPHER_free(sk);
1273         return(NULL);
1274         }
1275
1276 unsigned long SSL_SESSION_hash(const SSL_SESSION *a)
1277         {
1278         unsigned long l;
1279
1280         l=(unsigned long)
1281                 ((unsigned int) a->session_id[0]     )|
1282                 ((unsigned int) a->session_id[1]<< 8L)|
1283                 ((unsigned long)a->session_id[2]<<16L)|
1284                 ((unsigned long)a->session_id[3]<<24L);
1285         return(l);
1286         }
1287
1288 /* NB: If this function (or indeed the hash function which uses a sort of
1289  * coarser function than this one) is changed, ensure
1290  * SSL_CTX_has_matching_session_id() is checked accordingly. It relies on being
1291  * able to construct an SSL_SESSION that will collide with any existing session
1292  * with a matching session ID. */
1293 int SSL_SESSION_cmp(const SSL_SESSION *a,const SSL_SESSION *b)
1294         {
1295         if (a->ssl_version != b->ssl_version)
1296                 return(1);
1297         if (a->session_id_length != b->session_id_length)
1298                 return(1);
1299         return(memcmp(a->session_id,b->session_id,a->session_id_length));
1300         }
1301
1302 /* These wrapper functions should remain rather than redeclaring
1303  * SSL_SESSION_hash and SSL_SESSION_cmp for void* types and casting each
1304  * variable. The reason is that the functions aren't static, they're exposed via
1305  * ssl.h. */
1306 static IMPLEMENT_LHASH_HASH_FN(SSL_SESSION_hash, SSL_SESSION *)
1307 static IMPLEMENT_LHASH_COMP_FN(SSL_SESSION_cmp, SSL_SESSION *)
1308
1309 SSL_CTX *SSL_CTX_new(SSL_METHOD *meth)
1310         {
1311         SSL_CTX *ret=NULL;
1312
1313         if (meth == NULL)
1314                 {
1315                 SSLerr(SSL_F_SSL_CTX_NEW,SSL_R_NULL_SSL_METHOD_PASSED);
1316                 return(NULL);
1317                 }
1318
1319         if (SSL_get_ex_data_X509_STORE_CTX_idx() < 0)
1320                 {
1321                 SSLerr(SSL_F_SSL_CTX_NEW,SSL_R_X509_VERIFICATION_SETUP_PROBLEMS);
1322                 goto err;
1323                 }
1324         ret=(SSL_CTX *)OPENSSL_malloc(sizeof(SSL_CTX));
1325         if (ret == NULL)
1326                 goto err;
1327
1328         memset(ret,0,sizeof(SSL_CTX));
1329
1330         ret->method=meth;
1331
1332         ret->cert_store=NULL;
1333         ret->session_cache_mode=SSL_SESS_CACHE_SERVER;
1334         ret->session_cache_size=SSL_SESSION_CACHE_MAX_SIZE_DEFAULT;
1335         ret->session_cache_head=NULL;
1336         ret->session_cache_tail=NULL;
1337
1338         /* We take the system default */
1339         ret->session_timeout=meth->get_timeout();
1340
1341         ret->new_session_cb=0;
1342         ret->remove_session_cb=0;
1343         ret->get_session_cb=0;
1344         ret->generate_session_id=0;
1345
1346         memset((char *)&ret->stats,0,sizeof(ret->stats));
1347
1348         ret->references=1;
1349         ret->quiet_shutdown=0;
1350
1351 /*      ret->cipher=NULL;*/
1352 /*      ret->s2->challenge=NULL;
1353         ret->master_key=NULL;
1354         ret->key_arg=NULL;
1355         ret->s2->conn_id=NULL; */
1356
1357         ret->info_callback=NULL;
1358
1359         ret->app_verify_callback=0;
1360         ret->app_verify_arg=NULL;
1361
1362         ret->max_cert_list=SSL_MAX_CERT_LIST_DEFAULT;
1363         ret->read_ahead=0;
1364         ret->msg_callback=0;
1365         ret->msg_callback_arg=NULL;
1366         ret->verify_mode=SSL_VERIFY_NONE;
1367 #if 0
1368         ret->verify_depth=-1; /* Don't impose a limit (but x509_lu.c does) */
1369 #endif
1370         ret->sid_ctx_length=0;
1371         ret->default_verify_callback=NULL;
1372         if ((ret->cert=ssl_cert_new()) == NULL)
1373                 goto err;
1374
1375         ret->default_passwd_callback=0;
1376         ret->default_passwd_callback_userdata=NULL;
1377         ret->client_cert_cb=0;
1378     ret->app_gen_cookie_cb=0;
1379     ret->app_verify_cookie_cb=0;
1380
1381         ret->sessions=lh_new(LHASH_HASH_FN(SSL_SESSION_hash),
1382                         LHASH_COMP_FN(SSL_SESSION_cmp));
1383         if (ret->sessions == NULL) goto err;
1384         ret->cert_store=X509_STORE_new();
1385         if (ret->cert_store == NULL) goto err;
1386
1387         ssl_create_cipher_list(ret->method,
1388                 &ret->cipher_list,&ret->cipher_list_by_id,
1389                 SSL_DEFAULT_CIPHER_LIST);
1390         if (ret->cipher_list == NULL
1391             || sk_SSL_CIPHER_num(ret->cipher_list) <= 0)
1392                 {
1393                 SSLerr(SSL_F_SSL_CTX_NEW,SSL_R_LIBRARY_HAS_NO_CIPHERS);
1394                 goto err2;
1395                 }
1396
1397         ret->param = X509_VERIFY_PARAM_new();
1398         if (!ret->param)
1399                 goto err;
1400
1401         if ((ret->rsa_md5=EVP_get_digestbyname("ssl2-md5")) == NULL)
1402                 {
1403                 SSLerr(SSL_F_SSL_CTX_NEW,SSL_R_UNABLE_TO_LOAD_SSL2_MD5_ROUTINES);
1404                 goto err2;
1405                 }
1406         if ((ret->md5=EVP_get_digestbyname("ssl3-md5")) == NULL)
1407                 {
1408                 SSLerr(SSL_F_SSL_CTX_NEW,SSL_R_UNABLE_TO_LOAD_SSL3_MD5_ROUTINES);
1409                 goto err2;
1410                 }
1411         if ((ret->sha1=EVP_get_digestbyname("ssl3-sha1")) == NULL)
1412                 {
1413                 SSLerr(SSL_F_SSL_CTX_NEW,SSL_R_UNABLE_TO_LOAD_SSL3_SHA1_ROUTINES);
1414                 goto err2;
1415                 }
1416
1417         if ((ret->client_CA=sk_X509_NAME_new_null()) == NULL)
1418                 goto err;
1419
1420         CRYPTO_new_ex_data(CRYPTO_EX_INDEX_SSL_CTX, ret, &ret->ex_data);
1421
1422         ret->extra_certs=NULL;
1423         ret->comp_methods=SSL_COMP_get_compression_methods();
1424
1425         return(ret);
1426 err:
1427         SSLerr(SSL_F_SSL_CTX_NEW,ERR_R_MALLOC_FAILURE);
1428 err2:
1429         if (ret != NULL) SSL_CTX_free(ret);
1430         return(NULL);
1431         }
1432
1433 #if 0
1434 static void SSL_COMP_free(SSL_COMP *comp)
1435     { OPENSSL_free(comp); }
1436 #endif
1437
1438 void SSL_CTX_free(SSL_CTX *a)
1439         {
1440         int i;
1441
1442         if (a == NULL) return;
1443
1444         i=CRYPTO_add(&a->references,-1,CRYPTO_LOCK_SSL_CTX);
1445 #ifdef REF_PRINT
1446         REF_PRINT("SSL_CTX",a);
1447 #endif
1448         if (i > 0) return;
1449 #ifdef REF_CHECK
1450         if (i < 0)
1451                 {
1452                 fprintf(stderr,"SSL_CTX_free, bad reference count\n");
1453                 abort(); /* ok */
1454                 }
1455 #endif
1456
1457         if (a->param)
1458                 X509_VERIFY_PARAM_free(a->param);
1459
1460         /*
1461          * Free internal session cache. However: the remove_cb() may reference
1462          * the ex_data of SSL_CTX, thus the ex_data store can only be removed
1463          * after the sessions were flushed.
1464          * As the ex_data handling routines might also touch the session cache,
1465          * the most secure solution seems to be: empty (flush) the cache, then
1466          * free ex_data, then finally free the cache.
1467          * (See ticket [openssl.org #212].)
1468          */
1469         if (a->sessions != NULL)
1470                 SSL_CTX_flush_sessions(a,0);
1471
1472         CRYPTO_free_ex_data(CRYPTO_EX_INDEX_SSL_CTX, a, &a->ex_data);
1473
1474         if (a->sessions != NULL)
1475                 lh_free(a->sessions);
1476
1477         if (a->cert_store != NULL)
1478                 X509_STORE_free(a->cert_store);
1479         if (a->cipher_list != NULL)
1480                 sk_SSL_CIPHER_free(a->cipher_list);
1481         if (a->cipher_list_by_id != NULL)
1482                 sk_SSL_CIPHER_free(a->cipher_list_by_id);
1483         if (a->cert != NULL)
1484                 ssl_cert_free(a->cert);
1485         if (a->client_CA != NULL)
1486                 sk_X509_NAME_pop_free(a->client_CA,X509_NAME_free);
1487         if (a->extra_certs != NULL)
1488                 sk_X509_pop_free(a->extra_certs,X509_free);
1489 #if 0 /* This should never be done, since it removes a global database */
1490         if (a->comp_methods != NULL)
1491                 sk_SSL_COMP_pop_free(a->comp_methods,SSL_COMP_free);
1492 #else
1493         a->comp_methods = NULL;
1494 #endif
1495         OPENSSL_free(a);
1496         }
1497
1498 void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, pem_password_cb *cb)
1499         {
1500         ctx->default_passwd_callback=cb;
1501         }
1502
1503 void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx,void *u)
1504         {
1505         ctx->default_passwd_callback_userdata=u;
1506         }
1507
1508 void SSL_CTX_set_cert_verify_callback(SSL_CTX *ctx, int (*cb)(X509_STORE_CTX *,void *), void *arg)
1509         {
1510         ctx->app_verify_callback=cb;
1511         ctx->app_verify_arg=arg;
1512         }
1513
1514 void SSL_CTX_set_verify(SSL_CTX *ctx,int mode,int (*cb)(int, X509_STORE_CTX *))
1515         {
1516         ctx->verify_mode=mode;
1517         ctx->default_verify_callback=cb;
1518         }
1519
1520 void SSL_CTX_set_verify_depth(SSL_CTX *ctx,int depth)
1521         {
1522         X509_VERIFY_PARAM_set_depth(ctx->param, depth);
1523         }
1524
1525 void ssl_set_cert_masks(CERT *c, SSL_CIPHER *cipher)
1526         {
1527         CERT_PKEY *cpk;
1528         int rsa_enc,rsa_tmp,rsa_sign,dh_tmp,dh_rsa,dh_dsa,dsa_sign;
1529         int rsa_enc_export,dh_rsa_export,dh_dsa_export;
1530         int rsa_tmp_export,dh_tmp_export,kl;
1531         unsigned long mask,emask;
1532         int have_ecc_cert, have_ecdh_tmp, ecdh_ok, ecdsa_ok, ecc_pkey_size;
1533         X509 *x = NULL;
1534         EVP_PKEY *ecc_pkey = NULL;
1535         int signature_nid = 0;
1536
1537         if (c == NULL) return;
1538
1539         kl=SSL_C_EXPORT_PKEYLENGTH(cipher);
1540
1541 #ifndef OPENSSL_NO_RSA
1542         rsa_tmp=(c->rsa_tmp != NULL || c->rsa_tmp_cb != NULL);
1543         rsa_tmp_export=(c->rsa_tmp_cb != NULL ||
1544                 (rsa_tmp && RSA_size(c->rsa_tmp)*8 <= kl));
1545 #else
1546         rsa_tmp=rsa_tmp_export=0;
1547 #endif
1548 #ifndef OPENSSL_NO_DH
1549         dh_tmp=(c->dh_tmp != NULL || c->dh_tmp_cb != NULL);
1550         dh_tmp_export=(c->dh_tmp_cb != NULL ||
1551                 (dh_tmp && DH_size(c->dh_tmp)*8 <= kl));
1552 #else
1553         dh_tmp=dh_tmp_export=0;
1554 #endif
1555
1556 #ifndef OPENSSL_NO_ECDH
1557         have_ecdh_tmp=(c->ecdh_tmp != NULL || c->ecdh_tmp_cb != NULL);
1558 #endif
1559         cpk= &(c->pkeys[SSL_PKEY_RSA_ENC]);
1560         rsa_enc= (cpk->x509 != NULL && cpk->privatekey != NULL);
1561         rsa_enc_export=(rsa_enc && EVP_PKEY_size(cpk->privatekey)*8 <= kl);
1562         cpk= &(c->pkeys[SSL_PKEY_RSA_SIGN]);
1563         rsa_sign=(cpk->x509 != NULL && cpk->privatekey != NULL);
1564         cpk= &(c->pkeys[SSL_PKEY_DSA_SIGN]);
1565         dsa_sign=(cpk->x509 != NULL && cpk->privatekey != NULL);
1566         cpk= &(c->pkeys[SSL_PKEY_DH_RSA]);
1567         dh_rsa=  (cpk->x509 != NULL && cpk->privatekey != NULL);
1568         dh_rsa_export=(dh_rsa && EVP_PKEY_size(cpk->privatekey)*8 <= kl);
1569         cpk= &(c->pkeys[SSL_PKEY_DH_DSA]);
1570 /* FIX THIS EAY EAY EAY */
1571         dh_dsa=  (cpk->x509 != NULL && cpk->privatekey != NULL);
1572         dh_dsa_export=(dh_dsa && EVP_PKEY_size(cpk->privatekey)*8 <= kl);
1573         cpk= &(c->pkeys[SSL_PKEY_ECC]);
1574         have_ecc_cert= (cpk->x509 != NULL && cpk->privatekey != NULL);
1575         mask=0;
1576         emask=0;
1577
1578 #ifdef CIPHER_DEBUG
1579         printf("rt=%d rte=%d dht=%d re=%d ree=%d rs=%d ds=%d dhr=%d dhd=%d\n",
1580                 rsa_tmp,rsa_tmp_export,dh_tmp,
1581                 rsa_enc,rsa_enc_export,rsa_sign,dsa_sign,dh_rsa,dh_dsa);
1582 #endif
1583
1584         if (rsa_enc || (rsa_tmp && rsa_sign))
1585                 mask|=SSL_kRSA;
1586         if (rsa_enc_export || (rsa_tmp_export && (rsa_sign || rsa_enc)))
1587                 emask|=SSL_kRSA;
1588
1589 #if 0
1590         /* The match needs to be both kEDH and aRSA or aDSA, so don't worry */
1591         if (    (dh_tmp || dh_rsa || dh_dsa) &&
1592                 (rsa_enc || rsa_sign || dsa_sign))
1593                 mask|=SSL_kEDH;
1594         if ((dh_tmp_export || dh_rsa_export || dh_dsa_export) &&
1595                 (rsa_enc || rsa_sign || dsa_sign))
1596                 emask|=SSL_kEDH;
1597 #endif
1598
1599         if (dh_tmp_export)
1600                 emask|=SSL_kEDH;
1601
1602         if (dh_tmp)
1603                 mask|=SSL_kEDH;
1604
1605         if (dh_rsa) mask|=SSL_kDHr;
1606         if (dh_rsa_export) emask|=SSL_kDHr;
1607
1608         if (dh_dsa) mask|=SSL_kDHd;
1609         if (dh_dsa_export) emask|=SSL_kDHd;
1610
1611         if (rsa_enc || rsa_sign)
1612                 {
1613                 mask|=SSL_aRSA;
1614                 emask|=SSL_aRSA;
1615                 }
1616
1617         if (dsa_sign)
1618                 {
1619                 mask|=SSL_aDSS;
1620                 emask|=SSL_aDSS;
1621                 }
1622
1623         mask|=SSL_aNULL;
1624         emask|=SSL_aNULL;
1625
1626 #ifndef OPENSSL_NO_KRB5
1627         mask|=SSL_kKRB5|SSL_aKRB5;
1628         emask|=SSL_kKRB5|SSL_aKRB5;
1629 #endif
1630
1631         /* An ECC certificate may be usable for ECDH and/or
1632          * ECDSA cipher suites depending on the key usage extension.
1633          */
1634         if (have_ecc_cert)
1635                 {
1636                 /* This call populates extension flags (ex_flags) */
1637                 x = (c->pkeys[SSL_PKEY_ECC]).x509;
1638                 X509_check_purpose(x, -1, 0);
1639                 ecdh_ok = (x->ex_flags & EXFLAG_KUSAGE) ?
1640                     (x->ex_kusage & X509v3_KU_KEY_AGREEMENT) : 1;
1641                 ecdsa_ok = (x->ex_flags & EXFLAG_KUSAGE) ?
1642                     (x->ex_kusage & X509v3_KU_DIGITAL_SIGNATURE) : 1;
1643                 ecc_pkey = X509_get_pubkey(x);
1644                 ecc_pkey_size = (ecc_pkey != NULL) ?
1645                     EVP_PKEY_bits(ecc_pkey) : 0;
1646                 EVP_PKEY_free(ecc_pkey);
1647                 if ((x->sig_alg) && (x->sig_alg->algorithm))
1648                         signature_nid = OBJ_obj2nid(x->sig_alg->algorithm);
1649 #ifndef OPENSSL_NO_ECDH
1650                 if (ecdh_ok)
1651                         {
1652                         if ((signature_nid == NID_md5WithRSAEncryption) ||
1653                             (signature_nid == NID_md4WithRSAEncryption) ||
1654                             (signature_nid == NID_md2WithRSAEncryption))
1655                                 {
1656                                 mask|=SSL_kECDH|SSL_aRSA;
1657                                 if (ecc_pkey_size <= 163)
1658                                         emask|=SSL_kECDH|SSL_aRSA;
1659                                 }
1660                         if (signature_nid == NID_ecdsa_with_SHA1)
1661                                 {
1662                                 mask|=SSL_kECDH|SSL_aECDSA;
1663                                 if (ecc_pkey_size <= 163)
1664                                         emask|=SSL_kECDH|SSL_aECDSA;
1665                                 }
1666                         }
1667 #endif
1668 #ifndef OPENSSL_NO_ECDSA
1669                 if (ecdsa_ok)
1670                         {
1671                         mask|=SSL_aECDSA;
1672                         emask|=SSL_aECDSA;
1673                         }
1674 #endif
1675                 }
1676
1677 #ifndef OPENSSL_NO_ECDH
1678         if (have_ecdh_tmp)
1679                 {
1680                 mask|=SSL_kECDHE;
1681                 emask|=SSL_kECDHE;
1682                 }
1683 #endif
1684         c->mask=mask;
1685         c->export_mask=emask;
1686         c->valid=1;
1687         }
1688
1689 /* This handy macro borrowed from crypto/x509v3/v3_purp.c */
1690 #define ku_reject(x, usage) \
1691         (((x)->ex_flags & EXFLAG_KUSAGE) && !((x)->ex_kusage & (usage)))
1692
1693 int check_srvr_ecc_cert_and_alg(X509 *x, SSL_CIPHER *cs)
1694         {
1695         unsigned long alg = cs->algorithms;
1696         EVP_PKEY *pkey = NULL;
1697         int keysize = 0;
1698         int signature_nid = 0;
1699
1700         if (SSL_C_IS_EXPORT(cs))
1701                 {
1702                 /* ECDH key length in export ciphers must be <= 163 bits */
1703                 pkey = X509_get_pubkey(x);
1704                 if (pkey == NULL) return 0;
1705                 keysize = EVP_PKEY_bits(pkey);
1706                 EVP_PKEY_free(pkey);
1707                 if (keysize > 163) return 0;
1708                 }
1709
1710         /* This call populates the ex_flags field correctly */
1711         X509_check_purpose(x, -1, 0);
1712         if ((x->sig_alg) && (x->sig_alg->algorithm))
1713                 signature_nid = OBJ_obj2nid(x->sig_alg->algorithm);
1714         if (alg & SSL_kECDH)
1715                 {
1716                 /* key usage, if present, must allow key agreement */
1717                 if (ku_reject(x, X509v3_KU_KEY_AGREEMENT))
1718                         {
1719                         return 0;
1720                         }
1721                 if (alg & SSL_aECDSA)
1722                         {
1723                         /* signature alg must be ECDSA */
1724                         if (signature_nid != NID_ecdsa_with_SHA1)
1725                                 {
1726                                 return 0;
1727                                 }
1728                         }
1729                 if (alg & SSL_aRSA)
1730                         {
1731                         /* signature alg must be RSA */
1732                         if ((signature_nid != NID_md5WithRSAEncryption) &&
1733                             (signature_nid != NID_md4WithRSAEncryption) &&
1734                             (signature_nid != NID_md2WithRSAEncryption))
1735                                 {
1736                                 return 0;
1737                                 }
1738                         }
1739                 }
1740         else if (alg & SSL_aECDSA)
1741                 {
1742                 /* key usage, if present, must allow signing */
1743                 if (ku_reject(x, X509v3_KU_DIGITAL_SIGNATURE))
1744                         {
1745                         return 0;
1746                         }
1747                 }
1748
1749         return 1;  /* all checks are ok */
1750         }
1751
1752 /* THIS NEEDS CLEANING UP */
1753 X509 *ssl_get_server_send_cert(SSL *s)
1754         {
1755         unsigned long alg,mask,kalg;
1756         CERT *c;
1757         int i,is_export;
1758
1759         c=s->cert;
1760         ssl_set_cert_masks(c, s->s3->tmp.new_cipher);
1761         alg=s->s3->tmp.new_cipher->algorithms;
1762         is_export=SSL_C_IS_EXPORT(s->s3->tmp.new_cipher);
1763         mask=is_export?c->export_mask:c->mask;
1764         kalg=alg&(SSL_MKEY_MASK|SSL_AUTH_MASK);
1765
1766         if (kalg & SSL_kECDH)
1767                 {
1768                 /* we don't need to look at SSL_kECDHE
1769                  * since no certificate is needed for
1770                  * anon ECDH and for authenticated
1771                  * ECDHE, the check for the auth
1772                  * algorithm will set i correctly
1773                  * NOTE: For ECDH-RSA, we need an ECC
1774                  * not an RSA cert but for ECDHE-RSA
1775                  * we need an RSA cert. Placing the
1776                  * checks for SSL_kECDH before RSA
1777                  * checks ensures the correct cert is chosen.
1778                  */
1779                 i=SSL_PKEY_ECC;
1780                 }
1781         else if (kalg & SSL_aECDSA)
1782                 {
1783                 i=SSL_PKEY_ECC;
1784                 }
1785         else if (kalg & SSL_kDHr)
1786                 i=SSL_PKEY_DH_RSA;
1787         else if (kalg & SSL_kDHd)
1788                 i=SSL_PKEY_DH_DSA;
1789         else if (kalg & SSL_aDSS)
1790                 i=SSL_PKEY_DSA_SIGN;
1791         else if (kalg & SSL_aRSA)
1792                 {
1793                 if (c->pkeys[SSL_PKEY_RSA_ENC].x509 == NULL)
1794                         i=SSL_PKEY_RSA_SIGN;
1795                 else
1796                         i=SSL_PKEY_RSA_ENC;
1797                 }
1798         else if (kalg & SSL_aKRB5)
1799                 {
1800                 /* VRS something else here? */
1801                 return(NULL);
1802                 }
1803         else /* if (kalg & SSL_aNULL) */
1804                 {
1805                 SSLerr(SSL_F_SSL_GET_SERVER_SEND_CERT,ERR_R_INTERNAL_ERROR);
1806                 return(NULL);
1807                 }
1808         if (c->pkeys[i].x509 == NULL) return(NULL);
1809
1810         return(c->pkeys[i].x509);
1811         }
1812
1813 EVP_PKEY *ssl_get_sign_pkey(SSL *s,SSL_CIPHER *cipher)
1814         {
1815         unsigned long alg;
1816         CERT *c;
1817
1818         alg=cipher->algorithms;
1819         c=s->cert;
1820
1821         if ((alg & SSL_aDSS) &&
1822                 (c->pkeys[SSL_PKEY_DSA_SIGN].privatekey != NULL))
1823                 return(c->pkeys[SSL_PKEY_DSA_SIGN].privatekey);
1824         else if (alg & SSL_aRSA)
1825                 {
1826                 if (c->pkeys[SSL_PKEY_RSA_SIGN].privatekey != NULL)
1827                         return(c->pkeys[SSL_PKEY_RSA_SIGN].privatekey);
1828                 else if (c->pkeys[SSL_PKEY_RSA_ENC].privatekey != NULL)
1829                         return(c->pkeys[SSL_PKEY_RSA_ENC].privatekey);
1830                 else
1831                         return(NULL);
1832                 }
1833         else if ((alg & SSL_aECDSA) &&
1834                  (c->pkeys[SSL_PKEY_ECC].privatekey != NULL))
1835                 return(c->pkeys[SSL_PKEY_ECC].privatekey);
1836         else /* if (alg & SSL_aNULL) */
1837                 {
1838                 SSLerr(SSL_F_SSL_GET_SIGN_PKEY,ERR_R_INTERNAL_ERROR);
1839                 return(NULL);
1840                 }
1841         }
1842
1843 void ssl_update_cache(SSL *s,int mode)
1844         {
1845         int i;
1846
1847         /* If the session_id_length is 0, we are not supposed to cache it,
1848          * and it would be rather hard to do anyway :-) */
1849         if (s->session->session_id_length == 0) return;
1850
1851         i=s->ctx->session_cache_mode;
1852         if ((i & mode) && (!s->hit)
1853                 && ((i & SSL_SESS_CACHE_NO_INTERNAL_STORE)
1854                     || SSL_CTX_add_session(s->ctx,s->session))
1855                 && (s->ctx->new_session_cb != NULL))
1856                 {
1857                 CRYPTO_add(&s->session->references,1,CRYPTO_LOCK_SSL_SESSION);
1858                 if (!s->ctx->new_session_cb(s,s->session))
1859                         SSL_SESSION_free(s->session);
1860                 }
1861
1862         /* auto flush every 255 connections */
1863         if ((!(i & SSL_SESS_CACHE_NO_AUTO_CLEAR)) &&
1864                 ((i & mode) == mode))
1865                 {
1866                 if (  (((mode & SSL_SESS_CACHE_CLIENT)
1867                         ?s->ctx->stats.sess_connect_good
1868                         :s->ctx->stats.sess_accept_good) & 0xff) == 0xff)
1869                         {
1870                         SSL_CTX_flush_sessions(s->ctx,time(NULL));
1871                         }
1872                 }
1873         }
1874
1875 SSL_METHOD *SSL_get_ssl_method(SSL *s)
1876         {
1877         return(s->method);
1878         }
1879
1880 int SSL_set_ssl_method(SSL *s,SSL_METHOD *meth)
1881         {
1882         int conn= -1;
1883         int ret=1;
1884
1885         if (s->method != meth)
1886                 {
1887                 if (s->handshake_func != NULL)
1888                         conn=(s->handshake_func == s->method->ssl_connect);
1889
1890                 if (s->method->version == meth->version)
1891                         s->method=meth;
1892                 else
1893                         {
1894                         s->method->ssl_free(s);
1895                         s->method=meth;
1896                         ret=s->method->ssl_new(s);
1897                         }
1898
1899                 if (conn == 1)
1900                         s->handshake_func=meth->ssl_connect;
1901                 else if (conn == 0)
1902                         s->handshake_func=meth->ssl_accept;
1903                 }
1904         return(ret);
1905         }
1906
1907 int SSL_get_error(const SSL *s,int i)
1908         {
1909         int reason;
1910         unsigned long l;
1911         BIO *bio;
1912
1913         if (i > 0) return(SSL_ERROR_NONE);
1914
1915         /* Make things return SSL_ERROR_SYSCALL when doing SSL_do_handshake
1916          * etc, where we do encode the error */
1917         if ((l=ERR_peek_error()) != 0)
1918                 {
1919                 if (ERR_GET_LIB(l) == ERR_LIB_SYS)
1920                         return(SSL_ERROR_SYSCALL);
1921                 else
1922                         return(SSL_ERROR_SSL);
1923                 }
1924
1925         if ((i < 0) && SSL_want_read(s))
1926                 {
1927                 bio=SSL_get_rbio(s);
1928                 if (BIO_should_read(bio))
1929                         return(SSL_ERROR_WANT_READ);
1930                 else if (BIO_should_write(bio))
1931                         /* This one doesn't make too much sense ... We never try
1932                          * to write to the rbio, and an application program where
1933                          * rbio and wbio are separate couldn't even know what it
1934                          * should wait for.
1935                          * However if we ever set s->rwstate incorrectly
1936                          * (so that we have SSL_want_read(s) instead of
1937                          * SSL_want_write(s)) and rbio and wbio *are* the same,
1938                          * this test works around that bug; so it might be safer
1939                          * to keep it. */
1940                         return(SSL_ERROR_WANT_WRITE);
1941                 else if (BIO_should_io_special(bio))
1942                         {
1943                         reason=BIO_get_retry_reason(bio);
1944                         if (reason == BIO_RR_CONNECT)
1945                                 return(SSL_ERROR_WANT_CONNECT);
1946                         else if (reason == BIO_RR_ACCEPT)
1947                                 return(SSL_ERROR_WANT_ACCEPT);
1948                         else
1949                                 return(SSL_ERROR_SYSCALL); /* unknown */
1950                         }
1951                 }
1952
1953         if ((i < 0) && SSL_want_write(s))
1954                 {
1955                 bio=SSL_get_wbio(s);
1956                 if (BIO_should_write(bio))
1957                         return(SSL_ERROR_WANT_WRITE);
1958                 else if (BIO_should_read(bio))
1959                         /* See above (SSL_want_read(s) with BIO_should_write(bio)) */
1960                         return(SSL_ERROR_WANT_READ);
1961                 else if (BIO_should_io_special(bio))
1962                         {
1963                         reason=BIO_get_retry_reason(bio);
1964                         if (reason == BIO_RR_CONNECT)
1965                                 return(SSL_ERROR_WANT_CONNECT);
1966                         else if (reason == BIO_RR_ACCEPT)
1967                                 return(SSL_ERROR_WANT_ACCEPT);
1968                         else
1969                                 return(SSL_ERROR_SYSCALL);
1970                         }
1971                 }
1972         if ((i < 0) && SSL_want_x509_lookup(s))
1973                 {
1974                 return(SSL_ERROR_WANT_X509_LOOKUP);
1975                 }
1976
1977         if (i == 0)
1978                 {
1979                 if (s->version == SSL2_VERSION)
1980                         {
1981                         /* assume it is the socket being closed */
1982                         return(SSL_ERROR_ZERO_RETURN);
1983                         }
1984                 else
1985                         {
1986                         if ((s->shutdown & SSL_RECEIVED_SHUTDOWN) &&
1987                                 (s->s3->warn_alert == SSL_AD_CLOSE_NOTIFY))
1988                                 return(SSL_ERROR_ZERO_RETURN);
1989                         }
1990                 }
1991         return(SSL_ERROR_SYSCALL);
1992         }
1993
1994 int SSL_do_handshake(SSL *s)
1995         {
1996         int ret=1;
1997
1998         if (s->handshake_func == NULL)
1999                 {
2000                 SSLerr(SSL_F_SSL_DO_HANDSHAKE,SSL_R_CONNECTION_TYPE_NOT_SET);
2001                 return(-1);
2002                 }
2003
2004         s->method->ssl_renegotiate_check(s);
2005
2006         if (SSL_in_init(s) || SSL_in_before(s))
2007                 {
2008                 ret=s->handshake_func(s);
2009                 }
2010         return(ret);
2011         }
2012
2013 /* For the next 2 functions, SSL_clear() sets shutdown and so
2014  * one of these calls will reset it */
2015 void SSL_set_accept_state(SSL *s)
2016         {
2017         s->server=1;
2018         s->shutdown=0;
2019         s->state=SSL_ST_ACCEPT|SSL_ST_BEFORE;
2020         s->handshake_func=s->method->ssl_accept;
2021         /* clear the current cipher */
2022         ssl_clear_cipher_ctx(s);
2023         }
2024
2025 void SSL_set_connect_state(SSL *s)
2026         {
2027         s->server=0;
2028         s->shutdown=0;
2029         s->state=SSL_ST_CONNECT|SSL_ST_BEFORE;
2030         s->handshake_func=s->method->ssl_connect;
2031         /* clear the current cipher */
2032         ssl_clear_cipher_ctx(s);
2033         }
2034
2035 int ssl_undefined_function(SSL *s)
2036         {
2037         SSLerr(SSL_F_SSL_UNDEFINED_FUNCTION,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2038         return(0);
2039         }
2040
2041 int ssl_undefined_void_function(void)
2042         {
2043         SSLerr(SSL_F_SSL_UNDEFINED_VOID_FUNCTION,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2044         return(0);
2045         }
2046
2047 int ssl_undefined_const_function(const SSL *s)
2048         {
2049         SSLerr(SSL_F_SSL_UNDEFINED_CONST_FUNCTION,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2050         return(0);
2051         }
2052
2053 SSL_METHOD *ssl_bad_method(int ver)
2054         {
2055         SSLerr(SSL_F_SSL_BAD_METHOD,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
2056         return(NULL);
2057         }
2058
2059 const char *SSL_get_version(const SSL *s)
2060         {
2061         if (s->version == TLS1_VERSION)
2062                 return("TLSv1");
2063         else if (s->version == SSL3_VERSION)
2064                 return("SSLv3");
2065         else if (s->version == SSL2_VERSION)
2066                 return("SSLv2");
2067         else
2068                 return("unknown");
2069         }
2070
2071 SSL *SSL_dup(SSL *s)
2072         {
2073         STACK_OF(X509_NAME) *sk;
2074         X509_NAME *xn;
2075         SSL *ret;
2076         int i;
2077
2078         if ((ret=SSL_new(SSL_get_SSL_CTX(s))) == NULL)
2079             return(NULL);
2080
2081         ret->version = s->version;
2082         ret->type = s->type;
2083         ret->method = s->method;
2084
2085         if (s->session != NULL)
2086                 {
2087                 /* This copies session-id, SSL_METHOD, sid_ctx, and 'cert' */
2088                 SSL_copy_session_id(ret,s);
2089                 }
2090         else
2091                 {
2092                 /* No session has been established yet, so we have to expect
2093                  * that s->cert or ret->cert will be changed later --
2094                  * they should not both point to the same object,
2095                  * and thus we can't use SSL_copy_session_id. */
2096
2097                 ret->method->ssl_free(ret);
2098                 ret->method = s->method;
2099                 ret->method->ssl_new(ret);
2100
2101                 if (s->cert != NULL)
2102                         {
2103                         if (ret->cert != NULL)
2104                                 {
2105                                 ssl_cert_free(ret->cert);
2106                                 }
2107                         ret->cert = ssl_cert_dup(s->cert);
2108                         if (ret->cert == NULL)
2109                                 goto err;
2110                         }
2111
2112                 SSL_set_session_id_context(ret,
2113                         s->sid_ctx, s->sid_ctx_length);
2114                 }
2115
2116         ret->options=s->options;
2117         ret->mode=s->mode;
2118         SSL_set_max_cert_list(ret,SSL_get_max_cert_list(s));
2119         SSL_set_read_ahead(ret,SSL_get_read_ahead(s));
2120         ret->msg_callback = s->msg_callback;
2121         ret->msg_callback_arg = s->msg_callback_arg;
2122         SSL_set_verify(ret,SSL_get_verify_mode(s),
2123                 SSL_get_verify_callback(s));
2124         SSL_set_verify_depth(ret,SSL_get_verify_depth(s));
2125         ret->generate_session_id = s->generate_session_id;
2126
2127         SSL_set_info_callback(ret,SSL_get_info_callback(s));
2128
2129         ret->debug=s->debug;
2130
2131         /* copy app data, a little dangerous perhaps */
2132         if (!CRYPTO_dup_ex_data(CRYPTO_EX_INDEX_SSL, &ret->ex_data, &s->ex_data))
2133                 goto err;
2134
2135         /* setup rbio, and wbio */
2136         if (s->rbio != NULL)
2137                 {
2138                 if (!BIO_dup_state(s->rbio,(char *)&ret->rbio))
2139                         goto err;
2140                 }
2141         if (s->wbio != NULL)
2142                 {
2143                 if (s->wbio != s->rbio)
2144                         {
2145                         if (!BIO_dup_state(s->wbio,(char *)&ret->wbio))
2146                                 goto err;
2147                         }
2148                 else
2149                         ret->wbio=ret->rbio;
2150                 }
2151         ret->rwstate = s->rwstate;
2152         ret->in_handshake = s->in_handshake;
2153         ret->handshake_func = s->handshake_func;
2154         ret->server = s->server;
2155         ret->new_session = s->new_session;
2156         ret->quiet_shutdown = s->quiet_shutdown;
2157         ret->shutdown=s->shutdown;
2158         ret->state=s->state; /* SSL_dup does not really work at any state, though */
2159         ret->rstate=s->rstate;
2160         ret->init_num = 0; /* would have to copy ret->init_buf, ret->init_msg, ret->init_num, ret->init_off */
2161         ret->hit=s->hit;
2162
2163         X509_VERIFY_PARAM_inherit(ret->param, s->param);
2164
2165         /* dup the cipher_list and cipher_list_by_id stacks */
2166         if (s->cipher_list != NULL)
2167                 {
2168                 if ((ret->cipher_list=sk_SSL_CIPHER_dup(s->cipher_list)) == NULL)
2169                         goto err;
2170                 }
2171         if (s->cipher_list_by_id != NULL)
2172                 if ((ret->cipher_list_by_id=sk_SSL_CIPHER_dup(s->cipher_list_by_id))
2173                         == NULL)
2174                         goto err;
2175
2176         /* Dup the client_CA list */
2177         if (s->client_CA != NULL)
2178                 {
2179                 if ((sk=sk_X509_NAME_dup(s->client_CA)) == NULL) goto err;
2180                 ret->client_CA=sk;
2181                 for (i=0; i<sk_X509_NAME_num(sk); i++)
2182                         {
2183                         xn=sk_X509_NAME_value(sk,i);
2184                         if (sk_X509_NAME_set(sk,i,X509_NAME_dup(xn)) == NULL)
2185                                 {
2186                                 X509_NAME_free(xn);
2187                                 goto err;
2188                                 }
2189                         }
2190                 }
2191
2192         if (0)
2193                 {
2194 err:
2195                 if (ret != NULL) SSL_free(ret);
2196                 ret=NULL;
2197                 }
2198         return(ret);
2199         }
2200
2201 void ssl_clear_cipher_ctx(SSL *s)
2202         {
2203         if (s->enc_read_ctx != NULL)
2204                 {
2205                 EVP_CIPHER_CTX_cleanup(s->enc_read_ctx);
2206                 OPENSSL_free(s->enc_read_ctx);
2207                 s->enc_read_ctx=NULL;
2208                 }
2209         if (s->enc_write_ctx != NULL)
2210                 {
2211                 EVP_CIPHER_CTX_cleanup(s->enc_write_ctx);
2212                 OPENSSL_free(s->enc_write_ctx);
2213                 s->enc_write_ctx=NULL;
2214                 }
2215         if (s->expand != NULL)
2216                 {
2217                 COMP_CTX_free(s->expand);
2218                 s->expand=NULL;
2219                 }
2220         if (s->compress != NULL)
2221                 {
2222                 COMP_CTX_free(s->compress);
2223                 s->compress=NULL;
2224                 }
2225         }
2226
2227 /* Fix this function so that it takes an optional type parameter */
2228 X509 *SSL_get_certificate(const SSL *s)
2229         {
2230         if (s->cert != NULL)
2231                 return(s->cert->key->x509);
2232         else
2233                 return(NULL);
2234         }
2235
2236 /* Fix this function so that it takes an optional type parameter */
2237 EVP_PKEY *SSL_get_privatekey(SSL *s)
2238         {
2239         if (s->cert != NULL)
2240                 return(s->cert->key->privatekey);
2241         else
2242                 return(NULL);
2243         }
2244
2245 SSL_CIPHER *SSL_get_current_cipher(const SSL *s)
2246         {
2247         if ((s->session != NULL) && (s->session->cipher != NULL))
2248                 return(s->session->cipher);
2249         return(NULL);
2250         }
2251
2252 const COMP_METHOD *SSL_get_current_compression(SSL *s)
2253         {
2254         if (s->compress != NULL)
2255                 return(s->compress->meth);
2256         return(NULL);
2257         }
2258
2259 const COMP_METHOD *SSL_get_current_expansion(SSL *s)
2260         {
2261         if (s->expand != NULL)
2262                 return(s->expand->meth);
2263         return(NULL);
2264         }
2265
2266 int ssl_init_wbio_buffer(SSL *s,int push)
2267         {
2268         BIO *bbio;
2269
2270         if (s->bbio == NULL)
2271                 {
2272                 bbio=BIO_new(BIO_f_buffer());
2273                 if (bbio == NULL) return(0);
2274                 s->bbio=bbio;
2275                 }
2276         else
2277                 {
2278                 bbio=s->bbio;
2279                 if (s->bbio == s->wbio)
2280                         s->wbio=BIO_pop(s->wbio);
2281                 }
2282         (void)BIO_reset(bbio);
2283 /*      if (!BIO_set_write_buffer_size(bbio,16*1024)) */
2284         if (!BIO_set_read_buffer_size(bbio,1))
2285                 {
2286                 SSLerr(SSL_F_SSL_INIT_WBIO_BUFFER,ERR_R_BUF_LIB);
2287                 return(0);
2288                 }
2289         if (push)
2290                 {
2291                 if (s->wbio != bbio)
2292                         s->wbio=BIO_push(bbio,s->wbio);
2293                 }
2294         else
2295                 {
2296                 if (s->wbio == bbio)
2297                         s->wbio=BIO_pop(bbio);
2298                 }
2299         return(1);
2300         }
2301
2302 void ssl_free_wbio_buffer(SSL *s)
2303         {
2304         if (s->bbio == NULL) return;
2305
2306         if (s->bbio == s->wbio)
2307                 {
2308                 /* remove buffering */
2309                 s->wbio=BIO_pop(s->wbio);
2310 #ifdef REF_CHECK /* not the usual REF_CHECK, but this avoids adding one more preprocessor symbol */
2311                 assert(s->wbio != NULL);
2312 #endif
2313         }
2314         BIO_free(s->bbio);
2315         s->bbio=NULL;
2316         }
2317
2318 void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx,int mode)
2319         {
2320         ctx->quiet_shutdown=mode;
2321         }
2322
2323 int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx)
2324         {
2325         return(ctx->quiet_shutdown);
2326         }
2327
2328 void SSL_set_quiet_shutdown(SSL *s,int mode)
2329         {
2330         s->quiet_shutdown=mode;
2331         }
2332
2333 int SSL_get_quiet_shutdown(const SSL *s)
2334         {
2335         return(s->quiet_shutdown);
2336         }
2337
2338 void SSL_set_shutdown(SSL *s,int mode)
2339         {
2340         s->shutdown=mode;
2341         }
2342
2343 int SSL_get_shutdown(const SSL *s)
2344         {
2345         return(s->shutdown);
2346         }
2347
2348 int SSL_version(const SSL *s)
2349         {
2350         return(s->version);
2351         }
2352
2353 SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl)
2354         {
2355         return(ssl->ctx);
2356         }
2357
2358 #ifndef OPENSSL_NO_STDIO
2359 int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx)
2360         {
2361         return(X509_STORE_set_default_paths(ctx->cert_store));
2362         }
2363
2364 int SSL_CTX_load_verify_locations(SSL_CTX *ctx, const char *CAfile,
2365                 const char *CApath)
2366         {
2367         return(X509_STORE_load_locations(ctx->cert_store,CAfile,CApath));
2368         }
2369 #endif
2370
2371 void SSL_set_info_callback(SSL *ssl,
2372                            void (*cb)(const SSL *ssl,int type,int val))
2373         {
2374         ssl->info_callback=cb;
2375         }
2376
2377 void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl,int type,int val)
2378         {
2379         return ssl->info_callback;
2380         }
2381
2382 int SSL_state(const SSL *ssl)
2383         {
2384         return(ssl->state);
2385         }
2386
2387 void SSL_set_verify_result(SSL *ssl,long arg)
2388         {
2389         ssl->verify_result=arg;
2390         }
2391
2392 long SSL_get_verify_result(const SSL *ssl)
2393         {
2394         return(ssl->verify_result);
2395         }
2396
2397 int SSL_get_ex_new_index(long argl,void *argp,CRYPTO_EX_new *new_func,
2398                          CRYPTO_EX_dup *dup_func,CRYPTO_EX_free *free_func)
2399         {
2400         return CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_SSL, argl, argp,
2401                                 new_func, dup_func, free_func);
2402         }
2403
2404 int SSL_set_ex_data(SSL *s,int idx,void *arg)
2405         {
2406         return(CRYPTO_set_ex_data(&s->ex_data,idx,arg));
2407         }
2408
2409 void *SSL_get_ex_data(const SSL *s,int idx)
2410         {
2411         return(CRYPTO_get_ex_data(&s->ex_data,idx));
2412         }
2413
2414 int SSL_CTX_get_ex_new_index(long argl,void *argp,CRYPTO_EX_new *new_func,
2415                              CRYPTO_EX_dup *dup_func,CRYPTO_EX_free *free_func)
2416         {
2417         return CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_SSL_CTX, argl, argp,
2418                                 new_func, dup_func, free_func);
2419         }
2420
2421 int SSL_CTX_set_ex_data(SSL_CTX *s,int idx,void *arg)
2422         {
2423         return(CRYPTO_set_ex_data(&s->ex_data,idx,arg));
2424         }
2425
2426 void *SSL_CTX_get_ex_data(const SSL_CTX *s,int idx)
2427         {
2428         return(CRYPTO_get_ex_data(&s->ex_data,idx));
2429         }
2430
2431 int ssl_ok(SSL *s)
2432         {
2433         return(1);
2434         }
2435
2436 X509_STORE *SSL_CTX_get_cert_store(const SSL_CTX *ctx)
2437         {
2438         return(ctx->cert_store);
2439         }
2440
2441 void SSL_CTX_set_cert_store(SSL_CTX *ctx,X509_STORE *store)
2442         {
2443         if (ctx->cert_store != NULL)
2444                 X509_STORE_free(ctx->cert_store);
2445         ctx->cert_store=store;
2446         }
2447
2448 int SSL_want(const SSL *s)
2449         {
2450         return(s->rwstate);
2451         }
2452
2453 /*!
2454  * \brief Set the callback for generating temporary RSA keys.
2455  * \param ctx the SSL context.
2456  * \param cb the callback
2457  */
2458
2459 #ifndef OPENSSL_NO_RSA
2460 void SSL_CTX_set_tmp_rsa_callback(SSL_CTX *ctx,RSA *(*cb)(SSL *ssl,
2461                                                           int is_export,
2462                                                           int keylength))
2463     {
2464     SSL_CTX_callback_ctrl(ctx,SSL_CTRL_SET_TMP_RSA_CB,(void (*)(void))cb);
2465     }
2466
2467 void SSL_set_tmp_rsa_callback(SSL *ssl,RSA *(*cb)(SSL *ssl,
2468                                                   int is_export,
2469                                                   int keylength))
2470     {
2471     SSL_callback_ctrl(ssl,SSL_CTRL_SET_TMP_RSA_CB,(void (*)(void))cb);
2472     }
2473 #endif
2474
2475 #ifdef DOXYGEN
2476 /*!
2477  * \brief The RSA temporary key callback function.
2478  * \param ssl the SSL session.
2479  * \param is_export \c TRUE if the temp RSA key is for an export ciphersuite.
2480  * \param keylength if \c is_export is \c TRUE, then \c keylength is the size
2481  * of the required key in bits.
2482  * \return the temporary RSA key.
2483  * \sa SSL_CTX_set_tmp_rsa_callback, SSL_set_tmp_rsa_callback
2484  */
2485
2486 RSA *cb(SSL *ssl,int is_export,int keylength)
2487     {}
2488 #endif
2489
2490 /*!
2491  * \brief Set the callback for generating temporary DH keys.
2492  * \param ctx the SSL context.
2493  * \param dh the callback
2494  */
2495
2496 #ifndef OPENSSL_NO_DH
2497 void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,DH *(*dh)(SSL *ssl,int is_export,
2498                                                         int keylength))
2499         {
2500         SSL_CTX_callback_ctrl(ctx,SSL_CTRL_SET_TMP_DH_CB,(void (*)(void))dh);
2501         }
2502
2503 void SSL_set_tmp_dh_callback(SSL *ssl,DH *(*dh)(SSL *ssl,int is_export,
2504                                                 int keylength))
2505         {
2506         SSL_callback_ctrl(ssl,SSL_CTRL_SET_TMP_DH_CB,(void (*)(void))dh);
2507         }
2508 #endif
2509
2510 #ifndef OPENSSL_NO_ECDH
2511 void SSL_CTX_set_tmp_ecdh_callback(SSL_CTX *ctx,EC_KEY *(*ecdh)(SSL *ssl,int is_export,
2512                                                         int keylength))
2513         {
2514         SSL_CTX_callback_ctrl(ctx,SSL_CTRL_SET_TMP_ECDH_CB,(void (*)(void))ecdh);
2515         }
2516
2517 void SSL_set_tmp_ecdh_callback(SSL *ssl,EC_KEY *(*ecdh)(SSL *ssl,int is_export,
2518                                                 int keylength))
2519         {
2520         SSL_callback_ctrl(ssl,SSL_CTRL_SET_TMP_ECDH_CB,(void (*)(void))ecdh);
2521         }
2522 #endif
2523
2524
2525 void SSL_CTX_set_msg_callback(SSL_CTX *ctx, void (*cb)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg))
2526         {
2527         SSL_CTX_callback_ctrl(ctx, SSL_CTRL_SET_MSG_CALLBACK, (void (*)(void))cb);
2528         }
2529 void SSL_set_msg_callback(SSL *ssl, void (*cb)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg))
2530         {
2531         SSL_callback_ctrl(ssl, SSL_CTRL_SET_MSG_CALLBACK, (void (*)(void))cb);
2532         }
2533
2534
2535
2536 #if defined(_WINDLL) && defined(OPENSSL_SYS_WIN16)
2537 #include "../crypto/bio/bss_file.c"
2538 #endif
2539
2540 IMPLEMENT_STACK_OF(SSL_CIPHER)
2541 IMPLEMENT_STACK_OF(SSL_COMP)