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. */ 166struct timeval; 167 168#if defined(__cplusplus) 169extern "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. */ 179OPENSSL_EXPORT int SSL_library_init(void); 180 181 182/* Cipher suites. */ 183 184/* An SSL_CIPHER represents a cipher suite. */ 185typedef 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 209DECLARE_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. */ 214OPENSSL_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. */ 218OPENSSL_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). */ 222OPENSSL_EXPORT int SSL_CIPHER_is_AES(const SSL_CIPHER *cipher); 223 224/* SSL_CIPHER_has_MD5_HMAC returns one if |cipher| uses HMAC-MD5. */ 225OPENSSL_EXPORT int SSL_CIPHER_has_MD5_HMAC(const SSL_CIPHER *cipher); 226 227/* SSL_CIPHER_is_AESGCM returns one if |cipher| uses AES-GCM. */ 228OPENSSL_EXPORT int SSL_CIPHER_is_AESGCM(const SSL_CIPHER *cipher); 229 230/* SSL_CIPHER_is_CHACHA20POLY1305 returns one if |cipher| uses 231 * CHACHA20_POLY1305. */ 232OPENSSL_EXPORT int SSL_CIPHER_is_CHACHA20POLY1305(const SSL_CIPHER *cipher); 233 234/* SSL_CIPHER_get_name returns the OpenSSL name of |cipher|. */ 235OPENSSL_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". */ 239OPENSSL_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. */ 245OPENSSL_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|. */ 250OPENSSL_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. */ 257typedef struct ssl_method_st SSL_METHOD; 258 259/* TLS_method is the |SSL_METHOD| used for TLS (and SSLv3) connections. */ 260OPENSSL_EXPORT const SSL_METHOD *TLS_method(void); 261 262/* DTLS_method is the |SSL_METHOD| used for DTLS connections. */ 263OPENSSL_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. */ 268OPENSSL_EXPORT SSL_CTX *SSL_CTX_new(const SSL_METHOD *method); 269 270/* SSL_CTX_free releases memory associated with |ctx|. */ 271OPENSSL_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. */ 283OPENSSL_EXPORT SSL *SSL_new(SSL_CTX *ctx); 284 285/* SSL_free releases memory associated with |ssl|. */ 286OPENSSL_EXPORT void SSL_free(SSL *ssl); 287 288/* SSL_set_connect_state configures |ssl| to be a client. */ 289OPENSSL_EXPORT void SSL_set_connect_state(SSL *ssl); 290 291/* SSL_set_accept_state configures |ssl| to be a server. */ 292OPENSSL_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|. */ 309OPENSSL_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|. */ 313OPENSSL_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|. */ 317OPENSSL_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|. */ 321OPENSSL_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. */ 387OPENSSL_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. */ 392OPENSSL_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|. */ 396OPENSSL_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. */ 401OPENSSL_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. */ 406OPENSSL_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|. */ 410OPENSSL_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. */ 472OPENSSL_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. */ 477OPENSSL_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|. */ 481OPENSSL_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. */ 486OPENSSL_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. */ 491OPENSSL_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|. */ 495OPENSSL_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. */ 517OPENSSL_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 613typedef struct ssl_protocol_method_st SSL_PROTOCOL_METHOD; 614typedef struct ssl_session_st SSL_SESSION; 615typedef struct tls_sigalgs_st TLS_SIGALGS; 616typedef struct ssl_conf_ctx_st SSL_CONF_CTX; 617typedef struct ssl3_enc_method SSL3_ENC_METHOD; 618 619/* SRTP protection profiles for use with the use_srtp extension (RFC 5764). */ 620typedef struct srtp_protection_profile_st { 621 const char *name; 622 unsigned long id; 623} SRTP_PROTECTION_PROFILE; 624 625DECLARE_STACK_OF(SRTP_PROTECTION_PROFILE) 626 627/* An SSL_SESSION represents an SSL session that may be resumed in an 628 * abbreviated handshake. */ 629struct 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. */ 720OPENSSL_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. */ 724OPENSSL_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. */ 740OPENSSL_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. */ 746OPENSSL_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. */ 750OPENSSL_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. */ 755OPENSSL_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. */ 763OPENSSL_EXPORT void SSL_CTX_set_keylog_bio(SSL_CTX *ctx, BIO *keylog_bio); 764 765 766struct ssl_aead_ctx_st; 767typedef 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. */ 788typedef 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. */ 794struct 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. */ 813OPENSSL_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 817typedef struct ssl_comp_st SSL_COMP; 818 819struct ssl_comp_st { 820 int id; 821 const char *name; 822 char *method; 823}; 824 825DECLARE_STACK_OF(SSL_COMP) 826DECLARE_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 */ 859struct ssl_cipher_preference_list_st { 860 STACK_OF(SSL_CIPHER) *ciphers; 861 uint8_t *in_group_flags; 862}; 863 864struct 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 1097OPENSSL_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. */ 1101OPENSSL_EXPORT size_t SSL_CTX_sess_number(const SSL_CTX *ctx); 1102 1103OPENSSL_EXPORT void SSL_CTX_sess_set_new_cb( 1104 SSL_CTX *ctx, int (*new_session_cb)(SSL *ssl, SSL_SESSION *sess)); 1105OPENSSL_EXPORT int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx))(SSL *ssl, 1106 SSL_SESSION *sess); 1107OPENSSL_EXPORT void SSL_CTX_sess_set_remove_cb( 1108 SSL_CTX *ctx, 1109 void (*remove_session_cb)(SSL_CTX *ctx, SSL_SESSION *sess)); 1110OPENSSL_EXPORT void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx))( 1111 SSL_CTX *ctx, SSL_SESSION *sess); 1112OPENSSL_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)); 1116OPENSSL_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. */ 1122OPENSSL_EXPORT SSL_SESSION *SSL_magic_pending_session_ptr(void); 1123OPENSSL_EXPORT void SSL_CTX_set_info_callback(SSL_CTX *ctx, 1124 void (*cb)(const SSL *ssl, 1125 int type, int val)); 1126OPENSSL_EXPORT void (*SSL_CTX_get_info_callback(SSL_CTX *ctx))(const SSL *ssl, 1127 int type, 1128 int val); 1129OPENSSL_EXPORT void SSL_CTX_set_client_cert_cb( 1130 SSL_CTX *ctx, 1131 int (*client_cert_cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey)); 1132OPENSSL_EXPORT int (*SSL_CTX_get_client_cert_cb(SSL_CTX *ctx))(SSL *ssl, 1133 X509 **x509, 1134 EVP_PKEY **pkey); 1135OPENSSL_EXPORT void SSL_CTX_set_channel_id_cb( 1136 SSL_CTX *ctx, void (*channel_id_cb)(SSL *ssl, EVP_PKEY **pkey)); 1137OPENSSL_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. */ 1143OPENSSL_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|. */ 1147OPENSSL_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. */ 1152OPENSSL_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|. */ 1156OPENSSL_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. */ 1166OPENSSL_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. */ 1175OPENSSL_EXPORT void SSL_get0_ocsp_response(const SSL *ssl, const uint8_t **out, 1176 size_t *out_len); 1177 1178OPENSSL_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); 1182OPENSSL_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); 1186OPENSSL_EXPORT void SSL_get0_next_proto_negotiated(const SSL *s, 1187 const uint8_t **data, 1188 unsigned *len); 1189 1190OPENSSL_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. */ 1205OPENSSL_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. */ 1214OPENSSL_EXPORT int SSL_set_alpn_protos(SSL *ssl, const uint8_t *protos, 1215 unsigned protos_len); 1216 1217OPENSSL_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); 1221OPENSSL_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). */ 1227OPENSSL_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.) */ 1233OPENSSL_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 1239OPENSSL_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)); 1244OPENSSL_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)); 1250OPENSSL_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)); 1255OPENSSL_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)); 1260OPENSSL_EXPORT int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, 1261 const char *identity_hint); 1262OPENSSL_EXPORT int SSL_use_psk_identity_hint(SSL *s, const char *identity_hint); 1263OPENSSL_EXPORT const char *SSL_get_psk_identity_hint(const SSL *s); 1264OPENSSL_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 1284struct 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. */ 1534OPENSSL_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. */ 1546OPENSSL_EXPORT size_t SSL_get_finished(const SSL *s, void *buf, size_t count); 1547OPENSSL_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 1578DECLARE_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. */ 1676OPENSSL_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. */ 1688OPENSSL_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. */ 1695OPENSSL_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. */ 1699OPENSSL_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. */ 1704OPENSSL_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. */ 1709OPENSSL_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.) */ 1716OPENSSL_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.) */ 1723OPENSSL_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. */ 1728OPENSSL_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. */ 1733OPENSSL_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. */ 1738OPENSSL_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. */ 1744OPENSSL_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. */ 1751OPENSSL_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 1853OPENSSL_EXPORT int SSL_CTX_set_cipher_list(SSL_CTX *, const char *str); 1854OPENSSL_EXPORT int SSL_CTX_set_cipher_list_tls11(SSL_CTX *, const char *str); 1855OPENSSL_EXPORT long SSL_CTX_set_timeout(SSL_CTX *ctx, long t); 1856OPENSSL_EXPORT long SSL_CTX_get_timeout(const SSL_CTX *ctx); 1857OPENSSL_EXPORT X509_STORE *SSL_CTX_get_cert_store(const SSL_CTX *); 1858OPENSSL_EXPORT void SSL_CTX_set_cert_store(SSL_CTX *, X509_STORE *); 1859OPENSSL_EXPORT int SSL_want(const SSL *s); 1860 1861OPENSSL_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. */ 1865OPENSSL_EXPORT const SSL_CIPHER *SSL_get_current_cipher(const SSL *s); 1866 1867OPENSSL_EXPORT int SSL_get_fd(const SSL *s); 1868OPENSSL_EXPORT int SSL_get_rfd(const SSL *s); 1869OPENSSL_EXPORT int SSL_get_wfd(const SSL *s); 1870OPENSSL_EXPORT const char *SSL_get_cipher_list(const SSL *s, int n); 1871OPENSSL_EXPORT int SSL_pending(const SSL *s); 1872OPENSSL_EXPORT int SSL_set_fd(SSL *s, int fd); 1873OPENSSL_EXPORT int SSL_set_rfd(SSL *s, int fd); 1874OPENSSL_EXPORT int SSL_set_wfd(SSL *s, int fd); 1875OPENSSL_EXPORT void SSL_set_bio(SSL *s, BIO *rbio, BIO *wbio); 1876OPENSSL_EXPORT BIO *SSL_get_rbio(const SSL *s); 1877OPENSSL_EXPORT BIO *SSL_get_wbio(const SSL *s); 1878OPENSSL_EXPORT int SSL_set_cipher_list(SSL *s, const char *str); 1879OPENSSL_EXPORT int SSL_get_verify_mode(const SSL *s); 1880OPENSSL_EXPORT int SSL_get_verify_depth(const SSL *s); 1881OPENSSL_EXPORT int (*SSL_get_verify_callback(const SSL *s))(int, 1882 X509_STORE_CTX *); 1883OPENSSL_EXPORT void SSL_set_verify(SSL *s, int mode, 1884 int (*callback)(int ok, 1885 X509_STORE_CTX *ctx)); 1886OPENSSL_EXPORT void SSL_set_verify_depth(SSL *s, int depth); 1887OPENSSL_EXPORT void SSL_set_cert_cb(SSL *s, int (*cb)(SSL *ssl, void *arg), 1888 void *arg); 1889OPENSSL_EXPORT int SSL_use_RSAPrivateKey(SSL *ssl, RSA *rsa); 1890OPENSSL_EXPORT int SSL_use_RSAPrivateKey_ASN1(SSL *ssl, uint8_t *d, long len); 1891OPENSSL_EXPORT int SSL_use_PrivateKey(SSL *ssl, EVP_PKEY *pkey); 1892OPENSSL_EXPORT int SSL_use_PrivateKey_ASN1(int pk, SSL *ssl, const uint8_t *d, 1893 long len); 1894OPENSSL_EXPORT int SSL_use_certificate(SSL *ssl, X509 *x); 1895OPENSSL_EXPORT int SSL_use_certificate_ASN1(SSL *ssl, const uint8_t *d, 1896 int len); 1897 1898OPENSSL_EXPORT int SSL_use_RSAPrivateKey_file(SSL *ssl, const char *file, 1899 int type); 1900OPENSSL_EXPORT int SSL_use_PrivateKey_file(SSL *ssl, const char *file, 1901 int type); 1902OPENSSL_EXPORT int SSL_use_certificate_file(SSL *ssl, const char *file, 1903 int type); 1904OPENSSL_EXPORT int SSL_CTX_use_RSAPrivateKey_file(SSL_CTX *ctx, 1905 const char *file, int type); 1906OPENSSL_EXPORT int SSL_CTX_use_PrivateKey_file(SSL_CTX *ctx, const char *file, 1907 int type); 1908OPENSSL_EXPORT int SSL_CTX_use_certificate_file(SSL_CTX *ctx, const char *file, 1909 int type); 1910OPENSSL_EXPORT int SSL_CTX_use_certificate_chain_file( 1911 SSL_CTX *ctx, const char *file); /* PEM type */ 1912OPENSSL_EXPORT STACK_OF(X509_NAME) *SSL_load_client_CA_file(const char *file); 1913OPENSSL_EXPORT int SSL_add_file_cert_subjects_to_stack(STACK_OF(X509_NAME) * 1914 stackCAs, 1915 const char *file); 1916OPENSSL_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. */ 1921OPENSSL_EXPORT void SSL_load_error_strings(void); 1922 1923OPENSSL_EXPORT const char *SSL_state_string(const SSL *s); 1924OPENSSL_EXPORT const char *SSL_rstate_string(const SSL *s); 1925OPENSSL_EXPORT const char *SSL_state_string_long(const SSL *s); 1926OPENSSL_EXPORT const char *SSL_rstate_string_long(const SSL *s); 1927OPENSSL_EXPORT long SSL_SESSION_get_time(const SSL_SESSION *s); 1928OPENSSL_EXPORT long SSL_SESSION_set_time(SSL_SESSION *s, long t); 1929OPENSSL_EXPORT long SSL_SESSION_get_timeout(const SSL_SESSION *s); 1930OPENSSL_EXPORT long SSL_SESSION_set_timeout(SSL_SESSION *s, long t); 1931OPENSSL_EXPORT X509 *SSL_SESSION_get0_peer(SSL_SESSION *s); 1932OPENSSL_EXPORT int SSL_SESSION_set1_id_context(SSL_SESSION *s, 1933 const uint8_t *sid_ctx, 1934 unsigned int sid_ctx_len); 1935 1936OPENSSL_EXPORT SSL_SESSION *SSL_SESSION_new(void); 1937OPENSSL_EXPORT const uint8_t *SSL_SESSION_get_id(const SSL_SESSION *s, 1938 unsigned int *len); 1939OPENSSL_EXPORT int SSL_SESSION_print_fp(FILE *fp, const SSL_SESSION *ses); 1940OPENSSL_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|. */ 1944OPENSSL_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. */ 1948OPENSSL_EXPORT void SSL_SESSION_free(SSL_SESSION *session); 1949 1950OPENSSL_EXPORT int SSL_set_session(SSL *to, SSL_SESSION *session); 1951OPENSSL_EXPORT int SSL_CTX_add_session(SSL_CTX *s, SSL_SESSION *c); 1952OPENSSL_EXPORT int SSL_CTX_remove_session(SSL_CTX *, SSL_SESSION *c); 1953OPENSSL_EXPORT int SSL_CTX_set_generate_session_id(SSL_CTX *, GEN_SESSION_CB); 1954OPENSSL_EXPORT int SSL_set_generate_session_id(SSL *, GEN_SESSION_CB); 1955OPENSSL_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. */ 1963OPENSSL_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. */ 1968OPENSSL_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. */ 1978OPENSSL_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. */ 1991OPENSSL_EXPORT SSL_SESSION *d2i_SSL_SESSION(SSL_SESSION **a, const uint8_t **pp, 1992 long length); 1993 1994OPENSSL_EXPORT X509 *SSL_get_peer_certificate(const SSL *s); 1995 1996OPENSSL_EXPORT STACK_OF(X509) *SSL_get_peer_cert_chain(const SSL *s); 1997 1998OPENSSL_EXPORT int SSL_CTX_get_verify_mode(const SSL_CTX *ctx); 1999OPENSSL_EXPORT int SSL_CTX_get_verify_depth(const SSL_CTX *ctx); 2000OPENSSL_EXPORT int (*SSL_CTX_get_verify_callback(const SSL_CTX *ctx))( 2001 int, X509_STORE_CTX *); 2002OPENSSL_EXPORT void SSL_CTX_set_verify(SSL_CTX *ctx, int mode, 2003 int (*callback)(int, X509_STORE_CTX *)); 2004OPENSSL_EXPORT void SSL_CTX_set_verify_depth(SSL_CTX *ctx, int depth); 2005OPENSSL_EXPORT void SSL_CTX_set_cert_verify_callback( 2006 SSL_CTX *ctx, int (*cb)(X509_STORE_CTX *, void *), void *arg); 2007OPENSSL_EXPORT void SSL_CTX_set_cert_cb(SSL_CTX *c, 2008 int (*cb)(SSL *ssl, void *arg), 2009 void *arg); 2010OPENSSL_EXPORT int SSL_CTX_use_RSAPrivateKey(SSL_CTX *ctx, RSA *rsa); 2011OPENSSL_EXPORT int SSL_CTX_use_RSAPrivateKey_ASN1(SSL_CTX *ctx, 2012 const uint8_t *d, long len); 2013OPENSSL_EXPORT int SSL_CTX_use_PrivateKey(SSL_CTX *ctx, EVP_PKEY *pkey); 2014OPENSSL_EXPORT int SSL_CTX_use_PrivateKey_ASN1(int pk, SSL_CTX *ctx, 2015 const uint8_t *d, long len); 2016OPENSSL_EXPORT int SSL_CTX_use_certificate(SSL_CTX *ctx, X509 *x); 2017OPENSSL_EXPORT int SSL_CTX_use_certificate_ASN1(SSL_CTX *ctx, int len, 2018 const uint8_t *d); 2019 2020OPENSSL_EXPORT void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, 2021 pem_password_cb *cb); 2022OPENSSL_EXPORT void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx, 2023 void *u); 2024 2025OPENSSL_EXPORT int SSL_CTX_check_private_key(const SSL_CTX *ctx); 2026OPENSSL_EXPORT int SSL_check_private_key(const SSL *ctx); 2027 2028OPENSSL_EXPORT int SSL_CTX_set_session_id_context(SSL_CTX *ctx, 2029 const uint8_t *sid_ctx, 2030 unsigned int sid_ctx_len); 2031 2032OPENSSL_EXPORT int SSL_set_session_id_context(SSL *ssl, const uint8_t *sid_ctx, 2033 unsigned int sid_ctx_len); 2034 2035OPENSSL_EXPORT int SSL_CTX_set_purpose(SSL_CTX *s, int purpose); 2036OPENSSL_EXPORT int SSL_set_purpose(SSL *s, int purpose); 2037OPENSSL_EXPORT int SSL_CTX_set_trust(SSL_CTX *s, int trust); 2038OPENSSL_EXPORT int SSL_set_trust(SSL *s, int trust); 2039 2040OPENSSL_EXPORT int SSL_CTX_set1_param(SSL_CTX *ctx, X509_VERIFY_PARAM *vpm); 2041OPENSSL_EXPORT int SSL_set1_param(SSL *ssl, X509_VERIFY_PARAM *vpm); 2042 2043OPENSSL_EXPORT X509_VERIFY_PARAM *SSL_CTX_get0_param(SSL_CTX *ctx); 2044OPENSSL_EXPORT X509_VERIFY_PARAM *SSL_get0_param(SSL *ssl); 2045 2046OPENSSL_EXPORT void SSL_certs_clear(SSL *s); 2047OPENSSL_EXPORT int SSL_accept(SSL *ssl); 2048OPENSSL_EXPORT int SSL_connect(SSL *ssl); 2049OPENSSL_EXPORT int SSL_read(SSL *ssl, void *buf, int num); 2050OPENSSL_EXPORT int SSL_peek(SSL *ssl, void *buf, int num); 2051OPENSSL_EXPORT int SSL_write(SSL *ssl, const void *buf, int num); 2052OPENSSL_EXPORT long SSL_ctrl(SSL *ssl, int cmd, long larg, void *parg); 2053OPENSSL_EXPORT long SSL_CTX_ctrl(SSL_CTX *ctx, int cmd, long larg, void *parg); 2054 2055OPENSSL_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". */ 2058OPENSSL_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". */ 2061OPENSSL_EXPORT const char *SSL_SESSION_get_version(const SSL_SESSION *sess); 2062 2063OPENSSL_EXPORT STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *s); 2064 2065OPENSSL_EXPORT int SSL_do_handshake(SSL *s); 2066 2067/* SSL_renegotiate_pending returns one if |ssl| is in the middle of a 2068 * renegotiation. */ 2069OPENSSL_EXPORT int SSL_renegotiate_pending(SSL *ssl); 2070 2071OPENSSL_EXPORT int SSL_shutdown(SSL *s); 2072 2073OPENSSL_EXPORT const char *SSL_alert_type_string_long(int value); 2074OPENSSL_EXPORT const char *SSL_alert_type_string(int value); 2075OPENSSL_EXPORT const char *SSL_alert_desc_string_long(int value); 2076OPENSSL_EXPORT const char *SSL_alert_desc_string(int value); 2077 2078OPENSSL_EXPORT void SSL_set_client_CA_list(SSL *s, 2079 STACK_OF(X509_NAME) *name_list); 2080OPENSSL_EXPORT void SSL_CTX_set_client_CA_list(SSL_CTX *ctx, 2081 STACK_OF(X509_NAME) *name_list); 2082OPENSSL_EXPORT STACK_OF(X509_NAME) *SSL_get_client_CA_list(const SSL *s); 2083OPENSSL_EXPORT STACK_OF(X509_NAME) * 2084 SSL_CTX_get_client_CA_list(const SSL_CTX *s); 2085OPENSSL_EXPORT int SSL_add_client_CA(SSL *ssl, X509 *x); 2086OPENSSL_EXPORT int SSL_CTX_add_client_CA(SSL_CTX *ctx, X509 *x); 2087 2088OPENSSL_EXPORT long SSL_get_default_timeout(const SSL *s); 2089 2090OPENSSL_EXPORT STACK_OF(X509_NAME) *SSL_dup_CA_list(STACK_OF(X509_NAME) *sk); 2091 2092OPENSSL_EXPORT X509 *SSL_get_certificate(const SSL *ssl); 2093OPENSSL_EXPORT EVP_PKEY *SSL_get_privatekey(const SSL *ssl); 2094 2095OPENSSL_EXPORT X509 *SSL_CTX_get0_certificate(const SSL_CTX *ctx); 2096OPENSSL_EXPORT EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx); 2097 2098OPENSSL_EXPORT void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode); 2099OPENSSL_EXPORT int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx); 2100OPENSSL_EXPORT void SSL_set_quiet_shutdown(SSL *ssl, int mode); 2101OPENSSL_EXPORT int SSL_get_quiet_shutdown(const SSL *ssl); 2102OPENSSL_EXPORT void SSL_set_shutdown(SSL *ssl, int mode); 2103OPENSSL_EXPORT int SSL_get_shutdown(const SSL *ssl); 2104OPENSSL_EXPORT int SSL_version(const SSL *ssl); 2105OPENSSL_EXPORT int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx); 2106OPENSSL_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 */ 2110OPENSSL_EXPORT SSL_SESSION *SSL_get_session(const SSL *ssl); 2111OPENSSL_EXPORT SSL_SESSION *SSL_get1_session( 2112 SSL *ssl); /* obtain a reference count */ 2113OPENSSL_EXPORT SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl); 2114OPENSSL_EXPORT SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx); 2115OPENSSL_EXPORT void SSL_set_info_callback(SSL *ssl, 2116 void (*cb)(const SSL *ssl, int type, 2117 int val)); 2118OPENSSL_EXPORT void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl, 2119 int type, int val); 2120OPENSSL_EXPORT int SSL_state(const SSL *ssl); 2121 2122OPENSSL_EXPORT void SSL_set_verify_result(SSL *ssl, long v); 2123OPENSSL_EXPORT long SSL_get_verify_result(const SSL *ssl); 2124 2125OPENSSL_EXPORT int SSL_set_ex_data(SSL *ssl, int idx, void *data); 2126OPENSSL_EXPORT void *SSL_get_ex_data(const SSL *ssl, int idx); 2127OPENSSL_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 2132OPENSSL_EXPORT int SSL_SESSION_set_ex_data(SSL_SESSION *ss, int idx, 2133 void *data); 2134OPENSSL_EXPORT void *SSL_SESSION_get_ex_data(const SSL_SESSION *ss, int idx); 2135OPENSSL_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 2140OPENSSL_EXPORT int SSL_CTX_set_ex_data(SSL_CTX *ssl, int idx, void *data); 2141OPENSSL_EXPORT void *SSL_CTX_get_ex_data(const SSL_CTX *ssl, int idx); 2142OPENSSL_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 2147OPENSSL_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. */ 2151OPENSSL_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. */ 2156OPENSSL_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. */ 2172OPENSSL_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| */ 2176OPENSSL_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|. */ 2180OPENSSL_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. */ 2185OPENSSL_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|. */ 2190OPENSSL_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. */ 2195OPENSSL_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. */ 2200OPENSSL_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. */ 2206OPENSSL_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. */ 2216OPENSSL_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. */ 2226OPENSSL_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. */ 2241OPENSSL_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. */ 2255OPENSSL_EXPORT void SSL_set_tmp_ecdh_callback( 2256 SSL *ssl, EC_KEY *(*callback)(SSL *ssl, int is_export, int keylength)); 2257 2258OPENSSL_EXPORT const void *SSL_get_current_compression(SSL *s); 2259OPENSSL_EXPORT const void *SSL_get_current_expansion(SSL *s); 2260 2261OPENSSL_EXPORT int SSL_cache_hit(SSL *s); 2262OPENSSL_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. */ 2267OPENSSL_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. */ 2273OPENSSL_EXPORT void SSL_get_structure_sizes(size_t *ssl_size, 2274 size_t *ssl_ctx_size, 2275 size_t *ssl_session_size); 2276 2277OPENSSL_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. */ 2282OPENSSL_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. */ 2296OPENSSL_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". */ 2300OPENSSL_EXPORT const char *SSL_CIPHER_get_version(const SSL_CIPHER *cipher); 2301 2302/* SSL_COMP_get_compression_methods returns NULL. */ 2303OPENSSL_EXPORT void *SSL_COMP_get_compression_methods(void); 2304 2305/* SSL_COMP_add_compression_method returns one. */ 2306OPENSSL_EXPORT int SSL_COMP_add_compression_method(int id, void *cm); 2307 2308/* SSL_COMP_get_name returns NULL. */ 2309OPENSSL_EXPORT const char *SSL_COMP_get_name(const void *comp); 2310 2311/* SSLv23_method calls |TLS_method|. */ 2312OPENSSL_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. */ 2317OPENSSL_EXPORT const SSL_METHOD *SSLv3_method(void); 2318OPENSSL_EXPORT const SSL_METHOD *TLSv1_method(void); 2319OPENSSL_EXPORT const SSL_METHOD *TLSv1_1_method(void); 2320OPENSSL_EXPORT const SSL_METHOD *TLSv1_2_method(void); 2321OPENSSL_EXPORT const SSL_METHOD *DTLSv1_method(void); 2322OPENSSL_EXPORT const SSL_METHOD *DTLSv1_2_method(void); 2323 2324/* Client- and server-specific methods call their corresponding generic 2325 * methods. */ 2326OPENSSL_EXPORT const SSL_METHOD *SSLv23_server_method(void); 2327OPENSSL_EXPORT const SSL_METHOD *SSLv23_client_method(void); 2328OPENSSL_EXPORT const SSL_METHOD *SSLv3_server_method(void); 2329OPENSSL_EXPORT const SSL_METHOD *SSLv3_client_method(void); 2330OPENSSL_EXPORT const SSL_METHOD *TLSv1_server_method(void); 2331OPENSSL_EXPORT const SSL_METHOD *TLSv1_client_method(void); 2332OPENSSL_EXPORT const SSL_METHOD *TLSv1_1_server_method(void); 2333OPENSSL_EXPORT const SSL_METHOD *TLSv1_1_client_method(void); 2334OPENSSL_EXPORT const SSL_METHOD *TLSv1_2_server_method(void); 2335OPENSSL_EXPORT const SSL_METHOD *TLSv1_2_client_method(void); 2336OPENSSL_EXPORT const SSL_METHOD *DTLS_server_method(void); 2337OPENSSL_EXPORT const SSL_METHOD *DTLS_client_method(void); 2338OPENSSL_EXPORT const SSL_METHOD *DTLSv1_server_method(void); 2339OPENSSL_EXPORT const SSL_METHOD *DTLSv1_client_method(void); 2340OPENSSL_EXPORT const SSL_METHOD *DTLSv1_2_server_method(void); 2341OPENSSL_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. */ 2348OPENSSL_EXPORT int SSL_clear(SSL *ssl); 2349 2350/* SSL_CTX_set_tmp_rsa_callback does nothing. */ 2351OPENSSL_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. */ 2355OPENSSL_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. */ 2360OPENSSL_EXPORT int SSL_CTX_sess_connect(const SSL_CTX *ctx); 2361 2362/* SSL_CTX_sess_connect_good returns zero. */ 2363OPENSSL_EXPORT int SSL_CTX_sess_connect_good(const SSL_CTX *ctx); 2364 2365/* SSL_CTX_sess_connect_renegotiate returns zero. */ 2366OPENSSL_EXPORT int SSL_CTX_sess_connect_renegotiate(const SSL_CTX *ctx); 2367 2368/* SSL_CTX_sess_accept returns zero. */ 2369OPENSSL_EXPORT int SSL_CTX_sess_accept(const SSL_CTX *ctx); 2370 2371/* SSL_CTX_sess_accept_renegotiate returns zero. */ 2372OPENSSL_EXPORT int SSL_CTX_sess_accept_renegotiate(const SSL_CTX *ctx); 2373 2374/* SSL_CTX_sess_accept_good returns zero. */ 2375OPENSSL_EXPORT int SSL_CTX_sess_accept_good(const SSL_CTX *ctx); 2376 2377/* SSL_CTX_sess_hits returns zero. */ 2378OPENSSL_EXPORT int SSL_CTX_sess_hits(const SSL_CTX *ctx); 2379 2380/* SSL_CTX_sess_cb_hits returns zero. */ 2381OPENSSL_EXPORT int SSL_CTX_sess_cb_hits(const SSL_CTX *ctx); 2382 2383/* SSL_CTX_sess_misses returns zero. */ 2384OPENSSL_EXPORT int SSL_CTX_sess_misses(const SSL_CTX *ctx); 2385 2386/* SSL_CTX_sess_timeouts returns zero. */ 2387OPENSSL_EXPORT int SSL_CTX_sess_timeouts(const SSL_CTX *ctx); 2388 2389/* SSL_CTX_sess_cache_full returns zero. */ 2390OPENSSL_EXPORT int SSL_CTX_sess_cache_full(const SSL_CTX *ctx); 2391 2392/* SSL_cutthrough_complete calls |SSL_in_false_start|. */ 2393OPENSSL_EXPORT int SSL_cutthrough_complete(const SSL *s); 2394 2395/* SSL_num_renegotiations calls |SSL_total_renegotiations|. */ 2396OPENSSL_EXPORT int SSL_num_renegotiations(const SSL *ssl); 2397 2398/* SSL_CTX_need_tmp_RSA returns zero. */ 2399OPENSSL_EXPORT int SSL_CTX_need_tmp_RSA(const SSL_CTX *ctx); 2400 2401/* SSL_need_tmp_RSA returns zero. */ 2402OPENSSL_EXPORT int SSL_need_tmp_RSA(const SSL *ssl); 2403 2404/* SSL_CTX_set_tmp_rsa returns one. */ 2405OPENSSL_EXPORT int SSL_CTX_set_tmp_rsa(SSL_CTX *ctx, const RSA *rsa); 2406 2407/* SSL_set_tmp_rsa returns one. */ 2408OPENSSL_EXPORT int SSL_set_tmp_rsa(SSL *ssl, const RSA *rsa); 2409 2410/* SSL_CTX_get_read_head returns zero. */ 2411OPENSSL_EXPORT int SSL_CTX_get_read_ahead(const SSL_CTX *ctx); 2412 2413/* SSL_CTX_set_read_ahead does nothing. */ 2414OPENSSL_EXPORT void SSL_CTX_set_read_ahead(SSL_CTX *ctx, int yes); 2415 2416/* SSL_get_read_head returns zero. */ 2417OPENSSL_EXPORT int SSL_get_read_ahead(const SSL *s); 2418 2419/* SSL_set_read_ahead does nothing. */ 2420OPENSSL_EXPORT void SSL_set_read_ahead(SSL *s, int yes); 2421 2422/* SSL_renegotiate put an error on the error queue and returns zero. */ 2423OPENSSL_EXPORT int SSL_renegotiate(SSL *ssl); 2424 2425/* SSL_set_state does nothing. */ 2426OPENSSL_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 2437OPENSSL_EXPORT int SSL_set_session_ticket_ext(SSL *s, void *ext_data, 2438 int ext_len); 2439OPENSSL_EXPORT int SSL_set_session_secret_cb(SSL *s, void *cb, void *arg); 2440OPENSSL_EXPORT int SSL_set_session_ticket_ext_cb(SSL *s, void *cb, void *arg); 2441OPENSSL_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". */ 2449OPENSSL_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