1 /*! \file ssl/ssl_lib.c
2 * \brief Version independent SSL functions.
4 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
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.
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).
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.
25 * Redistribution and use in source and binary forms, with or without
26 * modification, are permitted provided that the following conditions
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)"
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
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.]
60 /* ====================================================================
61 * Copyright (c) 1998-2007 The OpenSSL Project. All rights reserved.
63 * Redistribution and use in source and binary forms, with or without
64 * modification, are permitted provided that the following conditions
67 * 1. Redistributions of source code must retain the above copyright
68 * notice, this list of conditions and the following disclaimer.
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
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/)"
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.
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.
89 * 6. Redistributions of any form whatsoever must retain the following
91 * "This product includes software developed by the OpenSSL Project
92 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
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 * ====================================================================
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).
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.
118 /* ====================================================================
119 * Copyright 2005 Nokia. All rights reserved.
121 * The portions of the attached software ("Contribution") is developed by
122 * Nokia Corporation and is licensed pursuant to the OpenSSL open source
125 * The Contribution, originally written by Mika Kousa and Pasi Eronen of
126 * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
127 * support (see RFC 4279) to OpenSSL.
129 * No patent licenses or other rights except those expressly stated in
130 * the OpenSSL open source license shall be deemed granted or received
131 * expressly, by implication, estoppel, or otherwise.
133 * No assurances are provided by Nokia that the Contribution does not
134 * infringe the patent or other intellectual property rights of any third
135 * party or that the license provides you with all the necessary rights
136 * to make use of the Contribution.
138 * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
139 * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
140 * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
141 * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
149 #include "ssl_locl.h"
150 #include "kssl_lcl.h"
151 #include <openssl/objects.h>
152 #include <openssl/lhash.h>
153 #include <openssl/x509v3.h>
154 #include <openssl/rand.h>
155 #ifndef OPENSSL_NO_DH
156 #include <openssl/dh.h>
159 const char *SSL_version_str
=OPENSSL_VERSION_TEXT
;
161 SSL3_ENC_METHOD ssl3_undef_enc_method
={
162 /* evil casts, but these functions are only called if there's a library bug */
163 (int (*)(SSL
*,int))ssl_undefined_function
,
164 (int (*)(SSL
*, unsigned char *, int))ssl_undefined_function
,
165 ssl_undefined_function
,
166 (int (*)(SSL
*, unsigned char *, unsigned char *, int))ssl_undefined_function
,
167 (int (*)(SSL
*, int))ssl_undefined_function
,
168 (int (*)(SSL
*, const char*, int, unsigned char *))ssl_undefined_function
,
169 0, /* finish_mac_length */
170 (int (*)(SSL
*, const EVP_MD
*, unsigned char *))ssl_undefined_function
,
171 NULL
, /* client_finished_label */
172 0, /* client_finished_label_len */
173 NULL
, /* server_finished_label */
174 0, /* server_finished_label_len */
175 (int (*)(int))ssl_undefined_function
178 int SSL_clear(SSL
*s
)
181 if (s
->method
== NULL
)
183 SSLerr(SSL_F_SSL_CLEAR
,SSL_R_NO_METHOD_SPECIFIED
);
187 if (ssl_clear_bad_session(s
))
189 SSL_SESSION_free(s
->session
);
197 #if 0 /* Disabled since version 1.10 of this file (early return not
198 * needed because SSL_clear is not called when doing renegotiation) */
199 /* This is set if we are doing dynamic renegotiation so keep
200 * the old cipher. It is sort of a SSL_clear_lite :-) */
201 if (s
->new_session
) return(1);
205 SSLerr(SSL_F_SSL_CLEAR
,ERR_R_INTERNAL_ERROR
);
212 s
->state
=SSL_ST_BEFORE
|((s
->server
)?SSL_ST_ACCEPT
:SSL_ST_CONNECT
);
214 s
->version
=s
->method
->version
;
215 s
->client_version
=s
->version
;
216 s
->rwstate
=SSL_NOTHING
;
217 s
->rstate
=SSL_ST_READ_HEADER
;
219 s
->read_ahead
=s
->ctx
->read_ahead
;
222 if (s
->init_buf
!= NULL
)
224 BUF_MEM_free(s
->init_buf
);
228 ssl_clear_cipher_ctx(s
);
229 ssl_clear_hash_ctx(&s
->read_hash
);
230 ssl_clear_hash_ctx(&s
->write_hash
);
235 /* Check to see if we were changed into a different method, if
236 * so, revert back if we are not doing session-id reuse. */
237 if (!s
->in_handshake
&& (s
->session
== NULL
) && (s
->method
!= s
->ctx
->method
))
239 s
->method
->ssl_free(s
);
240 s
->method
=s
->ctx
->method
;
241 if (!s
->method
->ssl_new(s
))
246 s
->method
->ssl_clear(s
);
250 /** Used to change an SSL_CTXs default SSL method type */
251 int SSL_CTX_set_ssl_version(SSL_CTX
*ctx
,const SSL_METHOD
*meth
)
253 STACK_OF(SSL_CIPHER
) *sk
;
257 sk
=ssl_create_cipher_list(ctx
->method
,&(ctx
->cipher_list
),
258 &(ctx
->cipher_list_by_id
),SSL_DEFAULT_CIPHER_LIST
);
259 if ((sk
== NULL
) || (sk_SSL_CIPHER_num(sk
) <= 0))
261 SSLerr(SSL_F_SSL_CTX_SET_SSL_VERSION
,SSL_R_SSL_LIBRARY_HAS_NO_CIPHERS
);
267 SSL
*SSL_new(SSL_CTX
*ctx
)
273 SSLerr(SSL_F_SSL_NEW
,SSL_R_NULL_SSL_CTX
);
276 if (ctx
->method
== NULL
)
278 SSLerr(SSL_F_SSL_NEW
,SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION
);
282 s
=(SSL
*)OPENSSL_malloc(sizeof(SSL
));
283 if (s
== NULL
) goto err
;
284 memset(s
,0,sizeof(SSL
));
286 #ifndef OPENSSL_NO_KRB5
287 s
->kssl_ctx
= kssl_ctx_new();
288 #endif /* OPENSSL_NO_KRB5 */
290 s
->options
=ctx
->options
;
292 s
->max_cert_list
=ctx
->max_cert_list
;
294 if (ctx
->cert
!= NULL
)
296 /* Earlier library versions used to copy the pointer to
297 * the CERT, not its contents; only when setting new
298 * parameters for the per-SSL copy, ssl_cert_new would be
299 * called (and the direct reference to the per-SSL_CTX
300 * settings would be lost, but those still were indirectly
301 * accessed for various purposes, and for that reason they
302 * used to be known as s->ctx->default_cert).
303 * Now we don't look at the SSL_CTX's CERT after having
304 * duplicated it once. */
306 s
->cert
= ssl_cert_dup(ctx
->cert
);
311 s
->cert
=NULL
; /* Cannot really happen (see SSL_CTX_new) */
313 s
->read_ahead
=ctx
->read_ahead
;
314 s
->msg_callback
=ctx
->msg_callback
;
315 s
->msg_callback_arg
=ctx
->msg_callback_arg
;
316 s
->verify_mode
=ctx
->verify_mode
;
318 s
->verify_depth
=ctx
->verify_depth
;
320 s
->sid_ctx_length
=ctx
->sid_ctx_length
;
321 OPENSSL_assert(s
->sid_ctx_length
<= sizeof s
->sid_ctx
);
322 memcpy(&s
->sid_ctx
,&ctx
->sid_ctx
,sizeof(s
->sid_ctx
));
323 s
->verify_callback
=ctx
->default_verify_callback
;
324 s
->generate_session_id
=ctx
->generate_session_id
;
326 s
->param
= X509_VERIFY_PARAM_new();
329 X509_VERIFY_PARAM_inherit(s
->param
, ctx
->param
);
331 s
->purpose
= ctx
->purpose
;
332 s
->trust
= ctx
->trust
;
334 s
->quiet_shutdown
=ctx
->quiet_shutdown
;
335 s
->max_send_fragment
= ctx
->max_send_fragment
;
337 CRYPTO_add(&ctx
->references
,1,CRYPTO_LOCK_SSL_CTX
);
339 #ifndef OPENSSL_NO_TLSEXT
340 s
->tlsext_debug_cb
= 0;
341 s
->tlsext_debug_arg
= NULL
;
342 s
->tlsext_ticket_expected
= 0;
343 CRYPTO_add(&ctx
->references
,1,CRYPTO_LOCK_SSL_CTX
);
347 s
->verify_result
=X509_V_OK
;
349 s
->method
=ctx
->method
;
351 if (!s
->method
->ssl_new(s
))
355 s
->server
=(ctx
->method
->ssl_accept
== ssl_undefined_function
)?0:1;
359 CRYPTO_new_ex_data(CRYPTO_EX_INDEX_SSL
, s
, &s
->ex_data
);
361 #ifndef OPENSSL_NO_PSK
362 s
->psk_client_callback
=ctx
->psk_client_callback
;
363 s
->psk_server_callback
=ctx
->psk_server_callback
;
371 ssl_cert_free(s
->cert
);
373 SSL_CTX_free(s
->ctx
); /* decrement reference count */
376 SSLerr(SSL_F_SSL_NEW
,ERR_R_MALLOC_FAILURE
);
380 int SSL_CTX_set_session_id_context(SSL_CTX
*ctx
,const unsigned char *sid_ctx
,
381 unsigned int sid_ctx_len
)
383 if(sid_ctx_len
> sizeof ctx
->sid_ctx
)
385 SSLerr(SSL_F_SSL_CTX_SET_SESSION_ID_CONTEXT
,SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG
);
388 ctx
->sid_ctx_length
=sid_ctx_len
;
389 memcpy(ctx
->sid_ctx
,sid_ctx
,sid_ctx_len
);
394 int SSL_set_session_id_context(SSL
*ssl
,const unsigned char *sid_ctx
,
395 unsigned int sid_ctx_len
)
397 if(sid_ctx_len
> SSL_MAX_SID_CTX_LENGTH
)
399 SSLerr(SSL_F_SSL_SET_SESSION_ID_CONTEXT
,SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG
);
402 ssl
->sid_ctx_length
=sid_ctx_len
;
403 memcpy(ssl
->sid_ctx
,sid_ctx
,sid_ctx_len
);
408 int SSL_CTX_set_generate_session_id(SSL_CTX
*ctx
, GEN_SESSION_CB cb
)
410 CRYPTO_w_lock(CRYPTO_LOCK_SSL_CTX
);
411 ctx
->generate_session_id
= cb
;
412 CRYPTO_w_unlock(CRYPTO_LOCK_SSL_CTX
);
416 int SSL_set_generate_session_id(SSL
*ssl
, GEN_SESSION_CB cb
)
418 CRYPTO_w_lock(CRYPTO_LOCK_SSL
);
419 ssl
->generate_session_id
= cb
;
420 CRYPTO_w_unlock(CRYPTO_LOCK_SSL
);
424 int SSL_has_matching_session_id(const SSL
*ssl
, const unsigned char *id
,
427 /* A quick examination of SSL_SESSION_hash and SSL_SESSION_cmp shows how
428 * we can "construct" a session to give us the desired check - ie. to
429 * find if there's a session in the hash table that would conflict with
430 * any new session built out of this id/id_len and the ssl_version in
431 * use by this SSL. */
434 if(id_len
> sizeof r
.session_id
)
437 r
.ssl_version
= ssl
->version
;
438 r
.session_id_length
= id_len
;
439 memcpy(r
.session_id
, id
, id_len
);
440 /* NB: SSLv2 always uses a fixed 16-byte session ID, so even if a
441 * callback is calling us to check the uniqueness of a shorter ID, it
442 * must be compared as a padded-out ID because that is what it will be
443 * converted to when the callback has finished choosing it. */
444 if((r
.ssl_version
== SSL2_VERSION
) &&
445 (id_len
< SSL2_SSL_SESSION_ID_LENGTH
))
447 memset(r
.session_id
+ id_len
, 0,
448 SSL2_SSL_SESSION_ID_LENGTH
- id_len
);
449 r
.session_id_length
= SSL2_SSL_SESSION_ID_LENGTH
;
452 CRYPTO_r_lock(CRYPTO_LOCK_SSL_CTX
);
453 p
= (SSL_SESSION
*)lh_retrieve(ssl
->ctx
->sessions
, &r
);
454 CRYPTO_r_unlock(CRYPTO_LOCK_SSL_CTX
);
458 int SSL_CTX_set_purpose(SSL_CTX
*s
, int purpose
)
460 return X509_VERIFY_PARAM_set_purpose(s
->param
, purpose
);
463 int SSL_set_purpose(SSL
*s
, int purpose
)
465 return X509_VERIFY_PARAM_set_purpose(s
->param
, purpose
);
468 int SSL_CTX_set_trust(SSL_CTX
*s
, int trust
)
470 return X509_VERIFY_PARAM_set_trust(s
->param
, trust
);
473 int SSL_set_trust(SSL
*s
, int trust
)
475 return X509_VERIFY_PARAM_set_trust(s
->param
, trust
);
478 void SSL_free(SSL
*s
)
485 i
=CRYPTO_add(&s
->references
,-1,CRYPTO_LOCK_SSL
);
493 fprintf(stderr
,"SSL_free, bad reference count\n");
499 X509_VERIFY_PARAM_free(s
->param
);
501 CRYPTO_free_ex_data(CRYPTO_EX_INDEX_SSL
, s
, &s
->ex_data
);
505 /* If the buffering BIO is in place, pop it off */
506 if (s
->bbio
== s
->wbio
)
508 s
->wbio
=BIO_pop(s
->wbio
);
514 BIO_free_all(s
->rbio
);
515 if ((s
->wbio
!= NULL
) && (s
->wbio
!= s
->rbio
))
516 BIO_free_all(s
->wbio
);
518 if (s
->init_buf
!= NULL
) BUF_MEM_free(s
->init_buf
);
520 /* add extra stuff */
521 if (s
->cipher_list
!= NULL
) sk_SSL_CIPHER_free(s
->cipher_list
);
522 if (s
->cipher_list_by_id
!= NULL
) sk_SSL_CIPHER_free(s
->cipher_list_by_id
);
524 /* Make the next call work :-) */
525 if (s
->session
!= NULL
)
527 ssl_clear_bad_session(s
);
528 SSL_SESSION_free(s
->session
);
531 ssl_clear_cipher_ctx(s
);
532 ssl_clear_hash_ctx(&s
->read_hash
);
533 ssl_clear_hash_ctx(&s
->write_hash
);
535 if (s
->cert
!= NULL
) ssl_cert_free(s
->cert
);
536 /* Free up if allocated */
538 if (s
->ctx
) SSL_CTX_free(s
->ctx
);
539 #ifndef OPENSSL_NO_TLSEXT
540 if (s
->initial_ctx
) SSL_CTX_free(s
->initial_ctx
);
541 #ifndef OPENSSL_NO_EC
542 if (s
->tlsext_ecpointformatlist
) OPENSSL_free(s
->tlsext_ecpointformatlist
);
543 if (s
->tlsext_ellipticcurvelist
) OPENSSL_free(s
->tlsext_ellipticcurvelist
);
544 #endif /* OPENSSL_NO_EC */
547 if (s
->client_CA
!= NULL
)
548 sk_X509_NAME_pop_free(s
->client_CA
,X509_NAME_free
);
550 if (s
->method
!= NULL
) s
->method
->ssl_free(s
);
552 #ifndef OPENSSL_NO_KRB5
553 if (s
->kssl_ctx
!= NULL
)
554 kssl_ctx_free(s
->kssl_ctx
);
555 #endif /* OPENSSL_NO_KRB5 */
560 void SSL_set_bio(SSL
*s
,BIO
*rbio
,BIO
*wbio
)
562 /* If the output buffering BIO is still in place, remove it
566 if (s
->wbio
== s
->bbio
)
568 s
->wbio
=s
->wbio
->next_bio
;
569 s
->bbio
->next_bio
=NULL
;
572 if ((s
->rbio
!= NULL
) && (s
->rbio
!= rbio
))
573 BIO_free_all(s
->rbio
);
574 if ((s
->wbio
!= NULL
) && (s
->wbio
!= wbio
) && (s
->rbio
!= s
->wbio
))
575 BIO_free_all(s
->wbio
);
580 BIO
*SSL_get_rbio(const SSL
*s
)
583 BIO
*SSL_get_wbio(const SSL
*s
)
586 int SSL_get_fd(const SSL
*s
)
588 return(SSL_get_rfd(s
));
591 int SSL_get_rfd(const SSL
*s
)
597 r
=BIO_find_type(b
,BIO_TYPE_DESCRIPTOR
);
603 int SSL_get_wfd(const SSL
*s
)
609 r
=BIO_find_type(b
,BIO_TYPE_DESCRIPTOR
);
615 #ifndef OPENSSL_NO_SOCK
616 int SSL_set_fd(SSL
*s
,int fd
)
621 bio
=BIO_new(BIO_s_socket());
625 SSLerr(SSL_F_SSL_SET_FD
,ERR_R_BUF_LIB
);
628 BIO_set_fd(bio
,fd
,BIO_NOCLOSE
);
629 SSL_set_bio(s
,bio
,bio
);
635 int SSL_set_wfd(SSL
*s
,int fd
)
640 if ((s
->rbio
== NULL
) || (BIO_method_type(s
->rbio
) != BIO_TYPE_SOCKET
)
641 || ((int)BIO_get_fd(s
->rbio
,NULL
) != fd
))
643 bio
=BIO_new(BIO_s_socket());
646 { SSLerr(SSL_F_SSL_SET_WFD
,ERR_R_BUF_LIB
); goto err
; }
647 BIO_set_fd(bio
,fd
,BIO_NOCLOSE
);
648 SSL_set_bio(s
,SSL_get_rbio(s
),bio
);
651 SSL_set_bio(s
,SSL_get_rbio(s
),SSL_get_rbio(s
));
657 int SSL_set_rfd(SSL
*s
,int fd
)
662 if ((s
->wbio
== NULL
) || (BIO_method_type(s
->wbio
) != BIO_TYPE_SOCKET
)
663 || ((int)BIO_get_fd(s
->wbio
,NULL
) != fd
))
665 bio
=BIO_new(BIO_s_socket());
669 SSLerr(SSL_F_SSL_SET_RFD
,ERR_R_BUF_LIB
);
672 BIO_set_fd(bio
,fd
,BIO_NOCLOSE
);
673 SSL_set_bio(s
,bio
,SSL_get_wbio(s
));
676 SSL_set_bio(s
,SSL_get_wbio(s
),SSL_get_wbio(s
));
684 /* return length of latest Finished message we sent, copy to 'buf' */
685 size_t SSL_get_finished(const SSL
*s
, void *buf
, size_t count
)
691 ret
= s
->s3
->tmp
.finish_md_len
;
694 memcpy(buf
, s
->s3
->tmp
.finish_md
, count
);
699 /* return length of latest Finished message we expected, copy to 'buf' */
700 size_t SSL_get_peer_finished(const SSL
*s
, void *buf
, size_t count
)
706 ret
= s
->s3
->tmp
.peer_finish_md_len
;
709 memcpy(buf
, s
->s3
->tmp
.peer_finish_md
, count
);
715 int SSL_get_verify_mode(const SSL
*s
)
717 return(s
->verify_mode
);
720 int SSL_get_verify_depth(const SSL
*s
)
722 return X509_VERIFY_PARAM_get_depth(s
->param
);
725 int (*SSL_get_verify_callback(const SSL
*s
))(int,X509_STORE_CTX
*)
727 return(s
->verify_callback
);
730 int SSL_CTX_get_verify_mode(const SSL_CTX
*ctx
)
732 return(ctx
->verify_mode
);
735 int SSL_CTX_get_verify_depth(const SSL_CTX
*ctx
)
737 return X509_VERIFY_PARAM_get_depth(ctx
->param
);
740 int (*SSL_CTX_get_verify_callback(const SSL_CTX
*ctx
))(int,X509_STORE_CTX
*)
742 return(ctx
->default_verify_callback
);
745 void SSL_set_verify(SSL
*s
,int mode
,
746 int (*callback
)(int ok
,X509_STORE_CTX
*ctx
))
749 if (callback
!= NULL
)
750 s
->verify_callback
=callback
;
753 void SSL_set_verify_depth(SSL
*s
,int depth
)
755 X509_VERIFY_PARAM_set_depth(s
->param
, depth
);
758 void SSL_set_read_ahead(SSL
*s
,int yes
)
763 int SSL_get_read_ahead(const SSL
*s
)
765 return(s
->read_ahead
);
768 int SSL_pending(const SSL
*s
)
770 /* SSL_pending cannot work properly if read-ahead is enabled
771 * (SSL_[CTX_]ctrl(..., SSL_CTRL_SET_READ_AHEAD, 1, NULL)),
772 * and it is impossible to fix since SSL_pending cannot report
773 * errors that may be observed while scanning the new data.
774 * (Note that SSL_pending() is often used as a boolean value,
775 * so we'd better not return -1.)
777 return(s
->method
->ssl_pending(s
));
780 X509
*SSL_get_peer_certificate(const SSL
*s
)
784 if ((s
== NULL
) || (s
->session
== NULL
))
789 if (r
== NULL
) return(r
);
791 CRYPTO_add(&r
->references
,1,CRYPTO_LOCK_X509
);
796 STACK_OF(X509
) *SSL_get_peer_cert_chain(const SSL
*s
)
800 if ((s
== NULL
) || (s
->session
== NULL
) || (s
->session
->sess_cert
== NULL
))
803 r
=s
->session
->sess_cert
->cert_chain
;
805 /* If we are a client, cert_chain includes the peer's own
806 * certificate; if we are a server, it does not. */
811 /* Now in theory, since the calling process own 't' it should be safe to
812 * modify. We need to be able to read f without being hassled */
813 void SSL_copy_session_id(SSL
*t
,const SSL
*f
)
817 /* Do we need to to SSL locking? */
818 SSL_set_session(t
,SSL_get_session(f
));
820 /* what if we are setup as SSLv2 but want to talk SSLv3 or
822 if (t
->method
!= f
->method
)
824 t
->method
->ssl_free(t
); /* cleanup current */
825 t
->method
=f
->method
; /* change method */
826 t
->method
->ssl_new(t
); /* setup new */
832 CRYPTO_add(&f
->cert
->references
,1,CRYPTO_LOCK_SSL_CERT
);
837 if (tmp
!= NULL
) ssl_cert_free(tmp
);
838 SSL_set_session_id_context(t
,f
->sid_ctx
,f
->sid_ctx_length
);
841 /* Fix this so it checks all the valid key/cert options */
842 int SSL_CTX_check_private_key(const SSL_CTX
*ctx
)
844 if ( (ctx
== NULL
) ||
845 (ctx
->cert
== NULL
) ||
846 (ctx
->cert
->key
->x509
== NULL
))
848 SSLerr(SSL_F_SSL_CTX_CHECK_PRIVATE_KEY
,SSL_R_NO_CERTIFICATE_ASSIGNED
);
851 if (ctx
->cert
->key
->privatekey
== NULL
)
853 SSLerr(SSL_F_SSL_CTX_CHECK_PRIVATE_KEY
,SSL_R_NO_PRIVATE_KEY_ASSIGNED
);
856 return(X509_check_private_key(ctx
->cert
->key
->x509
, ctx
->cert
->key
->privatekey
));
859 /* Fix this function so that it takes an optional type parameter */
860 int SSL_check_private_key(const SSL
*ssl
)
864 SSLerr(SSL_F_SSL_CHECK_PRIVATE_KEY
,ERR_R_PASSED_NULL_PARAMETER
);
867 if (ssl
->cert
== NULL
)
869 SSLerr(SSL_F_SSL_CHECK_PRIVATE_KEY
,SSL_R_NO_CERTIFICATE_ASSIGNED
);
872 if (ssl
->cert
->key
->x509
== NULL
)
874 SSLerr(SSL_F_SSL_CHECK_PRIVATE_KEY
,SSL_R_NO_CERTIFICATE_ASSIGNED
);
877 if (ssl
->cert
->key
->privatekey
== NULL
)
879 SSLerr(SSL_F_SSL_CHECK_PRIVATE_KEY
,SSL_R_NO_PRIVATE_KEY_ASSIGNED
);
882 return(X509_check_private_key(ssl
->cert
->key
->x509
,
883 ssl
->cert
->key
->privatekey
));
886 int SSL_accept(SSL
*s
)
888 if (s
->handshake_func
== 0)
889 /* Not properly initialized yet */
890 SSL_set_accept_state(s
);
892 return(s
->method
->ssl_accept(s
));
895 int SSL_connect(SSL
*s
)
897 if (s
->handshake_func
== 0)
898 /* Not properly initialized yet */
899 SSL_set_connect_state(s
);
901 return(s
->method
->ssl_connect(s
));
904 long SSL_get_default_timeout(const SSL
*s
)
906 return(s
->method
->get_timeout());
909 int SSL_read(SSL
*s
,void *buf
,int num
)
911 if (s
->handshake_func
== 0)
913 SSLerr(SSL_F_SSL_READ
, SSL_R_UNINITIALIZED
);
917 if (s
->shutdown
& SSL_RECEIVED_SHUTDOWN
)
919 s
->rwstate
=SSL_NOTHING
;
922 return(s
->method
->ssl_read(s
,buf
,num
));
925 int SSL_peek(SSL
*s
,void *buf
,int num
)
927 if (s
->handshake_func
== 0)
929 SSLerr(SSL_F_SSL_PEEK
, SSL_R_UNINITIALIZED
);
933 if (s
->shutdown
& SSL_RECEIVED_SHUTDOWN
)
937 return(s
->method
->ssl_peek(s
,buf
,num
));
940 int SSL_write(SSL
*s
,const void *buf
,int num
)
942 if (s
->handshake_func
== 0)
944 SSLerr(SSL_F_SSL_WRITE
, SSL_R_UNINITIALIZED
);
948 if (s
->shutdown
& SSL_SENT_SHUTDOWN
)
950 s
->rwstate
=SSL_NOTHING
;
951 SSLerr(SSL_F_SSL_WRITE
,SSL_R_PROTOCOL_IS_SHUTDOWN
);
954 return(s
->method
->ssl_write(s
,buf
,num
));
957 int SSL_shutdown(SSL
*s
)
959 /* Note that this function behaves differently from what one might
960 * expect. Return values are 0 for no success (yet),
961 * 1 for success; but calling it once is usually not enough,
962 * even if blocking I/O is used (see ssl3_shutdown).
965 if (s
->handshake_func
== 0)
967 SSLerr(SSL_F_SSL_SHUTDOWN
, SSL_R_UNINITIALIZED
);
971 if ((s
!= NULL
) && !SSL_in_init(s
))
972 return(s
->method
->ssl_shutdown(s
));
977 int SSL_renegotiate(SSL
*s
)
979 if (s
->new_session
== 0)
983 return(s
->method
->ssl_renegotiate(s
));
986 int SSL_renegotiate_pending(SSL
*s
)
988 /* becomes true when negotiation is requested;
989 * false again once a handshake has finished */
990 return (s
->new_session
!= 0);
993 long SSL_ctrl(SSL
*s
,int cmd
,long larg
,void *parg
)
999 case SSL_CTRL_GET_READ_AHEAD
:
1000 return(s
->read_ahead
);
1001 case SSL_CTRL_SET_READ_AHEAD
:
1006 case SSL_CTRL_SET_MSG_CALLBACK_ARG
:
1007 s
->msg_callback_arg
= parg
;
1010 case SSL_CTRL_OPTIONS
:
1011 return(s
->options
|=larg
);
1013 return(s
->mode
|=larg
);
1014 case SSL_CTRL_GET_MAX_CERT_LIST
:
1015 return(s
->max_cert_list
);
1016 case SSL_CTRL_SET_MAX_CERT_LIST
:
1018 s
->max_cert_list
=larg
;
1020 case SSL_CTRL_SET_MTU
:
1021 if (SSL_version(s
) == DTLS1_VERSION
)
1027 case SSL_CTRL_SET_MAX_SEND_FRAGMENT
:
1028 if (larg
< 512 || larg
> SSL3_RT_MAX_PLAIN_LENGTH
)
1030 s
->max_send_fragment
= larg
;
1033 return(s
->method
->ssl_ctrl(s
,cmd
,larg
,parg
));
1037 long SSL_callback_ctrl(SSL
*s
, int cmd
, void (*fp
)(void))
1041 case SSL_CTRL_SET_MSG_CALLBACK
:
1042 s
->msg_callback
= (void (*)(int write_p
, int version
, int content_type
, const void *buf
, size_t len
, SSL
*ssl
, void *arg
))(fp
);
1046 return(s
->method
->ssl_callback_ctrl(s
,cmd
,fp
));
1050 struct lhash_st
*SSL_CTX_sessions(SSL_CTX
*ctx
)
1052 return ctx
->sessions
;
1055 long SSL_CTX_ctrl(SSL_CTX
*ctx
,int cmd
,long larg
,void *parg
)
1061 case SSL_CTRL_GET_READ_AHEAD
:
1062 return(ctx
->read_ahead
);
1063 case SSL_CTRL_SET_READ_AHEAD
:
1065 ctx
->read_ahead
=larg
;
1068 case SSL_CTRL_SET_MSG_CALLBACK_ARG
:
1069 ctx
->msg_callback_arg
= parg
;
1072 case SSL_CTRL_GET_MAX_CERT_LIST
:
1073 return(ctx
->max_cert_list
);
1074 case SSL_CTRL_SET_MAX_CERT_LIST
:
1075 l
=ctx
->max_cert_list
;
1076 ctx
->max_cert_list
=larg
;
1079 case SSL_CTRL_SET_SESS_CACHE_SIZE
:
1080 l
=ctx
->session_cache_size
;
1081 ctx
->session_cache_size
=larg
;
1083 case SSL_CTRL_GET_SESS_CACHE_SIZE
:
1084 return(ctx
->session_cache_size
);
1085 case SSL_CTRL_SET_SESS_CACHE_MODE
:
1086 l
=ctx
->session_cache_mode
;
1087 ctx
->session_cache_mode
=larg
;
1089 case SSL_CTRL_GET_SESS_CACHE_MODE
:
1090 return(ctx
->session_cache_mode
);
1092 case SSL_CTRL_SESS_NUMBER
:
1093 return(ctx
->sessions
->num_items
);
1094 case SSL_CTRL_SESS_CONNECT
:
1095 return(ctx
->stats
.sess_connect
);
1096 case SSL_CTRL_SESS_CONNECT_GOOD
:
1097 return(ctx
->stats
.sess_connect_good
);
1098 case SSL_CTRL_SESS_CONNECT_RENEGOTIATE
:
1099 return(ctx
->stats
.sess_connect_renegotiate
);
1100 case SSL_CTRL_SESS_ACCEPT
:
1101 return(ctx
->stats
.sess_accept
);
1102 case SSL_CTRL_SESS_ACCEPT_GOOD
:
1103 return(ctx
->stats
.sess_accept_good
);
1104 case SSL_CTRL_SESS_ACCEPT_RENEGOTIATE
:
1105 return(ctx
->stats
.sess_accept_renegotiate
);
1106 case SSL_CTRL_SESS_HIT
:
1107 return(ctx
->stats
.sess_hit
);
1108 case SSL_CTRL_SESS_CB_HIT
:
1109 return(ctx
->stats
.sess_cb_hit
);
1110 case SSL_CTRL_SESS_MISSES
:
1111 return(ctx
->stats
.sess_miss
);
1112 case SSL_CTRL_SESS_TIMEOUTS
:
1113 return(ctx
->stats
.sess_timeout
);
1114 case SSL_CTRL_SESS_CACHE_FULL
:
1115 return(ctx
->stats
.sess_cache_full
);
1116 case SSL_CTRL_OPTIONS
:
1117 return(ctx
->options
|=larg
);
1119 return(ctx
->mode
|=larg
);
1120 case SSL_CTRL_SET_MAX_SEND_FRAGMENT
:
1121 if (larg
< 512 || larg
> SSL3_RT_MAX_PLAIN_LENGTH
)
1123 ctx
->max_send_fragment
= larg
;
1126 return(ctx
->method
->ssl_ctx_ctrl(ctx
,cmd
,larg
,parg
));
1130 long SSL_CTX_callback_ctrl(SSL_CTX
*ctx
, int cmd
, void (*fp
)(void))
1134 case SSL_CTRL_SET_MSG_CALLBACK
:
1135 ctx
->msg_callback
= (void (*)(int write_p
, int version
, int content_type
, const void *buf
, size_t len
, SSL
*ssl
, void *arg
))(fp
);
1139 return(ctx
->method
->ssl_ctx_callback_ctrl(ctx
,cmd
,fp
));
1143 int ssl_cipher_id_cmp(const SSL_CIPHER
*a
, const SSL_CIPHER
*b
)
1151 return((l
> 0)?1:-1);
1154 int ssl_cipher_ptr_id_cmp(const SSL_CIPHER
* const *ap
,
1155 const SSL_CIPHER
* const *bp
)
1159 l
=(*ap
)->id
-(*bp
)->id
;
1163 return((l
> 0)?1:-1);
1166 /** return a STACK of the ciphers available for the SSL and in order of
1168 STACK_OF(SSL_CIPHER
) *SSL_get_ciphers(const SSL
*s
)
1172 if (s
->cipher_list
!= NULL
)
1174 return(s
->cipher_list
);
1176 else if ((s
->ctx
!= NULL
) &&
1177 (s
->ctx
->cipher_list
!= NULL
))
1179 return(s
->ctx
->cipher_list
);
1185 /** return a STACK of the ciphers available for the SSL and in order of
1187 STACK_OF(SSL_CIPHER
) *ssl_get_ciphers_by_id(SSL
*s
)
1191 if (s
->cipher_list_by_id
!= NULL
)
1193 return(s
->cipher_list_by_id
);
1195 else if ((s
->ctx
!= NULL
) &&
1196 (s
->ctx
->cipher_list_by_id
!= NULL
))
1198 return(s
->ctx
->cipher_list_by_id
);
1204 /** The old interface to get the same thing as SSL_get_ciphers() */
1205 const char *SSL_get_cipher_list(const SSL
*s
,int n
)
1208 STACK_OF(SSL_CIPHER
) *sk
;
1210 if (s
== NULL
) return(NULL
);
1211 sk
=SSL_get_ciphers(s
);
1212 if ((sk
== NULL
) || (sk_SSL_CIPHER_num(sk
) <= n
))
1214 c
=sk_SSL_CIPHER_value(sk
,n
);
1215 if (c
== NULL
) return(NULL
);
1219 /** specify the ciphers to be used by default by the SSL_CTX */
1220 int SSL_CTX_set_cipher_list(SSL_CTX
*ctx
, const char *str
)
1222 STACK_OF(SSL_CIPHER
) *sk
;
1224 sk
=ssl_create_cipher_list(ctx
->method
,&ctx
->cipher_list
,
1225 &ctx
->cipher_list_by_id
,str
);
1226 /* ssl_create_cipher_list may return an empty stack if it
1227 * was unable to find a cipher matching the given rule string
1228 * (for example if the rule string specifies a cipher which
1229 * has been disabled). This is not an error as far as
1230 * ssl_create_cipher_list is concerned, and hence
1231 * ctx->cipher_list and ctx->cipher_list_by_id has been
1235 else if (sk_SSL_CIPHER_num(sk
) == 0)
1237 SSLerr(SSL_F_SSL_CTX_SET_CIPHER_LIST
, SSL_R_NO_CIPHER_MATCH
);
1243 /** specify the ciphers to be used by the SSL */
1244 int SSL_set_cipher_list(SSL
*s
,const char *str
)
1246 STACK_OF(SSL_CIPHER
) *sk
;
1248 sk
=ssl_create_cipher_list(s
->ctx
->method
,&s
->cipher_list
,
1249 &s
->cipher_list_by_id
,str
);
1250 /* see comment in SSL_CTX_set_cipher_list */
1253 else if (sk_SSL_CIPHER_num(sk
) == 0)
1255 SSLerr(SSL_F_SSL_SET_CIPHER_LIST
, SSL_R_NO_CIPHER_MATCH
);
1261 /* works well for SSLv2, not so good for SSLv3 */
1262 char *SSL_get_shared_ciphers(const SSL
*s
,char *buf
,int len
)
1266 STACK_OF(SSL_CIPHER
) *sk
;
1270 if ((s
->session
== NULL
) || (s
->session
->ciphers
== NULL
) ||
1275 sk
=s
->session
->ciphers
;
1276 for (i
=0; i
<sk_SSL_CIPHER_num(sk
); i
++)
1278 /* Decrement for either the ':' or a '\0' */
1280 c
=sk_SSL_CIPHER_value(sk
,i
);
1281 for (cp
=c
->name
; *cp
; )
1297 int ssl_cipher_list_to_bytes(SSL
*s
,STACK_OF(SSL_CIPHER
) *sk
,unsigned char *p
,
1298 int (*put_cb
)(const SSL_CIPHER
*, unsigned char *))
1303 #ifndef OPENSSL_NO_KRB5
1304 int nokrb5
= !kssl_tgt_is_available(s
->kssl_ctx
);
1305 #endif /* OPENSSL_NO_KRB5 */
1307 if (sk
== NULL
) return(0);
1310 for (i
=0; i
<sk_SSL_CIPHER_num(sk
); i
++)
1312 c
=sk_SSL_CIPHER_value(sk
,i
);
1313 #ifndef OPENSSL_NO_KRB5
1314 if (((c
->algorithm_mkey
& SSL_kKRB5
) || (c
->algorithm_auth
& SSL_aKRB5
)) &&
1317 #endif /* OPENSSL_NO_KRB5 */
1318 #ifndef OPENSSL_NO_PSK
1319 /* with PSK there must be client callback set */
1320 if (((c
->algorithm_mkey
& SSL_kPSK
) || (c
->algorithm_auth
& SSL_aPSK
)) &&
1321 s
->psk_client_callback
== NULL
)
1323 #endif /* OPENSSL_NO_PSK */
1324 j
= put_cb
? put_cb(c
,p
) : ssl_put_cipher_by_char(s
,c
,p
);
1330 STACK_OF(SSL_CIPHER
) *ssl_bytes_to_cipher_list(SSL
*s
,unsigned char *p
,int num
,
1331 STACK_OF(SSL_CIPHER
) **skp
)
1334 STACK_OF(SSL_CIPHER
) *sk
;
1337 n
=ssl_put_cipher_by_char(s
,NULL
,NULL
);
1340 SSLerr(SSL_F_SSL_BYTES_TO_CIPHER_LIST
,SSL_R_ERROR_IN_RECEIVED_CIPHER_LIST
);
1343 if ((skp
== NULL
) || (*skp
== NULL
))
1344 sk
=sk_SSL_CIPHER_new_null(); /* change perhaps later */
1348 sk_SSL_CIPHER_zero(sk
);
1351 for (i
=0; i
<num
; i
+=n
)
1353 c
=ssl_get_cipher_by_char(s
,p
);
1357 if (!sk_SSL_CIPHER_push(sk
,c
))
1359 SSLerr(SSL_F_SSL_BYTES_TO_CIPHER_LIST
,ERR_R_MALLOC_FAILURE
);
1369 if ((skp
== NULL
) || (*skp
== NULL
))
1370 sk_SSL_CIPHER_free(sk
);
1375 #ifndef OPENSSL_NO_TLSEXT
1376 /** return a servername extension value if provided in Client Hello, or NULL.
1377 * So far, only host_name types are defined (RFC 3546).
1380 const char *SSL_get_servername(const SSL
*s
, const int type
)
1382 if (type
!= TLSEXT_NAMETYPE_host_name
)
1385 return s
->session
&& !s
->tlsext_hostname
?
1386 s
->session
->tlsext_hostname
:
1390 int SSL_get_servername_type(const SSL
*s
)
1392 if (s
->session
&& (!s
->tlsext_hostname
? s
->session
->tlsext_hostname
: s
->tlsext_hostname
))
1393 return TLSEXT_NAMETYPE_host_name
;
1398 unsigned long SSL_SESSION_hash(const SSL_SESSION
*a
)
1403 ((unsigned int) a
->session_id
[0] )|
1404 ((unsigned int) a
->session_id
[1]<< 8L)|
1405 ((unsigned long)a
->session_id
[2]<<16L)|
1406 ((unsigned long)a
->session_id
[3]<<24L);
1410 /* NB: If this function (or indeed the hash function which uses a sort of
1411 * coarser function than this one) is changed, ensure
1412 * SSL_CTX_has_matching_session_id() is checked accordingly. It relies on being
1413 * able to construct an SSL_SESSION that will collide with any existing session
1414 * with a matching session ID. */
1415 int SSL_SESSION_cmp(const SSL_SESSION
*a
,const SSL_SESSION
*b
)
1417 if (a
->ssl_version
!= b
->ssl_version
)
1419 if (a
->session_id_length
!= b
->session_id_length
)
1421 return(memcmp(a
->session_id
,b
->session_id
,a
->session_id_length
));
1424 /* These wrapper functions should remain rather than redeclaring
1425 * SSL_SESSION_hash and SSL_SESSION_cmp for void* types and casting each
1426 * variable. The reason is that the functions aren't static, they're exposed via
1428 static IMPLEMENT_LHASH_HASH_FN(SSL_SESSION_hash
, SSL_SESSION
*)
1429 static IMPLEMENT_LHASH_COMP_FN(SSL_SESSION_cmp
, SSL_SESSION
*)
1431 SSL_CTX
*SSL_CTX_new(const SSL_METHOD
*meth
)
1437 SSLerr(SSL_F_SSL_CTX_NEW
,SSL_R_NULL_SSL_METHOD_PASSED
);
1441 if (SSL_get_ex_data_X509_STORE_CTX_idx() < 0)
1443 SSLerr(SSL_F_SSL_CTX_NEW
,SSL_R_X509_VERIFICATION_SETUP_PROBLEMS
);
1446 ret
=(SSL_CTX
*)OPENSSL_malloc(sizeof(SSL_CTX
));
1450 memset(ret
,0,sizeof(SSL_CTX
));
1454 ret
->cert_store
=NULL
;
1455 ret
->session_cache_mode
=SSL_SESS_CACHE_SERVER
;
1456 ret
->session_cache_size
=SSL_SESSION_CACHE_MAX_SIZE_DEFAULT
;
1457 ret
->session_cache_head
=NULL
;
1458 ret
->session_cache_tail
=NULL
;
1460 /* We take the system default */
1461 ret
->session_timeout
=meth
->get_timeout();
1463 ret
->new_session_cb
=0;
1464 ret
->remove_session_cb
=0;
1465 ret
->get_session_cb
=0;
1466 ret
->generate_session_id
=0;
1468 memset((char *)&ret
->stats
,0,sizeof(ret
->stats
));
1471 ret
->quiet_shutdown
=0;
1473 /* ret->cipher=NULL;*/
1474 /* ret->s2->challenge=NULL;
1475 ret->master_key=NULL;
1477 ret->s2->conn_id=NULL; */
1479 ret
->info_callback
=NULL
;
1481 ret
->app_verify_callback
=0;
1482 ret
->app_verify_arg
=NULL
;
1484 ret
->max_cert_list
=SSL_MAX_CERT_LIST_DEFAULT
;
1486 ret
->msg_callback
=0;
1487 ret
->msg_callback_arg
=NULL
;
1488 ret
->verify_mode
=SSL_VERIFY_NONE
;
1490 ret
->verify_depth
=-1; /* Don't impose a limit (but x509_lu.c does) */
1492 ret
->sid_ctx_length
=0;
1493 ret
->default_verify_callback
=NULL
;
1494 if ((ret
->cert
=ssl_cert_new()) == NULL
)
1497 ret
->default_passwd_callback
=0;
1498 ret
->default_passwd_callback_userdata
=NULL
;
1499 ret
->client_cert_cb
=0;
1500 ret
->app_gen_cookie_cb
=0;
1501 ret
->app_verify_cookie_cb
=0;
1503 ret
->sessions
=lh_new(LHASH_HASH_FN(SSL_SESSION_hash
),
1504 LHASH_COMP_FN(SSL_SESSION_cmp
));
1505 if (ret
->sessions
== NULL
) goto err
;
1506 ret
->cert_store
=X509_STORE_new();
1507 if (ret
->cert_store
== NULL
) goto err
;
1509 ssl_create_cipher_list(ret
->method
,
1510 &ret
->cipher_list
,&ret
->cipher_list_by_id
,
1511 SSL_DEFAULT_CIPHER_LIST
);
1512 if (ret
->cipher_list
== NULL
1513 || sk_SSL_CIPHER_num(ret
->cipher_list
) <= 0)
1515 SSLerr(SSL_F_SSL_CTX_NEW
,SSL_R_LIBRARY_HAS_NO_CIPHERS
);
1519 ret
->param
= X509_VERIFY_PARAM_new();
1523 if ((ret
->rsa_md5
=EVP_get_digestbyname("ssl2-md5")) == NULL
)
1525 SSLerr(SSL_F_SSL_CTX_NEW
,SSL_R_UNABLE_TO_LOAD_SSL2_MD5_ROUTINES
);
1528 if ((ret
->md5
=EVP_get_digestbyname("ssl3-md5")) == NULL
)
1530 SSLerr(SSL_F_SSL_CTX_NEW
,SSL_R_UNABLE_TO_LOAD_SSL3_MD5_ROUTINES
);
1533 if ((ret
->sha1
=EVP_get_digestbyname("ssl3-sha1")) == NULL
)
1535 SSLerr(SSL_F_SSL_CTX_NEW
,SSL_R_UNABLE_TO_LOAD_SSL3_SHA1_ROUTINES
);
1539 if ((ret
->client_CA
=sk_X509_NAME_new_null()) == NULL
)
1542 CRYPTO_new_ex_data(CRYPTO_EX_INDEX_SSL_CTX
, ret
, &ret
->ex_data
);
1544 ret
->extra_certs
=NULL
;
1545 ret
->comp_methods
=SSL_COMP_get_compression_methods();
1547 ret
->max_send_fragment
= SSL3_RT_MAX_PLAIN_LENGTH
;
1549 #ifndef OPENSSL_NO_TLSEXT
1550 ret
->tlsext_servername_callback
= 0;
1551 ret
->tlsext_servername_arg
= NULL
;
1552 /* Setup RFC4507 ticket keys */
1553 if ((RAND_pseudo_bytes(ret
->tlsext_tick_key_name
, 16) <= 0)
1554 || (RAND_bytes(ret
->tlsext_tick_hmac_key
, 16) <= 0)
1555 || (RAND_bytes(ret
->tlsext_tick_aes_key
, 16) <= 0))
1556 ret
->options
|= SSL_OP_NO_TICKET
;
1559 #ifndef OPENSSL_NO_PSK
1560 ret
->psk_identity_hint
=NULL
;
1561 ret
->psk_client_callback
=NULL
;
1562 ret
->psk_server_callback
=NULL
;
1566 SSLerr(SSL_F_SSL_CTX_NEW
,ERR_R_MALLOC_FAILURE
);
1568 if (ret
!= NULL
) SSL_CTX_free(ret
);
1573 static void SSL_COMP_free(SSL_COMP
*comp
)
1574 { OPENSSL_free(comp
); }
1577 void SSL_CTX_free(SSL_CTX
*a
)
1581 if (a
== NULL
) return;
1583 i
=CRYPTO_add(&a
->references
,-1,CRYPTO_LOCK_SSL_CTX
);
1585 REF_PRINT("SSL_CTX",a
);
1591 fprintf(stderr
,"SSL_CTX_free, bad reference count\n");
1597 X509_VERIFY_PARAM_free(a
->param
);
1600 * Free internal session cache. However: the remove_cb() may reference
1601 * the ex_data of SSL_CTX, thus the ex_data store can only be removed
1602 * after the sessions were flushed.
1603 * As the ex_data handling routines might also touch the session cache,
1604 * the most secure solution seems to be: empty (flush) the cache, then
1605 * free ex_data, then finally free the cache.
1606 * (See ticket [openssl.org #212].)
1608 if (a
->sessions
!= NULL
)
1609 SSL_CTX_flush_sessions(a
,0);
1611 CRYPTO_free_ex_data(CRYPTO_EX_INDEX_SSL_CTX
, a
, &a
->ex_data
);
1613 if (a
->sessions
!= NULL
)
1614 lh_free(a
->sessions
);
1616 if (a
->cert_store
!= NULL
)
1617 X509_STORE_free(a
->cert_store
);
1618 if (a
->cipher_list
!= NULL
)
1619 sk_SSL_CIPHER_free(a
->cipher_list
);
1620 if (a
->cipher_list_by_id
!= NULL
)
1621 sk_SSL_CIPHER_free(a
->cipher_list_by_id
);
1622 if (a
->cert
!= NULL
)
1623 ssl_cert_free(a
->cert
);
1624 if (a
->client_CA
!= NULL
)
1625 sk_X509_NAME_pop_free(a
->client_CA
,X509_NAME_free
);
1626 if (a
->extra_certs
!= NULL
)
1627 sk_X509_pop_free(a
->extra_certs
,X509_free
);
1628 #if 0 /* This should never be done, since it removes a global database */
1629 if (a
->comp_methods
!= NULL
)
1630 sk_SSL_COMP_pop_free(a
->comp_methods
,SSL_COMP_free
);
1632 a
->comp_methods
= NULL
;
1635 #ifndef OPENSSL_NO_PSK
1636 if (a
->psk_identity_hint
)
1637 OPENSSL_free(a
->psk_identity_hint
);
1642 void SSL_CTX_set_default_passwd_cb(SSL_CTX
*ctx
, pem_password_cb
*cb
)
1644 ctx
->default_passwd_callback
=cb
;
1647 void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX
*ctx
,void *u
)
1649 ctx
->default_passwd_callback_userdata
=u
;
1652 void SSL_CTX_set_cert_verify_callback(SSL_CTX
*ctx
, int (*cb
)(X509_STORE_CTX
*,void *), void *arg
)
1654 ctx
->app_verify_callback
=cb
;
1655 ctx
->app_verify_arg
=arg
;
1658 void SSL_CTX_set_verify(SSL_CTX
*ctx
,int mode
,int (*cb
)(int, X509_STORE_CTX
*))
1660 ctx
->verify_mode
=mode
;
1661 ctx
->default_verify_callback
=cb
;
1664 void SSL_CTX_set_verify_depth(SSL_CTX
*ctx
,int depth
)
1666 X509_VERIFY_PARAM_set_depth(ctx
->param
, depth
);
1669 void ssl_set_cert_masks(CERT
*c
, SSL_CIPHER
*cipher
)
1672 int rsa_enc
,rsa_tmp
,rsa_sign
,dh_tmp
,dh_rsa
,dh_dsa
,dsa_sign
;
1673 int rsa_enc_export
,dh_rsa_export
,dh_dsa_export
;
1674 int rsa_tmp_export
,dh_tmp_export
,kl
;
1675 unsigned long mask_k
,mask_a
,emask_k
,emask_a
;
1676 int have_ecc_cert
, ecdh_ok
, ecdsa_ok
, ecc_pkey_size
;
1677 #ifndef OPENSSL_NO_ECDH
1681 EVP_PKEY
*ecc_pkey
= NULL
;
1682 int signature_nid
= 0;
1684 if (c
== NULL
) return;
1686 kl
=SSL_C_EXPORT_PKEYLENGTH(cipher
);
1688 #ifndef OPENSSL_NO_RSA
1689 rsa_tmp
=(c
->rsa_tmp
!= NULL
|| c
->rsa_tmp_cb
!= NULL
);
1690 rsa_tmp_export
=(c
->rsa_tmp_cb
!= NULL
||
1691 (rsa_tmp
&& RSA_size(c
->rsa_tmp
)*8 <= kl
));
1693 rsa_tmp
=rsa_tmp_export
=0;
1695 #ifndef OPENSSL_NO_DH
1696 dh_tmp
=(c
->dh_tmp
!= NULL
|| c
->dh_tmp_cb
!= NULL
);
1697 dh_tmp_export
=(c
->dh_tmp_cb
!= NULL
||
1698 (dh_tmp
&& DH_size(c
->dh_tmp
)*8 <= kl
));
1700 dh_tmp
=dh_tmp_export
=0;
1703 #ifndef OPENSSL_NO_ECDH
1704 have_ecdh_tmp
=(c
->ecdh_tmp
!= NULL
|| c
->ecdh_tmp_cb
!= NULL
);
1706 cpk
= &(c
->pkeys
[SSL_PKEY_RSA_ENC
]);
1707 rsa_enc
= (cpk
->x509
!= NULL
&& cpk
->privatekey
!= NULL
);
1708 rsa_enc_export
=(rsa_enc
&& EVP_PKEY_size(cpk
->privatekey
)*8 <= kl
);
1709 cpk
= &(c
->pkeys
[SSL_PKEY_RSA_SIGN
]);
1710 rsa_sign
=(cpk
->x509
!= NULL
&& cpk
->privatekey
!= NULL
);
1711 cpk
= &(c
->pkeys
[SSL_PKEY_DSA_SIGN
]);
1712 dsa_sign
=(cpk
->x509
!= NULL
&& cpk
->privatekey
!= NULL
);
1713 cpk
= &(c
->pkeys
[SSL_PKEY_DH_RSA
]);
1714 dh_rsa
= (cpk
->x509
!= NULL
&& cpk
->privatekey
!= NULL
);
1715 dh_rsa_export
=(dh_rsa
&& EVP_PKEY_size(cpk
->privatekey
)*8 <= kl
);
1716 cpk
= &(c
->pkeys
[SSL_PKEY_DH_DSA
]);
1717 /* FIX THIS EAY EAY EAY */
1718 dh_dsa
= (cpk
->x509
!= NULL
&& cpk
->privatekey
!= NULL
);
1719 dh_dsa_export
=(dh_dsa
&& EVP_PKEY_size(cpk
->privatekey
)*8 <= kl
);
1720 cpk
= &(c
->pkeys
[SSL_PKEY_ECC
]);
1721 have_ecc_cert
= (cpk
->x509
!= NULL
&& cpk
->privatekey
!= NULL
);
1728 printf("rt=%d rte=%d dht=%d ecdht=%d re=%d ree=%d rs=%d ds=%d dhr=%d dhd=%d\n",
1729 rsa_tmp
,rsa_tmp_export
,dh_tmp
,have_ecdh_tmp
,
1730 rsa_enc
,rsa_enc_export
,rsa_sign
,dsa_sign
,dh_rsa
,dh_dsa
);
1733 if (rsa_enc
|| (rsa_tmp
&& rsa_sign
))
1735 if (rsa_enc_export
|| (rsa_tmp_export
&& (rsa_sign
|| rsa_enc
)))
1739 /* The match needs to be both kEDH and aRSA or aDSA, so don't worry */
1740 if ( (dh_tmp
|| dh_rsa
|| dh_dsa
) &&
1741 (rsa_enc
|| rsa_sign
|| dsa_sign
))
1743 if ((dh_tmp_export
|| dh_rsa_export
|| dh_dsa_export
) &&
1744 (rsa_enc
|| rsa_sign
|| dsa_sign
))
1754 if (dh_rsa
) mask_k
|=SSL_kDHr
;
1755 if (dh_rsa_export
) emask_k
|=SSL_kDHr
;
1757 if (dh_dsa
) mask_k
|=SSL_kDHd
;
1758 if (dh_dsa_export
) emask_k
|=SSL_kDHd
;
1760 if (rsa_enc
|| rsa_sign
)
1775 #ifndef OPENSSL_NO_KRB5
1782 /* An ECC certificate may be usable for ECDH and/or
1783 * ECDSA cipher suites depending on the key usage extension.
1787 /* This call populates extension flags (ex_flags) */
1788 x
= (c
->pkeys
[SSL_PKEY_ECC
]).x509
;
1789 X509_check_purpose(x
, -1, 0);
1790 ecdh_ok
= (x
->ex_flags
& EXFLAG_KUSAGE
) ?
1791 (x
->ex_kusage
& X509v3_KU_KEY_AGREEMENT
) : 1;
1792 ecdsa_ok
= (x
->ex_flags
& EXFLAG_KUSAGE
) ?
1793 (x
->ex_kusage
& X509v3_KU_DIGITAL_SIGNATURE
) : 1;
1794 ecc_pkey
= X509_get_pubkey(x
);
1795 ecc_pkey_size
= (ecc_pkey
!= NULL
) ?
1796 EVP_PKEY_bits(ecc_pkey
) : 0;
1797 EVP_PKEY_free(ecc_pkey
);
1798 if ((x
->sig_alg
) && (x
->sig_alg
->algorithm
))
1799 signature_nid
= OBJ_obj2nid(x
->sig_alg
->algorithm
);
1800 #ifndef OPENSSL_NO_ECDH
1803 const char *sig
= OBJ_nid2ln(signature_nid
);
1810 if (strstr(sig
, "WithRSA"))
1814 if (ecc_pkey_size
<= 163)
1816 emask_k
|=SSL_kECDHr
;
1821 if (signature_nid
== NID_ecdsa_with_SHA1
)
1825 if (ecc_pkey_size
<= 163)
1827 emask_k
|=SSL_kECDHe
;
1833 #ifndef OPENSSL_NO_ECDSA
1837 emask_a
|=SSL_aECDSA
;
1842 #ifndef OPENSSL_NO_ECDH
1846 emask_k
|=SSL_kEECDH
;
1850 #ifndef OPENSSL_NO_PSK
1853 emask_k
|= SSL_kPSK
;
1854 emask_a
|= SSL_aPSK
;
1859 c
->export_mask_k
=emask_k
;
1860 c
->export_mask_a
=emask_a
;
1864 /* This handy macro borrowed from crypto/x509v3/v3_purp.c */
1865 #define ku_reject(x, usage) \
1866 (((x)->ex_flags & EXFLAG_KUSAGE) && !((x)->ex_kusage & (usage)))
1868 int ssl_check_srvr_ecc_cert_and_alg(X509
*x
, SSL_CIPHER
*cs
)
1870 unsigned long alg_k
, alg_a
;
1871 EVP_PKEY
*pkey
= NULL
;
1873 int signature_nid
= 0;
1875 alg_k
= cs
->algorithm_mkey
;
1876 alg_a
= cs
->algorithm_auth
;
1878 if (SSL_C_IS_EXPORT(cs
))
1880 /* ECDH key length in export ciphers must be <= 163 bits */
1881 pkey
= X509_get_pubkey(x
);
1882 if (pkey
== NULL
) return 0;
1883 keysize
= EVP_PKEY_bits(pkey
);
1884 EVP_PKEY_free(pkey
);
1885 if (keysize
> 163) return 0;
1888 /* This call populates the ex_flags field correctly */
1889 X509_check_purpose(x
, -1, 0);
1890 if ((x
->sig_alg
) && (x
->sig_alg
->algorithm
))
1891 signature_nid
= OBJ_obj2nid(x
->sig_alg
->algorithm
);
1892 if (alg_k
& SSL_kECDHe
|| alg_k
& SSL_kECDHr
)
1894 /* key usage, if present, must allow key agreement */
1895 if (ku_reject(x
, X509v3_KU_KEY_AGREEMENT
))
1897 SSLerr(SSL_F_SSL_CHECK_SRVR_ECC_CERT_AND_ALG
, SSL_R_ECC_CERT_NOT_FOR_KEY_AGREEMENT
);
1900 if (alg_k
& SSL_kECDHe
)
1902 /* signature alg must be ECDSA */
1903 if (signature_nid
!= NID_ecdsa_with_SHA1
)
1905 SSLerr(SSL_F_SSL_CHECK_SRVR_ECC_CERT_AND_ALG
, SSL_R_ECC_CERT_SHOULD_HAVE_SHA1_SIGNATURE
);
1909 if (alg_k
& SSL_kECDHr
)
1911 /* signature alg must be RSA */
1913 const char *sig
= OBJ_nid2ln(signature_nid
);
1919 if (strstr(sig
, "WithRSA") == NULL
)
1921 SSLerr(SSL_F_SSL_CHECK_SRVR_ECC_CERT_AND_ALG
, SSL_R_ECC_CERT_SHOULD_HAVE_RSA_SIGNATURE
);
1926 if (alg_a
& SSL_aECDSA
)
1928 /* key usage, if present, must allow signing */
1929 if (ku_reject(x
, X509v3_KU_DIGITAL_SIGNATURE
))
1931 SSLerr(SSL_F_SSL_CHECK_SRVR_ECC_CERT_AND_ALG
, SSL_R_ECC_CERT_NOT_FOR_SIGNING
);
1936 return 1; /* all checks are ok */
1939 /* THIS NEEDS CLEANING UP */
1940 X509
*ssl_get_server_send_cert(SSL
*s
)
1942 unsigned long alg_k
,alg_a
,mask_k
,mask_a
;
1947 ssl_set_cert_masks(c
, s
->s3
->tmp
.new_cipher
);
1948 is_export
=SSL_C_IS_EXPORT(s
->s3
->tmp
.new_cipher
);
1951 mask_k
= c
->export_mask_k
;
1952 mask_a
= c
->export_mask_a
;
1960 alg_k
= s
->s3
->tmp
.new_cipher
->algorithm_mkey
;
1961 alg_a
= s
->s3
->tmp
.new_cipher
->algorithm_auth
;
1963 if (alg_k
& (SSL_kECDHr
|SSL_kECDHe
))
1965 /* we don't need to look at SSL_kEECDH
1966 * since no certificate is needed for
1967 * anon ECDH and for authenticated
1968 * EECDH, the check for the auth
1969 * algorithm will set i correctly
1970 * NOTE: For ECDH-RSA, we need an ECC
1971 * not an RSA cert but for EECDH-RSA
1972 * we need an RSA cert. Placing the
1973 * checks for SSL_kECDH before RSA
1974 * checks ensures the correct cert is chosen.
1978 else if (alg_a
& SSL_aECDSA
)
1982 else if (alg_k
& SSL_kDHr
)
1984 else if (alg_k
& SSL_kDHd
)
1986 else if (alg_a
& SSL_aDSS
)
1987 i
=SSL_PKEY_DSA_SIGN
;
1988 else if (alg_a
& SSL_aRSA
)
1990 if (c
->pkeys
[SSL_PKEY_RSA_ENC
].x509
== NULL
)
1991 i
=SSL_PKEY_RSA_SIGN
;
1995 else if (alg_a
& SSL_aKRB5
)
1997 /* VRS something else here? */
2000 else /* if (alg_a & SSL_aNULL) */
2002 SSLerr(SSL_F_SSL_GET_SERVER_SEND_CERT
,ERR_R_INTERNAL_ERROR
);
2005 if (c
->pkeys
[i
].x509
== NULL
) return(NULL
);
2007 return(c
->pkeys
[i
].x509
);
2010 EVP_PKEY
*ssl_get_sign_pkey(SSL
*s
,SSL_CIPHER
*cipher
)
2012 unsigned long alg_a
;
2015 alg_a
= cipher
->algorithm_auth
;
2018 if ((alg_a
& SSL_aDSS
) &&
2019 (c
->pkeys
[SSL_PKEY_DSA_SIGN
].privatekey
!= NULL
))
2020 return(c
->pkeys
[SSL_PKEY_DSA_SIGN
].privatekey
);
2021 else if (alg_a
& SSL_aRSA
)
2023 if (c
->pkeys
[SSL_PKEY_RSA_SIGN
].privatekey
!= NULL
)
2024 return(c
->pkeys
[SSL_PKEY_RSA_SIGN
].privatekey
);
2025 else if (c
->pkeys
[SSL_PKEY_RSA_ENC
].privatekey
!= NULL
)
2026 return(c
->pkeys
[SSL_PKEY_RSA_ENC
].privatekey
);
2030 else if ((alg_a
& SSL_aECDSA
) &&
2031 (c
->pkeys
[SSL_PKEY_ECC
].privatekey
!= NULL
))
2032 return(c
->pkeys
[SSL_PKEY_ECC
].privatekey
);
2033 else /* if (alg_a & SSL_aNULL) */
2035 SSLerr(SSL_F_SSL_GET_SIGN_PKEY
,ERR_R_INTERNAL_ERROR
);
2040 void ssl_update_cache(SSL
*s
,int mode
)
2044 /* If the session_id_length is 0, we are not supposed to cache it,
2045 * and it would be rather hard to do anyway :-) */
2046 if (s
->session
->session_id_length
== 0) return;
2048 i
=s
->session_ctx
->session_cache_mode
;
2049 if ((i
& mode
) && (!s
->hit
)
2050 && ((i
& SSL_SESS_CACHE_NO_INTERNAL_STORE
)
2051 || SSL_CTX_add_session(s
->session_ctx
,s
->session
))
2052 && (s
->session_ctx
->new_session_cb
!= NULL
))
2054 CRYPTO_add(&s
->session
->references
,1,CRYPTO_LOCK_SSL_SESSION
);
2055 if (!s
->session_ctx
->new_session_cb(s
,s
->session
))
2056 SSL_SESSION_free(s
->session
);
2059 /* auto flush every 255 connections */
2060 if ((!(i
& SSL_SESS_CACHE_NO_AUTO_CLEAR
)) &&
2061 ((i
& mode
) == mode
))
2063 if ( (((mode
& SSL_SESS_CACHE_CLIENT
)
2064 ?s
->session_ctx
->stats
.sess_connect_good
2065 :s
->session_ctx
->stats
.sess_accept_good
) & 0xff) == 0xff)
2067 SSL_CTX_flush_sessions(s
->session_ctx
,(unsigned long)time(NULL
));
2072 const SSL_METHOD
*SSL_get_ssl_method(SSL
*s
)
2077 int SSL_set_ssl_method(SSL
*s
, const SSL_METHOD
*meth
)
2082 if (s
->method
!= meth
)
2084 if (s
->handshake_func
!= NULL
)
2085 conn
=(s
->handshake_func
== s
->method
->ssl_connect
);
2087 if (s
->method
->version
== meth
->version
)
2091 s
->method
->ssl_free(s
);
2093 ret
=s
->method
->ssl_new(s
);
2097 s
->handshake_func
=meth
->ssl_connect
;
2099 s
->handshake_func
=meth
->ssl_accept
;
2104 int SSL_get_error(const SSL
*s
,int i
)
2110 if (i
> 0) return(SSL_ERROR_NONE
);
2112 /* Make things return SSL_ERROR_SYSCALL when doing SSL_do_handshake
2113 * etc, where we do encode the error */
2114 if ((l
=ERR_peek_error()) != 0)
2116 if (ERR_GET_LIB(l
) == ERR_LIB_SYS
)
2117 return(SSL_ERROR_SYSCALL
);
2119 return(SSL_ERROR_SSL
);
2122 if ((i
< 0) && SSL_want_read(s
))
2124 bio
=SSL_get_rbio(s
);
2125 if (BIO_should_read(bio
))
2126 return(SSL_ERROR_WANT_READ
);
2127 else if (BIO_should_write(bio
))
2128 /* This one doesn't make too much sense ... We never try
2129 * to write to the rbio, and an application program where
2130 * rbio and wbio are separate couldn't even know what it
2132 * However if we ever set s->rwstate incorrectly
2133 * (so that we have SSL_want_read(s) instead of
2134 * SSL_want_write(s)) and rbio and wbio *are* the same,
2135 * this test works around that bug; so it might be safer
2137 return(SSL_ERROR_WANT_WRITE
);
2138 else if (BIO_should_io_special(bio
))
2140 reason
=BIO_get_retry_reason(bio
);
2141 if (reason
== BIO_RR_CONNECT
)
2142 return(SSL_ERROR_WANT_CONNECT
);
2143 else if (reason
== BIO_RR_ACCEPT
)
2144 return(SSL_ERROR_WANT_ACCEPT
);
2146 return(SSL_ERROR_SYSCALL
); /* unknown */
2150 if ((i
< 0) && SSL_want_write(s
))
2152 bio
=SSL_get_wbio(s
);
2153 if (BIO_should_write(bio
))
2154 return(SSL_ERROR_WANT_WRITE
);
2155 else if (BIO_should_read(bio
))
2156 /* See above (SSL_want_read(s) with BIO_should_write(bio)) */
2157 return(SSL_ERROR_WANT_READ
);
2158 else if (BIO_should_io_special(bio
))
2160 reason
=BIO_get_retry_reason(bio
);
2161 if (reason
== BIO_RR_CONNECT
)
2162 return(SSL_ERROR_WANT_CONNECT
);
2163 else if (reason
== BIO_RR_ACCEPT
)
2164 return(SSL_ERROR_WANT_ACCEPT
);
2166 return(SSL_ERROR_SYSCALL
);
2169 if ((i
< 0) && SSL_want_x509_lookup(s
))
2171 return(SSL_ERROR_WANT_X509_LOOKUP
);
2176 if (s
->version
== SSL2_VERSION
)
2178 /* assume it is the socket being closed */
2179 return(SSL_ERROR_ZERO_RETURN
);
2183 if ((s
->shutdown
& SSL_RECEIVED_SHUTDOWN
) &&
2184 (s
->s3
->warn_alert
== SSL_AD_CLOSE_NOTIFY
))
2185 return(SSL_ERROR_ZERO_RETURN
);
2188 return(SSL_ERROR_SYSCALL
);
2191 int SSL_do_handshake(SSL
*s
)
2195 if (s
->handshake_func
== NULL
)
2197 SSLerr(SSL_F_SSL_DO_HANDSHAKE
,SSL_R_CONNECTION_TYPE_NOT_SET
);
2201 s
->method
->ssl_renegotiate_check(s
);
2203 if (SSL_in_init(s
) || SSL_in_before(s
))
2205 ret
=s
->handshake_func(s
);
2210 /* For the next 2 functions, SSL_clear() sets shutdown and so
2211 * one of these calls will reset it */
2212 void SSL_set_accept_state(SSL
*s
)
2216 s
->state
=SSL_ST_ACCEPT
|SSL_ST_BEFORE
;
2217 s
->handshake_func
=s
->method
->ssl_accept
;
2218 /* clear the current cipher */
2219 ssl_clear_cipher_ctx(s
);
2220 ssl_clear_hash_ctx(&s
->read_hash
);
2221 ssl_clear_hash_ctx(&s
->write_hash
);
2224 void SSL_set_connect_state(SSL
*s
)
2228 s
->state
=SSL_ST_CONNECT
|SSL_ST_BEFORE
;
2229 s
->handshake_func
=s
->method
->ssl_connect
;
2230 /* clear the current cipher */
2231 ssl_clear_cipher_ctx(s
);
2232 ssl_clear_hash_ctx(&s
->read_hash
);
2233 ssl_clear_hash_ctx(&s
->write_hash
);
2236 int ssl_undefined_function(SSL
*s
)
2238 SSLerr(SSL_F_SSL_UNDEFINED_FUNCTION
,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
2242 int ssl_undefined_void_function(void)
2244 SSLerr(SSL_F_SSL_UNDEFINED_VOID_FUNCTION
,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
2248 int ssl_undefined_const_function(const SSL
*s
)
2250 SSLerr(SSL_F_SSL_UNDEFINED_CONST_FUNCTION
,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
2254 SSL_METHOD
*ssl_bad_method(int ver
)
2256 SSLerr(SSL_F_SSL_BAD_METHOD
,ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED
);
2260 const char *SSL_get_version(const SSL
*s
)
2262 if (s
->version
== TLS1_VERSION
)
2264 else if (s
->version
== SSL3_VERSION
)
2266 else if (s
->version
== SSL2_VERSION
)
2272 SSL
*SSL_dup(SSL
*s
)
2274 STACK_OF(X509_NAME
) *sk
;
2279 if ((ret
=SSL_new(SSL_get_SSL_CTX(s
))) == NULL
)
2282 ret
->version
= s
->version
;
2283 ret
->type
= s
->type
;
2284 ret
->method
= s
->method
;
2286 if (s
->session
!= NULL
)
2288 /* This copies session-id, SSL_METHOD, sid_ctx, and 'cert' */
2289 SSL_copy_session_id(ret
,s
);
2293 /* No session has been established yet, so we have to expect
2294 * that s->cert or ret->cert will be changed later --
2295 * they should not both point to the same object,
2296 * and thus we can't use SSL_copy_session_id. */
2298 ret
->method
->ssl_free(ret
);
2299 ret
->method
= s
->method
;
2300 ret
->method
->ssl_new(ret
);
2302 if (s
->cert
!= NULL
)
2304 if (ret
->cert
!= NULL
)
2306 ssl_cert_free(ret
->cert
);
2308 ret
->cert
= ssl_cert_dup(s
->cert
);
2309 if (ret
->cert
== NULL
)
2313 SSL_set_session_id_context(ret
,
2314 s
->sid_ctx
, s
->sid_ctx_length
);
2317 ret
->options
=s
->options
;
2319 SSL_set_max_cert_list(ret
,SSL_get_max_cert_list(s
));
2320 SSL_set_read_ahead(ret
,SSL_get_read_ahead(s
));
2321 ret
->msg_callback
= s
->msg_callback
;
2322 ret
->msg_callback_arg
= s
->msg_callback_arg
;
2323 SSL_set_verify(ret
,SSL_get_verify_mode(s
),
2324 SSL_get_verify_callback(s
));
2325 SSL_set_verify_depth(ret
,SSL_get_verify_depth(s
));
2326 ret
->generate_session_id
= s
->generate_session_id
;
2328 SSL_set_info_callback(ret
,SSL_get_info_callback(s
));
2330 ret
->debug
=s
->debug
;
2332 /* copy app data, a little dangerous perhaps */
2333 if (!CRYPTO_dup_ex_data(CRYPTO_EX_INDEX_SSL
, &ret
->ex_data
, &s
->ex_data
))
2336 /* setup rbio, and wbio */
2337 if (s
->rbio
!= NULL
)
2339 if (!BIO_dup_state(s
->rbio
,(char *)&ret
->rbio
))
2342 if (s
->wbio
!= NULL
)
2344 if (s
->wbio
!= s
->rbio
)
2346 if (!BIO_dup_state(s
->wbio
,(char *)&ret
->wbio
))
2350 ret
->wbio
=ret
->rbio
;
2352 ret
->rwstate
= s
->rwstate
;
2353 ret
->in_handshake
= s
->in_handshake
;
2354 ret
->handshake_func
= s
->handshake_func
;
2355 ret
->server
= s
->server
;
2356 ret
->new_session
= s
->new_session
;
2357 ret
->quiet_shutdown
= s
->quiet_shutdown
;
2358 ret
->shutdown
=s
->shutdown
;
2359 ret
->state
=s
->state
; /* SSL_dup does not really work at any state, though */
2360 ret
->rstate
=s
->rstate
;
2361 ret
->init_num
= 0; /* would have to copy ret->init_buf, ret->init_msg, ret->init_num, ret->init_off */
2364 X509_VERIFY_PARAM_inherit(ret
->param
, s
->param
);
2366 /* dup the cipher_list and cipher_list_by_id stacks */
2367 if (s
->cipher_list
!= NULL
)
2369 if ((ret
->cipher_list
=sk_SSL_CIPHER_dup(s
->cipher_list
)) == NULL
)
2372 if (s
->cipher_list_by_id
!= NULL
)
2373 if ((ret
->cipher_list_by_id
=sk_SSL_CIPHER_dup(s
->cipher_list_by_id
))
2377 /* Dup the client_CA list */
2378 if (s
->client_CA
!= NULL
)
2380 if ((sk
=sk_X509_NAME_dup(s
->client_CA
)) == NULL
) goto err
;
2382 for (i
=0; i
<sk_X509_NAME_num(sk
); i
++)
2384 xn
=sk_X509_NAME_value(sk
,i
);
2385 if (sk_X509_NAME_set(sk
,i
,X509_NAME_dup(xn
)) == NULL
)
2396 if (ret
!= NULL
) SSL_free(ret
);
2402 void ssl_clear_cipher_ctx(SSL
*s
)
2404 if (s
->enc_read_ctx
!= NULL
)
2406 EVP_CIPHER_CTX_cleanup(s
->enc_read_ctx
);
2407 OPENSSL_free(s
->enc_read_ctx
);
2408 s
->enc_read_ctx
=NULL
;
2410 if (s
->enc_write_ctx
!= NULL
)
2412 EVP_CIPHER_CTX_cleanup(s
->enc_write_ctx
);
2413 OPENSSL_free(s
->enc_write_ctx
);
2414 s
->enc_write_ctx
=NULL
;
2416 #ifndef OPENSSL_NO_COMP
2417 if (s
->expand
!= NULL
)
2419 COMP_CTX_free(s
->expand
);
2422 if (s
->compress
!= NULL
)
2424 COMP_CTX_free(s
->compress
);
2430 /* Fix this function so that it takes an optional type parameter */
2431 X509
*SSL_get_certificate(const SSL
*s
)
2433 if (s
->cert
!= NULL
)
2434 return(s
->cert
->key
->x509
);
2439 /* Fix this function so that it takes an optional type parameter */
2440 EVP_PKEY
*SSL_get_privatekey(SSL
*s
)
2442 if (s
->cert
!= NULL
)
2443 return(s
->cert
->key
->privatekey
);
2448 SSL_CIPHER
*SSL_get_current_cipher(const SSL
*s
)
2450 if ((s
->session
!= NULL
) && (s
->session
->cipher
!= NULL
))
2451 return(s
->session
->cipher
);
2454 #ifdef OPENSSL_NO_COMP
2455 const void *SSL_get_current_compression(SSL
*s
)
2459 const void *SSL_get_current_expansion(SSL
*s
)
2465 const COMP_METHOD
*SSL_get_current_compression(SSL
*s
)
2467 if (s
->compress
!= NULL
)
2468 return(s
->compress
->meth
);
2472 const COMP_METHOD
*SSL_get_current_expansion(SSL
*s
)
2474 if (s
->expand
!= NULL
)
2475 return(s
->expand
->meth
);
2480 int ssl_init_wbio_buffer(SSL
*s
,int push
)
2484 if (s
->bbio
== NULL
)
2486 bbio
=BIO_new(BIO_f_buffer());
2487 if (bbio
== NULL
) return(0);
2493 if (s
->bbio
== s
->wbio
)
2494 s
->wbio
=BIO_pop(s
->wbio
);
2496 (void)BIO_reset(bbio
);
2497 /* if (!BIO_set_write_buffer_size(bbio,16*1024)) */
2498 if (!BIO_set_read_buffer_size(bbio
,1))
2500 SSLerr(SSL_F_SSL_INIT_WBIO_BUFFER
,ERR_R_BUF_LIB
);
2505 if (s
->wbio
!= bbio
)
2506 s
->wbio
=BIO_push(bbio
,s
->wbio
);
2510 if (s
->wbio
== bbio
)
2511 s
->wbio
=BIO_pop(bbio
);
2516 void ssl_free_wbio_buffer(SSL
*s
)
2518 if (s
->bbio
== NULL
) return;
2520 if (s
->bbio
== s
->wbio
)
2522 /* remove buffering */
2523 s
->wbio
=BIO_pop(s
->wbio
);
2524 #ifdef REF_CHECK /* not the usual REF_CHECK, but this avoids adding one more preprocessor symbol */
2525 assert(s
->wbio
!= NULL
);
2532 void SSL_CTX_set_quiet_shutdown(SSL_CTX
*ctx
,int mode
)
2534 ctx
->quiet_shutdown
=mode
;
2537 int SSL_CTX_get_quiet_shutdown(const SSL_CTX
*ctx
)
2539 return(ctx
->quiet_shutdown
);
2542 void SSL_set_quiet_shutdown(SSL
*s
,int mode
)
2544 s
->quiet_shutdown
=mode
;
2547 int SSL_get_quiet_shutdown(const SSL
*s
)
2549 return(s
->quiet_shutdown
);
2552 void SSL_set_shutdown(SSL
*s
,int mode
)
2557 int SSL_get_shutdown(const SSL
*s
)
2559 return(s
->shutdown
);
2562 int SSL_version(const SSL
*s
)
2567 SSL_CTX
*SSL_get_SSL_CTX(const SSL
*ssl
)
2572 SSL_CTX
*SSL_set_SSL_CTX(SSL
*ssl
, SSL_CTX
* ctx
)
2574 if (ssl
->ctx
== ctx
)
2576 #ifndef OPENSSL_NO_TLSEXT
2578 ctx
= ssl
->initial_ctx
;
2580 if (ssl
->cert
!= NULL
)
2581 ssl_cert_free(ssl
->cert
);
2582 ssl
->cert
= ssl_cert_dup(ctx
->cert
);
2583 CRYPTO_add(&ctx
->references
,1,CRYPTO_LOCK_SSL_CTX
);
2584 if (ssl
->ctx
!= NULL
)
2585 SSL_CTX_free(ssl
->ctx
); /* decrement reference count */
2590 #ifndef OPENSSL_NO_STDIO
2591 int SSL_CTX_set_default_verify_paths(SSL_CTX
*ctx
)
2593 return(X509_STORE_set_default_paths(ctx
->cert_store
));
2596 int SSL_CTX_load_verify_locations(SSL_CTX
*ctx
, const char *CAfile
,
2599 return(X509_STORE_load_locations(ctx
->cert_store
,CAfile
,CApath
));
2603 void SSL_set_info_callback(SSL
*ssl
,
2604 void (*cb
)(const SSL
*ssl
,int type
,int val
))
2606 ssl
->info_callback
=cb
;
2609 /* One compiler (Diab DCC) doesn't like argument names in returned
2610 function pointer. */
2611 void (*SSL_get_info_callback(const SSL
*ssl
))(const SSL
* /*ssl*/,int /*type*/,int /*val*/)
2613 return ssl
->info_callback
;
2616 int SSL_state(const SSL
*ssl
)
2621 void SSL_set_verify_result(SSL
*ssl
,long arg
)
2623 ssl
->verify_result
=arg
;
2626 long SSL_get_verify_result(const SSL
*ssl
)
2628 return(ssl
->verify_result
);
2631 int SSL_get_ex_new_index(long argl
,void *argp
,CRYPTO_EX_new
*new_func
,
2632 CRYPTO_EX_dup
*dup_func
,CRYPTO_EX_free
*free_func
)
2634 return CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_SSL
, argl
, argp
,
2635 new_func
, dup_func
, free_func
);
2638 int SSL_set_ex_data(SSL
*s
,int idx
,void *arg
)
2640 return(CRYPTO_set_ex_data(&s
->ex_data
,idx
,arg
));
2643 void *SSL_get_ex_data(const SSL
*s
,int idx
)
2645 return(CRYPTO_get_ex_data(&s
->ex_data
,idx
));
2648 int SSL_CTX_get_ex_new_index(long argl
,void *argp
,CRYPTO_EX_new
*new_func
,
2649 CRYPTO_EX_dup
*dup_func
,CRYPTO_EX_free
*free_func
)
2651 return CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_SSL_CTX
, argl
, argp
,
2652 new_func
, dup_func
, free_func
);
2655 int SSL_CTX_set_ex_data(SSL_CTX
*s
,int idx
,void *arg
)
2657 return(CRYPTO_set_ex_data(&s
->ex_data
,idx
,arg
));
2660 void *SSL_CTX_get_ex_data(const SSL_CTX
*s
,int idx
)
2662 return(CRYPTO_get_ex_data(&s
->ex_data
,idx
));
2670 X509_STORE
*SSL_CTX_get_cert_store(const SSL_CTX
*ctx
)
2672 return(ctx
->cert_store
);
2675 void SSL_CTX_set_cert_store(SSL_CTX
*ctx
,X509_STORE
*store
)
2677 if (ctx
->cert_store
!= NULL
)
2678 X509_STORE_free(ctx
->cert_store
);
2679 ctx
->cert_store
=store
;
2682 int SSL_want(const SSL
*s
)
2688 * \brief Set the callback for generating temporary RSA keys.
2689 * \param ctx the SSL context.
2690 * \param cb the callback
2693 #ifndef OPENSSL_NO_RSA
2694 void SSL_CTX_set_tmp_rsa_callback(SSL_CTX
*ctx
,RSA
*(*cb
)(SSL
*ssl
,
2698 SSL_CTX_callback_ctrl(ctx
,SSL_CTRL_SET_TMP_RSA_CB
,(void (*)(void))cb
);
2701 void SSL_set_tmp_rsa_callback(SSL
*ssl
,RSA
*(*cb
)(SSL
*ssl
,
2705 SSL_callback_ctrl(ssl
,SSL_CTRL_SET_TMP_RSA_CB
,(void (*)(void))cb
);
2711 * \brief The RSA temporary key callback function.
2712 * \param ssl the SSL session.
2713 * \param is_export \c TRUE if the temp RSA key is for an export ciphersuite.
2714 * \param keylength if \c is_export is \c TRUE, then \c keylength is the size
2715 * of the required key in bits.
2716 * \return the temporary RSA key.
2717 * \sa SSL_CTX_set_tmp_rsa_callback, SSL_set_tmp_rsa_callback
2720 RSA
*cb(SSL
*ssl
,int is_export
,int keylength
)
2725 * \brief Set the callback for generating temporary DH keys.
2726 * \param ctx the SSL context.
2727 * \param dh the callback
2730 #ifndef OPENSSL_NO_DH
2731 void SSL_CTX_set_tmp_dh_callback(SSL_CTX
*ctx
,DH
*(*dh
)(SSL
*ssl
,int is_export
,
2734 SSL_CTX_callback_ctrl(ctx
,SSL_CTRL_SET_TMP_DH_CB
,(void (*)(void))dh
);
2737 void SSL_set_tmp_dh_callback(SSL
*ssl
,DH
*(*dh
)(SSL
*ssl
,int is_export
,
2740 SSL_callback_ctrl(ssl
,SSL_CTRL_SET_TMP_DH_CB
,(void (*)(void))dh
);
2744 #ifndef OPENSSL_NO_ECDH
2745 void SSL_CTX_set_tmp_ecdh_callback(SSL_CTX
*ctx
,EC_KEY
*(*ecdh
)(SSL
*ssl
,int is_export
,
2748 SSL_CTX_callback_ctrl(ctx
,SSL_CTRL_SET_TMP_ECDH_CB
,(void (*)(void))ecdh
);
2751 void SSL_set_tmp_ecdh_callback(SSL
*ssl
,EC_KEY
*(*ecdh
)(SSL
*ssl
,int is_export
,
2754 SSL_callback_ctrl(ssl
,SSL_CTRL_SET_TMP_ECDH_CB
,(void (*)(void))ecdh
);
2758 #ifndef OPENSSL_NO_PSK
2759 int SSL_CTX_use_psk_identity_hint(SSL_CTX
*ctx
, const char *identity_hint
)
2761 if (identity_hint
!= NULL
&& strlen(identity_hint
) > PSK_MAX_IDENTITY_LEN
)
2763 SSLerr(SSL_F_SSL_CTX_USE_PSK_IDENTITY_HINT
, SSL_R_DATA_LENGTH_TOO_LONG
);
2766 if (ctx
->psk_identity_hint
!= NULL
)
2767 OPENSSL_free(ctx
->psk_identity_hint
);
2768 if (identity_hint
!= NULL
)
2770 ctx
->psk_identity_hint
= BUF_strdup(identity_hint
);
2771 if (ctx
->psk_identity_hint
== NULL
)
2775 ctx
->psk_identity_hint
= NULL
;
2779 int SSL_use_psk_identity_hint(SSL
*s
, const char *identity_hint
)
2784 if (s
->session
== NULL
)
2785 return 1; /* session not created yet, ignored */
2787 if (identity_hint
!= NULL
&& strlen(identity_hint
) > PSK_MAX_IDENTITY_LEN
)
2789 SSLerr(SSL_F_SSL_USE_PSK_IDENTITY_HINT
, SSL_R_DATA_LENGTH_TOO_LONG
);
2792 if (s
->session
->psk_identity_hint
!= NULL
)
2793 OPENSSL_free(s
->session
->psk_identity_hint
);
2794 if (identity_hint
!= NULL
)
2796 s
->session
->psk_identity_hint
= BUF_strdup(identity_hint
);
2797 if (s
->session
->psk_identity_hint
== NULL
)
2801 s
->session
->psk_identity_hint
= NULL
;
2805 const char *SSL_get_psk_identity_hint(const SSL
*s
)
2807 if (s
== NULL
|| s
->session
== NULL
)
2809 return(s
->session
->psk_identity_hint
);
2812 const char *SSL_get_psk_identity(const SSL
*s
)
2814 if (s
== NULL
|| s
->session
== NULL
)
2816 return(s
->session
->psk_identity
);
2819 void SSL_set_psk_client_callback(SSL
*s
,
2820 unsigned int (*cb
)(SSL
*ssl
, const char *hint
,
2821 char *identity
, unsigned int max_identity_len
, unsigned char *psk
,
2822 unsigned int max_psk_len
))
2824 s
->psk_client_callback
= cb
;
2827 void SSL_CTX_set_psk_client_callback(SSL_CTX
*ctx
,
2828 unsigned int (*cb
)(SSL
*ssl
, const char *hint
,
2829 char *identity
, unsigned int max_identity_len
, unsigned char *psk
,
2830 unsigned int max_psk_len
))
2832 ctx
->psk_client_callback
= cb
;
2835 void SSL_set_psk_server_callback(SSL
*s
,
2836 unsigned int (*cb
)(SSL
*ssl
, const char *identity
,
2837 unsigned char *psk
, unsigned int max_psk_len
))
2839 s
->psk_server_callback
= cb
;
2842 void SSL_CTX_set_psk_server_callback(SSL_CTX
*ctx
,
2843 unsigned int (*cb
)(SSL
*ssl
, const char *identity
,
2844 unsigned char *psk
, unsigned int max_psk_len
))
2846 ctx
->psk_server_callback
= cb
;
2850 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
))
2852 SSL_CTX_callback_ctrl(ctx
, SSL_CTRL_SET_MSG_CALLBACK
, (void (*)(void))cb
);
2854 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
))
2856 SSL_callback_ctrl(ssl
, SSL_CTRL_SET_MSG_CALLBACK
, (void (*)(void))cb
);
2859 /* Allocates new EVP_MD_CTX and sets pointer to it into given pointer
2860 * vairable, freeing EVP_MD_CTX previously stored in that variable, if
2861 * any. If EVP_MD pointer is passed, initializes ctx with this md
2862 * Returns newly allocated ctx;
2865 EVP_MD_CTX
*ssl_replace_hash(EVP_MD_CTX
**hash
,const EVP_MD
*md
)
2867 ssl_clear_hash_ctx(hash
);
2868 *hash
= EVP_MD_CTX_create();
2869 if (md
) EVP_DigestInit_ex(*hash
,md
,NULL
);
2872 void ssl_clear_hash_ctx(EVP_MD_CTX
**hash
)
2875 if (*hash
) EVP_MD_CTX_destroy(*hash
);
2879 #if defined(_WINDLL) && defined(OPENSSL_SYS_WIN16)
2880 #include "../crypto/bio/bss_file.c"
2883 IMPLEMENT_STACK_OF(SSL_CIPHER
)
2884 IMPLEMENT_STACK_OF(SSL_COMP
)