1 /* ssl/ssl.h */ 2 /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) 3 * All rights reserved. 4 * 5 * This package is an SSL implementation written 6 * by Eric Young (eay@cryptsoft.com). 7 * The implementation was written so as to conform with Netscapes SSL. 8 * 9 * This library is free for commercial and non-commercial use as long as 10 * the following conditions are aheared to. The following conditions 11 * apply to all code found in this distribution, be it the RC4, RSA, 12 * lhash, DES, etc., code; not just the SSL code. The SSL documentation 13 * included with this distribution is covered by the same copyright terms 14 * except that the holder is Tim Hudson (tjh@cryptsoft.com). 15 * 16 * Copyright remains Eric Young's, and as such any Copyright notices in 17 * the code are not to be removed. 18 * If this package is used in a product, Eric Young should be given attribution 19 * as the author of the parts of the library used. 20 * This can be in the form of a textual message at program startup or 21 * in documentation (online or textual) provided with the package. 22 * 23 * Redistribution and use in source and binary forms, with or without 24 * modification, are permitted provided that the following conditions 25 * are met: 26 * 1. Redistributions of source code must retain the copyright 27 * notice, this list of conditions and the following disclaimer. 28 * 2. Redistributions in binary form must reproduce the above copyright 29 * notice, this list of conditions and the following disclaimer in the 30 * documentation and/or other materials provided with the distribution. 31 * 3. All advertising materials mentioning features or use of this software 32 * must display the following acknowledgement: 33 * "This product includes cryptographic software written by 34 * Eric Young (eay@cryptsoft.com)" 35 * The word 'cryptographic' can be left out if the rouines from the library 36 * being used are not cryptographic related :-). 37 * 4. If you include any Windows specific code (or a derivative thereof) from 38 * the apps directory (application code) you must include an acknowledgement: 39 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)" 40 * 41 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND 42 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 43 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 44 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 45 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 46 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 47 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 48 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 49 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 50 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 51 * SUCH DAMAGE. 52 * 53 * The licence and distribution terms for any publically available version or 54 * derivative of this code cannot be changed. i.e. this code cannot simply be 55 * copied and put under another distribution licence 56 * [including the GNU Public Licence.] 57 */ 58 /* ==================================================================== 59 * Copyright (c) 1998-2007 The OpenSSL Project. All rights reserved. 60 * 61 * Redistribution and use in source and binary forms, with or without 62 * modification, are permitted provided that the following conditions 63 * are met: 64 * 65 * 1. Redistributions of source code must retain the above copyright 66 * notice, this list of conditions and the following disclaimer. 67 * 68 * 2. Redistributions in binary form must reproduce the above copyright 69 * notice, this list of conditions and the following disclaimer in 70 * the documentation and/or other materials provided with the 71 * distribution. 72 * 73 * 3. All advertising materials mentioning features or use of this 74 * software must display the following acknowledgment: 75 * "This product includes software developed by the OpenSSL Project 76 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)" 77 * 78 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to 79 * endorse or promote products derived from this software without 80 * prior written permission. For written permission, please contact 81 * openssl-core@openssl.org. 82 * 83 * 5. Products derived from this software may not be called "OpenSSL" 84 * nor may "OpenSSL" appear in their names without prior written 85 * permission of the OpenSSL Project. 86 * 87 * 6. Redistributions of any form whatsoever must retain the following 88 * acknowledgment: 89 * "This product includes software developed by the OpenSSL Project 90 * for use in the OpenSSL Toolkit (http://www.openssl.org/)" 91 * 92 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY 93 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 94 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 95 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR 96 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 97 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 98 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 99 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 100 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 101 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 102 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 103 * OF THE POSSIBILITY OF SUCH DAMAGE. 104 * ==================================================================== 105 * 106 * This product includes cryptographic software written by Eric Young 107 * (eay@cryptsoft.com). This product includes software written by Tim 108 * Hudson (tjh@cryptsoft.com). 109 * 110 */ 111 /* ==================================================================== 112 * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED. 113 * ECC cipher suite support in OpenSSL originally developed by 114 * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project. 115 */ 116 /* ==================================================================== 117 * Copyright 2005 Nokia. All rights reserved. 118 * 119 * The portions of the attached software ("Contribution") is developed by 120 * Nokia Corporation and is licensed pursuant to the OpenSSL open source 121 * license. 122 * 123 * The Contribution, originally written by Mika Kousa and Pasi Eronen of 124 * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites 125 * support (see RFC 4279) to OpenSSL. 126 * 127 * No patent licenses or other rights except those expressly stated in 128 * the OpenSSL open source license shall be deemed granted or received 129 * expressly, by implication, estoppel, or otherwise. 130 * 131 * No assurances are provided by Nokia that the Contribution does not 132 * infringe the patent or other intellectual property rights of any third 133 * party or that the license provides you with all the necessary rights 134 * to make use of the Contribution. 135 * 136 * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN 137 * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA 138 * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY 139 * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR 140 * OTHERWISE. 141 */ 142 143 #ifndef OPENSSL_HEADER_SSL_H 144 #define OPENSSL_HEADER_SSL_H 145 146 #include <openssl/base.h> 147 148 #include <openssl/bio.h> 149 #include <openssl/buf.h> 150 #include <openssl/hmac.h> 151 #include <openssl/lhash.h> 152 #include <openssl/pem.h> 153 #include <openssl/thread.h> 154 #include <openssl/x509.h> 155 156 #if !defined(OPENSSL_WINDOWS) 157 #include <sys/time.h> 158 #endif 159 160 /* wpa_supplicant expects to get the version functions from ssl.h */ 161 #include <openssl/crypto.h> 162 163 /* Forward-declare struct timeval. On Windows, it is defined in winsock2.h and 164 * Windows headers define too many macros to be included in public headers. 165 * However, only a forward declaration is needed. */ 166 struct timeval; 167 168 #if defined(__cplusplus) 169 extern "C" { 170 #endif 171 172 173 /* SSL implementation. */ 174 175 176 /* Initialization. */ 177 178 /* SSL_library_init initializes the crypto and SSL libraries and returns one. */ 179 OPENSSL_EXPORT int SSL_library_init(void); 180 181 182 /* Cipher suites. */ 183 184 /* An SSL_CIPHER represents a cipher suite. */ 185 typedef struct ssl_cipher_st { 186 /* name is the OpenSSL name for the cipher. */ 187 const char *name; 188 /* id is the cipher suite value bitwise OR-d with 0x03000000. */ 189 uint32_t id; 190 191 /* The following are internal fields. See ssl/internal.h for their values. */ 192 193 uint32_t algorithm_mkey; 194 uint32_t algorithm_auth; 195 uint32_t algorithm_enc; 196 uint32_t algorithm_mac; 197 uint32_t algorithm_ssl; 198 uint32_t algo_strength; 199 200 /* algorithm2 contains extra flags. See ssl/internal.h. */ 201 uint32_t algorithm2; 202 203 /* strength_bits is the strength of the cipher in bits. */ 204 int strength_bits; 205 /* alg_bits is the number of bits of key material used by the algorithm. */ 206 int alg_bits; 207 } SSL_CIPHER; 208 209 DECLARE_STACK_OF(SSL_CIPHER) 210 211 /* SSL_get_cipher_by_value returns the structure representing a TLS cipher 212 * suite based on its assigned number, or NULL if unknown. See 213 * https://www.iana.org/assignments/tls-parameters/tls-parameters.xhtml#tls-parameters-4. */ 214 OPENSSL_EXPORT const SSL_CIPHER *SSL_get_cipher_by_value(uint16_t value); 215 216 /* SSL_CIPHER_get_id returns |cipher|'s id. It may be cast to a |uint16_t| to 217 * get the cipher suite value. */ 218 OPENSSL_EXPORT uint32_t SSL_CIPHER_get_id(const SSL_CIPHER *cipher); 219 220 /* SSL_CIPHER_is_AES returns one if |cipher| uses AES (either GCM or CBC 221 * mode). */ 222 OPENSSL_EXPORT int SSL_CIPHER_is_AES(const SSL_CIPHER *cipher); 223 224 /* SSL_CIPHER_has_MD5_HMAC returns one if |cipher| uses HMAC-MD5. */ 225 OPENSSL_EXPORT int SSL_CIPHER_has_MD5_HMAC(const SSL_CIPHER *cipher); 226 227 /* SSL_CIPHER_is_AESGCM returns one if |cipher| uses AES-GCM. */ 228 OPENSSL_EXPORT int SSL_CIPHER_is_AESGCM(const SSL_CIPHER *cipher); 229 230 /* SSL_CIPHER_is_CHACHA20POLY1305 returns one if |cipher| uses 231 * CHACHA20_POLY1305. */ 232 OPENSSL_EXPORT int SSL_CIPHER_is_CHACHA20POLY1305(const SSL_CIPHER *cipher); 233 234 /* SSL_CIPHER_get_name returns the OpenSSL name of |cipher|. */ 235 OPENSSL_EXPORT const char *SSL_CIPHER_get_name(const SSL_CIPHER *cipher); 236 237 /* SSL_CIPHER_get_kx_name returns a string that describes the key-exchange 238 * method used by |cipher|. For example, "ECDHE_ECDSA". */ 239 OPENSSL_EXPORT const char *SSL_CIPHER_get_kx_name(const SSL_CIPHER *cipher); 240 241 /* SSL_CIPHER_get_rfc_name returns a newly-allocated string with the standard 242 * name for |cipher| or NULL on error. For example, 243 * "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256". The caller is responsible for 244 * calling |OPENSSL_free| on the result. */ 245 OPENSSL_EXPORT char *SSL_CIPHER_get_rfc_name(const SSL_CIPHER *cipher); 246 247 /* SSL_CIPHER_get_bits returns the strength, in bits, of |cipher|. If 248 * |out_alg_bits| is not NULL, it writes the number of bits consumed by the 249 * symmetric algorithm to |*out_alg_bits|. */ 250 OPENSSL_EXPORT int SSL_CIPHER_get_bits(const SSL_CIPHER *cipher, 251 int *out_alg_bits); 252 253 254 /* SSL contexts. */ 255 256 /* An SSL_METHOD selects whether to use TLS or DTLS. */ 257 typedef struct ssl_method_st SSL_METHOD; 258 259 /* TLS_method is the |SSL_METHOD| used for TLS (and SSLv3) connections. */ 260 OPENSSL_EXPORT const SSL_METHOD *TLS_method(void); 261 262 /* DTLS_method is the |SSL_METHOD| used for DTLS connections. */ 263 OPENSSL_EXPORT const SSL_METHOD *DTLS_method(void); 264 265 /* SSL_CTX_new returns a newly-allocated |SSL_CTX| with default settings or NULL 266 * on error. An |SSL_CTX| manages shared state and configuration between 267 * multiple TLS or DTLS connections. */ 268 OPENSSL_EXPORT SSL_CTX *SSL_CTX_new(const SSL_METHOD *method); 269 270 /* SSL_CTX_free releases memory associated with |ctx|. */ 271 OPENSSL_EXPORT void SSL_CTX_free(SSL_CTX *ctx); 272 273 274 /* SSL connections. */ 275 276 /* SSL_new returns a newly-allocated |SSL| using |ctx| or NULL on error. An 277 * |SSL| object represents a single TLS or DTLS connection. It inherits settings 278 * from |ctx| at the time of creation. Settings may also be individually 279 * configured on the connection. 280 * 281 * On creation, an |SSL| is not configured to be either a client or server. Call 282 * |SSL_set_connect_state| or |SSL_set_accept_state| to set this. */ 283 OPENSSL_EXPORT SSL *SSL_new(SSL_CTX *ctx); 284 285 /* SSL_free releases memory associated with |ssl|. */ 286 OPENSSL_EXPORT void SSL_free(SSL *ssl); 287 288 /* SSL_set_connect_state configures |ssl| to be a client. */ 289 OPENSSL_EXPORT void SSL_set_connect_state(SSL *ssl); 290 291 /* SSL_set_accept_state configures |ssl| to be a server. */ 292 OPENSSL_EXPORT void SSL_set_accept_state(SSL *ssl); 293 294 295 /* Protocol versions. */ 296 297 #define SSL3_VERSION_MAJOR 0x03 298 299 #define SSL3_VERSION 0x0300 300 #define TLS1_VERSION 0x0301 301 #define TLS1_1_VERSION 0x0302 302 #define TLS1_2_VERSION 0x0303 303 304 #define DTLS1_VERSION 0xfeff 305 #define DTLS1_2_VERSION 0xfefd 306 307 /* SSL_CTX_set_min_version sets the minimum protocol version for |ctx| to 308 * |version|. */ 309 OPENSSL_EXPORT void SSL_CTX_set_min_version(SSL_CTX *ctx, uint16_t version); 310 311 /* SSL_CTX_set_max_version sets the maximum protocol version for |ctx| to 312 * |version|. */ 313 OPENSSL_EXPORT void SSL_CTX_set_max_version(SSL_CTX *ctx, uint16_t version); 314 315 /* SSL_set_min_version sets the minimum protocol version for |ssl| to 316 * |version|. */ 317 OPENSSL_EXPORT void SSL_set_min_version(SSL *ssl, uint16_t version); 318 319 /* SSL_set_max_version sets the maximum protocol version for |ssl| to 320 * |version|. */ 321 OPENSSL_EXPORT void SSL_set_max_version(SSL *ssl, uint16_t version); 322 323 324 /* Options. 325 * 326 * Options configure protocol behavior. */ 327 328 /* SSL_OP_LEGACY_SERVER_CONNECT allows initial connections to servers that don't 329 * support the renegotiation_info extension (RFC 5746). It is on by default. */ 330 #define SSL_OP_LEGACY_SERVER_CONNECT 0x00000004L 331 332 /* SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER allows for record sizes |SSL3_RT_MAX_EXTRA| 333 * bytes above the maximum record size. */ 334 #define SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER 0x00000020L 335 336 /* SSL_OP_TLS_D5_BUG accepts an RSAClientKeyExchange in TLS encoded as in SSL3 337 * (i.e. without a length prefix). */ 338 #define SSL_OP_TLS_D5_BUG 0x00000100L 339 340 /* SSL_OP_ALL enables the above bug workarounds that are enabled by many 341 * consumers. 342 * TODO(davidben): Determine which of the remaining may be removed now. */ 343 #define SSL_OP_ALL 0x00000BFFL 344 345 /* SSL_OP_NO_QUERY_MTU, in DTLS, disables querying the MTU from the underlying 346 * |BIO|. Instead, the MTU is configured with |SSL_set_mtu|. */ 347 #define SSL_OP_NO_QUERY_MTU 0x00001000L 348 349 /* SSL_OP_NO_TICKET disables session ticket support (RFC 4507). */ 350 #define SSL_OP_NO_TICKET 0x00004000L 351 352 /* SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION permits unsafe legacy renegotiation 353 * without renegotiation_info (RFC 5746) support. */ 354 #define SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION 0x00040000L 355 356 /* SSL_OP_CIPHER_SERVER_PREFERENCE configures servers to select ciphers and 357 * ECDHE curves according to the server's preferences instead of the 358 * client's. */ 359 #define SSL_OP_CIPHER_SERVER_PREFERENCE 0x00400000L 360 361 /* The following flags toggle individual protocol versions. This is deprecated. 362 * Use |SSL_CTX_set_min_version| and |SSL_CTX_set_max_version| instead. */ 363 #define SSL_OP_NO_SSLv3 0x02000000L 364 #define SSL_OP_NO_TLSv1 0x04000000L 365 #define SSL_OP_NO_TLSv1_2 0x08000000L 366 #define SSL_OP_NO_TLSv1_1 0x10000000L 367 #define SSL_OP_NO_DTLSv1 SSL_OP_NO_TLSv1 368 #define SSL_OP_NO_DTLSv1_2 SSL_OP_NO_TLSv1_2 369 370 /* The following flags do nothing and are included only to make it easier to 371 * compile code with BoringSSL. */ 372 #define SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS 0 373 #define SSL_OP_MICROSOFT_SESS_ID_BUG 0 374 #define SSL_OP_NETSCAPE_CHALLENGE_BUG 0 375 #define SSL_OP_NO_COMPRESSION 0 376 #define SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION 0 377 #define SSL_OP_NO_SSLv2 0 378 #define SSL_OP_SINGLE_DH_USE 0 379 #define SSL_OP_SINGLE_ECDH_USE 0 380 #define SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG 0 381 #define SSL_OP_TLS_BLOCK_PADDING_BUG 0 382 #define SSL_OP_TLS_ROLLBACK_BUG 0 383 384 /* SSL_CTX_set_options enables all options set in |options| (which should be one 385 * or more of the |SSL_OP_*| values, ORed together) in |ctx|. It returns a 386 * bitmask representing the resulting enabled options. */ 387 OPENSSL_EXPORT uint32_t SSL_CTX_set_options(SSL_CTX *ctx, uint32_t options); 388 389 /* SSL_CTX_clear_options disables all options set in |options| (which should be 390 * one or more of the |SSL_OP_*| values, ORed together) in |ctx|. It returns a 391 * bitmask representing the resulting enabled options. */ 392 OPENSSL_EXPORT uint32_t SSL_CTX_clear_options(SSL_CTX *ctx, uint32_t options); 393 394 /* SSL_CTX_get_options returns a bitmask of |SSL_OP_*| values that represent all 395 * the options enabled for |ctx|. */ 396 OPENSSL_EXPORT uint32_t SSL_CTX_get_options(const SSL_CTX *ctx); 397 398 /* SSL_set_options enables all options set in |options| (which should be one or 399 * more of the |SSL_OP_*| values, ORed together) in |ssl|. It returns a bitmask 400 * representing the resulting enabled options. */ 401 OPENSSL_EXPORT uint32_t SSL_set_options(SSL *ssl, uint32_t options); 402 403 /* SSL_clear_options disables all options set in |options| (which should be one 404 * or more of the |SSL_OP_*| values, ORed together) in |ssl|. It returns a 405 * bitmask representing the resulting enabled options. */ 406 OPENSSL_EXPORT uint32_t SSL_clear_options(SSL *ssl, uint32_t options); 407 408 /* SSL_get_options returns a bitmask of |SSL_OP_*| values that represent all the 409 * options enabled for |ssl|. */ 410 OPENSSL_EXPORT uint32_t SSL_get_options(const SSL *ssl); 411 412 413 /* Modes. 414 * 415 * Modes configure API behavior. */ 416 417 /* SSL_MODE_ENABLE_PARTIAL_WRITE allows |SSL_write| to complete with a partial 418 * result when the only part of the input was written in a single record. */ 419 #define SSL_MODE_ENABLE_PARTIAL_WRITE 0x00000001L 420 421 /* SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER allows retrying an incomplete |SSL_write| 422 * with a different buffer. However, |SSL_write| still assumes the buffer 423 * contents are unchanged. This is not the default to avoid the misconception 424 * that non-blocking |SSL_write| behaves like non-blocking |write|. */ 425 #define SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER 0x00000002L 426 427 /* SSL_MODE_NO_AUTO_CHAIN disables automatically building a certificate chain 428 * before sending certificates to the peer. 429 * TODO(davidben): Remove this behavior. https://crbug.com/486295. */ 430 #define SSL_MODE_NO_AUTO_CHAIN 0x00000008L 431 432 /* SSL_MODE_ENABLE_FALSE_START allows clients to send application data before 433 * receipt of CCS and Finished. This mode enables full-handshakes to 'complete' 434 * in one RTT. See draft-bmoeller-tls-falsestart-01. */ 435 #define SSL_MODE_ENABLE_FALSE_START 0x00000080L 436 437 /* Deprecated: SSL_MODE_HANDSHAKE_CUTTHROUGH is the same as 438 * SSL_MODE_ENABLE_FALSE_START. */ 439 #define SSL_MODE_HANDSHAKE_CUTTHROUGH SSL_MODE_ENABLE_FALSE_START 440 441 /* SSL_MODE_CBC_RECORD_SPLITTING causes multi-byte CBC records in SSL 3.0 and 442 * TLS 1.0 to be split in two: the first record will contain a single byte and 443 * the second will contain the remainder. This effectively randomises the IV and 444 * prevents BEAST attacks. */ 445 #define SSL_MODE_CBC_RECORD_SPLITTING 0x00000100L 446 447 /* SSL_MODE_NO_SESSION_CREATION will cause any attempts to create a session to 448 * fail with SSL_R_SESSION_MAY_NOT_BE_CREATED. This can be used to enforce that 449 * session resumption is used for a given SSL*. */ 450 #define SSL_MODE_NO_SESSION_CREATION 0x00000200L 451 452 /* SSL_MODE_SEND_FALLBACK_SCSV sends TLS_FALLBACK_SCSV in the ClientHello. 453 * To be set only by applications that reconnect with a downgraded protocol 454 * version; see https://tools.ietf.org/html/draft-ietf-tls-downgrade-scsv-05 455 * for details. 456 * 457 * DO NOT ENABLE THIS if your application attempts a normal handshake. Only use 458 * this in explicit fallback retries, following the guidance in 459 * draft-ietf-tls-downgrade-scsv-05. */ 460 #define SSL_MODE_SEND_FALLBACK_SCSV 0x00000400L 461 462 /* The following flags do nothing and are included only to make it easier to 463 * compile code with BoringSSL. */ 464 #define SSL_MODE_AUTO_RETRY 0 465 #define SSL_MODE_RELEASE_BUFFERS 0 466 #define SSL_MODE_SEND_CLIENTHELLO_TIME 0 467 #define SSL_MODE_SEND_SERVERHELLO_TIME 0 468 469 /* SSL_CTX_set_mode enables all modes set in |mode| (which should be one or more 470 * of the |SSL_MODE_*| values, ORed together) in |ctx|. It returns a bitmask 471 * representing the resulting enabled modes. */ 472 OPENSSL_EXPORT uint32_t SSL_CTX_set_mode(SSL_CTX *ctx, uint32_t mode); 473 474 /* SSL_CTX_clear_mode disables all modes set in |mode| (which should be one or 475 * more of the |SSL_MODE_*| values, ORed together) in |ctx|. It returns a 476 * bitmask representing the resulting enabled modes. */ 477 OPENSSL_EXPORT uint32_t SSL_CTX_clear_mode(SSL_CTX *ctx, uint32_t mode); 478 479 /* SSL_CTX_get_mode returns a bitmask of |SSL_MODE_*| values that represent all 480 * the modes enabled for |ssl|. */ 481 OPENSSL_EXPORT uint32_t SSL_CTX_get_mode(const SSL_CTX *ctx); 482 483 /* SSL_set_mode enables all modes set in |mode| (which should be one or more of 484 * the |SSL_MODE_*| values, ORed together) in |ssl|. It returns a bitmask 485 * representing the resulting enabled modes. */ 486 OPENSSL_EXPORT uint32_t SSL_set_mode(SSL *ssl, uint32_t mode); 487 488 /* SSL_clear_mode disables all modes set in |mode| (which should be one or more 489 * of the |SSL_MODE_*| values, ORed together) in |ssl|. It returns a bitmask 490 * representing the resulting enabled modes. */ 491 OPENSSL_EXPORT uint32_t SSL_clear_mode(SSL *ssl, uint32_t mode); 492 493 /* SSL_get_mode returns a bitmask of |SSL_MODE_*| values that represent all the 494 * modes enabled for |ssl|. */ 495 OPENSSL_EXPORT uint32_t SSL_get_mode(const SSL *ssl); 496 497 498 /* Connection information. */ 499 500 /* SSL_get_tls_unique writes at most |max_out| bytes of the tls-unique value 501 * for |ssl| to |out| and sets |*out_len| to the number of bytes written. It 502 * returns one on success or zero on error. In general |max_out| should be at 503 * least 12. 504 * 505 * This function will always fail if the initial handshake has not completed. 506 * The tls-unique value will change after a renegotiation but, since 507 * renegotiations can be initiated by the server at any point, the higher-level 508 * protocol must either leave them disabled or define states in which the 509 * tls-unique value can be read. 510 * 511 * The tls-unique value is defined by 512 * https://tools.ietf.org/html/rfc5929#section-3.1. Due to a weakness in the 513 * TLS protocol, tls-unique is broken for resumed connections unless the 514 * Extended Master Secret extension is negotiated. Thus this function will 515 * return zero if |ssl| performed session resumption unless EMS was used when 516 * negotiating the original session. */ 517 OPENSSL_EXPORT int SSL_get_tls_unique(const SSL *ssl, uint8_t *out, 518 size_t *out_len, size_t max_out); 519 520 521 /* Underdocumented functions. 522 * 523 * Functions below here haven't been touched up and may be underdocumented. */ 524 525 /* SSLeay version number for ASN.1 encoding of the session information */ 526 /* Version 0 - initial version 527 * Version 1 - added the optional peer certificate. */ 528 #define SSL_SESSION_ASN1_VERSION 0x0001 529 530 #define SSL_MAX_SSL_SESSION_ID_LENGTH 32 531 #define SSL_MAX_SID_CTX_LENGTH 32 532 #define SSL_MAX_MASTER_KEY_LENGTH 48 533 534 /* These are used to specify which ciphers to use and not to use */ 535 536 #define SSL_TXT_MEDIUM "MEDIUM" 537 #define SSL_TXT_HIGH "HIGH" 538 #define SSL_TXT_FIPS "FIPS" 539 540 #define SSL_TXT_kRSA "kRSA" 541 #define SSL_TXT_kDHE "kDHE" 542 #define SSL_TXT_kEDH "kEDH" /* same as "kDHE" */ 543 #define SSL_TXT_kECDHE "kECDHE" 544 #define SSL_TXT_kEECDH "kEECDH" /* same as "kECDHE" */ 545 #define SSL_TXT_kPSK "kPSK" 546 547 #define SSL_TXT_aRSA "aRSA" 548 #define SSL_TXT_aECDSA "aECDSA" 549 #define SSL_TXT_aPSK "aPSK" 550 551 #define SSL_TXT_DH "DH" 552 #define SSL_TXT_DHE "DHE" /* same as "kDHE" */ 553 #define SSL_TXT_EDH "EDH" /* same as "DHE" */ 554 #define SSL_TXT_RSA "RSA" 555 #define SSL_TXT_ECDH "ECDH" 556 #define SSL_TXT_ECDHE "ECDHE" /* same as "kECDHE" */ 557 #define SSL_TXT_EECDH "EECDH" /* same as "ECDHE" */ 558 #define SSL_TXT_ECDSA "ECDSA" 559 #define SSL_TXT_PSK "PSK" 560 561 #define SSL_TXT_3DES "3DES" 562 #define SSL_TXT_RC4 "RC4" 563 #define SSL_TXT_AES128 "AES128" 564 #define SSL_TXT_AES256 "AES256" 565 #define SSL_TXT_AES "AES" 566 #define SSL_TXT_AES_GCM "AESGCM" 567 #define SSL_TXT_CHACHA20 "CHACHA20" 568 569 #define SSL_TXT_MD5 "MD5" 570 #define SSL_TXT_SHA1 "SHA1" 571 #define SSL_TXT_SHA "SHA" /* same as "SHA1" */ 572 #define SSL_TXT_SHA256 "SHA256" 573 #define SSL_TXT_SHA384 "SHA384" 574 575 #define SSL_TXT_SSLV3 "SSLv3" 576 #define SSL_TXT_TLSV1 "TLSv1" 577 #define SSL_TXT_TLSV1_1 "TLSv1.1" 578 #define SSL_TXT_TLSV1_2 "TLSv1.2" 579 580 #define SSL_TXT_ALL "ALL" 581 582 /* COMPLEMENTOF* definitions. These identifiers are used to (de-select) ciphers 583 * normally not being used. 584 * 585 * Example: "RC4" will activate all ciphers using RC4 including ciphers without 586 * authentication, which would normally disabled by DEFAULT (due the "!ADH" 587 * being part of default). Therefore "RC4:!COMPLEMENTOFDEFAULT" will make sure 588 * that it is also disabled in the specific selection. COMPLEMENTOF* 589 * identifiers are portable between version, as adjustments to the default 590 * cipher setup will also be included here. 591 * 592 * COMPLEMENTOFDEFAULT does not experience the same special treatment that 593 * DEFAULT gets, as only selection is being done and no sorting as needed for 594 * DEFAULT. */ 595 #define SSL_TXT_CMPDEF "COMPLEMENTOFDEFAULT" 596 597 /* The following cipher list is used by default. It also is substituted when an 598 * application-defined cipher list string starts with 'DEFAULT'. */ 599 #define SSL_DEFAULT_CIPHER_LIST "ALL" 600 601 /* As of OpenSSL 1.0.0, ssl_create_cipher_list() in ssl/ssl_ciph.c always 602 * starts with a reasonable order, and all we have to do for DEFAULT is 603 * throwing out anonymous and unencrypted ciphersuites! (The latter are not 604 * actually enabled by ALL, but "ALL:RSA" would enable some of them.) */ 605 606 /* Used in SSL_set_shutdown()/SSL_get_shutdown(); */ 607 #define SSL_SENT_SHUTDOWN 1 608 #define SSL_RECEIVED_SHUTDOWN 2 609 610 #define SSL_FILETYPE_ASN1 X509_FILETYPE_ASN1 611 #define SSL_FILETYPE_PEM X509_FILETYPE_PEM 612 613 typedef struct ssl_protocol_method_st SSL_PROTOCOL_METHOD; 614 typedef struct ssl_session_st SSL_SESSION; 615 typedef struct tls_sigalgs_st TLS_SIGALGS; 616 typedef struct ssl_conf_ctx_st SSL_CONF_CTX; 617 typedef struct ssl3_enc_method SSL3_ENC_METHOD; 618 619 /* SRTP protection profiles for use with the use_srtp extension (RFC 5764). */ 620 typedef struct srtp_protection_profile_st { 621 const char *name; 622 unsigned long id; 623 } SRTP_PROTECTION_PROFILE; 624 625 DECLARE_STACK_OF(SRTP_PROTECTION_PROFILE) 626 627 /* An SSL_SESSION represents an SSL session that may be resumed in an 628 * abbreviated handshake. */ 629 struct ssl_session_st { 630 int ssl_version; /* what ssl version session info is being kept in here? */ 631 632 int master_key_length; 633 uint8_t master_key[SSL_MAX_MASTER_KEY_LENGTH]; 634 /* session_id - valid? */ 635 unsigned int session_id_length; 636 uint8_t session_id[SSL_MAX_SSL_SESSION_ID_LENGTH]; 637 /* this is used to determine whether the session is being reused in 638 * the appropriate context. It is up to the application to set this, 639 * via SSL_new */ 640 unsigned int sid_ctx_length; 641 uint8_t sid_ctx[SSL_MAX_SID_CTX_LENGTH]; 642 643 char *psk_identity; 644 /* Used to indicate that session resumption is not allowed. Applications can 645 * also set this bit for a new session via not_resumable_session_cb to 646 * disable session caching and tickets. */ 647 int not_resumable; 648 649 /* The cert is the certificate used to establish this connection */ 650 struct sess_cert_st /* SESS_CERT */ *sess_cert; 651 652 /* This is the cert for the other end. On clients, it will be the same as 653 * sess_cert->peer_key->x509 (the latter is not enough as sess_cert is not 654 * retained in the external representation of sessions, see ssl_asn1.c). */ 655 X509 *peer; 656 /* when app_verify_callback accepts a session where the peer's certificate is 657 * not ok, we must remember the error for session reuse: */ 658 long verify_result; /* only for servers */ 659 660 CRYPTO_refcount_t references; 661 long timeout; 662 long time; 663 664 const SSL_CIPHER *cipher; 665 666 CRYPTO_EX_DATA ex_data; /* application specific data */ 667 668 /* These are used to make removal of session-ids more efficient and to 669 * implement a maximum cache size. */ 670 SSL_SESSION *prev, *next; 671 char *tlsext_hostname; 672 /* RFC4507 info */ 673 uint8_t *tlsext_tick; /* Session ticket */ 674 size_t tlsext_ticklen; /* Session ticket length */ 675 uint32_t tlsext_tick_lifetime_hint; /* Session lifetime hint in seconds */ 676 677 size_t tlsext_signed_cert_timestamp_list_length; 678 uint8_t *tlsext_signed_cert_timestamp_list; /* Server's list. */ 679 680 /* The OCSP response that came with the session. */ 681 size_t ocsp_response_length; 682 uint8_t *ocsp_response; 683 684 char peer_sha256_valid; /* Non-zero if peer_sha256 is valid */ 685 uint8_t 686 peer_sha256[SHA256_DIGEST_LENGTH]; /* SHA256 of peer certificate */ 687 688 /* original_handshake_hash contains the handshake hash (either SHA-1+MD5 or 689 * SHA-2, depending on TLS version) for the original, full handshake that 690 * created a session. This is used by Channel IDs during resumption. */ 691 uint8_t original_handshake_hash[EVP_MAX_MD_SIZE]; 692 unsigned int original_handshake_hash_len; 693 694 /* extended_master_secret is true if the master secret in this session was 695 * generated using EMS and thus isn't vulnerable to the Triple Handshake 696 * attack. */ 697 char extended_master_secret; 698 }; 699 700 701 /* Cert related flags */ 702 /* Many implementations ignore some aspects of the TLS standards such as 703 * enforcing certifcate chain algorithms. When this is set we enforce them. */ 704 #define SSL_CERT_FLAG_TLS_STRICT 0x00000001L 705 706 /* Flags for building certificate chains */ 707 /* Treat any existing certificates as untrusted CAs */ 708 #define SSL_BUILD_CHAIN_FLAG_UNTRUSTED 0x1 709 /* Don't include root CA in chain */ 710 #define SSL_BUILD_CHAIN_FLAG_NO_ROOT 0x2 711 /* Just check certificates already there */ 712 #define SSL_BUILD_CHAIN_FLAG_CHECK 0x4 713 /* Ignore verification errors */ 714 #define SSL_BUILD_CHAIN_FLAG_IGNORE_ERROR 0x8 715 /* Clear verification errors from queue */ 716 #define SSL_BUILD_CHAIN_FLAG_CLEAR_ERROR 0x10 717 718 /* SSL_set_mtu sets the |ssl|'s MTU in DTLS to |mtu|. It returns one on success 719 * and zero on failure. */ 720 OPENSSL_EXPORT int SSL_set_mtu(SSL *ssl, unsigned mtu); 721 722 /* SSL_get_secure_renegotiation_support returns one if the peer supports secure 723 * renegotiation (RFC 5746) and zero otherwise. */ 724 OPENSSL_EXPORT int SSL_get_secure_renegotiation_support(const SSL *ssl); 725 726 /* SSL_CTX_set_msg_callback installs |cb| as the message callback for |ctx|. 727 * This callback will be called when sending or receiving low-level record 728 * headers, complete handshake messages, ChangeCipherSpec, and alerts. 729 * |write_p| is one for outgoing messages and zero for incoming messages. 730 * 731 * For each record header, |cb| is called with |version| = 0 and |content_type| 732 * = |SSL3_RT_HEADER|. The |len| bytes from |buf| contain the header. Note that 733 * this does not include the record body. If the record is sealed, the length 734 * in the header is the length of the ciphertext. 735 * 736 * For each handshake message, ChangeCipherSpec, and alert, |version| is the 737 * protocol version and |content_type| is the corresponding record type. The 738 * |len| bytes from |buf| contain the handshake message, one-byte 739 * ChangeCipherSpec body, and two-byte alert, respectively. */ 740 OPENSSL_EXPORT void SSL_CTX_set_msg_callback( 741 SSL_CTX *ctx, void (*cb)(int write_p, int version, int content_type, 742 const void *buf, size_t len, SSL *ssl, void *arg)); 743 744 /* SSL_CTX_set_msg_callback_arg sets the |arg| parameter of the message 745 * callback. */ 746 OPENSSL_EXPORT void SSL_CTX_set_msg_callback_arg(SSL_CTX *ctx, void *arg); 747 748 /* SSL_set_msg_callback installs |cb| as the message callback of |ssl|. See 749 * |SSL_CTX_set_msg_callback| for when this callback is called. */ 750 OPENSSL_EXPORT void SSL_set_msg_callback( 751 SSL *ssl, void (*cb)(int write_p, int version, int content_type, 752 const void *buf, size_t len, SSL *ssl, void *arg)); 753 754 /* SSL_set_msg_callback_arg sets the |arg| parameter of the message callback. */ 755 OPENSSL_EXPORT void SSL_set_msg_callback_arg(SSL *ssl, void *arg); 756 757 /* SSL_CTX_set_keylog_bio sets configures all SSL objects attached to |ctx| to 758 * log session material to |keylog_bio|. This is intended for debugging use 759 * with tools like Wireshark. |ctx| takes ownership of |keylog_bio|. 760 * 761 * The format is described in 762 * https://developer.mozilla.org/en-US/docs/Mozilla/Projects/NSS/Key_Log_Format. */ 763 OPENSSL_EXPORT void SSL_CTX_set_keylog_bio(SSL_CTX *ctx, BIO *keylog_bio); 764 765 766 struct ssl_aead_ctx_st; 767 typedef struct ssl_aead_ctx_st SSL_AEAD_CTX; 768 769 #define SSL_MAX_CERT_LIST_DEFAULT 1024 * 100 /* 100k max cert list */ 770 771 #define SSL_SESSION_CACHE_MAX_SIZE_DEFAULT (1024 * 20) 772 773 #define SSL_DEFAULT_SESSION_TIMEOUT (2 * 60 * 60) 774 775 /* This callback type is used inside SSL_CTX, SSL, and in the functions that 776 * set them. It is used to override the generation of SSL/TLS session IDs in a 777 * server. Return value should be zero on an error, non-zero to proceed. Also, 778 * callbacks should themselves check if the id they generate is unique 779 * otherwise the SSL handshake will fail with an error - callbacks can do this 780 * using the 'ssl' value they're passed by; 781 * SSL_has_matching_session_id(ssl, id, *id_len) 782 * The length value passed in is set at the maximum size the session ID can be. 783 * In SSLv2 this is 16 bytes, whereas SSLv3/TLSv1 it is 32 bytes. The callback 784 * can alter this length to be less if desired, but under SSLv2 session IDs are 785 * supposed to be fixed at 16 bytes so the id will be padded after the callback 786 * returns in this case. It is also an error for the callback to set the size 787 * to zero. */ 788 typedef int (*GEN_SESSION_CB)(const SSL *ssl, uint8_t *id, 789 unsigned int *id_len); 790 791 /* ssl_early_callback_ctx is passed to certain callbacks that are called very 792 * early on during the server handshake. At this point, much of the SSL* hasn't 793 * been filled out and only the ClientHello can be depended on. */ 794 struct ssl_early_callback_ctx { 795 SSL *ssl; 796 const uint8_t *client_hello; 797 size_t client_hello_len; 798 const uint8_t *session_id; 799 size_t session_id_len; 800 const uint8_t *cipher_suites; 801 size_t cipher_suites_len; 802 const uint8_t *compression_methods; 803 size_t compression_methods_len; 804 const uint8_t *extensions; 805 size_t extensions_len; 806 }; 807 808 /* SSL_early_callback_ctx_extension_get searches the extensions in |ctx| for an 809 * extension of the given type. If not found, it returns zero. Otherwise it 810 * sets |out_data| to point to the extension contents (not including the type 811 * and length bytes), sets |out_len| to the length of the extension contents 812 * and returns one. */ 813 OPENSSL_EXPORT char SSL_early_callback_ctx_extension_get( 814 const struct ssl_early_callback_ctx *ctx, uint16_t extension_type, 815 const uint8_t **out_data, size_t *out_len); 816 817 typedef struct ssl_comp_st SSL_COMP; 818 819 struct ssl_comp_st { 820 int id; 821 const char *name; 822 char *method; 823 }; 824 825 DECLARE_STACK_OF(SSL_COMP) 826 DECLARE_LHASH_OF(SSL_SESSION) 827 828 /* ssl_cipher_preference_list_st contains a list of SSL_CIPHERs with 829 * equal-preference groups. For TLS clients, the groups are moot because the 830 * server picks the cipher and groups cannot be expressed on the wire. However, 831 * for servers, the equal-preference groups allow the client's preferences to 832 * be partially respected. (This only has an effect with 833 * SSL_OP_CIPHER_SERVER_PREFERENCE). 834 * 835 * The equal-preference groups are expressed by grouping SSL_CIPHERs together. 836 * All elements of a group have the same priority: no ordering is expressed 837 * within a group. 838 * 839 * The values in |ciphers| are in one-to-one correspondence with 840 * |in_group_flags|. (That is, sk_SSL_CIPHER_num(ciphers) is the number of 841 * bytes in |in_group_flags|.) The bytes in |in_group_flags| are either 1, to 842 * indicate that the corresponding SSL_CIPHER is not the last element of a 843 * group, or 0 to indicate that it is. 844 * 845 * For example, if |in_group_flags| contains all zeros then that indicates a 846 * traditional, fully-ordered preference. Every SSL_CIPHER is the last element 847 * of the group (i.e. they are all in a one-element group). 848 * 849 * For a more complex example, consider: 850 * ciphers: A B C D E F 851 * in_group_flags: 1 1 0 0 1 0 852 * 853 * That would express the following, order: 854 * 855 * A E 856 * B -> D -> F 857 * C 858 */ 859 struct ssl_cipher_preference_list_st { 860 STACK_OF(SSL_CIPHER) *ciphers; 861 uint8_t *in_group_flags; 862 }; 863 864 struct ssl_ctx_st { 865 const SSL_PROTOCOL_METHOD *method; 866 867 /* lock is used to protect various operations on this object. */ 868 CRYPTO_MUTEX lock; 869 870 /* max_version is the maximum acceptable protocol version. If zero, the 871 * maximum supported version, currently (D)TLS 1.2, is used. */ 872 uint16_t max_version; 873 874 /* min_version is the minimum acceptable protocl version. If zero, the 875 * minimum supported version, currently SSL 3.0 and DTLS 1.0, is used */ 876 uint16_t min_version; 877 878 struct ssl_cipher_preference_list_st *cipher_list; 879 /* same as above but sorted for lookup */ 880 STACK_OF(SSL_CIPHER) *cipher_list_by_id; 881 /* cipher_list_tls11 is the list of ciphers when TLS 1.1 or greater is in 882 * use. This only applies to server connections as, for clients, the version 883 * number is known at connect time and so the cipher list can be set then. */ 884 struct ssl_cipher_preference_list_st *cipher_list_tls11; 885 886 X509_STORE *cert_store; 887 LHASH_OF(SSL_SESSION) *sessions; 888 /* Most session-ids that will be cached, default is 889 * SSL_SESSION_CACHE_MAX_SIZE_DEFAULT. 0 is unlimited. */ 890 unsigned long session_cache_size; 891 SSL_SESSION *session_cache_head; 892 SSL_SESSION *session_cache_tail; 893 894 /* handshakes_since_cache_flush is the number of successful handshakes since 895 * the last cache flush. */ 896 int handshakes_since_cache_flush; 897 898 /* This can have one of 2 values, ored together, 899 * SSL_SESS_CACHE_CLIENT, 900 * SSL_SESS_CACHE_SERVER, 901 * Default is SSL_SESSION_CACHE_SERVER, which means only 902 * SSL_accept which cache SSL_SESSIONS. */ 903 int session_cache_mode; 904 905 /* If timeout is not 0, it is the default timeout value set when SSL_new() is 906 * called. This has been put in to make life easier to set things up */ 907 long session_timeout; 908 909 /* If this callback is not null, it will be called each time a session id is 910 * added to the cache. If this function returns 1, it means that the 911 * callback will do a SSL_SESSION_free() when it has finished using it. 912 * Otherwise, on 0, it means the callback has finished with it. If 913 * remove_session_cb is not null, it will be called when a session-id is 914 * removed from the cache. After the call, OpenSSL will SSL_SESSION_free() 915 * it. */ 916 int (*new_session_cb)(SSL *ssl, SSL_SESSION *sess); 917 void (*remove_session_cb)(SSL_CTX *ctx, SSL_SESSION *sess); 918 SSL_SESSION *(*get_session_cb)(SSL *ssl, uint8_t *data, int len, 919 int *copy); 920 921 CRYPTO_refcount_t references; 922 923 /* if defined, these override the X509_verify_cert() calls */ 924 int (*app_verify_callback)(X509_STORE_CTX *, void *); 925 void *app_verify_arg; 926 /* before OpenSSL 0.9.7, 'app_verify_arg' was ignored ('app_verify_callback' 927 * was called with just one argument) */ 928 929 /* Default password callback. */ 930 pem_password_cb *default_passwd_callback; 931 932 /* Default password callback user data. */ 933 void *default_passwd_callback_userdata; 934 935 /* get client cert callback */ 936 int (*client_cert_cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey); 937 938 /* get channel id callback */ 939 void (*channel_id_cb)(SSL *ssl, EVP_PKEY **pkey); 940 941 CRYPTO_EX_DATA ex_data; 942 943 STACK_OF(X509) *extra_certs; 944 945 946 /* Default values used when no per-SSL value is defined follow */ 947 948 void (*info_callback)(const SSL *ssl, int type, 949 int val); /* used if SSL's info_callback is NULL */ 950 951 /* what we put in client cert requests */ 952 STACK_OF(X509_NAME) *client_CA; 953 954 955 /* Default values to use in SSL structures follow (these are copied by 956 * SSL_new) */ 957 958 uint32_t options; 959 uint32_t mode; 960 uint32_t max_cert_list; 961 962 struct cert_st /* CERT */ *cert; 963 964 /* callback that allows applications to peek at protocol messages */ 965 void (*msg_callback)(int write_p, int version, int content_type, 966 const void *buf, size_t len, SSL *ssl, void *arg); 967 void *msg_callback_arg; 968 969 int verify_mode; 970 unsigned int sid_ctx_length; 971 uint8_t sid_ctx[SSL_MAX_SID_CTX_LENGTH]; 972 int (*default_verify_callback)( 973 int ok, X509_STORE_CTX *ctx); /* called 'verify_callback' in the SSL */ 974 975 /* Default generate session ID callback. */ 976 GEN_SESSION_CB generate_session_id; 977 978 X509_VERIFY_PARAM *param; 979 980 /* select_certificate_cb is called before most ClientHello processing and 981 * before the decision whether to resume a session is made. It may return one 982 * to continue the handshake or zero to cause the handshake loop to return 983 * with an error and cause SSL_get_error to return 984 * SSL_ERROR_PENDING_CERTIFICATE. Note: when the handshake loop is resumed, it 985 * will not call the callback a second time. */ 986 int (*select_certificate_cb)(const struct ssl_early_callback_ctx *); 987 988 /* dos_protection_cb is called once the resumption decision for a ClientHello 989 * has been made. It returns one to continue the handshake or zero to 990 * abort. */ 991 int (*dos_protection_cb) (const struct ssl_early_callback_ctx *); 992 993 /* quiet_shutdown is true if the connection should not send a close_notify on 994 * shutdown. */ 995 int quiet_shutdown; 996 997 /* Maximum amount of data to send in one fragment. actual record size can be 998 * more than this due to padding and MAC overheads. */ 999 uint16_t max_send_fragment; 1000 1001 /* TLS extensions servername callback */ 1002 int (*tlsext_servername_callback)(SSL *, int *, void *); 1003 void *tlsext_servername_arg; 1004 /* RFC 4507 session ticket keys */ 1005 uint8_t tlsext_tick_key_name[16]; 1006 uint8_t tlsext_tick_hmac_key[16]; 1007 uint8_t tlsext_tick_aes_key[16]; 1008 /* Callback to support customisation of ticket key setting */ 1009 int (*tlsext_ticket_key_cb)(SSL *ssl, uint8_t *name, uint8_t *iv, 1010 EVP_CIPHER_CTX *ectx, HMAC_CTX *hctx, int enc); 1011 1012 /* Server-only: psk_identity_hint is the default identity hint to send in 1013 * PSK-based key exchanges. */ 1014 char *psk_identity_hint; 1015 1016 unsigned int (*psk_client_callback)(SSL *ssl, const char *hint, 1017 char *identity, 1018 unsigned int max_identity_len, 1019 uint8_t *psk, unsigned int max_psk_len); 1020 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity, 1021 uint8_t *psk, unsigned int max_psk_len); 1022 1023 1024 /* retain_only_sha256_of_client_certs is true if we should compute the SHA256 1025 * hash of the peer's certifiate and then discard it to save memory and 1026 * session space. Only effective on the server side. */ 1027 char retain_only_sha256_of_client_certs; 1028 1029 /* Next protocol negotiation information */ 1030 /* (for experimental NPN extension). */ 1031 1032 /* For a server, this contains a callback function by which the set of 1033 * advertised protocols can be provided. */ 1034 int (*next_protos_advertised_cb)(SSL *s, const uint8_t **buf, 1035 unsigned int *len, void *arg); 1036 void *next_protos_advertised_cb_arg; 1037 /* For a client, this contains a callback function that selects the 1038 * next protocol from the list provided by the server. */ 1039 int (*next_proto_select_cb)(SSL *s, uint8_t **out, uint8_t *outlen, 1040 const uint8_t *in, unsigned int inlen, void *arg); 1041 void *next_proto_select_cb_arg; 1042 1043 /* ALPN information 1044 * (we are in the process of transitioning from NPN to ALPN.) */ 1045 1046 /* For a server, this contains a callback function that allows the 1047 * server to select the protocol for the connection. 1048 * out: on successful return, this must point to the raw protocol 1049 * name (without the length prefix). 1050 * outlen: on successful return, this contains the length of |*out|. 1051 * in: points to the client's list of supported protocols in 1052 * wire-format. 1053 * inlen: the length of |in|. */ 1054 int (*alpn_select_cb)(SSL *s, const uint8_t **out, uint8_t *outlen, 1055 const uint8_t *in, unsigned int inlen, void *arg); 1056 void *alpn_select_cb_arg; 1057 1058 /* For a client, this contains the list of supported protocols in wire 1059 * format. */ 1060 uint8_t *alpn_client_proto_list; 1061 unsigned alpn_client_proto_list_len; 1062 1063 /* SRTP profiles we are willing to do from RFC 5764 */ 1064 STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles; 1065 1066 /* EC extension values inherited by SSL structure */ 1067 size_t tlsext_ecpointformatlist_length; 1068 uint8_t *tlsext_ecpointformatlist; 1069 size_t tlsext_ellipticcurvelist_length; 1070 uint16_t *tlsext_ellipticcurvelist; 1071 1072 /* If true, a client will advertise the Channel ID extension and a server 1073 * will echo it. */ 1074 char tlsext_channel_id_enabled; 1075 /* tlsext_channel_id_enabled_new is a hack to support both old and new 1076 * ChannelID signatures. It indicates that a client should advertise the new 1077 * ChannelID extension number. */ 1078 char tlsext_channel_id_enabled_new; 1079 /* The client's Channel ID private key. */ 1080 EVP_PKEY *tlsext_channel_id_private; 1081 1082 /* If true, a client will request certificate timestamps. */ 1083 char signed_cert_timestamps_enabled; 1084 1085 /* If true, a client will request a stapled OCSP response. */ 1086 char ocsp_stapling_enabled; 1087 1088 /* If not NULL, session key material will be logged to this BIO for debugging 1089 * purposes. The format matches NSS's and is readable by Wireshark. */ 1090 BIO *keylog_bio; 1091 1092 /* current_time_cb, if not NULL, is the function to use to get the current 1093 * time. It sets |*out_clock| to the current time. */ 1094 void (*current_time_cb)(const SSL *ssl, struct timeval *out_clock); 1095 }; 1096 1097 OPENSSL_EXPORT LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx); 1098 1099 /* SSL_CTX_sess_number returns the number of sessions in |ctx|'s internal 1100 * session cache. */ 1101 OPENSSL_EXPORT size_t SSL_CTX_sess_number(const SSL_CTX *ctx); 1102 1103 OPENSSL_EXPORT void SSL_CTX_sess_set_new_cb( 1104 SSL_CTX *ctx, int (*new_session_cb)(SSL *ssl, SSL_SESSION *sess)); 1105 OPENSSL_EXPORT int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx))(SSL *ssl, 1106 SSL_SESSION *sess); 1107 OPENSSL_EXPORT void SSL_CTX_sess_set_remove_cb( 1108 SSL_CTX *ctx, 1109 void (*remove_session_cb)(SSL_CTX *ctx, SSL_SESSION *sess)); 1110 OPENSSL_EXPORT void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx))( 1111 SSL_CTX *ctx, SSL_SESSION *sess); 1112 OPENSSL_EXPORT void SSL_CTX_sess_set_get_cb( 1113 SSL_CTX *ctx, 1114 SSL_SESSION *(*get_session_cb)(SSL *ssl, uint8_t *data, int len, 1115 int *copy)); 1116 OPENSSL_EXPORT SSL_SESSION *(*SSL_CTX_sess_get_get_cb(SSL_CTX *ctx))( 1117 SSL *ssl, uint8_t *data, int len, int *copy); 1118 /* SSL_magic_pending_session_ptr returns a magic SSL_SESSION* which indicates 1119 * that the session isn't currently unavailable. SSL_get_error will then return 1120 * SSL_ERROR_PENDING_SESSION and the handshake can be retried later when the 1121 * lookup has completed. */ 1122 OPENSSL_EXPORT SSL_SESSION *SSL_magic_pending_session_ptr(void); 1123 OPENSSL_EXPORT void SSL_CTX_set_info_callback(SSL_CTX *ctx, 1124 void (*cb)(const SSL *ssl, 1125 int type, int val)); 1126 OPENSSL_EXPORT void (*SSL_CTX_get_info_callback(SSL_CTX *ctx))(const SSL *ssl, 1127 int type, 1128 int val); 1129 OPENSSL_EXPORT void SSL_CTX_set_client_cert_cb( 1130 SSL_CTX *ctx, 1131 int (*client_cert_cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey)); 1132 OPENSSL_EXPORT int (*SSL_CTX_get_client_cert_cb(SSL_CTX *ctx))(SSL *ssl, 1133 X509 **x509, 1134 EVP_PKEY **pkey); 1135 OPENSSL_EXPORT void SSL_CTX_set_channel_id_cb( 1136 SSL_CTX *ctx, void (*channel_id_cb)(SSL *ssl, EVP_PKEY **pkey)); 1137 OPENSSL_EXPORT void (*SSL_CTX_get_channel_id_cb(SSL_CTX *ctx))(SSL *ssl, 1138 EVP_PKEY **pkey); 1139 1140 /* SSL_enable_signed_cert_timestamps causes |ssl| (which must be the client end 1141 * of a connection) to request SCTs from the server. See 1142 * https://tools.ietf.org/html/rfc6962. It returns one. */ 1143 OPENSSL_EXPORT int SSL_enable_signed_cert_timestamps(SSL *ssl); 1144 1145 /* SSL_CTX_enable_signed_cert_timestamps enables SCT requests on all client SSL 1146 * objects created from |ctx|. */ 1147 OPENSSL_EXPORT void SSL_CTX_enable_signed_cert_timestamps(SSL_CTX *ctx); 1148 1149 /* SSL_enable_ocsp_stapling causes |ssl| (which must be the client end of a 1150 * connection) to request a stapled OCSP response from the server. It returns 1151 * one. */ 1152 OPENSSL_EXPORT int SSL_enable_ocsp_stapling(SSL *ssl); 1153 1154 /* SSL_CTX_enable_ocsp_stapling enables OCSP stapling on all client SSL objects 1155 * created from |ctx|. */ 1156 OPENSSL_EXPORT void SSL_CTX_enable_ocsp_stapling(SSL_CTX *ctx); 1157 1158 /* SSL_get0_signed_cert_timestamp_list sets |*out| and |*out_len| to point to 1159 * |*out_len| bytes of SCT information from the server. This is only valid if 1160 * |ssl| is a client. The SCT information is a SignedCertificateTimestampList 1161 * (including the two leading length bytes). 1162 * See https://tools.ietf.org/html/rfc6962#section-3.3 1163 * If no SCT was received then |*out_len| will be zero on return. 1164 * 1165 * WARNING: the returned data is not guaranteed to be well formed. */ 1166 OPENSSL_EXPORT void SSL_get0_signed_cert_timestamp_list(const SSL *ssl, 1167 const uint8_t **out, 1168 size_t *out_len); 1169 1170 /* SSL_get0_ocsp_response sets |*out| and |*out_len| to point to |*out_len| 1171 * bytes of an OCSP response from the server. This is the DER encoding of an 1172 * OCSPResponse type as defined in RFC 2560. 1173 * 1174 * WARNING: the returned data is not guaranteed to be well formed. */ 1175 OPENSSL_EXPORT void SSL_get0_ocsp_response(const SSL *ssl, const uint8_t **out, 1176 size_t *out_len); 1177 1178 OPENSSL_EXPORT void SSL_CTX_set_next_protos_advertised_cb( 1179 SSL_CTX *s, 1180 int (*cb)(SSL *ssl, const uint8_t **out, unsigned int *outlen, void *arg), 1181 void *arg); 1182 OPENSSL_EXPORT void SSL_CTX_set_next_proto_select_cb( 1183 SSL_CTX *s, int (*cb)(SSL *ssl, uint8_t **out, uint8_t *outlen, 1184 const uint8_t *in, unsigned int inlen, void *arg), 1185 void *arg); 1186 OPENSSL_EXPORT void SSL_get0_next_proto_negotiated(const SSL *s, 1187 const uint8_t **data, 1188 unsigned *len); 1189 1190 OPENSSL_EXPORT int SSL_select_next_proto(uint8_t **out, uint8_t *outlen, 1191 const uint8_t *in, unsigned int inlen, 1192 const uint8_t *client, 1193 unsigned int client_len); 1194 1195 #define OPENSSL_NPN_UNSUPPORTED 0 1196 #define OPENSSL_NPN_NEGOTIATED 1 1197 #define OPENSSL_NPN_NO_OVERLAP 2 1198 1199 /* SSL_CTX_set_alpn_protos sets the ALPN protocol list on |ctx| to |protos|. 1200 * |protos| must be in wire-format (i.e. a series of non-empty, 8-bit 1201 * length-prefixed strings). It returns zero on success and one on failure. 1202 * 1203 * WARNING: this function is dangerous because it breaks the usual return value 1204 * convention. */ 1205 OPENSSL_EXPORT int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const uint8_t *protos, 1206 unsigned protos_len); 1207 1208 /* SSL_set_alpn_protos sets the ALPN protocol list on |ssl| to |protos|. 1209 * |protos| must be in wire-format (i.e. a series of non-empty, 8-bit 1210 * length-prefixed strings). It returns zero on success and one on failure. 1211 * 1212 * WARNING: this function is dangerous because it breaks the usual return value 1213 * convention. */ 1214 OPENSSL_EXPORT int SSL_set_alpn_protos(SSL *ssl, const uint8_t *protos, 1215 unsigned protos_len); 1216 1217 OPENSSL_EXPORT void SSL_CTX_set_alpn_select_cb( 1218 SSL_CTX *ctx, int (*cb)(SSL *ssl, const uint8_t **out, uint8_t *outlen, 1219 const uint8_t *in, unsigned int inlen, void *arg), 1220 void *arg); 1221 OPENSSL_EXPORT void SSL_get0_alpn_selected(const SSL *ssl, const uint8_t **data, 1222 unsigned *len); 1223 1224 /* SSL_enable_fastradio_padding controls whether fastradio padding is enabled 1225 * on |ssl|. If it is, ClientHello messages are padded to 1024 bytes. This 1226 * causes 3G radios to switch to DCH mode (high data rate). */ 1227 OPENSSL_EXPORT void SSL_enable_fastradio_padding(SSL *ssl, char on_off); 1228 1229 /* SSL_set_reject_peer_renegotiations controls whether renegotiation attempts by 1230 * the peer are rejected. It may be set at any point in a connection's lifetime 1231 * to control future renegotiations programmatically. By default, renegotiations 1232 * are rejected. (Renegotiations requested by a client are always rejected.) */ 1233 OPENSSL_EXPORT void SSL_set_reject_peer_renegotiations(SSL *ssl, int reject); 1234 1235 /* the maximum length of the buffer given to callbacks containing the resulting 1236 * identity/psk */ 1237 #define PSK_MAX_IDENTITY_LEN 128 1238 #define PSK_MAX_PSK_LEN 256 1239 OPENSSL_EXPORT void SSL_CTX_set_psk_client_callback( 1240 SSL_CTX *ctx, 1241 unsigned int (*psk_client_callback)( 1242 SSL *ssl, const char *hint, char *identity, 1243 unsigned int max_identity_len, uint8_t *psk, unsigned int max_psk_len)); 1244 OPENSSL_EXPORT void SSL_set_psk_client_callback( 1245 SSL *ssl, unsigned int (*psk_client_callback)(SSL *ssl, const char *hint, 1246 char *identity, 1247 unsigned int max_identity_len, 1248 uint8_t *psk, 1249 unsigned int max_psk_len)); 1250 OPENSSL_EXPORT void SSL_CTX_set_psk_server_callback( 1251 SSL_CTX *ctx, 1252 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity, 1253 uint8_t *psk, 1254 unsigned int max_psk_len)); 1255 OPENSSL_EXPORT void SSL_set_psk_server_callback( 1256 SSL *ssl, 1257 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity, 1258 uint8_t *psk, 1259 unsigned int max_psk_len)); 1260 OPENSSL_EXPORT int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, 1261 const char *identity_hint); 1262 OPENSSL_EXPORT int SSL_use_psk_identity_hint(SSL *s, const char *identity_hint); 1263 OPENSSL_EXPORT const char *SSL_get_psk_identity_hint(const SSL *s); 1264 OPENSSL_EXPORT const char *SSL_get_psk_identity(const SSL *s); 1265 1266 #define SSL_NOTHING 1 1267 #define SSL_WRITING 2 1268 #define SSL_READING 3 1269 #define SSL_X509_LOOKUP 4 1270 #define SSL_CHANNEL_ID_LOOKUP 5 1271 #define SSL_PENDING_SESSION 7 1272 #define SSL_CERTIFICATE_SELECTION_PENDING 8 1273 1274 /* These will only be used when doing non-blocking IO */ 1275 #define SSL_want_nothing(s) (SSL_want(s) == SSL_NOTHING) 1276 #define SSL_want_read(s) (SSL_want(s) == SSL_READING) 1277 #define SSL_want_write(s) (SSL_want(s) == SSL_WRITING) 1278 #define SSL_want_x509_lookup(s) (SSL_want(s) == SSL_X509_LOOKUP) 1279 #define SSL_want_channel_id_lookup(s) (SSL_want(s) == SSL_CHANNEL_ID_LOOKUP) 1280 #define SSL_want_session(s) (SSL_want(s) == SSL_PENDING_SESSION) 1281 #define SSL_want_certificate(s) \ 1282 (SSL_want(s) == SSL_CERTIFICATE_SELECTION_PENDING) 1283 1284 struct ssl_st { 1285 /* version is the protocol version. */ 1286 int version; 1287 1288 /* method is the method table corresponding to the current protocol (DTLS or 1289 * TLS). */ 1290 const SSL_PROTOCOL_METHOD *method; 1291 1292 /* enc_method is the method table corresponding to the current protocol 1293 * version. */ 1294 const SSL3_ENC_METHOD *enc_method; 1295 1296 /* max_version is the maximum acceptable protocol version. If zero, the 1297 * maximum supported version, currently (D)TLS 1.2, is used. */ 1298 uint16_t max_version; 1299 1300 /* min_version is the minimum acceptable protocl version. If zero, the 1301 * minimum supported version, currently SSL 3.0 and DTLS 1.0, is used */ 1302 uint16_t min_version; 1303 1304 /* There are 2 BIO's even though they are normally both the same. This is so 1305 * data can be read and written to different handlers */ 1306 1307 BIO *rbio; /* used by SSL_read */ 1308 BIO *wbio; /* used by SSL_write */ 1309 BIO *bbio; /* used during session-id reuse to concatenate 1310 * messages */ 1311 1312 /* This holds a variable that indicates what we were doing when a 0 or -1 is 1313 * returned. This is needed for non-blocking IO so we know what request 1314 * needs re-doing when in SSL_accept or SSL_connect */ 1315 int rwstate; 1316 1317 /* true when we are actually in SSL_accept() or SSL_connect() */ 1318 int in_handshake; 1319 int (*handshake_func)(SSL *); 1320 1321 /* Imagine that here's a boolean member "init" that is switched as soon as 1322 * SSL_set_{accept/connect}_state is called for the first time, so that 1323 * "state" and "handshake_func" are properly initialized. But as 1324 * handshake_func is == 0 until then, we use this test instead of an "init" 1325 * member. */ 1326 1327 /* server is true iff the this SSL* is the server half. Note: before the SSL* 1328 * is initialized by either SSL_set_accept_state or SSL_set_connect_state, 1329 * the side is not determined. In this state, server is always false. */ 1330 int server; 1331 1332 /* quiet_shutdown is true if the connection should not send a close_notify on 1333 * shutdown. */ 1334 int quiet_shutdown; 1335 1336 int shutdown; /* we have shut things down, 0x01 sent, 0x02 1337 * for received */ 1338 int state; /* where we are */ 1339 int rstate; /* where we are when reading */ 1340 1341 BUF_MEM *init_buf; /* buffer used during init */ 1342 uint8_t *init_msg; /* pointer to handshake message body, set by 1343 ssl3_get_message() */ 1344 int init_num; /* amount read/written */ 1345 int init_off; /* amount read/written */ 1346 1347 /* used internally to point at a raw packet */ 1348 uint8_t *packet; 1349 unsigned int packet_length; 1350 1351 struct ssl3_state_st *s3; /* SSLv3 variables */ 1352 struct dtls1_state_st *d1; /* DTLSv1 variables */ 1353 1354 /* callback that allows applications to peek at protocol messages */ 1355 void (*msg_callback)(int write_p, int version, int content_type, 1356 const void *buf, size_t len, SSL *ssl, void *arg); 1357 void *msg_callback_arg; 1358 1359 int hit; /* reusing a previous session */ 1360 1361 X509_VERIFY_PARAM *param; 1362 1363 /* crypto */ 1364 struct ssl_cipher_preference_list_st *cipher_list; 1365 STACK_OF(SSL_CIPHER) *cipher_list_by_id; 1366 1367 SSL_AEAD_CTX *aead_read_ctx; 1368 SSL_AEAD_CTX *aead_write_ctx; 1369 1370 /* session info */ 1371 1372 /* client cert? */ 1373 /* This is used to hold the server certificate used */ 1374 struct cert_st /* CERT */ *cert; 1375 1376 /* the session_id_context is used to ensure sessions are only reused 1377 * in the appropriate context */ 1378 unsigned int sid_ctx_length; 1379 uint8_t sid_ctx[SSL_MAX_SID_CTX_LENGTH]; 1380 1381 /* This can also be in the session once a session is established */ 1382 SSL_SESSION *session; 1383 1384 /* Default generate session ID callback. */ 1385 GEN_SESSION_CB generate_session_id; 1386 1387 /* Used in SSL2 and SSL3 */ 1388 int verify_mode; /* 0 don't care about verify failure. 1389 * 1 fail if verify fails */ 1390 int (*verify_callback)(int ok, 1391 X509_STORE_CTX *ctx); /* fail if callback returns 0 */ 1392 1393 void (*info_callback)(const SSL *ssl, int type, 1394 int val); /* optional informational callback */ 1395 1396 /* Server-only: psk_identity_hint is the identity hint to send in 1397 * PSK-based key exchanges. */ 1398 char *psk_identity_hint; 1399 1400 unsigned int (*psk_client_callback)(SSL *ssl, const char *hint, 1401 char *identity, 1402 unsigned int max_identity_len, 1403 uint8_t *psk, unsigned int max_psk_len); 1404 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity, 1405 uint8_t *psk, unsigned int max_psk_len); 1406 1407 SSL_CTX *ctx; 1408 1409 /* extra application data */ 1410 long verify_result; 1411 CRYPTO_EX_DATA ex_data; 1412 1413 /* for server side, keep the list of CA_dn we can use */ 1414 STACK_OF(X509_NAME) *client_CA; 1415 1416 uint32_t options; /* protocol behaviour */ 1417 uint32_t mode; /* API behaviour */ 1418 uint32_t max_cert_list; 1419 int client_version; /* what was passed, used for 1420 * SSLv3/TLS rollback check */ 1421 uint16_t max_send_fragment; 1422 char *tlsext_hostname; 1423 /* should_ack_sni is true if the SNI extension should be acked. This is 1424 * only used by a server. */ 1425 char should_ack_sni; 1426 /* RFC4507 session ticket expected to be received or sent */ 1427 int tlsext_ticket_expected; 1428 size_t tlsext_ecpointformatlist_length; 1429 uint8_t *tlsext_ecpointformatlist; /* our list */ 1430 size_t tlsext_ellipticcurvelist_length; 1431 uint16_t *tlsext_ellipticcurvelist; /* our list */ 1432 1433 SSL_CTX *initial_ctx; /* initial ctx, used to store sessions */ 1434 1435 /* Next protocol negotiation. For the client, this is the protocol that we 1436 * sent in NextProtocol and is set when handling ServerHello extensions. 1437 * 1438 * For a server, this is the client's selected_protocol from NextProtocol and 1439 * is set when handling the NextProtocol message, before the Finished 1440 * message. */ 1441 uint8_t *next_proto_negotiated; 1442 size_t next_proto_negotiated_len; 1443 1444 /* srtp_profiles is the list of configured SRTP protection profiles for 1445 * DTLS-SRTP. */ 1446 STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles; 1447 1448 /* srtp_profile is the selected SRTP protection profile for 1449 * DTLS-SRTP. */ 1450 const SRTP_PROTECTION_PROFILE *srtp_profile; 1451 1452 /* Copied from the SSL_CTX. For a server, means that we'll accept Channel IDs 1453 * from clients. For a client, means that we'll advertise support. */ 1454 char tlsext_channel_id_enabled; 1455 /* The client's Channel ID private key. */ 1456 EVP_PKEY *tlsext_channel_id_private; 1457 1458 /* Enable signed certificate time stamps. Currently client only. */ 1459 char signed_cert_timestamps_enabled; 1460 1461 /* Enable OCSP stapling. Currently client only. 1462 * TODO(davidben): Add a server-side implementation when it becomes 1463 * necesary. */ 1464 char ocsp_stapling_enabled; 1465 1466 /* For a client, this contains the list of supported protocols in wire 1467 * format. */ 1468 uint8_t *alpn_client_proto_list; 1469 unsigned alpn_client_proto_list_len; 1470 1471 /* fastradio_padding, if true, causes ClientHellos to be padded to 1024 1472 * bytes. This ensures that the cellular radio is fast forwarded to DCH (high 1473 * data rate) state in 3G networks. */ 1474 char fastradio_padding; 1475 1476 /* accept_peer_renegotiations, if one, accepts renegotiation attempts from the 1477 * peer. Otherwise, they will be rejected with a fatal error. */ 1478 char accept_peer_renegotiations; 1479 1480 /* These fields are always NULL and exist only to keep wpa_supplicant happy 1481 * about the change to EVP_AEAD. They are only needed for EAP-FAST, which we 1482 * don't support. */ 1483 EVP_CIPHER_CTX *enc_read_ctx; 1484 EVP_MD_CTX *read_hash; 1485 }; 1486 1487 /* compatibility */ 1488 #define SSL_set_app_data(s, arg) (SSL_set_ex_data(s, 0, (char *)arg)) 1489 #define SSL_get_app_data(s) (SSL_get_ex_data(s, 0)) 1490 #define SSL_SESSION_set_app_data(s, a) \ 1491 (SSL_SESSION_set_ex_data(s, 0, (char *)a)) 1492 #define SSL_SESSION_get_app_data(s) (SSL_SESSION_get_ex_data(s, 0)) 1493 #define SSL_CTX_get_app_data(ctx) (SSL_CTX_get_ex_data(ctx, 0)) 1494 #define SSL_CTX_set_app_data(ctx, arg) \ 1495 (SSL_CTX_set_ex_data(ctx, 0, (char *)arg)) 1496 1497 /* The following are the possible values for ssl->state are are used to 1498 * indicate where we are up to in the SSL connection establishment. The macros 1499 * that follow are about the only things you should need to use and even then, 1500 * only when using non-blocking IO. It can also be useful to work out where you 1501 * were when the connection failed */ 1502 1503 #define SSL_ST_CONNECT 0x1000 1504 #define SSL_ST_ACCEPT 0x2000 1505 #define SSL_ST_MASK 0x0FFF 1506 #define SSL_ST_INIT (SSL_ST_CONNECT | SSL_ST_ACCEPT) 1507 #define SSL_ST_OK 0x03 1508 #define SSL_ST_RENEGOTIATE (0x04 | SSL_ST_INIT) 1509 1510 #define SSL_CB_LOOP 0x01 1511 #define SSL_CB_EXIT 0x02 1512 #define SSL_CB_READ 0x04 1513 #define SSL_CB_WRITE 0x08 1514 #define SSL_CB_ALERT 0x4000 /* used in callback */ 1515 #define SSL_CB_READ_ALERT (SSL_CB_ALERT | SSL_CB_READ) 1516 #define SSL_CB_WRITE_ALERT (SSL_CB_ALERT | SSL_CB_WRITE) 1517 #define SSL_CB_ACCEPT_LOOP (SSL_ST_ACCEPT | SSL_CB_LOOP) 1518 #define SSL_CB_ACCEPT_EXIT (SSL_ST_ACCEPT | SSL_CB_EXIT) 1519 #define SSL_CB_CONNECT_LOOP (SSL_ST_CONNECT | SSL_CB_LOOP) 1520 #define SSL_CB_CONNECT_EXIT (SSL_ST_CONNECT | SSL_CB_EXIT) 1521 #define SSL_CB_HANDSHAKE_START 0x10 1522 #define SSL_CB_HANDSHAKE_DONE 0x20 1523 1524 /* Is the SSL_connection established? */ 1525 #define SSL_get_state(a) SSL_state(a) 1526 #define SSL_is_init_finished(a) (SSL_state(a) == SSL_ST_OK) 1527 #define SSL_in_init(a) (SSL_state(a) & SSL_ST_INIT) 1528 #define SSL_in_connect_init(a) (SSL_state(a) & SSL_ST_CONNECT) 1529 #define SSL_in_accept_init(a) (SSL_state(a) & SSL_ST_ACCEPT) 1530 1531 /* SSL_in_false_start returns one if |s| has a pending unfinished handshake that 1532 * is in False Start. |SSL_write| may be called at this point without waiting 1533 * for the peer, but |SSL_read| will require the handshake to be completed. */ 1534 OPENSSL_EXPORT int SSL_in_false_start(const SSL *s); 1535 1536 /* The following 2 states are kept in ssl->rstate when reads fail, 1537 * you should not need these */ 1538 #define SSL_ST_READ_HEADER 0xF0 1539 #define SSL_ST_READ_BODY 0xF1 1540 #define SSL_ST_READ_DONE 0xF2 1541 1542 /* Obtain latest Finished message 1543 * -- that we sent (SSL_get_finished) 1544 * -- that we expected from peer (SSL_get_peer_finished). 1545 * Returns length (0 == no Finished so far), copies up to 'count' bytes. */ 1546 OPENSSL_EXPORT size_t SSL_get_finished(const SSL *s, void *buf, size_t count); 1547 OPENSSL_EXPORT size_t SSL_get_peer_finished(const SSL *s, void *buf, size_t count); 1548 1549 /* use either SSL_VERIFY_NONE or SSL_VERIFY_PEER, the last 3 options 1550 * are 'ored' with SSL_VERIFY_PEER if they are desired */ 1551 #define SSL_VERIFY_NONE 0x00 1552 #define SSL_VERIFY_PEER 0x01 1553 #define SSL_VERIFY_FAIL_IF_NO_PEER_CERT 0x02 1554 /* SSL_VERIFY_CLIENT_ONCE does nothing. */ 1555 #define SSL_VERIFY_CLIENT_ONCE 0x04 1556 #define SSL_VERIFY_PEER_IF_NO_OBC 0x08 1557 1558 #define OpenSSL_add_ssl_algorithms() SSL_library_init() 1559 #define SSLeay_add_ssl_algorithms() SSL_library_init() 1560 1561 /* For backward compatibility */ 1562 #define SSL_get_cipher(s) SSL_CIPHER_get_name(SSL_get_current_cipher(s)) 1563 #define SSL_get_cipher_bits(s, np) \ 1564 SSL_CIPHER_get_bits(SSL_get_current_cipher(s), np) 1565 #define SSL_get_cipher_version(s) \ 1566 SSL_CIPHER_get_version(SSL_get_current_cipher(s)) 1567 #define SSL_get_cipher_name(s) SSL_CIPHER_get_name(SSL_get_current_cipher(s)) 1568 #define SSL_get_time(a) SSL_SESSION_get_time(a) 1569 #define SSL_set_time(a, b) SSL_SESSION_set_time((a), (b)) 1570 #define SSL_get_timeout(a) SSL_SESSION_get_timeout(a) 1571 #define SSL_set_timeout(a, b) SSL_SESSION_set_timeout((a), (b)) 1572 1573 #define d2i_SSL_SESSION_bio(bp, s_id) \ 1574 ASN1_d2i_bio_of(SSL_SESSION, SSL_SESSION_new, d2i_SSL_SESSION, bp, s_id) 1575 #define i2d_SSL_SESSION_bio(bp, s_id) \ 1576 ASN1_i2d_bio_of(SSL_SESSION, i2d_SSL_SESSION, bp, s_id) 1577 1578 DECLARE_PEM_rw(SSL_SESSION, SSL_SESSION) 1579 1580 /* make_errors.go reserves error codes above 1000 for manually-assigned errors. 1581 * This value must be kept in sync with reservedReasonCode in make_errors.h */ 1582 #define SSL_AD_REASON_OFFSET \ 1583 1000 /* offset to get SSL_R_... value from SSL_AD_... */ 1584 1585 /* These alert types are for SSLv3 and TLSv1 */ 1586 #define SSL_AD_CLOSE_NOTIFY SSL3_AD_CLOSE_NOTIFY 1587 #define SSL_AD_UNEXPECTED_MESSAGE SSL3_AD_UNEXPECTED_MESSAGE /* fatal */ 1588 #define SSL_AD_BAD_RECORD_MAC SSL3_AD_BAD_RECORD_MAC /* fatal */ 1589 #define SSL_AD_DECRYPTION_FAILED TLS1_AD_DECRYPTION_FAILED 1590 #define SSL_AD_RECORD_OVERFLOW TLS1_AD_RECORD_OVERFLOW 1591 #define SSL_AD_DECOMPRESSION_FAILURE SSL3_AD_DECOMPRESSION_FAILURE /* fatal */ 1592 #define SSL_AD_HANDSHAKE_FAILURE SSL3_AD_HANDSHAKE_FAILURE /* fatal */ 1593 #define SSL_AD_NO_CERTIFICATE SSL3_AD_NO_CERTIFICATE /* Not for TLS */ 1594 #define SSL_AD_BAD_CERTIFICATE SSL3_AD_BAD_CERTIFICATE 1595 #define SSL_AD_UNSUPPORTED_CERTIFICATE SSL3_AD_UNSUPPORTED_CERTIFICATE 1596 #define SSL_AD_CERTIFICATE_REVOKED SSL3_AD_CERTIFICATE_REVOKED 1597 #define SSL_AD_CERTIFICATE_EXPIRED SSL3_AD_CERTIFICATE_EXPIRED 1598 #define SSL_AD_CERTIFICATE_UNKNOWN SSL3_AD_CERTIFICATE_UNKNOWN 1599 #define SSL_AD_ILLEGAL_PARAMETER SSL3_AD_ILLEGAL_PARAMETER /* fatal */ 1600 #define SSL_AD_UNKNOWN_CA TLS1_AD_UNKNOWN_CA /* fatal */ 1601 #define SSL_AD_ACCESS_DENIED TLS1_AD_ACCESS_DENIED /* fatal */ 1602 #define SSL_AD_DECODE_ERROR TLS1_AD_DECODE_ERROR /* fatal */ 1603 #define SSL_AD_DECRYPT_ERROR TLS1_AD_DECRYPT_ERROR 1604 #define SSL_AD_EXPORT_RESTRICTION TLS1_AD_EXPORT_RESTRICTION /* fatal */ 1605 #define SSL_AD_PROTOCOL_VERSION TLS1_AD_PROTOCOL_VERSION /* fatal */ 1606 #define SSL_AD_INSUFFICIENT_SECURITY TLS1_AD_INSUFFICIENT_SECURITY /* fatal */ 1607 #define SSL_AD_INTERNAL_ERROR TLS1_AD_INTERNAL_ERROR /* fatal */ 1608 #define SSL_AD_USER_CANCELLED TLS1_AD_USER_CANCELLED 1609 #define SSL_AD_NO_RENEGOTIATION TLS1_AD_NO_RENEGOTIATION 1610 #define SSL_AD_UNSUPPORTED_EXTENSION TLS1_AD_UNSUPPORTED_EXTENSION 1611 #define SSL_AD_CERTIFICATE_UNOBTAINABLE TLS1_AD_CERTIFICATE_UNOBTAINABLE 1612 #define SSL_AD_UNRECOGNIZED_NAME TLS1_AD_UNRECOGNIZED_NAME 1613 #define SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE \ 1614 TLS1_AD_BAD_CERTIFICATE_STATUS_RESPONSE 1615 #define SSL_AD_BAD_CERTIFICATE_HASH_VALUE TLS1_AD_BAD_CERTIFICATE_HASH_VALUE 1616 #define SSL_AD_UNKNOWN_PSK_IDENTITY TLS1_AD_UNKNOWN_PSK_IDENTITY /* fatal */ 1617 #define SSL_AD_INAPPROPRIATE_FALLBACK SSL3_AD_INAPPROPRIATE_FALLBACK /* fatal */ 1618 1619 #define SSL_ERROR_NONE 0 1620 #define SSL_ERROR_SSL 1 1621 #define SSL_ERROR_WANT_READ 2 1622 #define SSL_ERROR_WANT_WRITE 3 1623 #define SSL_ERROR_WANT_X509_LOOKUP 4 1624 #define SSL_ERROR_SYSCALL 5 /* look at error stack/return value/errno */ 1625 #define SSL_ERROR_ZERO_RETURN 6 1626 #define SSL_ERROR_WANT_CONNECT 7 1627 #define SSL_ERROR_WANT_ACCEPT 8 1628 #define SSL_ERROR_WANT_CHANNEL_ID_LOOKUP 9 1629 #define SSL_ERROR_PENDING_SESSION 11 1630 #define SSL_ERROR_PENDING_CERTIFICATE 12 1631 1632 #define SSL_CTRL_EXTRA_CHAIN_CERT 14 1633 1634 /* see tls1.h for macros based on these */ 1635 #define SSL_CTRL_GET_TLSEXT_TICKET_KEYS 58 1636 #define SSL_CTRL_SET_TLSEXT_TICKET_KEYS 59 1637 1638 #define SSL_CTRL_SET_SRP_ARG 78 1639 #define SSL_CTRL_SET_TLS_EXT_SRP_USERNAME 79 1640 #define SSL_CTRL_SET_TLS_EXT_SRP_STRENGTH 80 1641 #define SSL_CTRL_SET_TLS_EXT_SRP_PASSWORD 81 1642 1643 #define SSL_CTRL_GET_EXTRA_CHAIN_CERTS 82 1644 #define SSL_CTRL_CLEAR_EXTRA_CHAIN_CERTS 83 1645 1646 #define SSL_CTRL_CHAIN 88 1647 #define SSL_CTRL_CHAIN_CERT 89 1648 1649 #define SSL_CTRL_GET_CURVES 90 1650 #define SSL_CTRL_SET_CURVES 91 1651 #define SSL_CTRL_SET_CURVES_LIST 92 1652 #define SSL_CTRL_SET_SIGALGS 97 1653 #define SSL_CTRL_SET_SIGALGS_LIST 98 1654 #define SSL_CTRL_SET_CLIENT_SIGALGS 101 1655 #define SSL_CTRL_SET_CLIENT_SIGALGS_LIST 102 1656 #define SSL_CTRL_GET_CLIENT_CERT_TYPES 103 1657 #define SSL_CTRL_SET_CLIENT_CERT_TYPES 104 1658 #define SSL_CTRL_BUILD_CERT_CHAIN 105 1659 #define SSL_CTRL_SET_VERIFY_CERT_STORE 106 1660 #define SSL_CTRL_SET_CHAIN_CERT_STORE 107 1661 #define SSL_CTRL_GET_SERVER_TMP_KEY 109 1662 #define SSL_CTRL_GET_EC_POINT_FORMATS 111 1663 1664 #define SSL_CTRL_GET_CHAIN_CERTS 115 1665 #define SSL_CTRL_SELECT_CURRENT_CERT 116 1666 1667 /* DTLSv1_get_timeout queries the next DTLS handshake timeout. If there is a 1668 * timeout in progress, it sets |*out| to the time remaining and returns one. 1669 * Otherwise, it returns zero. 1670 * 1671 * When the timeout expires, call |DTLSv1_handle_timeout| to handle the 1672 * retransmit behavior. 1673 * 1674 * NOTE: This function must be queried again whenever the handshake state 1675 * machine changes, including when |DTLSv1_handle_timeout| is called. */ 1676 OPENSSL_EXPORT int DTLSv1_get_timeout(const SSL *ssl, struct timeval *out); 1677 1678 /* DTLSv1_handle_timeout is called when a DTLS handshake timeout expires. If no 1679 * timeout had expired, it returns 0. Otherwise, it retransmits the previous 1680 * flight of handshake messages and returns 1. If too many timeouts had expired 1681 * without progress or an error occurs, it returns -1. 1682 * 1683 * NOTE: The caller's external timer should be compatible with the one |ssl| 1684 * queries within some fudge factor. Otherwise, the call will be a no-op, but 1685 * |DTLSv1_get_timeout| will return an updated timeout. 1686 * 1687 * WARNING: This function breaks the usual return value convention. */ 1688 OPENSSL_EXPORT int DTLSv1_handle_timeout(SSL *ssl); 1689 1690 /* SSL_session_reused returns one if |ssl| performed an abbreviated handshake 1691 * and zero otherwise. 1692 * 1693 * TODO(davidben): Hammer down the semantics of this API while a handshake, 1694 * initial or renego, is in progress. */ 1695 OPENSSL_EXPORT int SSL_session_reused(const SSL *ssl); 1696 1697 /* SSL_total_renegotiations returns the total number of renegotiation handshakes 1698 * peformed by |ssl|. This includes the pending renegotiation, if any. */ 1699 OPENSSL_EXPORT int SSL_total_renegotiations(const SSL *ssl); 1700 1701 /* SSL_CTX_set_tmp_dh configures |ctx| to use the group from |dh| as the group 1702 * for DHE. Only the group is used, so |dh| needn't have a keypair. It returns 1703 * one on success and zero on error. */ 1704 OPENSSL_EXPORT int SSL_CTX_set_tmp_dh(SSL_CTX *ctx, const DH *dh); 1705 1706 /* SSL_set_tmp_dh configures |ssl| to use the group from |dh| as the group for 1707 * DHE. Only the group is used, so |dh| needn't have a keypair. It returns one 1708 * on success and zero on error. */ 1709 OPENSSL_EXPORT int SSL_set_tmp_dh(SSL *ssl, const DH *dh); 1710 1711 /* SSL_CTX_set_tmp_ecdh configures |ctx| to use the curve from |ecdh| as the 1712 * curve for ephemeral ECDH keys. For historical reasons, this API expects an 1713 * |EC_KEY|, but only the curve is used. It returns one on success and zero on 1714 * error. If unset, an appropriate curve will be chosen automatically. (This is 1715 * recommended.) */ 1716 OPENSSL_EXPORT int SSL_CTX_set_tmp_ecdh(SSL_CTX *ctx, const EC_KEY *ec_key); 1717 1718 /* SSL_set_tmp_ecdh configures |ssl| to use the curve from |ecdh| as the curve 1719 * for ephemeral ECDH keys. For historical reasons, this API expects an 1720 * |EC_KEY|, but only the curve is used. It returns one on success and zero on 1721 * error. If unset, an appropriate curve will be chosen automatically. (This is 1722 * recommended.) */ 1723 OPENSSL_EXPORT int SSL_set_tmp_ecdh(SSL *ssl, const EC_KEY *ec_key); 1724 1725 /* SSL_CTX_enable_tls_channel_id either configures a TLS server to accept TLS 1726 * client IDs from clients, or configures a client to send TLS client IDs to 1727 * a server. It returns one. */ 1728 OPENSSL_EXPORT int SSL_CTX_enable_tls_channel_id(SSL_CTX *ctx); 1729 1730 /* SSL_enable_tls_channel_id either configures a TLS server to accept TLS 1731 * client IDs from clients, or configure a client to send TLS client IDs to 1732 * server. It returns one. */ 1733 OPENSSL_EXPORT int SSL_enable_tls_channel_id(SSL *ssl); 1734 1735 /* SSL_CTX_set1_tls_channel_id configures a TLS client to send a TLS Channel ID 1736 * to compatible servers. |private_key| must be a P-256 EC key. It returns one 1737 * on success and zero on error. */ 1738 OPENSSL_EXPORT int SSL_CTX_set1_tls_channel_id(SSL_CTX *ctx, 1739 EVP_PKEY *private_key); 1740 1741 /* SSL_set1_tls_channel_id configures a TLS client to send a TLS Channel ID to 1742 * compatible servers. |private_key| must be a P-256 EC key. It returns one on 1743 * success and zero on error. */ 1744 OPENSSL_EXPORT int SSL_set1_tls_channel_id(SSL *ssl, EVP_PKEY *private_key); 1745 1746 /* SSL_get_tls_channel_id gets the client's TLS Channel ID from a server SSL* 1747 * and copies up to the first |max_out| bytes into |out|. The Channel ID 1748 * consists of the client's P-256 public key as an (x,y) pair where each is a 1749 * 32-byte, big-endian field element. It returns 0 if the client didn't offer a 1750 * Channel ID and the length of the complete Channel ID otherwise. */ 1751 OPENSSL_EXPORT size_t SSL_get_tls_channel_id(SSL *ssl, uint8_t *out, 1752 size_t max_out); 1753 1754 #define SSL_CTX_add_extra_chain_cert(ctx, x509) \ 1755 SSL_CTX_ctrl(ctx, SSL_CTRL_EXTRA_CHAIN_CERT, 0, (char *)x509) 1756 #define SSL_CTX_get_extra_chain_certs(ctx, px509) \ 1757 SSL_CTX_ctrl(ctx, SSL_CTRL_GET_EXTRA_CHAIN_CERTS, 0, px509) 1758 #define SSL_CTX_get_extra_chain_certs_only(ctx, px509) \ 1759 SSL_CTX_ctrl(ctx, SSL_CTRL_GET_EXTRA_CHAIN_CERTS, 1, px509) 1760 #define SSL_CTX_clear_extra_chain_certs(ctx) \ 1761 SSL_CTX_ctrl(ctx, SSL_CTRL_CLEAR_EXTRA_CHAIN_CERTS, 0, NULL) 1762 1763 #define SSL_CTX_set0_chain(ctx, sk) \ 1764 SSL_CTX_ctrl(ctx, SSL_CTRL_CHAIN, 0, (char *)sk) 1765 #define SSL_CTX_set1_chain(ctx, sk) \ 1766 SSL_CTX_ctrl(ctx, SSL_CTRL_CHAIN, 1, (char *)sk) 1767 #define SSL_CTX_add0_chain_cert(ctx, x509) \ 1768 SSL_CTX_ctrl(ctx, SSL_CTRL_CHAIN_CERT, 0, (char *)x509) 1769 #define SSL_CTX_add1_chain_cert(ctx, x509) \ 1770 SSL_CTX_ctrl(ctx, SSL_CTRL_CHAIN_CERT, 1, (char *)x509) 1771 #define SSL_CTX_get0_chain_certs(ctx, px509) \ 1772 SSL_CTX_ctrl(ctx, SSL_CTRL_GET_CHAIN_CERTS, 0, px509) 1773 #define SSL_CTX_clear_chain_certs(ctx) SSL_CTX_set0_chain(ctx, NULL) 1774 #define SSL_CTX_build_cert_chain(ctx, flags) \ 1775 SSL_CTX_ctrl(ctx, SSL_CTRL_BUILD_CERT_CHAIN, flags, NULL) 1776 #define SSL_CTX_select_current_cert(ctx, x509) \ 1777 SSL_CTX_ctrl(ctx, SSL_CTRL_SELECT_CURRENT_CERT, 0, (char *)x509) 1778 1779 #define SSL_CTX_set0_verify_cert_store(ctx, st) \ 1780 SSL_CTX_ctrl(ctx, SSL_CTRL_SET_VERIFY_CERT_STORE, 0, (char *)st) 1781 #define SSL_CTX_set1_verify_cert_store(ctx, st) \ 1782 SSL_CTX_ctrl(ctx, SSL_CTRL_SET_VERIFY_CERT_STORE, 1, (char *)st) 1783 #define SSL_CTX_set0_chain_cert_store(ctx, st) \ 1784 SSL_CTX_ctrl(ctx, SSL_CTRL_SET_CHAIN_CERT_STORE, 0, (char *)st) 1785 #define SSL_CTX_set1_chain_cert_store(ctx, st) \ 1786 SSL_CTX_ctrl(ctx, SSL_CTRL_SET_CHAIN_CERT_STORE, 1, (char *)st) 1787 1788 #define SSL_set0_chain(ctx, sk) SSL_ctrl(ctx, SSL_CTRL_CHAIN, 0, (char *)sk) 1789 #define SSL_set1_chain(ctx, sk) SSL_ctrl(ctx, SSL_CTRL_CHAIN, 1, (char *)sk) 1790 #define SSL_add0_chain_cert(ctx, x509) \ 1791 SSL_ctrl(ctx, SSL_CTRL_CHAIN_CERT, 0, (char *)x509) 1792 #define SSL_add1_chain_cert(ctx, x509) \ 1793 SSL_ctrl(ctx, SSL_CTRL_CHAIN_CERT, 1, (char *)x509) 1794 #define SSL_get0_chain_certs(ctx, px509) \ 1795 SSL_ctrl(ctx, SSL_CTRL_GET_CHAIN_CERTS, 0, px509) 1796 #define SSL_clear_chain_certs(ctx) SSL_set0_chain(ctx, NULL) 1797 #define SSL_build_cert_chain(s, flags) \ 1798 SSL_ctrl(s, SSL_CTRL_BUILD_CERT_CHAIN, flags, NULL) 1799 #define SSL_select_current_cert(ctx, x509) \ 1800 SSL_ctrl(ctx, SSL_CTRL_SELECT_CURRENT_CERT, 0, (char *)x509) 1801 1802 #define SSL_set0_verify_cert_store(s, st) \ 1803 SSL_ctrl(s, SSL_CTRL_SET_VERIFY_CERT_STORE, 0, (char *)st) 1804 #define SSL_set1_verify_cert_store(s, st) \ 1805 SSL_ctrl(s, SSL_CTRL_SET_VERIFY_CERT_STORE, 1, (char *)st) 1806 #define SSL_set0_chain_cert_store(s, st) \ 1807 SSL_ctrl(s, SSL_CTRL_SET_CHAIN_CERT_STORE, 0, (char *)st) 1808 #define SSL_set1_chain_cert_store(s, st) \ 1809 SSL_ctrl(s, SSL_CTRL_SET_CHAIN_CERT_STORE, 1, (char *)st) 1810 1811 #define SSL_get1_curves(ctx, s) SSL_ctrl(ctx, SSL_CTRL_GET_CURVES, 0, (char *)s) 1812 #define SSL_CTX_set1_curves(ctx, clist, clistlen) \ 1813 SSL_CTX_ctrl(ctx, SSL_CTRL_SET_CURVES, clistlen, (char *)clist) 1814 #define SSL_CTX_set1_curves_list(ctx, s) \ 1815 SSL_CTX_ctrl(ctx, SSL_CTRL_SET_CURVES_LIST, 0, (char *)s) 1816 #define SSL_set1_curves(ctx, clist, clistlen) \ 1817 SSL_ctrl(ctx, SSL_CTRL_SET_CURVES, clistlen, (char *)clist) 1818 #define SSL_set1_curves_list(ctx, s) \ 1819 SSL_ctrl(ctx, SSL_CTRL_SET_CURVES_LIST, 0, (char *)s) 1820 1821 #define SSL_CTX_set1_sigalgs(ctx, slist, slistlen) \ 1822 SSL_CTX_ctrl(ctx, SSL_CTRL_SET_SIGALGS, slistlen, (int *)slist) 1823 #define SSL_CTX_set1_sigalgs_list(ctx, s) \ 1824 SSL_CTX_ctrl(ctx, SSL_CTRL_SET_SIGALGS_LIST, 0, (char *)s) 1825 #define SSL_set1_sigalgs(ctx, slist, slistlen) \ 1826 SSL_ctrl(ctx, SSL_CTRL_SET_SIGALGS, clistlen, (int *)slist) 1827 #define SSL_set1_sigalgs_list(ctx, s) \ 1828 SSL_ctrl(ctx, SSL_CTRL_SET_SIGALGS_LIST, 0, (char *)s) 1829 1830 #define SSL_CTX_set1_client_sigalgs(ctx, slist, slistlen) \ 1831 SSL_CTX_ctrl(ctx, SSL_CTRL_SET_CLIENT_SIGALGS, slistlen, (int *)slist) 1832 #define SSL_CTX_set1_client_sigalgs_list(ctx, s) \ 1833 SSL_CTX_ctrl(ctx, SSL_CTRL_SET_CLIENT_SIGALGS_LIST, 0, (char *)s) 1834 #define SSL_set1_client_sigalgs(ctx, slist, slistlen) \ 1835 SSL_ctrl(ctx, SSL_CTRL_SET_CLIENT_SIGALGS, clistlen, (int *)slist) 1836 #define SSL_set1_client_sigalgs_list(ctx, s) \ 1837 SSL_ctrl(ctx, SSL_CTRL_SET_CLIENT_SIGALGS_LIST, 0, (char *)s) 1838 1839 #define SSL_get0_certificate_types(s, clist) \ 1840 SSL_ctrl(s, SSL_CTRL_GET_CLIENT_CERT_TYPES, 0, (char *)clist) 1841 1842 #define SSL_CTX_set1_client_certificate_types(ctx, clist, clistlen) \ 1843 SSL_CTX_ctrl(ctx, SSL_CTRL_SET_CLIENT_CERT_TYPES, clistlen, (char *)clist) 1844 #define SSL_set1_client_certificate_types(s, clist, clistlen) \ 1845 SSL_ctrl(s, SSL_CTRL_SET_CLIENT_CERT_TYPES, clistlen, (char *)clist) 1846 1847 #define SSL_get_server_tmp_key(s, pk) \ 1848 SSL_ctrl(s, SSL_CTRL_GET_SERVER_TMP_KEY, 0, pk) 1849 1850 #define SSL_get0_ec_point_formats(s, plst) \ 1851 SSL_ctrl(s, SSL_CTRL_GET_EC_POINT_FORMATS, 0, (char *)plst) 1852 1853 OPENSSL_EXPORT int SSL_CTX_set_cipher_list(SSL_CTX *, const char *str); 1854 OPENSSL_EXPORT int SSL_CTX_set_cipher_list_tls11(SSL_CTX *, const char *str); 1855 OPENSSL_EXPORT long SSL_CTX_set_timeout(SSL_CTX *ctx, long t); 1856 OPENSSL_EXPORT long SSL_CTX_get_timeout(const SSL_CTX *ctx); 1857 OPENSSL_EXPORT X509_STORE *SSL_CTX_get_cert_store(const SSL_CTX *); 1858 OPENSSL_EXPORT void SSL_CTX_set_cert_store(SSL_CTX *, X509_STORE *); 1859 OPENSSL_EXPORT int SSL_want(const SSL *s); 1860 1861 OPENSSL_EXPORT void SSL_CTX_flush_sessions(SSL_CTX *ctx, long tm); 1862 1863 /* SSL_get_current_cipher returns the cipher used in the current outgoing 1864 * connection state, or NULL if the null cipher is active. */ 1865 OPENSSL_EXPORT const SSL_CIPHER *SSL_get_current_cipher(const SSL *s); 1866 1867 OPENSSL_EXPORT int SSL_get_fd(const SSL *s); 1868 OPENSSL_EXPORT int SSL_get_rfd(const SSL *s); 1869 OPENSSL_EXPORT int SSL_get_wfd(const SSL *s); 1870 OPENSSL_EXPORT const char *SSL_get_cipher_list(const SSL *s, int n); 1871 OPENSSL_EXPORT int SSL_pending(const SSL *s); 1872 OPENSSL_EXPORT int SSL_set_fd(SSL *s, int fd); 1873 OPENSSL_EXPORT int SSL_set_rfd(SSL *s, int fd); 1874 OPENSSL_EXPORT int SSL_set_wfd(SSL *s, int fd); 1875 OPENSSL_EXPORT void SSL_set_bio(SSL *s, BIO *rbio, BIO *wbio); 1876 OPENSSL_EXPORT BIO *SSL_get_rbio(const SSL *s); 1877 OPENSSL_EXPORT BIO *SSL_get_wbio(const SSL *s); 1878 OPENSSL_EXPORT int SSL_set_cipher_list(SSL *s, const char *str); 1879 OPENSSL_EXPORT int SSL_get_verify_mode(const SSL *s); 1880 OPENSSL_EXPORT int SSL_get_verify_depth(const SSL *s); 1881 OPENSSL_EXPORT int (*SSL_get_verify_callback(const SSL *s))(int, 1882 X509_STORE_CTX *); 1883 OPENSSL_EXPORT void SSL_set_verify(SSL *s, int mode, 1884 int (*callback)(int ok, 1885 X509_STORE_CTX *ctx)); 1886 OPENSSL_EXPORT void SSL_set_verify_depth(SSL *s, int depth); 1887 OPENSSL_EXPORT void SSL_set_cert_cb(SSL *s, int (*cb)(SSL *ssl, void *arg), 1888 void *arg); 1889 OPENSSL_EXPORT int SSL_use_RSAPrivateKey(SSL *ssl, RSA *rsa); 1890 OPENSSL_EXPORT int SSL_use_RSAPrivateKey_ASN1(SSL *ssl, uint8_t *d, long len); 1891 OPENSSL_EXPORT int SSL_use_PrivateKey(SSL *ssl, EVP_PKEY *pkey); 1892 OPENSSL_EXPORT int SSL_use_PrivateKey_ASN1(int pk, SSL *ssl, const uint8_t *d, 1893 long len); 1894 OPENSSL_EXPORT int SSL_use_certificate(SSL *ssl, X509 *x); 1895 OPENSSL_EXPORT int SSL_use_certificate_ASN1(SSL *ssl, const uint8_t *d, 1896 int len); 1897 1898 OPENSSL_EXPORT int SSL_use_RSAPrivateKey_file(SSL *ssl, const char *file, 1899 int type); 1900 OPENSSL_EXPORT int SSL_use_PrivateKey_file(SSL *ssl, const char *file, 1901 int type); 1902 OPENSSL_EXPORT int SSL_use_certificate_file(SSL *ssl, const char *file, 1903 int type); 1904 OPENSSL_EXPORT int SSL_CTX_use_RSAPrivateKey_file(SSL_CTX *ctx, 1905 const char *file, int type); 1906 OPENSSL_EXPORT int SSL_CTX_use_PrivateKey_file(SSL_CTX *ctx, const char *file, 1907 int type); 1908 OPENSSL_EXPORT int SSL_CTX_use_certificate_file(SSL_CTX *ctx, const char *file, 1909 int type); 1910 OPENSSL_EXPORT int SSL_CTX_use_certificate_chain_file( 1911 SSL_CTX *ctx, const char *file); /* PEM type */ 1912 OPENSSL_EXPORT STACK_OF(X509_NAME) *SSL_load_client_CA_file(const char *file); 1913 OPENSSL_EXPORT int SSL_add_file_cert_subjects_to_stack(STACK_OF(X509_NAME) * 1914 stackCAs, 1915 const char *file); 1916 OPENSSL_EXPORT int SSL_add_dir_cert_subjects_to_stack(STACK_OF(X509_NAME) * 1917 stackCAs, 1918 const char *dir); 1919 1920 /* SSL_load_error_strings does nothing. */ 1921 OPENSSL_EXPORT void SSL_load_error_strings(void); 1922 1923 OPENSSL_EXPORT const char *SSL_state_string(const SSL *s); 1924 OPENSSL_EXPORT const char *SSL_rstate_string(const SSL *s); 1925 OPENSSL_EXPORT const char *SSL_state_string_long(const SSL *s); 1926 OPENSSL_EXPORT const char *SSL_rstate_string_long(const SSL *s); 1927 OPENSSL_EXPORT long SSL_SESSION_get_time(const SSL_SESSION *s); 1928 OPENSSL_EXPORT long SSL_SESSION_set_time(SSL_SESSION *s, long t); 1929 OPENSSL_EXPORT long SSL_SESSION_get_timeout(const SSL_SESSION *s); 1930 OPENSSL_EXPORT long SSL_SESSION_set_timeout(SSL_SESSION *s, long t); 1931 OPENSSL_EXPORT X509 *SSL_SESSION_get0_peer(SSL_SESSION *s); 1932 OPENSSL_EXPORT int SSL_SESSION_set1_id_context(SSL_SESSION *s, 1933 const uint8_t *sid_ctx, 1934 unsigned int sid_ctx_len); 1935 1936 OPENSSL_EXPORT SSL_SESSION *SSL_SESSION_new(void); 1937 OPENSSL_EXPORT const uint8_t *SSL_SESSION_get_id(const SSL_SESSION *s, 1938 unsigned int *len); 1939 OPENSSL_EXPORT int SSL_SESSION_print_fp(FILE *fp, const SSL_SESSION *ses); 1940 OPENSSL_EXPORT int SSL_SESSION_print(BIO *fp, const SSL_SESSION *ses); 1941 1942 /* SSL_SESSION_up_ref, if |session| is not NULL, increments the reference count 1943 * of |session|. It then returns |session|. */ 1944 OPENSSL_EXPORT SSL_SESSION *SSL_SESSION_up_ref(SSL_SESSION *session); 1945 1946 /* SSL_SESSION_free decrements the reference count of |session|. If it reaches 1947 * zero, all data referenced by |session| and |session| itself are released. */ 1948 OPENSSL_EXPORT void SSL_SESSION_free(SSL_SESSION *session); 1949 1950 OPENSSL_EXPORT int SSL_set_session(SSL *to, SSL_SESSION *session); 1951 OPENSSL_EXPORT int SSL_CTX_add_session(SSL_CTX *s, SSL_SESSION *c); 1952 OPENSSL_EXPORT int SSL_CTX_remove_session(SSL_CTX *, SSL_SESSION *c); 1953 OPENSSL_EXPORT int SSL_CTX_set_generate_session_id(SSL_CTX *, GEN_SESSION_CB); 1954 OPENSSL_EXPORT int SSL_set_generate_session_id(SSL *, GEN_SESSION_CB); 1955 OPENSSL_EXPORT int SSL_has_matching_session_id(const SSL *ssl, 1956 const uint8_t *id, 1957 unsigned int id_len); 1958 1959 /* SSL_SESSION_to_bytes serializes |in| into a newly allocated buffer and sets 1960 * |*out_data| to that buffer and |*out_len| to its length. The caller takes 1961 * ownership of the buffer and must call |OPENSSL_free| when done. It returns 1962 * one on success and zero on error. */ 1963 OPENSSL_EXPORT int SSL_SESSION_to_bytes(SSL_SESSION *in, uint8_t **out_data, 1964 size_t *out_len); 1965 1966 /* SSL_SESSION_to_bytes_for_ticket serializes |in|, but excludes the session ID 1967 * which is not necessary in a session ticket. */ 1968 OPENSSL_EXPORT int SSL_SESSION_to_bytes_for_ticket(SSL_SESSION *in, 1969 uint8_t **out_data, 1970 size_t *out_len); 1971 1972 /* Deprecated: i2d_SSL_SESSION serializes |in| to the bytes pointed to by 1973 * |*pp|. On success, it returns the number of bytes written and advances |*pp| 1974 * by that many bytes. On failure, it returns -1. If |pp| is NULL, no bytes are 1975 * written and only the length is returned. 1976 * 1977 * Use SSL_SESSION_to_bytes instead. */ 1978 OPENSSL_EXPORT int i2d_SSL_SESSION(SSL_SESSION *in, uint8_t **pp); 1979 1980 /* d2i_SSL_SESSION deserializes a serialized buffer contained in the |length| 1981 * bytes pointed to by |*pp|. It returns the new SSL_SESSION and advances |*pp| 1982 * by the number of bytes consumed on success and NULL on failure. If |a| is 1983 * NULL, the caller takes ownership of the new session and must call 1984 * |SSL_SESSION_free| when done. 1985 * 1986 * If |a| and |*a| are not NULL, the SSL_SESSION at |*a| is overridden with the 1987 * deserialized session rather than allocating a new one. In addition, |a| is 1988 * not NULL, but |*a| is, |*a| is set to the new SSL_SESSION. 1989 * 1990 * Passing a value other than NULL to |a| is deprecated. */ 1991 OPENSSL_EXPORT SSL_SESSION *d2i_SSL_SESSION(SSL_SESSION **a, const uint8_t **pp, 1992 long length); 1993 1994 OPENSSL_EXPORT X509 *SSL_get_peer_certificate(const SSL *s); 1995 1996 OPENSSL_EXPORT STACK_OF(X509) *SSL_get_peer_cert_chain(const SSL *s); 1997 1998 OPENSSL_EXPORT int SSL_CTX_get_verify_mode(const SSL_CTX *ctx); 1999 OPENSSL_EXPORT int SSL_CTX_get_verify_depth(const SSL_CTX *ctx); 2000 OPENSSL_EXPORT int (*SSL_CTX_get_verify_callback(const SSL_CTX *ctx))( 2001 int, X509_STORE_CTX *); 2002 OPENSSL_EXPORT void SSL_CTX_set_verify(SSL_CTX *ctx, int mode, 2003 int (*callback)(int, X509_STORE_CTX *)); 2004 OPENSSL_EXPORT void SSL_CTX_set_verify_depth(SSL_CTX *ctx, int depth); 2005 OPENSSL_EXPORT void SSL_CTX_set_cert_verify_callback( 2006 SSL_CTX *ctx, int (*cb)(X509_STORE_CTX *, void *), void *arg); 2007 OPENSSL_EXPORT void SSL_CTX_set_cert_cb(SSL_CTX *c, 2008 int (*cb)(SSL *ssl, void *arg), 2009 void *arg); 2010 OPENSSL_EXPORT int SSL_CTX_use_RSAPrivateKey(SSL_CTX *ctx, RSA *rsa); 2011 OPENSSL_EXPORT int SSL_CTX_use_RSAPrivateKey_ASN1(SSL_CTX *ctx, 2012 const uint8_t *d, long len); 2013 OPENSSL_EXPORT int SSL_CTX_use_PrivateKey(SSL_CTX *ctx, EVP_PKEY *pkey); 2014 OPENSSL_EXPORT int SSL_CTX_use_PrivateKey_ASN1(int pk, SSL_CTX *ctx, 2015 const uint8_t *d, long len); 2016 OPENSSL_EXPORT int SSL_CTX_use_certificate(SSL_CTX *ctx, X509 *x); 2017 OPENSSL_EXPORT int SSL_CTX_use_certificate_ASN1(SSL_CTX *ctx, int len, 2018 const uint8_t *d); 2019 2020 OPENSSL_EXPORT void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, 2021 pem_password_cb *cb); 2022 OPENSSL_EXPORT void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx, 2023 void *u); 2024 2025 OPENSSL_EXPORT int SSL_CTX_check_private_key(const SSL_CTX *ctx); 2026 OPENSSL_EXPORT int SSL_check_private_key(const SSL *ctx); 2027 2028 OPENSSL_EXPORT int SSL_CTX_set_session_id_context(SSL_CTX *ctx, 2029 const uint8_t *sid_ctx, 2030 unsigned int sid_ctx_len); 2031 2032 OPENSSL_EXPORT int SSL_set_session_id_context(SSL *ssl, const uint8_t *sid_ctx, 2033 unsigned int sid_ctx_len); 2034 2035 OPENSSL_EXPORT int SSL_CTX_set_purpose(SSL_CTX *s, int purpose); 2036 OPENSSL_EXPORT int SSL_set_purpose(SSL *s, int purpose); 2037 OPENSSL_EXPORT int SSL_CTX_set_trust(SSL_CTX *s, int trust); 2038 OPENSSL_EXPORT int SSL_set_trust(SSL *s, int trust); 2039 2040 OPENSSL_EXPORT int SSL_CTX_set1_param(SSL_CTX *ctx, X509_VERIFY_PARAM *vpm); 2041 OPENSSL_EXPORT int SSL_set1_param(SSL *ssl, X509_VERIFY_PARAM *vpm); 2042 2043 OPENSSL_EXPORT X509_VERIFY_PARAM *SSL_CTX_get0_param(SSL_CTX *ctx); 2044 OPENSSL_EXPORT X509_VERIFY_PARAM *SSL_get0_param(SSL *ssl); 2045 2046 OPENSSL_EXPORT void SSL_certs_clear(SSL *s); 2047 OPENSSL_EXPORT int SSL_accept(SSL *ssl); 2048 OPENSSL_EXPORT int SSL_connect(SSL *ssl); 2049 OPENSSL_EXPORT int SSL_read(SSL *ssl, void *buf, int num); 2050 OPENSSL_EXPORT int SSL_peek(SSL *ssl, void *buf, int num); 2051 OPENSSL_EXPORT int SSL_write(SSL *ssl, const void *buf, int num); 2052 OPENSSL_EXPORT long SSL_ctrl(SSL *ssl, int cmd, long larg, void *parg); 2053 OPENSSL_EXPORT long SSL_CTX_ctrl(SSL_CTX *ctx, int cmd, long larg, void *parg); 2054 2055 OPENSSL_EXPORT int SSL_get_error(const SSL *s, int ret_code); 2056 /* SSL_get_version returns a string describing the TLS version used by |s|. For 2057 * example, "TLSv1.2" or "SSLv3". */ 2058 OPENSSL_EXPORT const char *SSL_get_version(const SSL *s); 2059 /* SSL_SESSION_get_version returns a string describing the TLS version used by 2060 * |sess|. For example, "TLSv1.2" or "SSLv3". */ 2061 OPENSSL_EXPORT const char *SSL_SESSION_get_version(const SSL_SESSION *sess); 2062 2063 OPENSSL_EXPORT STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *s); 2064 2065 OPENSSL_EXPORT int SSL_do_handshake(SSL *s); 2066 2067 /* SSL_renegotiate_pending returns one if |ssl| is in the middle of a 2068 * renegotiation. */ 2069 OPENSSL_EXPORT int SSL_renegotiate_pending(SSL *ssl); 2070 2071 OPENSSL_EXPORT int SSL_shutdown(SSL *s); 2072 2073 OPENSSL_EXPORT const char *SSL_alert_type_string_long(int value); 2074 OPENSSL_EXPORT const char *SSL_alert_type_string(int value); 2075 OPENSSL_EXPORT const char *SSL_alert_desc_string_long(int value); 2076 OPENSSL_EXPORT const char *SSL_alert_desc_string(int value); 2077 2078 OPENSSL_EXPORT void SSL_set_client_CA_list(SSL *s, 2079 STACK_OF(X509_NAME) *name_list); 2080 OPENSSL_EXPORT void SSL_CTX_set_client_CA_list(SSL_CTX *ctx, 2081 STACK_OF(X509_NAME) *name_list); 2082 OPENSSL_EXPORT STACK_OF(X509_NAME) *SSL_get_client_CA_list(const SSL *s); 2083 OPENSSL_EXPORT STACK_OF(X509_NAME) * 2084 SSL_CTX_get_client_CA_list(const SSL_CTX *s); 2085 OPENSSL_EXPORT int SSL_add_client_CA(SSL *ssl, X509 *x); 2086 OPENSSL_EXPORT int SSL_CTX_add_client_CA(SSL_CTX *ctx, X509 *x); 2087 2088 OPENSSL_EXPORT long SSL_get_default_timeout(const SSL *s); 2089 2090 OPENSSL_EXPORT STACK_OF(X509_NAME) *SSL_dup_CA_list(STACK_OF(X509_NAME) *sk); 2091 2092 OPENSSL_EXPORT X509 *SSL_get_certificate(const SSL *ssl); 2093 OPENSSL_EXPORT EVP_PKEY *SSL_get_privatekey(const SSL *ssl); 2094 2095 OPENSSL_EXPORT X509 *SSL_CTX_get0_certificate(const SSL_CTX *ctx); 2096 OPENSSL_EXPORT EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx); 2097 2098 OPENSSL_EXPORT void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode); 2099 OPENSSL_EXPORT int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx); 2100 OPENSSL_EXPORT void SSL_set_quiet_shutdown(SSL *ssl, int mode); 2101 OPENSSL_EXPORT int SSL_get_quiet_shutdown(const SSL *ssl); 2102 OPENSSL_EXPORT void SSL_set_shutdown(SSL *ssl, int mode); 2103 OPENSSL_EXPORT int SSL_get_shutdown(const SSL *ssl); 2104 OPENSSL_EXPORT int SSL_version(const SSL *ssl); 2105 OPENSSL_EXPORT int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx); 2106 OPENSSL_EXPORT int SSL_CTX_load_verify_locations(SSL_CTX *ctx, 2107 const char *CAfile, 2108 const char *CApath); 2109 #define SSL_get0_session SSL_get_session /* just peek at pointer */ 2110 OPENSSL_EXPORT SSL_SESSION *SSL_get_session(const SSL *ssl); 2111 OPENSSL_EXPORT SSL_SESSION *SSL_get1_session( 2112 SSL *ssl); /* obtain a reference count */ 2113 OPENSSL_EXPORT SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl); 2114 OPENSSL_EXPORT SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx); 2115 OPENSSL_EXPORT void SSL_set_info_callback(SSL *ssl, 2116 void (*cb)(const SSL *ssl, int type, 2117 int val)); 2118 OPENSSL_EXPORT void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl, 2119 int type, int val); 2120 OPENSSL_EXPORT int SSL_state(const SSL *ssl); 2121 2122 OPENSSL_EXPORT void SSL_set_verify_result(SSL *ssl, long v); 2123 OPENSSL_EXPORT long SSL_get_verify_result(const SSL *ssl); 2124 2125 OPENSSL_EXPORT int SSL_set_ex_data(SSL *ssl, int idx, void *data); 2126 OPENSSL_EXPORT void *SSL_get_ex_data(const SSL *ssl, int idx); 2127 OPENSSL_EXPORT int SSL_get_ex_new_index(long argl, void *argp, 2128 CRYPTO_EX_new *new_func, 2129 CRYPTO_EX_dup *dup_func, 2130 CRYPTO_EX_free *free_func); 2131 2132 OPENSSL_EXPORT int SSL_SESSION_set_ex_data(SSL_SESSION *ss, int idx, 2133 void *data); 2134 OPENSSL_EXPORT void *SSL_SESSION_get_ex_data(const SSL_SESSION *ss, int idx); 2135 OPENSSL_EXPORT int SSL_SESSION_get_ex_new_index(long argl, void *argp, 2136 CRYPTO_EX_new *new_func, 2137 CRYPTO_EX_dup *dup_func, 2138 CRYPTO_EX_free *free_func); 2139 2140 OPENSSL_EXPORT int SSL_CTX_set_ex_data(SSL_CTX *ssl, int idx, void *data); 2141 OPENSSL_EXPORT void *SSL_CTX_get_ex_data(const SSL_CTX *ssl, int idx); 2142 OPENSSL_EXPORT int SSL_CTX_get_ex_new_index(long argl, void *argp, 2143 CRYPTO_EX_new *new_func, 2144 CRYPTO_EX_dup *dup_func, 2145 CRYPTO_EX_free *free_func); 2146 2147 OPENSSL_EXPORT int SSL_get_ex_data_X509_STORE_CTX_idx(void); 2148 2149 /* SSL_CTX_sess_set_cache_size sets the maximum size of |ctx|'s session cache to 2150 * |size|. It returns the previous value. */ 2151 OPENSSL_EXPORT unsigned long SSL_CTX_sess_set_cache_size(SSL_CTX *ctx, 2152 unsigned long size); 2153 2154 /* SSL_CTX_sess_get_cache_size returns the maximum size of |ctx|'s session 2155 * cache. */ 2156 OPENSSL_EXPORT unsigned long SSL_CTX_sess_get_cache_size(const SSL_CTX *ctx); 2157 2158 /* SSL_SESS_CACHE_* are the possible session cache mode bits. 2159 * TODO(davidben): Document. */ 2160 #define SSL_SESS_CACHE_OFF 0x0000 2161 #define SSL_SESS_CACHE_CLIENT 0x0001 2162 #define SSL_SESS_CACHE_SERVER 0x0002 2163 #define SSL_SESS_CACHE_BOTH (SSL_SESS_CACHE_CLIENT | SSL_SESS_CACHE_SERVER) 2164 #define SSL_SESS_CACHE_NO_AUTO_CLEAR 0x0080 2165 #define SSL_SESS_CACHE_NO_INTERNAL_LOOKUP 0x0100 2166 #define SSL_SESS_CACHE_NO_INTERNAL_STORE 0x0200 2167 #define SSL_SESS_CACHE_NO_INTERNAL \ 2168 (SSL_SESS_CACHE_NO_INTERNAL_LOOKUP | SSL_SESS_CACHE_NO_INTERNAL_STORE) 2169 2170 /* SSL_CTX_set_session_cache_mode sets the session cache mode bits for |ctx| to 2171 * |mode|. It returns the previous value. */ 2172 OPENSSL_EXPORT int SSL_CTX_set_session_cache_mode(SSL_CTX *ctx, int mode); 2173 2174 /* SSL_CTX_get_session_cache_mode returns the session cache mode bits for 2175 * |ctx| */ 2176 OPENSSL_EXPORT int SSL_CTX_get_session_cache_mode(const SSL_CTX *ctx); 2177 2178 /* SSL_CTX_get_max_cert_list returns the maximum length, in bytes, of a peer 2179 * certificate chain accepted by |ctx|. */ 2180 OPENSSL_EXPORT size_t SSL_CTX_get_max_cert_list(const SSL_CTX *ctx); 2181 2182 /* SSL_CTX_set_max_cert_list sets the maximum length, in bytes, of a peer 2183 * certificate chain to |max_cert_list|. This affects how much memory may be 2184 * consumed during the handshake. */ 2185 OPENSSL_EXPORT void SSL_CTX_set_max_cert_list(SSL_CTX *ctx, 2186 size_t max_cert_list); 2187 2188 /* SSL_get_max_cert_list returns the maximum length, in bytes, of a peer 2189 * certificate chain accepted by |ssl|. */ 2190 OPENSSL_EXPORT size_t SSL_get_max_cert_list(const SSL *ssl); 2191 2192 /* SSL_set_max_cert_list sets the maximum length, in bytes, of a peer 2193 * certificate chain to |max_cert_list|. This affects how much memory may be 2194 * consumed during the handshake. */ 2195 OPENSSL_EXPORT void SSL_set_max_cert_list(SSL *ssl, size_t max_cert_list); 2196 2197 /* SSL_CTX_set_max_send_fragment sets the maximum length, in bytes, of records 2198 * sent by |ctx|. Beyond this length, handshake messages and application data 2199 * will be split into multiple records. */ 2200 OPENSSL_EXPORT void SSL_CTX_set_max_send_fragment(SSL_CTX *ctx, 2201 size_t max_send_fragment); 2202 2203 /* SSL_set_max_send_fragment sets the maximum length, in bytes, of records 2204 * sent by |ssl|. Beyond this length, handshake messages and application data 2205 * will be split into multiple records. */ 2206 OPENSSL_EXPORT void SSL_set_max_send_fragment(SSL *ssl, 2207 size_t max_send_fragment); 2208 2209 /* SSL_CTX_set_tmp_dh_callback configures |ctx| to use |callback| to determine 2210 * the group for DHE ciphers. |callback| should ignore |is_export| and 2211 * |keylength| and return a |DH| of the selected group or NULL on error. Only 2212 * the parameters are used, so the |DH| needn't have a generated keypair. 2213 * 2214 * WARNING: The caller does not take ownership of the resulting |DH|, so 2215 * |callback| must save and release the object elsewhere. */ 2216 OPENSSL_EXPORT void SSL_CTX_set_tmp_dh_callback( 2217 SSL_CTX *ctx, DH *(*callback)(SSL *ssl, int is_export, int keylength)); 2218 2219 /* SSL_set_tmp_dh_callback configures |ssl| to use |callback| to determine the 2220 * group for DHE ciphers. |callback| should ignore |is_export| and |keylength| 2221 * and return a |DH| of the selected group or NULL on error. Only the 2222 * parameters are used, so the |DH| needn't have a generated keypair. 2223 * 2224 * WARNING: The caller does not take ownership of the resulting |DH|, so 2225 * |callback| must save and release the object elsewhere. */ 2226 OPENSSL_EXPORT void SSL_set_tmp_dh_callback(SSL *ssl, 2227 DH *(*dh)(SSL *ssl, int is_export, 2228 int keylength)); 2229 2230 /* SSL_CTX_set_tmp_ecdh_callback configures |ctx| to use |callback| to determine 2231 * the curve for ephemeral ECDH keys. |callback| should ignore |is_export| and 2232 * |keylength| and return an |EC_KEY| of the selected curve or NULL on 2233 * error. Only the curve is used, so the |EC_KEY| needn't have a generated 2234 * keypair. 2235 * 2236 * If the callback is unset, an appropriate curve will be chosen automatically. 2237 * (This is recommended.) 2238 * 2239 * WARNING: The caller does not take ownership of the resulting |EC_KEY|, so 2240 * |callback| must save and release the object elsewhere. */ 2241 OPENSSL_EXPORT void SSL_CTX_set_tmp_ecdh_callback( 2242 SSL_CTX *ctx, EC_KEY *(*callback)(SSL *ssl, int is_export, int keylength)); 2243 2244 /* SSL_set_tmp_ecdh_callback configures |ssl| to use |callback| to determine the 2245 * curve for ephemeral ECDH keys. |callback| should ignore |is_export| and 2246 * |keylength| and return an |EC_KEY| of the selected curve or NULL on 2247 * error. Only the curve is used, so the |EC_KEY| needn't have a generated 2248 * keypair. 2249 * 2250 * If the callback is unset, an appropriate curve will be chosen automatically. 2251 * (This is recommended.) 2252 * 2253 * WARNING: The caller does not take ownership of the resulting |EC_KEY|, so 2254 * |callback| must save and release the object elsewhere. */ 2255 OPENSSL_EXPORT void SSL_set_tmp_ecdh_callback( 2256 SSL *ssl, EC_KEY *(*callback)(SSL *ssl, int is_export, int keylength)); 2257 2258 OPENSSL_EXPORT const void *SSL_get_current_compression(SSL *s); 2259 OPENSSL_EXPORT const void *SSL_get_current_expansion(SSL *s); 2260 2261 OPENSSL_EXPORT int SSL_cache_hit(SSL *s); 2262 OPENSSL_EXPORT int SSL_is_server(SSL *s); 2263 2264 /* SSL_CTX_set_dos_protection_cb sets a callback that is called once the 2265 * resumption decision for a ClientHello has been made. It can return 1 to 2266 * allow the handshake to continue or zero to cause the handshake to abort. */ 2267 OPENSSL_EXPORT void SSL_CTX_set_dos_protection_cb( 2268 SSL_CTX *ctx, int (*cb)(const struct ssl_early_callback_ctx *)); 2269 2270 /* SSL_get_structure_sizes returns the sizes of the SSL, SSL_CTX and 2271 * SSL_SESSION structures so that a test can ensure that outside code agrees on 2272 * these values. */ 2273 OPENSSL_EXPORT void SSL_get_structure_sizes(size_t *ssl_size, 2274 size_t *ssl_ctx_size, 2275 size_t *ssl_session_size); 2276 2277 OPENSSL_EXPORT void ERR_load_SSL_strings(void); 2278 2279 /* SSL_get_rc4_state sets |*read_key| and |*write_key| to the RC4 states for 2280 * the read and write directions. It returns one on success or zero if |ssl| 2281 * isn't using an RC4-based cipher suite. */ 2282 OPENSSL_EXPORT int SSL_get_rc4_state(const SSL *ssl, const RC4_KEY **read_key, 2283 const RC4_KEY **write_key); 2284 2285 2286 /* Deprecated functions. */ 2287 2288 /* SSL_CIPHER_description writes a description of |cipher| into |buf| and 2289 * returns |buf|. If |buf| is NULL, it returns a newly allocated string, to be 2290 * freed with |OPENSSL_free|, or NULL on error. 2291 * 2292 * The description includes a trailing newline and has the form: 2293 * AES128-SHA SSLv3 Kx=RSA Au=RSA Enc=AES(128) Mac=SHA1 2294 * 2295 * Consider |SSL_CIPHER_get_name| or |SSL_CIPHER_get_rfc_name| instead. */ 2296 OPENSSL_EXPORT const char *SSL_CIPHER_description(const SSL_CIPHER *cipher, 2297 char *buf, int len); 2298 2299 /* SSL_CIPHER_get_version returns the string "TLSv1/SSLv3". */ 2300 OPENSSL_EXPORT const char *SSL_CIPHER_get_version(const SSL_CIPHER *cipher); 2301 2302 /* SSL_COMP_get_compression_methods returns NULL. */ 2303 OPENSSL_EXPORT void *SSL_COMP_get_compression_methods(void); 2304 2305 /* SSL_COMP_add_compression_method returns one. */ 2306 OPENSSL_EXPORT int SSL_COMP_add_compression_method(int id, void *cm); 2307 2308 /* SSL_COMP_get_name returns NULL. */ 2309 OPENSSL_EXPORT const char *SSL_COMP_get_name(const void *comp); 2310 2311 /* SSLv23_method calls |TLS_method|. */ 2312 OPENSSL_EXPORT const SSL_METHOD *SSLv23_method(void); 2313 2314 /* Version-specific methods behave exactly like |TLS_method| and |DTLS_method| 2315 * except they also call |SSL_CTX_set_min_version| and |SSL_CTX_set_max_version| 2316 * to lock connections to that protocol version. */ 2317 OPENSSL_EXPORT const SSL_METHOD *SSLv3_method(void); 2318 OPENSSL_EXPORT const SSL_METHOD *TLSv1_method(void); 2319 OPENSSL_EXPORT const SSL_METHOD *TLSv1_1_method(void); 2320 OPENSSL_EXPORT const SSL_METHOD *TLSv1_2_method(void); 2321 OPENSSL_EXPORT const SSL_METHOD *DTLSv1_method(void); 2322 OPENSSL_EXPORT const SSL_METHOD *DTLSv1_2_method(void); 2323 2324 /* Client- and server-specific methods call their corresponding generic 2325 * methods. */ 2326 OPENSSL_EXPORT const SSL_METHOD *SSLv23_server_method(void); 2327 OPENSSL_EXPORT const SSL_METHOD *SSLv23_client_method(void); 2328 OPENSSL_EXPORT const SSL_METHOD *SSLv3_server_method(void); 2329 OPENSSL_EXPORT const SSL_METHOD *SSLv3_client_method(void); 2330 OPENSSL_EXPORT const SSL_METHOD *TLSv1_server_method(void); 2331 OPENSSL_EXPORT const SSL_METHOD *TLSv1_client_method(void); 2332 OPENSSL_EXPORT const SSL_METHOD *TLSv1_1_server_method(void); 2333 OPENSSL_EXPORT const SSL_METHOD *TLSv1_1_client_method(void); 2334 OPENSSL_EXPORT const SSL_METHOD *TLSv1_2_server_method(void); 2335 OPENSSL_EXPORT const SSL_METHOD *TLSv1_2_client_method(void); 2336 OPENSSL_EXPORT const SSL_METHOD *DTLS_server_method(void); 2337 OPENSSL_EXPORT const SSL_METHOD *DTLS_client_method(void); 2338 OPENSSL_EXPORT const SSL_METHOD *DTLSv1_server_method(void); 2339 OPENSSL_EXPORT const SSL_METHOD *DTLSv1_client_method(void); 2340 OPENSSL_EXPORT const SSL_METHOD *DTLSv1_2_server_method(void); 2341 OPENSSL_EXPORT const SSL_METHOD *DTLSv1_2_client_method(void); 2342 2343 /* SSL_clear resets |ssl| to allow another connection and returns one on success 2344 * or zero on failure. It returns most configuration state but releases memory 2345 * associated with the current connection. 2346 * 2347 * Free |ssl| and create a new one instead. */ 2348 OPENSSL_EXPORT int SSL_clear(SSL *ssl); 2349 2350 /* SSL_CTX_set_tmp_rsa_callback does nothing. */ 2351 OPENSSL_EXPORT void SSL_CTX_set_tmp_rsa_callback( 2352 SSL_CTX *ctx, RSA *(*cb)(SSL *ssl, int is_export, int keylength)); 2353 2354 /* SSL_set_tmp_rsa_callback does nothing. */ 2355 OPENSSL_EXPORT void SSL_set_tmp_rsa_callback(SSL *ssl, 2356 RSA *(*cb)(SSL *ssl, int is_export, 2357 int keylength)); 2358 2359 /* SSL_CTX_sess_connect returns zero. */ 2360 OPENSSL_EXPORT int SSL_CTX_sess_connect(const SSL_CTX *ctx); 2361 2362 /* SSL_CTX_sess_connect_good returns zero. */ 2363 OPENSSL_EXPORT int SSL_CTX_sess_connect_good(const SSL_CTX *ctx); 2364 2365 /* SSL_CTX_sess_connect_renegotiate returns zero. */ 2366 OPENSSL_EXPORT int SSL_CTX_sess_connect_renegotiate(const SSL_CTX *ctx); 2367 2368 /* SSL_CTX_sess_accept returns zero. */ 2369 OPENSSL_EXPORT int SSL_CTX_sess_accept(const SSL_CTX *ctx); 2370 2371 /* SSL_CTX_sess_accept_renegotiate returns zero. */ 2372 OPENSSL_EXPORT int SSL_CTX_sess_accept_renegotiate(const SSL_CTX *ctx); 2373 2374 /* SSL_CTX_sess_accept_good returns zero. */ 2375 OPENSSL_EXPORT int SSL_CTX_sess_accept_good(const SSL_CTX *ctx); 2376 2377 /* SSL_CTX_sess_hits returns zero. */ 2378 OPENSSL_EXPORT int SSL_CTX_sess_hits(const SSL_CTX *ctx); 2379 2380 /* SSL_CTX_sess_cb_hits returns zero. */ 2381 OPENSSL_EXPORT int SSL_CTX_sess_cb_hits(const SSL_CTX *ctx); 2382 2383 /* SSL_CTX_sess_misses returns zero. */ 2384 OPENSSL_EXPORT int SSL_CTX_sess_misses(const SSL_CTX *ctx); 2385 2386 /* SSL_CTX_sess_timeouts returns zero. */ 2387 OPENSSL_EXPORT int SSL_CTX_sess_timeouts(const SSL_CTX *ctx); 2388 2389 /* SSL_CTX_sess_cache_full returns zero. */ 2390 OPENSSL_EXPORT int SSL_CTX_sess_cache_full(const SSL_CTX *ctx); 2391 2392 /* SSL_cutthrough_complete calls |SSL_in_false_start|. */ 2393 OPENSSL_EXPORT int SSL_cutthrough_complete(const SSL *s); 2394 2395 /* SSL_num_renegotiations calls |SSL_total_renegotiations|. */ 2396 OPENSSL_EXPORT int SSL_num_renegotiations(const SSL *ssl); 2397 2398 /* SSL_CTX_need_tmp_RSA returns zero. */ 2399 OPENSSL_EXPORT int SSL_CTX_need_tmp_RSA(const SSL_CTX *ctx); 2400 2401 /* SSL_need_tmp_RSA returns zero. */ 2402 OPENSSL_EXPORT int SSL_need_tmp_RSA(const SSL *ssl); 2403 2404 /* SSL_CTX_set_tmp_rsa returns one. */ 2405 OPENSSL_EXPORT int SSL_CTX_set_tmp_rsa(SSL_CTX *ctx, const RSA *rsa); 2406 2407 /* SSL_set_tmp_rsa returns one. */ 2408 OPENSSL_EXPORT int SSL_set_tmp_rsa(SSL *ssl, const RSA *rsa); 2409 2410 /* SSL_CTX_get_read_head returns zero. */ 2411 OPENSSL_EXPORT int SSL_CTX_get_read_ahead(const SSL_CTX *ctx); 2412 2413 /* SSL_CTX_set_read_ahead does nothing. */ 2414 OPENSSL_EXPORT void SSL_CTX_set_read_ahead(SSL_CTX *ctx, int yes); 2415 2416 /* SSL_get_read_head returns zero. */ 2417 OPENSSL_EXPORT int SSL_get_read_ahead(const SSL *s); 2418 2419 /* SSL_set_read_ahead does nothing. */ 2420 OPENSSL_EXPORT void SSL_set_read_ahead(SSL *s, int yes); 2421 2422 /* SSL_renegotiate put an error on the error queue and returns zero. */ 2423 OPENSSL_EXPORT int SSL_renegotiate(SSL *ssl); 2424 2425 /* SSL_set_state does nothing. */ 2426 OPENSSL_EXPORT void SSL_set_state(SSL *ssl, int state); 2427 2428 2429 /* Android compatibility section. 2430 * 2431 * These functions are declared, temporarily, for Android because 2432 * wpa_supplicant will take a little time to sync with upstream. Outside of 2433 * Android they'll have no definition. */ 2434 2435 #define SSL_F_SSL_SET_SESSION_TICKET_EXT doesnt_exist 2436 2437 OPENSSL_EXPORT int SSL_set_session_ticket_ext(SSL *s, void *ext_data, 2438 int ext_len); 2439 OPENSSL_EXPORT int SSL_set_session_secret_cb(SSL *s, void *cb, void *arg); 2440 OPENSSL_EXPORT int SSL_set_session_ticket_ext_cb(SSL *s, void *cb, void *arg); 2441 OPENSSL_EXPORT int SSL_set_ssl_method(SSL *s, const SSL_METHOD *method); 2442 2443 #define OPENSSL_VERSION_TEXT "BoringSSL" 2444 2445 #define SSLEAY_VERSION 0 2446 2447 /* SSLeay_version is a compatibility function that returns the string 2448 * "BoringSSL". */ 2449 OPENSSL_EXPORT const char *SSLeay_version(int unused); 2450 2451 2452 /* Preprocessor compatibility section. 2453 * 2454 * Historically, a number of APIs were implemented in OpenSSL as macros and 2455 * constants to 'ctrl' functions. To avoid breaking #ifdefs in consumers, this 2456 * section defines a number of legacy macros. */ 2457 2458 #define SSL_CTRL_NEED_TMP_RSA doesnt_exist 2459 #define SSL_CTRL_SET_TMP_RSA doesnt_exist 2460 #define SSL_CTRL_SET_TMP_DH doesnt_exist 2461 #define SSL_CTRL_SET_TMP_ECDH doesnt_exist 2462 #define SSL_CTRL_SET_TMP_RSA_CB doesnt_exist 2463 #define SSL_CTRL_SET_TMP_DH_CB doesnt_exist 2464 #define SSL_CTRL_SET_TMP_ECDH_CB doesnt_exist 2465 #define SSL_CTRL_GET_SESSION_REUSED doesnt_exist 2466 #define SSL_CTRL_GET_NUM_RENEGOTIATIONS doesnt_exist 2467 #define SSL_CTRL_GET_TOTAL_RENEGOTIATIONS doesnt_exist 2468 #define SSL_CTRL_SET_MSG_CALLBACK doesnt_exist 2469 #define SSL_CTRL_SET_MSG_CALLBACK_ARG doesnt_exist 2470 #define SSL_CTRL_SET_MTU doesnt_exist 2471 #define SSL_CTRL_SESS_NUMBER doesnt_exist 2472 #define SSL_CTRL_OPTIONS doesnt_exist 2473 #define SSL_CTRL_MODE doesnt_exist 2474 #define SSL_CTRL_GET_READ_AHEAD doesnt_exist 2475 #define SSL_CTRL_SET_READ_AHEAD doesnt_exist 2476 #define SSL_CTRL_SET_SESS_CACHE_SIZE doesnt_exist 2477 #define SSL_CTRL_GET_SESS_CACHE_SIZE doesnt_exist 2478 #define SSL_CTRL_SET_SESS_CACHE_MODE doesnt_exist 2479 #define SSL_CTRL_GET_SESS_CACHE_MODE doesnt_exist 2480 #define SSL_CTRL_GET_MAX_CERT_LIST doesnt_exist 2481 #define SSL_CTRL_SET_MAX_CERT_LIST doesnt_exist 2482 #define SSL_CTRL_SET_MAX_SEND_FRAGMENT doesnt_exist 2483 #define SSL_CTRL_SET_TLSEXT_SERVERNAME_CB doesnt_exist 2484 #define SSL_CTRL_SET_TLSEXT_SERVERNAME_ARG doesnt_exist 2485 #define SSL_CTRL_SET_TLSEXT_HOSTNAME doesnt_exist 2486 #define SSL_CTRL_SET_TLSEXT_TICKET_KEY_CB doesnt_exist 2487 #define DTLS_CTRL_GET_TIMEOUT doesnt_exist 2488 #define DTLS_CTRL_HANDLE_TIMEOUT doesnt_exist 2489 #define SSL_CTRL_GET_RI_SUPPORT doesnt_exist 2490 #define SSL_CTRL_CLEAR_OPTIONS doesnt_exist 2491 #define SSL_CTRL_CLEAR_MODE doesnt_exist 2492 #define SSL_CTRL_CHANNEL_ID doesnt_exist 2493 #define SSL_CTRL_GET_CHANNEL_ID doesnt_exist 2494 #define SSL_CTRL_SET_CHANNEL_ID doesnt_exist 2495 2496 #define SSL_CTX_need_tmp_RSA SSL_CTX_need_tmp_RSA 2497 #define SSL_need_tmp_RSA SSL_need_tmp_RSA 2498 #define SSL_CTX_set_tmp_rsa SSL_CTX_set_tmp_rsa 2499 #define SSL_set_tmp_rsa SSL_set_tmp_rsa 2500 #define SSL_CTX_set_tmp_dh SSL_CTX_set_tmp_dh 2501 #define SSL_set_tmp_dh SSL_set_tmp_dh 2502 #define SSL_CTX_set_tmp_ecdh SSL_CTX_set_tmp_ecdh 2503 #define SSL_set_tmp_ecdh SSL_set_tmp_ecdh 2504 #define SSL_session_reused SSL_session_reused 2505 #define SSL_num_renegotiations SSL_num_renegotiations 2506 #define SSL_total_renegotiations SSL_total_renegotiations 2507 #define SSL_CTX_set_msg_callback_arg SSL_CTX_set_msg_callback_arg 2508 #define SSL_set_msg_callback_arg SSL_set_msg_callback_arg 2509 #define SSL_set_mtu SSL_set_mtu 2510 #define SSL_CTX_sess_number SSL_CTX_sess_number 2511 #define SSL_CTX_get_options SSL_CTX_get_options 2512 #define SSL_CTX_set_options SSL_CTX_set_options 2513 #define SSL_get_options SSL_get_options 2514 #define SSL_set_options SSL_set_options 2515 #define SSL_CTX_get_mode SSL_CTX_get_mode 2516 #define SSL_CTX_set_mode SSL_CTX_set_mode 2517 #define SSL_get_mode SSL_get_mode 2518 #define SSL_set_mode SSL_set_mode 2519 #define SSL_CTX_get_read_ahead SSL_CTX_get_read_ahead 2520 #define SSL_CTX_set_read_ahead SSL_CTX_set_read_ahead 2521 #define SSL_CTX_sess_set_cache_size SSL_CTX_sess_set_cache_size 2522 #define SSL_CTX_sess_get_cache_size SSL_CTX_sess_get_cache_size 2523 #define SSL_CTX_set_session_cache_mode SSL_CTX_set_session_cache_mode 2524 #define SSL_CTX_get_session_cache_mode SSL_CTX_get_session_cache_mode 2525 #define SSL_CTX_get_max_cert_list SSL_CTX_get_max_cert_list 2526 #define SSL_get_max_cert_list SSL_get_max_cert_list 2527 #define SSL_CTX_set_max_cert_list SSL_CTX_set_max_cert_list 2528 #define SSL_set_max_cert_list SSL_set_max_cert_list 2529 #define SSL_CTX_set_max_send_fragment SSL_CTX_set_max_send_fragment 2530 #define SSL_set_max_send_fragment SSL_set_max_send_fragment 2531 #define SSL_CTX_set_tlsext_servername_callback \ 2532 SSL_CTX_set_tlsext_servername_callback 2533 #define SSL_CTX_set_tlsext_servername_arg SSL_CTX_set_tlsext_servername_arg 2534 #define SSL_set_tlsext_host_name SSL_set_tlsext_host_name 2535 #define SSL_CTX_set_tlsext_ticket_key_cb SSL_CTX_set_tlsext_ticket_key_cb 2536 #define DTLSv1_get_timeout DTLSv1_get_timeout 2537 #define DTLSv1_handle_timeout DTLSv1_handle_timeout 2538 #define SSL_get_secure_renegotiation_support \ 2539 SSL_get_secure_renegotiation_support 2540 #define SSL_CTX_clear_options SSL_CTX_clear_options 2541 #define SSL_clear_options SSL_clear_options 2542 #define SSL_CTX_clear_mode SSL_CTX_clear_mode 2543 #define SSL_clear_mode SSL_clear_mode 2544 #define SSL_CTX_enable_tls_channel_id SSL_CTX_enable_tls_channel_id 2545 #define SSL_enable_tls_channel_id SSL_enable_tls_channel_id 2546 #define SSL_set1_tls_channel_id SSL_set1_tls_channel_id 2547 #define SSL_CTX_set1_tls_channel_id SSL_CTX_set1_tls_channel_id 2548 #define SSL_get_tls_channel_id SSL_get_tls_channel_id 2549 2550 2551 #if defined(__cplusplus) 2552 } /* extern C */ 2553 #endif 2554 2555 2556 /* Library consumers assume these headers are included by ssl.h, but they depend 2557 * on ssl.h, so include them after all declarations. 2558 * 2559 * TODO(davidben): The separation between ssl.h and these version-specific 2560 * headers introduces circular dependencies and is inconsistent. The function 2561 * declarations should move to ssl.h. Many of the constants can probably be 2562 * pruned or unexported. */ 2563 #include <openssl/ssl2.h> 2564 #include <openssl/ssl3.h> 2565 #include <openssl/tls1.h> /* This is mostly sslv3 with a few tweaks */ 2566 #include <openssl/ssl23.h> 2567 #include <openssl/srtp.h> /* Support for the use_srtp extension */ 2568 2569 2570 /* BEGIN ERROR CODES */ 2571 /* The following lines are auto generated by the script make_errors.go. Any 2572 * changes made after this point may be overwritten when the script is next run. 2573 */ 2574 #define SSL_F_SSL_CTX_check_private_key 100 2575 #define SSL_F_SSL_CTX_new 101 2576 #define SSL_F_SSL_CTX_set_cipher_list 102 2577 #define SSL_F_SSL_CTX_set_cipher_list_tls11 103 2578 #define SSL_F_SSL_CTX_set_session_id_context 104 2579 #define SSL_F_SSL_CTX_use_PrivateKey 105 2580 #define SSL_F_SSL_CTX_use_PrivateKey_ASN1 106 2581 #define SSL_F_SSL_CTX_use_PrivateKey_file 107 2582 #define SSL_F_SSL_CTX_use_RSAPrivateKey 108 2583 #define SSL_F_SSL_CTX_use_RSAPrivateKey_ASN1 109 2584 #define SSL_F_SSL_CTX_use_RSAPrivateKey_file 110 2585 #define SSL_F_SSL_CTX_use_certificate 111 2586 #define SSL_F_SSL_CTX_use_certificate_ASN1 112 2587 #define SSL_F_SSL_CTX_use_certificate_chain_file 113 2588 #define SSL_F_SSL_CTX_use_certificate_file 114 2589 #define SSL_F_SSL_CTX_use_psk_identity_hint 115 2590 #define SSL_F_SSL_SESSION_new 116 2591 #define SSL_F_SSL_SESSION_print_fp 117 2592 #define SSL_F_SSL_SESSION_set1_id_context 118 2593 #define SSL_F_SSL_SESSION_to_bytes_full 119 2594 #define SSL_F_SSL_accept 120 2595 #define SSL_F_SSL_add_dir_cert_subjects_to_stack 121 2596 #define SSL_F_SSL_add_file_cert_subjects_to_stack 122 2597 #define SSL_F_SSL_check_private_key 123 2598 #define SSL_F_SSL_clear 124 2599 #define SSL_F_SSL_connect 125 2600 #define SSL_F_SSL_do_handshake 126 2601 #define SSL_F_SSL_load_client_CA_file 127 2602 #define SSL_F_SSL_new 128 2603 #define SSL_F_SSL_peek 129 2604 #define SSL_F_SSL_read 130 2605 #define SSL_F_SSL_renegotiate 131 2606 #define SSL_F_SSL_set_cipher_list 132 2607 #define SSL_F_SSL_set_fd 133 2608 #define SSL_F_SSL_set_rfd 134 2609 #define SSL_F_SSL_set_session_id_context 135 2610 #define SSL_F_SSL_set_wfd 136 2611 #define SSL_F_SSL_shutdown 137 2612 #define SSL_F_SSL_use_PrivateKey 138 2613 #define SSL_F_SSL_use_PrivateKey_ASN1 139 2614 #define SSL_F_SSL_use_PrivateKey_file 140 2615 #define SSL_F_SSL_use_RSAPrivateKey 141 2616 #define SSL_F_SSL_use_RSAPrivateKey_ASN1 142 2617 #define SSL_F_SSL_use_RSAPrivateKey_file 143 2618 #define SSL_F_SSL_use_certificate 144 2619 #define SSL_F_SSL_use_certificate_ASN1 145 2620 #define SSL_F_SSL_use_certificate_file 146 2621 #define SSL_F_SSL_use_psk_identity_hint 147 2622 #define SSL_F_SSL_write 148 2623 #define SSL_F_d2i_SSL_SESSION 149 2624 #define SSL_F_d2i_SSL_SESSION_get_octet_string 150 2625 #define SSL_F_d2i_SSL_SESSION_get_string 151 2626 #define SSL_F_do_ssl3_write 152 2627 #define SSL_F_dtls1_accept 153 2628 #define SSL_F_dtls1_buffer_record 154 2629 #define SSL_F_dtls1_check_timeout_num 155 2630 #define SSL_F_dtls1_connect 156 2631 #define SSL_F_dtls1_do_write 157 2632 #define SSL_F_dtls1_get_hello_verify 158 2633 #define SSL_F_dtls1_get_message 159 2634 #define SSL_F_dtls1_get_message_fragment 160 2635 #define SSL_F_dtls1_preprocess_fragment 161 2636 #define SSL_F_dtls1_process_record 162 2637 #define SSL_F_dtls1_read_bytes 163 2638 #define SSL_F_dtls1_send_hello_verify_request 164 2639 #define SSL_F_dtls1_write_app_data 165 2640 #define SSL_F_i2d_SSL_SESSION 166 2641 #define SSL_F_ssl3_accept 167 2642 #define SSL_F_ssl3_cert_verify_hash 169 2643 #define SSL_F_ssl3_check_cert_and_algorithm 170 2644 #define SSL_F_ssl3_connect 171 2645 #define SSL_F_ssl3_ctrl 172 2646 #define SSL_F_ssl3_ctx_ctrl 173 2647 #define SSL_F_ssl3_digest_cached_records 174 2648 #define SSL_F_ssl3_do_change_cipher_spec 175 2649 #define SSL_F_ssl3_expect_change_cipher_spec 176 2650 #define SSL_F_ssl3_get_cert_status 177 2651 #define SSL_F_ssl3_get_cert_verify 178 2652 #define SSL_F_ssl3_get_certificate_request 179 2653 #define SSL_F_ssl3_get_channel_id 180 2654 #define SSL_F_ssl3_get_client_certificate 181 2655 #define SSL_F_ssl3_get_client_hello 182 2656 #define SSL_F_ssl3_get_client_key_exchange 183 2657 #define SSL_F_ssl3_get_finished 184 2658 #define SSL_F_ssl3_get_initial_bytes 185 2659 #define SSL_F_ssl3_get_message 186 2660 #define SSL_F_ssl3_get_new_session_ticket 187 2661 #define SSL_F_ssl3_get_next_proto 188 2662 #define SSL_F_ssl3_get_record 189 2663 #define SSL_F_ssl3_get_server_certificate 190 2664 #define SSL_F_ssl3_get_server_done 191 2665 #define SSL_F_ssl3_get_server_hello 192 2666 #define SSL_F_ssl3_get_server_key_exchange 193 2667 #define SSL_F_ssl3_get_v2_client_hello 194 2668 #define SSL_F_ssl3_handshake_mac 195 2669 #define SSL_F_ssl3_prf 196 2670 #define SSL_F_ssl3_read_bytes 197 2671 #define SSL_F_ssl3_read_n 198 2672 #define SSL_F_ssl3_send_cert_verify 199 2673 #define SSL_F_ssl3_send_certificate_request 200 2674 #define SSL_F_ssl3_send_channel_id 201 2675 #define SSL_F_ssl3_send_client_certificate 202 2676 #define SSL_F_ssl3_send_client_hello 203 2677 #define SSL_F_ssl3_send_client_key_exchange 204 2678 #define SSL_F_ssl3_send_server_certificate 205 2679 #define SSL_F_ssl3_send_server_hello 206 2680 #define SSL_F_ssl3_send_server_key_exchange 207 2681 #define SSL_F_ssl3_setup_read_buffer 208 2682 #define SSL_F_ssl3_setup_write_buffer 209 2683 #define SSL_F_ssl3_write_bytes 210 2684 #define SSL_F_ssl3_write_pending 211 2685 #define SSL_F_ssl_add_cert_chain 212 2686 #define SSL_F_ssl_add_cert_to_buf 213 2687 #define SSL_F_ssl_add_clienthello_renegotiate_ext 214 2688 #define SSL_F_ssl_add_clienthello_tlsext 215 2689 #define SSL_F_ssl_add_clienthello_use_srtp_ext 216 2690 #define SSL_F_ssl_add_serverhello_renegotiate_ext 217 2691 #define SSL_F_ssl_add_serverhello_tlsext 218 2692 #define SSL_F_ssl_add_serverhello_use_srtp_ext 219 2693 #define SSL_F_ssl_build_cert_chain 220 2694 #define SSL_F_ssl_bytes_to_cipher_list 221 2695 #define SSL_F_ssl_cert_dup 222 2696 #define SSL_F_ssl_cert_inst 223 2697 #define SSL_F_ssl_cert_new 224 2698 #define SSL_F_ssl_check_serverhello_tlsext 225 2699 #define SSL_F_ssl_check_srvr_ecc_cert_and_alg 226 2700 #define SSL_F_ssl_cipher_process_rulestr 227 2701 #define SSL_F_ssl_cipher_strength_sort 228 2702 #define SSL_F_ssl_create_cipher_list 229 2703 #define SSL_F_ssl_ctx_log_master_secret 230 2704 #define SSL_F_ssl_ctx_log_rsa_client_key_exchange 231 2705 #define SSL_F_ssl_ctx_make_profiles 232 2706 #define SSL_F_ssl_get_new_session 233 2707 #define SSL_F_ssl_get_prev_session 234 2708 #define SSL_F_ssl_get_server_cert_index 235 2709 #define SSL_F_ssl_get_sign_pkey 236 2710 #define SSL_F_ssl_init_wbio_buffer 237 2711 #define SSL_F_ssl_parse_clienthello_renegotiate_ext 238 2712 #define SSL_F_ssl_parse_clienthello_tlsext 239 2713 #define SSL_F_ssl_parse_clienthello_use_srtp_ext 240 2714 #define SSL_F_ssl_parse_serverhello_renegotiate_ext 241 2715 #define SSL_F_ssl_parse_serverhello_tlsext 242 2716 #define SSL_F_ssl_parse_serverhello_use_srtp_ext 243 2717 #define SSL_F_ssl_scan_clienthello_tlsext 244 2718 #define SSL_F_ssl_scan_serverhello_tlsext 245 2719 #define SSL_F_ssl_sess_cert_new 246 2720 #define SSL_F_ssl_set_cert 247 2721 #define SSL_F_ssl_set_pkey 248 2722 #define SSL_F_ssl_verify_cert_chain 252 2723 #define SSL_F_tls12_check_peer_sigalg 253 2724 #define SSL_F_tls1_aead_ctx_init 254 2725 #define SSL_F_tls1_cert_verify_mac 255 2726 #define SSL_F_tls1_change_cipher_state 256 2727 #define SSL_F_tls1_change_cipher_state_aead 257 2728 #define SSL_F_tls1_check_duplicate_extensions 258 2729 #define SSL_F_tls1_enc 259 2730 #define SSL_F_tls1_export_keying_material 260 2731 #define SSL_F_tls1_prf 261 2732 #define SSL_F_tls1_setup_key_block 262 2733 #define SSL_F_dtls1_get_buffered_message 263 2734 #define SSL_F_dtls1_process_fragment 264 2735 #define SSL_F_dtls1_hm_fragment_new 265 2736 #define SSL_F_ssl3_seal_record 266 2737 #define SSL_F_ssl3_record_sequence_update 267 2738 #define SSL_F_SSL_CTX_set_tmp_dh 268 2739 #define SSL_F_SSL_CTX_set_tmp_ecdh 269 2740 #define SSL_F_SSL_set_tmp_dh 270 2741 #define SSL_F_SSL_set_tmp_ecdh 271 2742 #define SSL_F_SSL_CTX_set1_tls_channel_id 272 2743 #define SSL_F_SSL_set1_tls_channel_id 273 2744 #define SSL_F_SSL_set_tlsext_host_name 274 2745 #define SSL_F_ssl3_output_cert_chain 275 2746 #define SSL_F_SSL_AEAD_CTX_new 276 2747 #define SSL_F_SSL_AEAD_CTX_open 277 2748 #define SSL_F_SSL_AEAD_CTX_seal 278 2749 #define SSL_F_dtls1_seal_record 279 2750 #define SSL_R_APP_DATA_IN_HANDSHAKE 100 2751 #define SSL_R_ATTEMPT_TO_REUSE_SESSION_IN_DIFFERENT_CONTEXT 101 2752 #define SSL_R_BAD_ALERT 102 2753 #define SSL_R_BAD_CHANGE_CIPHER_SPEC 103 2754 #define SSL_R_BAD_DATA_RETURNED_BY_CALLBACK 104 2755 #define SSL_R_BAD_DH_P_LENGTH 105 2756 #define SSL_R_BAD_DIGEST_LENGTH 106 2757 #define SSL_R_BAD_ECC_CERT 107 2758 #define SSL_R_BAD_ECPOINT 108 2759 #define SSL_R_BAD_HANDSHAKE_LENGTH 109 2760 #define SSL_R_BAD_HANDSHAKE_RECORD 110 2761 #define SSL_R_BAD_HELLO_REQUEST 111 2762 #define SSL_R_BAD_LENGTH 112 2763 #define SSL_R_BAD_PACKET_LENGTH 113 2764 #define SSL_R_BAD_RSA_ENCRYPT 114 2765 #define SSL_R_BAD_SIGNATURE 115 2766 #define SSL_R_BAD_SRTP_MKI_VALUE 116 2767 #define SSL_R_BAD_SRTP_PROTECTION_PROFILE_LIST 117 2768 #define SSL_R_BAD_SSL_FILETYPE 118 2769 #define SSL_R_BAD_WRITE_RETRY 119 2770 #define SSL_R_BIO_NOT_SET 120 2771 #define SSL_R_BN_LIB 121 2772 #define SSL_R_CANNOT_SERIALIZE_PUBLIC_KEY 122 2773 #define SSL_R_CA_DN_LENGTH_MISMATCH 123 2774 #define SSL_R_CA_DN_TOO_LONG 124 2775 #define SSL_R_CCS_RECEIVED_EARLY 125 2776 #define SSL_R_CERTIFICATE_VERIFY_FAILED 126 2777 #define SSL_R_CERT_CB_ERROR 127 2778 #define SSL_R_CERT_LENGTH_MISMATCH 128 2779 #define SSL_R_CHANNEL_ID_NOT_P256 129 2780 #define SSL_R_CHANNEL_ID_SIGNATURE_INVALID 130 2781 #define SSL_R_CIPHER_CODE_WRONG_LENGTH 131 2782 #define SSL_R_CIPHER_OR_HASH_UNAVAILABLE 132 2783 #define SSL_R_CLIENTHELLO_PARSE_FAILED 133 2784 #define SSL_R_CLIENTHELLO_TLSEXT 134 2785 #define SSL_R_CONNECTION_REJECTED 135 2786 #define SSL_R_CONNECTION_TYPE_NOT_SET 136 2787 #define SSL_R_COOKIE_MISMATCH 137 2788 #define SSL_R_D2I_ECDSA_SIG 138 2789 #define SSL_R_DATA_BETWEEN_CCS_AND_FINISHED 139 2790 #define SSL_R_DATA_LENGTH_TOO_LONG 140 2791 #define SSL_R_DECODE_ERROR 141 2792 #define SSL_R_DECRYPTION_FAILED 142 2793 #define SSL_R_DECRYPTION_FAILED_OR_BAD_RECORD_MAC 143 2794 #define SSL_R_DH_PUBLIC_VALUE_LENGTH_IS_WRONG 144 2795 #define SSL_R_DIGEST_CHECK_FAILED 145 2796 #define SSL_R_DTLS_MESSAGE_TOO_BIG 146 2797 #define SSL_R_ECC_CERT_NOT_FOR_SIGNING 147 2798 #define SSL_R_EMPTY_SRTP_PROTECTION_PROFILE_LIST 148 2799 #define SSL_R_ENCRYPTED_LENGTH_TOO_LONG 149 2800 #define SSL_R_ERROR_IN_RECEIVED_CIPHER_LIST 150 2801 #define SSL_R_EVP_DIGESTSIGNFINAL_FAILED 151 2802 #define SSL_R_EVP_DIGESTSIGNINIT_FAILED 152 2803 #define SSL_R_EXCESSIVE_MESSAGE_SIZE 153 2804 #define SSL_R_EXTRA_DATA_IN_MESSAGE 154 2805 #define SSL_R_GOT_A_FIN_BEFORE_A_CCS 155 2806 #define SSL_R_GOT_CHANNEL_ID_BEFORE_A_CCS 156 2807 #define SSL_R_GOT_NEXT_PROTO_BEFORE_A_CCS 157 2808 #define SSL_R_GOT_NEXT_PROTO_WITHOUT_EXTENSION 158 2809 #define SSL_R_HANDSHAKE_FAILURE_ON_CLIENT_HELLO 159 2810 #define SSL_R_HANDSHAKE_RECORD_BEFORE_CCS 160 2811 #define SSL_R_HTTPS_PROXY_REQUEST 161 2812 #define SSL_R_HTTP_REQUEST 162 2813 #define SSL_R_INAPPROPRIATE_FALLBACK 163 2814 #define SSL_R_INVALID_COMMAND 164 2815 #define SSL_R_INVALID_MESSAGE 165 2816 #define SSL_R_INVALID_SSL_SESSION 166 2817 #define SSL_R_INVALID_TICKET_KEYS_LENGTH 167 2818 #define SSL_R_LENGTH_MISMATCH 168 2819 #define SSL_R_LIBRARY_HAS_NO_CIPHERS 169 2820 #define SSL_R_MISSING_DH_KEY 170 2821 #define SSL_R_MISSING_ECDSA_SIGNING_CERT 171 2822 #define SSL_R_MISSING_RSA_CERTIFICATE 172 2823 #define SSL_R_MISSING_RSA_ENCRYPTING_CERT 173 2824 #define SSL_R_MISSING_RSA_SIGNING_CERT 174 2825 #define SSL_R_MISSING_TMP_DH_KEY 175 2826 #define SSL_R_MISSING_TMP_ECDH_KEY 176 2827 #define SSL_R_MIXED_SPECIAL_OPERATOR_WITH_GROUPS 177 2828 #define SSL_R_MTU_TOO_SMALL 178 2829 #define SSL_R_NESTED_GROUP 179 2830 #define SSL_R_NO_CERTIFICATES_RETURNED 180 2831 #define SSL_R_NO_CERTIFICATE_ASSIGNED 181 2832 #define SSL_R_NO_CERTIFICATE_SET 182 2833 #define SSL_R_NO_CIPHERS_AVAILABLE 183 2834 #define SSL_R_NO_CIPHERS_PASSED 184 2835 #define SSL_R_NO_CIPHERS_SPECIFIED 185 2836 #define SSL_R_NO_CIPHER_MATCH 186 2837 #define SSL_R_NO_COMPRESSION_SPECIFIED 187 2838 #define SSL_R_NO_METHOD_SPECIFIED 188 2839 #define SSL_R_NO_P256_SUPPORT 189 2840 #define SSL_R_NO_PRIVATE_KEY_ASSIGNED 190 2841 #define SSL_R_NO_RENEGOTIATION 191 2842 #define SSL_R_NO_REQUIRED_DIGEST 192 2843 #define SSL_R_NO_SHARED_CIPHER 193 2844 #define SSL_R_NO_SHARED_SIGATURE_ALGORITHMS 194 2845 #define SSL_R_NO_SRTP_PROFILES 195 2846 #define SSL_R_NULL_SSL_CTX 196 2847 #define SSL_R_NULL_SSL_METHOD_PASSED 197 2848 #define SSL_R_OLD_SESSION_CIPHER_NOT_RETURNED 198 2849 #define SSL_R_PACKET_LENGTH_TOO_LONG 199 2850 #define SSL_R_PARSE_TLSEXT 200 2851 #define SSL_R_PATH_TOO_LONG 201 2852 #define SSL_R_PEER_DID_NOT_RETURN_A_CERTIFICATE 202 2853 #define SSL_R_PEER_ERROR_UNSUPPORTED_CERTIFICATE_TYPE 203 2854 #define SSL_R_PROTOCOL_IS_SHUTDOWN 204 2855 #define SSL_R_PSK_IDENTITY_NOT_FOUND 205 2856 #define SSL_R_PSK_NO_CLIENT_CB 206 2857 #define SSL_R_PSK_NO_SERVER_CB 207 2858 #define SSL_R_READ_BIO_NOT_SET 208 2859 #define SSL_R_READ_TIMEOUT_EXPIRED 209 2860 #define SSL_R_RECORD_LENGTH_MISMATCH 210 2861 #define SSL_R_RECORD_TOO_LARGE 211 2862 #define SSL_R_RENEGOTIATE_EXT_TOO_LONG 212 2863 #define SSL_R_RENEGOTIATION_ENCODING_ERR 213 2864 #define SSL_R_RENEGOTIATION_MISMATCH 214 2865 #define SSL_R_REQUIRED_CIPHER_MISSING 215 2866 #define SSL_R_SCSV_RECEIVED_WHEN_RENEGOTIATING 216 2867 #define SSL_R_SERVERHELLO_TLSEXT 217 2868 #define SSL_R_SESSION_ID_CONTEXT_UNINITIALIZED 218 2869 #define SSL_R_SESSION_MAY_NOT_BE_CREATED 219 2870 #define SSL_R_SIGNATURE_ALGORITHMS_ERROR 220 2871 #define SSL_R_SRTP_COULD_NOT_ALLOCATE_PROFILES 221 2872 #define SSL_R_SRTP_PROTECTION_PROFILE_LIST_TOO_LONG 222 2873 #define SSL_R_SRTP_UNKNOWN_PROTECTION_PROFILE 223 2874 #define SSL_R_SSL3_EXT_INVALID_SERVERNAME 224 2875 #define SSL_R_SSL3_EXT_INVALID_SERVERNAME_TYPE 225 2876 #define SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION 226 2877 #define SSL_R_SSL_HANDSHAKE_FAILURE 227 2878 #define SSL_R_SSL_SESSION_ID_CALLBACK_FAILED 228 2879 #define SSL_R_SSL_SESSION_ID_CONFLICT 229 2880 #define SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG 230 2881 #define SSL_R_SSL_SESSION_ID_HAS_BAD_LENGTH 231 2882 #define SSL_R_TLS_CLIENT_CERT_REQ_WITH_ANON_CIPHER 232 2883 #define SSL_R_TLS_ILLEGAL_EXPORTER_LABEL 233 2884 #define SSL_R_TLS_INVALID_ECPOINTFORMAT_LIST 234 2885 #define SSL_R_TLS_PEER_DID_NOT_RESPOND_WITH_CERTIFICATE_LIST 235 2886 #define SSL_R_TLS_RSA_ENCRYPTED_VALUE_LENGTH_IS_WRONG 236 2887 #define SSL_R_TOO_MANY_EMPTY_FRAGMENTS 237 2888 #define SSL_R_UNABLE_TO_FIND_ECDH_PARAMETERS 238 2889 #define SSL_R_UNABLE_TO_FIND_PUBLIC_KEY_PARAMETERS 239 2890 #define SSL_R_UNEXPECTED_GROUP_CLOSE 240 2891 #define SSL_R_UNEXPECTED_MESSAGE 241 2892 #define SSL_R_UNEXPECTED_OPERATOR_IN_GROUP 242 2893 #define SSL_R_UNEXPECTED_RECORD 243 2894 #define SSL_R_UNINITIALIZED 244 2895 #define SSL_R_UNKNOWN_ALERT_TYPE 245 2896 #define SSL_R_UNKNOWN_CERTIFICATE_TYPE 246 2897 #define SSL_R_UNKNOWN_CIPHER_RETURNED 247 2898 #define SSL_R_UNKNOWN_CIPHER_TYPE 248 2899 #define SSL_R_UNKNOWN_DIGEST 249 2900 #define SSL_R_UNKNOWN_KEY_EXCHANGE_TYPE 250 2901 #define SSL_R_UNKNOWN_PROTOCOL 251 2902 #define SSL_R_UNKNOWN_SSL_VERSION 252 2903 #define SSL_R_UNKNOWN_STATE 253 2904 #define SSL_R_UNPROCESSED_HANDSHAKE_DATA 254 2905 #define SSL_R_UNSAFE_LEGACY_RENEGOTIATION_DISABLED 255 2906 #define SSL_R_UNSUPPORTED_CIPHER 256 2907 #define SSL_R_UNSUPPORTED_COMPRESSION_ALGORITHM 257 2908 #define SSL_R_UNSUPPORTED_ELLIPTIC_CURVE 258 2909 #define SSL_R_UNSUPPORTED_PROTOCOL 259 2910 #define SSL_R_UNSUPPORTED_SSL_VERSION 260 2911 #define SSL_R_USE_SRTP_NOT_NEGOTIATED 261 2912 #define SSL_R_WRONG_CERTIFICATE_TYPE 262 2913 #define SSL_R_WRONG_CIPHER_RETURNED 263 2914 #define SSL_R_WRONG_CURVE 264 2915 #define SSL_R_WRONG_MESSAGE_TYPE 265 2916 #define SSL_R_WRONG_SIGNATURE_TYPE 266 2917 #define SSL_R_WRONG_SSL_VERSION 267 2918 #define SSL_R_WRONG_VERSION_NUMBER 268 2919 #define SSL_R_X509_LIB 269 2920 #define SSL_R_X509_VERIFICATION_SETUP_PROBLEMS 270 2921 #define SSL_R_FRAGMENT_MISMATCH 271 2922 #define SSL_R_BUFFER_TOO_SMALL 272 2923 #define SSL_R_OLD_SESSION_VERSION_NOT_RETURNED 273 2924 #define SSL_R_OUTPUT_ALIASES_INPUT 274 2925 #define SSL_R_RESUMED_EMS_SESSION_WITHOUT_EMS_EXTENSION 275 2926 #define SSL_R_EMS_STATE_INCONSISTENT 276 2927 #define SSL_R_RESUMED_NON_EMS_SESSION_WITH_EMS_EXTENSION 277 2928 #define SSL_R_SSLV3_ALERT_CLOSE_NOTIFY 1000 2929 #define SSL_R_SSLV3_ALERT_UNEXPECTED_MESSAGE 1010 2930 #define SSL_R_SSLV3_ALERT_BAD_RECORD_MAC 1020 2931 #define SSL_R_TLSV1_ALERT_DECRYPTION_FAILED 1021 2932 #define SSL_R_TLSV1_ALERT_RECORD_OVERFLOW 1022 2933 #define SSL_R_SSLV3_ALERT_DECOMPRESSION_FAILURE 1030 2934 #define SSL_R_SSLV3_ALERT_HANDSHAKE_FAILURE 1040 2935 #define SSL_R_SSLV3_ALERT_NO_CERTIFICATE 1041 2936 #define SSL_R_SSLV3_ALERT_BAD_CERTIFICATE 1042 2937 #define SSL_R_SSLV3_ALERT_UNSUPPORTED_CERTIFICATE 1043 2938 #define SSL_R_SSLV3_ALERT_CERTIFICATE_REVOKED 1044 2939 #define SSL_R_SSLV3_ALERT_CERTIFICATE_EXPIRED 1045 2940 #define SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN 1046 2941 #define SSL_R_SSLV3_ALERT_ILLEGAL_PARAMETER 1047 2942 #define SSL_R_TLSV1_ALERT_UNKNOWN_CA 1048 2943 #define SSL_R_TLSV1_ALERT_ACCESS_DENIED 1049 2944 #define SSL_R_TLSV1_ALERT_DECODE_ERROR 1050 2945 #define SSL_R_TLSV1_ALERT_DECRYPT_ERROR 1051 2946 #define SSL_R_TLSV1_ALERT_EXPORT_RESTRICTION 1060 2947 #define SSL_R_TLSV1_ALERT_PROTOCOL_VERSION 1070 2948 #define SSL_R_TLSV1_ALERT_INSUFFICIENT_SECURITY 1071 2949 #define SSL_R_TLSV1_ALERT_INTERNAL_ERROR 1080 2950 #define SSL_R_TLSV1_ALERT_INAPPROPRIATE_FALLBACK 1086 2951 #define SSL_R_TLSV1_ALERT_USER_CANCELLED 1090 2952 #define SSL_R_TLSV1_ALERT_NO_RENEGOTIATION 1100 2953 #define SSL_R_TLSV1_UNSUPPORTED_EXTENSION 1110 2954 #define SSL_R_TLSV1_CERTIFICATE_UNOBTAINABLE 1111 2955 #define SSL_R_TLSV1_UNRECOGNIZED_NAME 1112 2956 #define SSL_R_TLSV1_BAD_CERTIFICATE_STATUS_RESPONSE 1113 2957 #define SSL_R_TLSV1_BAD_CERTIFICATE_HASH_VALUE 1114 2958 2959 #endif /* OPENSSL_HEADER_SSL_H */ 2960