blob: 0040cbb006f05633bfa47ddedaa00fabfe4974b5 [file] [log] [blame]
Adam Langley95c29f32014-06-20 12:00:00 -07001/* 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 HEADER_SSL_H
144#define 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/x509.h>
154
155/* Some code expected to get the threading functions by including ssl.h. */
156#include <openssl/thread.h>
157
158#ifdef __cplusplus
159extern "C" {
160#endif
161
162
163/* SSLeay version number for ASN.1 encoding of the session information */
164/* Version 0 - initial version
165 * Version 1 - added the optional peer certificate
166 */
167#define SSL_SESSION_ASN1_VERSION 0x0001
168
169/* text strings for the ciphers */
170#define SSL_TXT_NULL_WITH_MD5 SSL2_TXT_NULL_WITH_MD5
171#define SSL_TXT_RC4_128_WITH_MD5 SSL2_TXT_RC4_128_WITH_MD5
172#define SSL_TXT_RC4_128_EXPORT40_WITH_MD5 SSL2_TXT_RC4_128_EXPORT40_WITH_MD5
173#define SSL_TXT_RC2_128_CBC_WITH_MD5 SSL2_TXT_RC2_128_CBC_WITH_MD5
174#define SSL_TXT_RC2_128_CBC_EXPORT40_WITH_MD5 SSL2_TXT_RC2_128_CBC_EXPORT40_WITH_MD5
175#define SSL_TXT_IDEA_128_CBC_WITH_MD5 SSL2_TXT_IDEA_128_CBC_WITH_MD5
176#define SSL_TXT_DES_64_CBC_WITH_MD5 SSL2_TXT_DES_64_CBC_WITH_MD5
177#define SSL_TXT_DES_64_CBC_WITH_SHA SSL2_TXT_DES_64_CBC_WITH_SHA
178#define SSL_TXT_DES_192_EDE3_CBC_WITH_MD5 SSL2_TXT_DES_192_EDE3_CBC_WITH_MD5
179#define SSL_TXT_DES_192_EDE3_CBC_WITH_SHA SSL2_TXT_DES_192_EDE3_CBC_WITH_SHA
180
181/* VRS Additional Kerberos5 entries
182 */
183#define SSL_TXT_KRB5_DES_64_CBC_SHA SSL3_TXT_KRB5_DES_64_CBC_SHA
184#define SSL_TXT_KRB5_DES_192_CBC3_SHA SSL3_TXT_KRB5_DES_192_CBC3_SHA
185#define SSL_TXT_KRB5_RC4_128_SHA SSL3_TXT_KRB5_RC4_128_SHA
186#define SSL_TXT_KRB5_IDEA_128_CBC_SHA SSL3_TXT_KRB5_IDEA_128_CBC_SHA
187#define SSL_TXT_KRB5_DES_64_CBC_MD5 SSL3_TXT_KRB5_DES_64_CBC_MD5
188#define SSL_TXT_KRB5_DES_192_CBC3_MD5 SSL3_TXT_KRB5_DES_192_CBC3_MD5
189#define SSL_TXT_KRB5_RC4_128_MD5 SSL3_TXT_KRB5_RC4_128_MD5
190#define SSL_TXT_KRB5_IDEA_128_CBC_MD5 SSL3_TXT_KRB5_IDEA_128_CBC_MD5
191
192#define SSL_TXT_KRB5_DES_40_CBC_SHA SSL3_TXT_KRB5_DES_40_CBC_SHA
193#define SSL_TXT_KRB5_RC2_40_CBC_SHA SSL3_TXT_KRB5_RC2_40_CBC_SHA
194#define SSL_TXT_KRB5_RC4_40_SHA SSL3_TXT_KRB5_RC4_40_SHA
195#define SSL_TXT_KRB5_DES_40_CBC_MD5 SSL3_TXT_KRB5_DES_40_CBC_MD5
196#define SSL_TXT_KRB5_RC2_40_CBC_MD5 SSL3_TXT_KRB5_RC2_40_CBC_MD5
197#define SSL_TXT_KRB5_RC4_40_MD5 SSL3_TXT_KRB5_RC4_40_MD5
198
199#define SSL_TXT_KRB5_DES_40_CBC_SHA SSL3_TXT_KRB5_DES_40_CBC_SHA
200#define SSL_TXT_KRB5_DES_40_CBC_MD5 SSL3_TXT_KRB5_DES_40_CBC_MD5
201#define SSL_TXT_KRB5_DES_64_CBC_SHA SSL3_TXT_KRB5_DES_64_CBC_SHA
202#define SSL_TXT_KRB5_DES_64_CBC_MD5 SSL3_TXT_KRB5_DES_64_CBC_MD5
203#define SSL_TXT_KRB5_DES_192_CBC3_SHA SSL3_TXT_KRB5_DES_192_CBC3_SHA
204#define SSL_TXT_KRB5_DES_192_CBC3_MD5 SSL3_TXT_KRB5_DES_192_CBC3_MD5
205#define SSL_MAX_KRB5_PRINCIPAL_LENGTH 256
206
207#define SSL_MAX_SSL_SESSION_ID_LENGTH 32
208#define SSL_MAX_SID_CTX_LENGTH 32
209
210#define SSL_MIN_RSA_MODULUS_LENGTH_IN_BYTES (512/8)
211#define SSL_MAX_KEY_ARG_LENGTH 8
212#define SSL_MAX_MASTER_KEY_LENGTH 48
213
214
215/* These are used to specify which ciphers to use and not to use */
216
217#define SSL_TXT_EXP40 "EXPORT40"
218#define SSL_TXT_EXP56 "EXPORT56"
219#define SSL_TXT_LOW "LOW"
220#define SSL_TXT_MEDIUM "MEDIUM"
221#define SSL_TXT_HIGH "HIGH"
222#define SSL_TXT_FIPS "FIPS"
223
224#define SSL_TXT_kFZA "kFZA" /* unused! */
225#define SSL_TXT_aFZA "aFZA" /* unused! */
226#define SSL_TXT_eFZA "eFZA" /* unused! */
227#define SSL_TXT_FZA "FZA" /* unused! */
228
229#define SSL_TXT_aNULL "aNULL"
230#define SSL_TXT_eNULL "eNULL"
231#define SSL_TXT_NULL "NULL"
232
233#define SSL_TXT_kRSA "kRSA"
234#define SSL_TXT_kDHr "kDHr"
235#define SSL_TXT_kDHd "kDHd"
236#define SSL_TXT_kDH "kDH"
237#define SSL_TXT_kEDH "kEDH"
238#define SSL_TXT_kKRB5 "kKRB5"
239#define SSL_TXT_kECDHr "kECDHr"
240#define SSL_TXT_kECDHe "kECDHe"
241#define SSL_TXT_kECDH "kECDH"
242#define SSL_TXT_kEECDH "kEECDH"
243#define SSL_TXT_kPSK "kPSK"
244#define SSL_TXT_kGOST "kGOST"
245#define SSL_TXT_kSRP "kSRP"
246
247#define SSL_TXT_aRSA "aRSA"
248#define SSL_TXT_aDSS "aDSS"
249#define SSL_TXT_aDH "aDH"
250#define SSL_TXT_aECDH "aECDH"
251#define SSL_TXT_aKRB5 "aKRB5"
252#define SSL_TXT_aECDSA "aECDSA"
253#define SSL_TXT_aPSK "aPSK"
254#define SSL_TXT_aGOST94 "aGOST94"
255#define SSL_TXT_aGOST01 "aGOST01"
256#define SSL_TXT_aGOST "aGOST"
257
258#define SSL_TXT_DSS "DSS"
259#define SSL_TXT_DH "DH"
260#define SSL_TXT_EDH "EDH" /* same as "kEDH:-ADH" */
261#define SSL_TXT_ADH "ADH"
262#define SSL_TXT_RSA "RSA"
263#define SSL_TXT_ECDH "ECDH"
264#define SSL_TXT_EECDH "EECDH" /* same as "kEECDH:-AECDH" */
265#define SSL_TXT_AECDH "AECDH"
266#define SSL_TXT_ECDSA "ECDSA"
267#define SSL_TXT_KRB5 "KRB5"
268#define SSL_TXT_PSK "PSK"
269#define SSL_TXT_SRP "SRP"
270
271#define SSL_TXT_DES "DES"
272#define SSL_TXT_3DES "3DES"
273#define SSL_TXT_RC4 "RC4"
274#define SSL_TXT_RC2 "RC2"
275#define SSL_TXT_IDEA "IDEA"
276#define SSL_TXT_SEED "SEED"
277#define SSL_TXT_AES128 "AES128"
278#define SSL_TXT_AES256 "AES256"
279#define SSL_TXT_AES "AES"
280#define SSL_TXT_AES_GCM "AESGCM"
281#define SSL_TXT_CAMELLIA128 "CAMELLIA128"
282#define SSL_TXT_CAMELLIA256 "CAMELLIA256"
283#define SSL_TXT_CAMELLIA "CAMELLIA"
Adam Langleyde0b2022014-06-20 12:00:00 -0700284#define SSL_TXT_CHACHA20 "CHACHA20"
Adam Langley95c29f32014-06-20 12:00:00 -0700285
286#define SSL_TXT_MD5 "MD5"
287#define SSL_TXT_SHA1 "SHA1"
288#define SSL_TXT_SHA "SHA" /* same as "SHA1" */
289#define SSL_TXT_GOST94 "GOST94"
290#define SSL_TXT_GOST89MAC "GOST89MAC"
291#define SSL_TXT_SHA256 "SHA256"
292#define SSL_TXT_SHA384 "SHA384"
293
294#define SSL_TXT_SSLV2 "SSLv2"
295#define SSL_TXT_SSLV3 "SSLv3"
296#define SSL_TXT_TLSV1 "TLSv1"
297#define SSL_TXT_TLSV1_1 "TLSv1.1"
298#define SSL_TXT_TLSV1_2 "TLSv1.2"
299
300#define SSL_TXT_EXP "EXP"
301#define SSL_TXT_EXPORT "EXPORT"
302
303#define SSL_TXT_ALL "ALL"
304
305/*
306 * COMPLEMENTOF* definitions. These identifiers are used to (de-select)
307 * ciphers normally not being used.
308 * Example: "RC4" will activate all ciphers using RC4 including ciphers
309 * without authentication, which would normally disabled by DEFAULT (due
310 * the "!ADH" being part of default). Therefore "RC4:!COMPLEMENTOFDEFAULT"
311 * will make sure that it is also disabled in the specific selection.
312 * COMPLEMENTOF* identifiers are portable between version, as adjustments
313 * to the default cipher setup will also be included here.
314 *
315 * COMPLEMENTOFDEFAULT does not experience the same special treatment that
316 * DEFAULT gets, as only selection is being done and no sorting as needed
317 * for DEFAULT.
318 */
319#define SSL_TXT_CMPALL "COMPLEMENTOFALL"
320#define SSL_TXT_CMPDEF "COMPLEMENTOFDEFAULT"
321
322/* The following cipher list is used by default.
323 * It also is substituted when an application-defined cipher list string
324 * starts with 'DEFAULT'. */
325#define SSL_DEFAULT_CIPHER_LIST "ALL:!aNULL:!eNULL:!SSLv2"
326/* As of OpenSSL 1.0.0, ssl_create_cipher_list() in ssl/ssl_ciph.c always
327 * starts with a reasonable order, and all we have to do for DEFAULT is
328 * throwing out anonymous and unencrypted ciphersuites!
329 * (The latter are not actually enabled by ALL, but "ALL:RSA" would enable
330 * some of them.)
331 */
332
333/* Used in SSL_set_shutdown()/SSL_get_shutdown(); */
334#define SSL_SENT_SHUTDOWN 1
335#define SSL_RECEIVED_SHUTDOWN 2
336
337#ifdef __cplusplus
338}
339#endif
340
341#ifdef __cplusplus
342extern "C" {
343#endif
344
345#define SSL_FILETYPE_ASN1 X509_FILETYPE_ASN1
346#define SSL_FILETYPE_PEM X509_FILETYPE_PEM
347
348/* This is needed to stop compilers complaining about the
349 * 'struct ssl_st *' function parameters used to prototype callbacks
350 * in SSL_CTX. */
351typedef struct ssl_st *ssl_crock_st;
352typedef struct tls_session_ticket_ext_st TLS_SESSION_TICKET_EXT;
353typedef struct ssl_method_st SSL_METHOD;
354typedef struct ssl_cipher_st SSL_CIPHER;
355typedef struct ssl_session_st SSL_SESSION;
356typedef struct tls_sigalgs_st TLS_SIGALGS;
357typedef struct ssl_conf_ctx_st SSL_CONF_CTX;
358
359DECLARE_STACK_OF(SSL_CIPHER)
360
361/* SRTP protection profiles for use with the use_srtp extension (RFC 5764)*/
362typedef struct srtp_protection_profile_st
363 {
364 const char *name;
365 unsigned long id;
366 } SRTP_PROTECTION_PROFILE;
367
368DECLARE_STACK_OF(SRTP_PROTECTION_PROFILE)
369
370typedef int (*tls_session_ticket_ext_cb_fn)(SSL *s, const unsigned char *data, int len, void *arg);
371typedef int (*tls_session_secret_cb_fn)(SSL *s, void *secret, int *secret_len, STACK_OF(SSL_CIPHER) *peer_ciphers, SSL_CIPHER **cipher, void *arg);
372
373#ifndef OPENSSL_NO_TLSEXT
374/* Callbacks and structures for handling custom TLS Extensions:
375 * cli_ext_first_cb - sends data for ClientHello TLS Extension
376 * cli_ext_second_cb - receives data from ServerHello TLS Extension
377 * srv_ext_first_cb - receives data from ClientHello TLS Extension
378 * srv_ext_second_cb - sends data for ServerHello TLS Extension
379 *
380 * All these functions return nonzero on success. Zero will terminate
381 * the handshake (and return a specific TLS Fatal alert, if the function
382 * declaration has an "al" parameter). -1 for the "sending" functions
383 * will cause the TLS Extension to be omitted.
384 *
385 * "ext_type" is a TLS "ExtensionType" from 0-65535.
386 * "in" is a pointer to TLS "extension_data" being provided to the cb.
387 * "out" is used by the callback to return a pointer to "extension data"
388 * which OpenSSL will later copy into the TLS handshake. The contents
389 * of this buffer should not be changed until the handshake is complete.
390 * "inlen" and "outlen" are TLS Extension lengths from 0-65535.
391 * "al" is a TLS "AlertDescription" from 0-255 which WILL be sent as a
392 * fatal TLS alert, if the callback returns zero.
393 */
394typedef int (*custom_cli_ext_first_cb_fn)(SSL *s, unsigned short ext_type,
395 const unsigned char **out,
396 unsigned short *outlen, void *arg);
397typedef int (*custom_cli_ext_second_cb_fn)(SSL *s, unsigned short ext_type,
398 const unsigned char *in,
399 unsigned short inlen, int *al,
400 void *arg);
401
402typedef int (*custom_srv_ext_first_cb_fn)(SSL *s, unsigned short ext_type,
403 const unsigned char *in,
404 unsigned short inlen, int *al,
405 void *arg);
406typedef int (*custom_srv_ext_second_cb_fn)(SSL *s, unsigned short ext_type,
407 const unsigned char **out,
408 unsigned short *outlen, void *arg);
409
410typedef struct {
411 unsigned short ext_type;
412 custom_cli_ext_first_cb_fn fn1;
413 custom_cli_ext_second_cb_fn fn2;
414 void *arg;
415} custom_cli_ext_record;
416
417typedef struct {
418 unsigned short ext_type;
419 custom_srv_ext_first_cb_fn fn1;
420 custom_srv_ext_second_cb_fn fn2;
421 void *arg;
422} custom_srv_ext_record;
423#endif
424
425#ifndef OPENSSL_NO_SSL_INTERN
426
427/* used to hold info on the particular ciphers used */
428struct ssl_cipher_st
429 {
430 int valid;
431 const char *name; /* text name */
432 unsigned long id; /* id, 4 bytes, first is version */
433
434 /* changed in 0.9.9: these four used to be portions of a single value 'algorithms' */
435 unsigned long algorithm_mkey; /* key exchange algorithm */
436 unsigned long algorithm_auth; /* server authentication */
437 unsigned long algorithm_enc; /* symmetric encryption */
438 unsigned long algorithm_mac; /* symmetric authentication */
439 unsigned long algorithm_ssl; /* (major) protocol version */
440
441 unsigned long algo_strength; /* strength and export flags */
Adam Langleyc9fb3752014-06-20 12:00:00 -0700442 unsigned long algorithm2; /* Extra flags. See SSL2_CF_* in ssl2.h
443 and algorithm2 section in
444 ssl_locl.h */
Adam Langley95c29f32014-06-20 12:00:00 -0700445 int strength_bits; /* Number of bits really used */
446 int alg_bits; /* Number of bits for algorithm */
447 };
448
449
450/* Used to hold functions for SSLv2 or SSLv3/TLSv1 functions */
451struct ssl_method_st
452 {
453 int version;
454 int (*ssl_new)(SSL *s);
455 void (*ssl_clear)(SSL *s);
456 void (*ssl_free)(SSL *s);
457 int (*ssl_accept)(SSL *s);
458 int (*ssl_connect)(SSL *s);
459 int (*ssl_read)(SSL *s,void *buf,int len);
460 int (*ssl_peek)(SSL *s,void *buf,int len);
461 int (*ssl_write)(SSL *s,const void *buf,int len);
462 int (*ssl_shutdown)(SSL *s);
463 int (*ssl_renegotiate)(SSL *s);
464 int (*ssl_renegotiate_check)(SSL *s);
465 long (*ssl_get_message)(SSL *s, int st1, int stn, int mt, long
466 max, int *ok);
467 int (*ssl_read_bytes)(SSL *s, int type, unsigned char *buf, int len,
468 int peek);
469 int (*ssl_write_bytes)(SSL *s, int type, const void *buf_, int len);
470 int (*ssl_dispatch_alert)(SSL *s);
471 long (*ssl_ctrl)(SSL *s,int cmd,long larg,void *parg);
472 long (*ssl_ctx_ctrl)(SSL_CTX *ctx,int cmd,long larg,void *parg);
473 const SSL_CIPHER *(*get_cipher_by_char)(const unsigned char *ptr);
474 int (*put_cipher_by_char)(const SSL_CIPHER *cipher,unsigned char *ptr);
475 int (*ssl_pending)(const SSL *s);
476 int (*num_ciphers)(void);
477 const SSL_CIPHER *(*get_cipher)(unsigned ncipher);
478 const struct ssl_method_st *(*get_ssl_method)(int version);
479 long (*get_timeout)(void);
480 struct ssl3_enc_method *ssl3_enc; /* Extra SSLv3/TLS stuff */
481 int (*ssl_version)(void);
482 long (*ssl_callback_ctrl)(SSL *s, int cb_id, void (*fp)(void));
483 long (*ssl_ctx_callback_ctrl)(SSL_CTX *s, int cb_id, void (*fp)(void));
484 };
485
486/* Lets make this into an ASN.1 type structure as follows
487 * SSL_SESSION_ID ::= SEQUENCE {
488 * version INTEGER, -- structure version number
489 * SSLversion INTEGER, -- SSL version number
490 * Cipher OCTET STRING, -- the 3 byte cipher ID
491 * Session_ID OCTET STRING, -- the Session ID
492 * Master_key OCTET STRING, -- the master key
493 * KRB5_principal OCTET STRING -- optional Kerberos principal
494 * Key_Arg [ 0 ] IMPLICIT OCTET STRING, -- the optional Key argument
495 * Time [ 1 ] EXPLICIT INTEGER, -- optional Start Time
496 * Timeout [ 2 ] EXPLICIT INTEGER, -- optional Timeout ins seconds
497 * Peer [ 3 ] EXPLICIT X509, -- optional Peer Certificate
498 * Session_ID_context [ 4 ] EXPLICIT OCTET STRING, -- the Session ID context
499 * Verify_result [ 5 ] EXPLICIT INTEGER, -- X509_V_... code for `Peer'
500 * HostName [ 6 ] EXPLICIT OCTET STRING, -- optional HostName from servername TLS extension
501 * PSK_identity_hint [ 7 ] EXPLICIT OCTET STRING, -- optional PSK identity hint
502 * PSK_identity [ 8 ] EXPLICIT OCTET STRING, -- optional PSK identity
503 * Ticket_lifetime_hint [9] EXPLICIT INTEGER, -- server's lifetime hint for session ticket
504 * Ticket [10] EXPLICIT OCTET STRING, -- session ticket (clients only)
505 * Compression_meth [11] EXPLICIT OCTET STRING, -- optional compression method
506 * SRP_username [ 12 ] EXPLICIT OCTET STRING -- optional SRP username
Adam Langley75872532014-06-20 12:00:00 -0700507 * Peer SHA256 [13] EXPLICIT OCTET STRING, -- optional SHA256 hash of Peer certifiate
Adam Langley95c29f32014-06-20 12:00:00 -0700508 * }
509 * Look in ssl/ssl_asn1.c for more details
510 * I'm using EXPLICIT tags so I can read the damn things using asn1parse :-).
511 */
512struct ssl_session_st
513 {
514 int ssl_version; /* what ssl version session info is
515 * being kept in here? */
516
517 /* only really used in SSLv2 */
518 unsigned int key_arg_length;
519 unsigned char key_arg[SSL_MAX_KEY_ARG_LENGTH];
520 int master_key_length;
521 unsigned char master_key[SSL_MAX_MASTER_KEY_LENGTH];
522 /* session_id - valid? */
523 unsigned int session_id_length;
524 unsigned char session_id[SSL_MAX_SSL_SESSION_ID_LENGTH];
525 /* this is used to determine whether the session is being reused in
526 * the appropriate context. It is up to the application to set this,
527 * via SSL_new */
528 unsigned int sid_ctx_length;
529 unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
530
531#ifndef OPENSSL_NO_PSK
532 char *psk_identity_hint;
533 char *psk_identity;
534#endif
535 /* Used to indicate that session resumption is not allowed.
536 * Applications can also set this bit for a new session via
537 * not_resumable_session_cb to disable session caching and tickets. */
538 int not_resumable;
539
540 /* The cert is the certificate used to establish this connection */
541 struct sess_cert_st /* SESS_CERT */ *sess_cert;
542
543 /* This is the cert for the other end.
544 * On clients, it will be the same as sess_cert->peer_key->x509
545 * (the latter is not enough as sess_cert is not retained
546 * in the external representation of sessions, see ssl_asn1.c). */
547 X509 *peer;
548 /* when app_verify_callback accepts a session where the peer's certificate
549 * is not ok, we must remember the error for session reuse: */
550 long verify_result; /* only for servers */
551
552 int references;
553 long timeout;
554 long time;
555
556 unsigned int compress_meth; /* Need to lookup the method */
557
558 const SSL_CIPHER *cipher;
559 unsigned long cipher_id; /* when ASN.1 loaded, this
560 * needs to be used to load
561 * the 'cipher' structure */
562
563 STACK_OF(SSL_CIPHER) *ciphers; /* shared ciphers? */
564
565 CRYPTO_EX_DATA ex_data; /* application specific data */
566
567 /* These are used to make removal of session-ids more
568 * efficient and to implement a maximum cache size. */
569 struct ssl_session_st *prev,*next;
570#ifndef OPENSSL_NO_TLSEXT
571 char *tlsext_hostname;
572#ifndef OPENSSL_NO_EC
573 size_t tlsext_ecpointformatlist_length;
574 unsigned char *tlsext_ecpointformatlist; /* peer's list */
575 size_t tlsext_ellipticcurvelist_length;
576 unsigned char *tlsext_ellipticcurvelist; /* peer's list */
577#endif /* OPENSSL_NO_EC */
578 /* RFC4507 info */
579 unsigned char *tlsext_tick; /* Session ticket */
580 size_t tlsext_ticklen; /* Session ticket length */
581 long tlsext_tick_lifetime_hint; /* Session lifetime hint in seconds */
582#endif
Adam Langley75872532014-06-20 12:00:00 -0700583 char peer_sha256_valid; /* Non-zero if peer_sha256 is valid */
584 unsigned char peer_sha256[SHA256_DIGEST_LENGTH]; /* SHA256 of peer certificate */
Adam Langley95c29f32014-06-20 12:00:00 -0700585#ifndef OPENSSL_NO_TLSEXT
586 /* Used by client: the proof for this session.
587 * We store it outside the sess_cert structure, since the proof
588 * is received before the certificate. */
589 unsigned char *audit_proof;
590 size_t audit_proof_length;
591#endif
Adam Langley1258b6a2014-06-20 12:00:00 -0700592
593 /* original_handshake_hash contains the handshake hash (either
594 * SHA-1+MD5 or SHA-2, depending on TLS version) for the original, full
595 * handshake that created a session. This is used by Channel IDs during
596 * resumption. */
597 unsigned char original_handshake_hash[EVP_MAX_MD_SIZE];
598 unsigned int original_handshake_hash_len;
Adam Langley95c29f32014-06-20 12:00:00 -0700599 };
600
601#endif
602
603#define SSL_OP_MICROSOFT_SESS_ID_BUG 0x00000001L
604#define SSL_OP_NETSCAPE_CHALLENGE_BUG 0x00000002L
605/* Allow initial connection to servers that don't support RI */
606#define SSL_OP_LEGACY_SERVER_CONNECT 0x00000004L
607#define SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG 0x00000008L
608#define SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG 0x00000010L
609#define SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER 0x00000020L
610#define SSL_OP_SAFARI_ECDHE_ECDSA_BUG 0x00000040L
611#define SSL_OP_SSLEAY_080_CLIENT_DH_BUG 0x00000080L
612#define SSL_OP_TLS_D5_BUG 0x00000100L
613#define SSL_OP_TLS_BLOCK_PADDING_BUG 0x00000200L
614
615/* Hasn't done anything since OpenSSL 0.9.7h, retained for compatibility */
616#define SSL_OP_MSIE_SSLV2_RSA_PADDING 0x0
617
Adam Langleyd493d522014-06-20 12:00:00 -0700618/* SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS is vestigial. Previously it disabled the
619 * insertion of empty records in CBC mode, but the empty records were commonly
620 * misinterpreted as EOF by other TLS stacks and so this was disabled by
621 * SSL_OP_ALL.
622 *
623 * This has been replaced by 1/n-1 record splitting, which is enabled by
624 * SSL_MODE_CBC_RECORD_SPLITTING in SSL_set_mode. This involves sending a
625 * one-byte record rather than an empty record and has much better
626 * compatibility. */
Adam Langley95c29f32014-06-20 12:00:00 -0700627#define SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS 0x00000800L /* added in 0.9.6e */
628
629/* SSL_OP_ALL: various bug workarounds that should be rather harmless.
630 * This used to be 0x000FFFFFL before 0.9.7. */
631#define SSL_OP_ALL 0x80000BFFL
632
633/* DTLS options */
634#define SSL_OP_NO_QUERY_MTU 0x00001000L
635/* Turn on Cookie Exchange (on relevant for servers) */
636#define SSL_OP_COOKIE_EXCHANGE 0x00002000L
637/* Don't use RFC4507 ticket extension */
638#define SSL_OP_NO_TICKET 0x00004000L
639/* Use Cisco's "speshul" version of DTLS_BAD_VER (as client) */
640#define SSL_OP_CISCO_ANYCONNECT 0x00008000L
641
642/* As server, disallow session resumption on renegotiation */
643#define SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION 0x00010000L
644/* Don't use compression even if supported */
645#define SSL_OP_NO_COMPRESSION 0x00020000L
646/* Permit unsafe legacy renegotiation */
647#define SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION 0x00040000L
648/* If set, always create a new key when using tmp_ecdh parameters */
649#define SSL_OP_SINGLE_ECDH_USE 0x00080000L
650/* If set, always create a new key when using tmp_dh parameters */
651#define SSL_OP_SINGLE_DH_USE 0x00100000L
652/* Set to always use the tmp_rsa key when doing RSA operations,
653 * even when this violates protocol specs */
654#define SSL_OP_EPHEMERAL_RSA 0x00200000L
655/* Set on servers to choose the cipher according to the server's
656 * preferences */
657#define SSL_OP_CIPHER_SERVER_PREFERENCE 0x00400000L
658/* If set, a server will allow a client to issue a SSLv3.0 version number
659 * as latest version supported in the premaster secret, even when TLSv1.0
660 * (version 3.1) was announced in the client hello. Normally this is
661 * forbidden to prevent version rollback attacks. */
662#define SSL_OP_TLS_ROLLBACK_BUG 0x00800000L
663
664#define SSL_OP_NO_SSLv2 0x01000000L
665#define SSL_OP_NO_SSLv3 0x02000000L
666#define SSL_OP_NO_TLSv1 0x04000000L
667#define SSL_OP_NO_TLSv1_2 0x08000000L
668#define SSL_OP_NO_TLSv1_1 0x10000000L
669
670#define SSL_OP_NO_DTLSv1 0x04000000L
671#define SSL_OP_NO_DTLSv1_2 0x08000000L
672
673#define SSL_OP_NO_SSL_MASK (SSL_OP_NO_SSLv2|SSL_OP_NO_SSLv3|\
674 SSL_OP_NO_TLSv1|SSL_OP_NO_TLSv1_1|SSL_OP_NO_TLSv1_2)
675
676/* These next two were never actually used for anything since SSLeay
677 * zap so we have some more flags.
678 */
679/* The next flag deliberately changes the ciphertest, this is a check
680 * for the PKCS#1 attack */
681#define SSL_OP_PKCS1_CHECK_1 0x0
682#define SSL_OP_PKCS1_CHECK_2 0x0
683
684#define SSL_OP_NETSCAPE_CA_DN_BUG 0x20000000L
685#define SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG 0x40000000L
686/* Make server add server-hello extension from early version of
687 * cryptopro draft, when GOST ciphersuite is negotiated.
688 * Required for interoperability with CryptoPro CSP 3.x
689 */
690#define SSL_OP_CRYPTOPRO_TLSEXT_BUG 0x80000000L
691
692/* Allow SSL_write(..., n) to return r with 0 < r < n (i.e. report success
693 * when just a single record has been written): */
694#define SSL_MODE_ENABLE_PARTIAL_WRITE 0x00000001L
695/* Make it possible to retry SSL_write() with changed buffer location
696 * (buffer contents must stay the same!); this is not the default to avoid
697 * the misconception that non-blocking SSL_write() behaves like
698 * non-blocking write(): */
699#define SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER 0x00000002L
700/* Never bother the application with retries if the transport
701 * is blocking: */
702#define SSL_MODE_AUTO_RETRY 0x00000004L
703/* Don't attempt to automatically build certificate chain */
704#define SSL_MODE_NO_AUTO_CHAIN 0x00000008L
705/* Save RAM by releasing read and write buffers when they're empty. (SSL3 and
Adam Langley1b9d4772014-06-20 12:00:00 -0700706 * TLS only.) "Released" buffers are put onto a free-list in the context or
707 * just freed (depending on the context's setting for freelist_max_len). Also
708 * frees up RAM by releasing the list of client ciphersuites as soon as
709 * possible (SSL3 and TLS only). This stops SSL_get_shared_ciphers from
710 * working. */
Adam Langley95c29f32014-06-20 12:00:00 -0700711#define SSL_MODE_RELEASE_BUFFERS 0x00000010L
Adam Langleyadb739e2014-06-20 12:00:00 -0700712
Adam Langley95c29f32014-06-20 12:00:00 -0700713/* Send the current time in the Random fields of the ClientHello and
714 * ServerHello records for compatibility with hypothetical implementations
715 * that require it.
716 */
717#define SSL_MODE_SEND_CLIENTHELLO_TIME 0x00000020L
718#define SSL_MODE_SEND_SERVERHELLO_TIME 0x00000040L
719
720/* Cert related flags */
721/* Many implementations ignore some aspects of the TLS standards such as
722 * enforcing certifcate chain algorithms. When this is set we enforce them.
723 */
724#define SSL_CERT_FLAG_TLS_STRICT 0x00000001L
725
726/* Suite B modes, takes same values as certificate verify flags */
727#define SSL_CERT_FLAG_SUITEB_128_LOS_ONLY 0x10000
728/* Suite B 192 bit only mode */
729#define SSL_CERT_FLAG_SUITEB_192_LOS 0x20000
730/* Suite B 128 bit mode allowing 192 bit algorithms */
731#define SSL_CERT_FLAG_SUITEB_128_LOS 0x30000
732
733/* Perform all sorts of protocol violations for testing purposes */
734#define SSL_CERT_FLAG_BROKEN_PROTOCOL 0x10000000
735
736/* Flags for building certificate chains */
737/* Treat any existing certificates as untrusted CAs */
738#define SSL_BUILD_CHAIN_FLAG_UNTRUSTED 0x1
739/* Don't include root CA in chain */
740#define SSL_BUILD_CHAIN_FLAG_NO_ROOT 0x2
741
742/* Flags returned by SSL_check_chain */
743/* Certificate can be used with this session */
744#define CERT_PKEY_VALID 0x1
745/* Certificate can also be used for signing */
746#define CERT_PKEY_SIGN 0x2
747/* EE certificate signing algorithm OK */
748#define CERT_PKEY_EE_SIGNATURE 0x10
749/* CA signature algorithms OK */
750#define CERT_PKEY_CA_SIGNATURE 0x20
751/* EE certificate parameters OK */
752#define CERT_PKEY_EE_PARAM 0x40
753/* CA certificate parameters OK */
754#define CERT_PKEY_CA_PARAM 0x80
755/* Signing explicitly allowed as opposed to SHA1 fallback */
756#define CERT_PKEY_EXPLICIT_SIGN 0x100
757/* Client CA issuer names match (always set for server cert) */
758#define CERT_PKEY_ISSUER_NAME 0x200
759/* Cert type matches client types (always set for server cert) */
760#define CERT_PKEY_CERT_TYPE 0x400
761/* Cert chain suitable to Suite B */
762#define CERT_PKEY_SUITEB 0x800
763
764#define SSL_CONF_FLAG_CMDLINE 0x1
765#define SSL_CONF_FLAG_FILE 0x2
766#define SSL_CONF_FLAG_CLIENT 0x4
767#define SSL_CONF_FLAG_SERVER 0x8
768#define SSL_CONF_FLAG_SHOW_ERRORS 0x10
769#define SSL_CONF_FLAG_CERTIFICATE 0x20
770/* Configuration value types */
771#define SSL_CONF_TYPE_UNKNOWN 0x0
772#define SSL_CONF_TYPE_STRING 0x1
773#define SSL_CONF_TYPE_FILE 0x2
774#define SSL_CONF_TYPE_DIR 0x3
775
Adam Langleyadb739e2014-06-20 12:00:00 -0700776/* When set, clients may send application data before receipt of CCS
777 * and Finished. This mode enables full-handshakes to 'complete' in
778 * one RTT. */
779#define SSL_MODE_HANDSHAKE_CUTTHROUGH 0x00000080L
780
Adam Langleyd493d522014-06-20 12:00:00 -0700781/* When set, TLS 1.0 and SSLv3, multi-byte, CBC records will be split in two:
782 * the first record will contain a single byte and the second will contain the
783 * rest of the bytes. This effectively randomises the IV and prevents BEAST
784 * attacks. */
785#define SSL_MODE_CBC_RECORD_SPLITTING 0x00000100L
786
Adam Langley95c29f32014-06-20 12:00:00 -0700787/* Note: SSL[_CTX]_set_{options,mode} use |= op on the previous value,
788 * they cannot be used to clear bits. */
789
790#define SSL_CTX_set_options(ctx,op) \
791 SSL_CTX_ctrl((ctx),SSL_CTRL_OPTIONS,(op),NULL)
792#define SSL_CTX_clear_options(ctx,op) \
793 SSL_CTX_ctrl((ctx),SSL_CTRL_CLEAR_OPTIONS,(op),NULL)
794#define SSL_CTX_get_options(ctx) \
795 SSL_CTX_ctrl((ctx),SSL_CTRL_OPTIONS,0,NULL)
796#define SSL_set_options(ssl,op) \
797 SSL_ctrl((ssl),SSL_CTRL_OPTIONS,(op),NULL)
798#define SSL_clear_options(ssl,op) \
799 SSL_ctrl((ssl),SSL_CTRL_CLEAR_OPTIONS,(op),NULL)
800#define SSL_get_options(ssl) \
801 SSL_ctrl((ssl),SSL_CTRL_OPTIONS,0,NULL)
802
803#define SSL_CTX_set_mode(ctx,op) \
804 SSL_CTX_ctrl((ctx),SSL_CTRL_MODE,(op),NULL)
805#define SSL_CTX_clear_mode(ctx,op) \
806 SSL_CTX_ctrl((ctx),SSL_CTRL_CLEAR_MODE,(op),NULL)
807#define SSL_CTX_get_mode(ctx) \
808 SSL_CTX_ctrl((ctx),SSL_CTRL_MODE,0,NULL)
809#define SSL_clear_mode(ssl,op) \
810 SSL_ctrl((ssl),SSL_CTRL_CLEAR_MODE,(op),NULL)
811#define SSL_set_mode(ssl,op) \
812 SSL_ctrl((ssl),SSL_CTRL_MODE,(op),NULL)
813#define SSL_get_mode(ssl) \
814 SSL_ctrl((ssl),SSL_CTRL_MODE,0,NULL)
815#define SSL_set_mtu(ssl, mtu) \
816 SSL_ctrl((ssl),SSL_CTRL_SET_MTU,(mtu),NULL)
817
818#define SSL_get_secure_renegotiation_support(ssl) \
819 SSL_ctrl((SSL*) (ssl), SSL_CTRL_GET_RI_SUPPORT, 0, NULL)
820
821#ifndef OPENSSL_NO_HEARTBEATS
822#define SSL_heartbeat(ssl) \
823 SSL_ctrl((ssl),SSL_CTRL_TLS_EXT_SEND_HEARTBEAT,0,NULL)
824#endif
825
826#define SSL_CTX_set_cert_flags(ctx,op) \
827 SSL_CTX_ctrl((ctx),SSL_CTRL_CERT_FLAGS,(op),NULL)
828#define SSL_set_cert_flags(s,op) \
829 SSL_ctrl((s),SSL_CTRL_CERT_FLAGS,(op),NULL)
830#define SSL_CTX_clear_cert_flags(ctx,op) \
831 SSL_CTX_ctrl((ctx),SSL_CTRL_CLEAR_CERT_FLAGS,(op),NULL)
832#define SSL_clear_cert_flags(s,op) \
833 SSL_ctrl((s),SSL_CTRL_CLEAR_CERT_FLAGS,(op),NULL)
834
835void SSL_CTX_set_msg_callback(SSL_CTX *ctx, void (*cb)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg));
836void SSL_set_msg_callback(SSL *ssl, void (*cb)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg));
837#define SSL_CTX_set_msg_callback_arg(ctx, arg) SSL_CTX_ctrl((ctx), SSL_CTRL_SET_MSG_CALLBACK_ARG, 0, (arg))
838#define SSL_set_msg_callback_arg(ssl, arg) SSL_ctrl((ssl), SSL_CTRL_SET_MSG_CALLBACK_ARG, 0, (arg))
839
840
Adam Langleyc9fb3752014-06-20 12:00:00 -0700841struct ssl_aead_ctx_st;
842typedef struct ssl_aead_ctx_st SSL_AEAD_CTX;
843
Adam Langley95c29f32014-06-20 12:00:00 -0700844#if defined(OPENSSL_SYS_MSDOS) && !defined(OPENSSL_SYS_WIN32)
845#define SSL_MAX_CERT_LIST_DEFAULT 1024*30 /* 30k max cert list :-) */
846#else
847#define SSL_MAX_CERT_LIST_DEFAULT 1024*100 /* 100k max cert list :-) */
848#endif
849
850#define SSL_SESSION_CACHE_MAX_SIZE_DEFAULT (1024*20)
851
852/* This callback type is used inside SSL_CTX, SSL, and in the functions that set
853 * them. It is used to override the generation of SSL/TLS session IDs in a
854 * server. Return value should be zero on an error, non-zero to proceed. Also,
855 * callbacks should themselves check if the id they generate is unique otherwise
856 * the SSL handshake will fail with an error - callbacks can do this using the
857 * 'ssl' value they're passed by;
858 * SSL_has_matching_session_id(ssl, id, *id_len)
859 * The length value passed in is set at the maximum size the session ID can be.
860 * In SSLv2 this is 16 bytes, whereas SSLv3/TLSv1 it is 32 bytes. The callback
861 * can alter this length to be less if desired, but under SSLv2 session IDs are
862 * supposed to be fixed at 16 bytes so the id will be padded after the callback
863 * returns in this case. It is also an error for the callback to set the size to
864 * zero. */
865typedef int (*GEN_SESSION_CB)(const SSL *ssl, unsigned char *id,
866 unsigned int *id_len);
867
Adam Langleydc9b1412014-06-20 12:00:00 -0700868/* ssl_early_callback_ctx is passed to certain callbacks that are called very
869 * early on during the server handshake. At this point, much of the SSL*
870 * hasn't been filled out and only the ClientHello can be depended on. */
871struct ssl_early_callback_ctx
872 {
873 SSL *ssl;
874 const unsigned char *client_hello; size_t client_hello_len;
875 const unsigned char *session_id; size_t session_id_len;
876 const unsigned char *cipher_suites; size_t cipher_suites_len;
877 const unsigned char *compression_methods;size_t compression_methods_len;
878 const unsigned char *extensions; size_t extensions_len;
879 };
880
881/* SSL_early_callback_ctx_extension_get searches the extensions in |ctx| for
882 * an extension of the given type. If not found, it returns zero. Otherwise
883 * it sets |out_data| to point to the extension contents (not including the type
884 * and length bytes), sets |out_len| to the length of the extension contents
885 * and returns one. */
886char
887SSL_early_callback_ctx_extension_get(const struct ssl_early_callback_ctx *ctx,
888 uint16_t extension_type,
889 const unsigned char **out_data,
890 size_t *out_len);
891
Adam Langley95c29f32014-06-20 12:00:00 -0700892typedef struct ssl_comp_st SSL_COMP;
893
894#ifndef OPENSSL_NO_SSL_INTERN
895
896struct ssl_comp_st
897 {
898 int id;
899 const char *name;
900 char *method;
901 };
902
903DECLARE_STACK_OF(SSL_COMP)
904DECLARE_LHASH_OF(SSL_SESSION);
905
Adam Langley858a88d2014-06-20 12:00:00 -0700906/* ssl_cipher_preference_list_st contains a list of SSL_CIPHERs with
907 * equal-preference groups. For TLS clients, the groups are moot because the
908 * server picks the cipher and groups cannot be expressed on the wire. However,
909 * for servers, the equal-preference groups allow the client's preferences to
910 * be partially respected. (This only has an effect with
911 * SSL_OP_CIPHER_SERVER_PREFERENCE).
912 *
913 * The equal-preference groups are expressed by grouping SSL_CIPHERs together.
914 * All elements of a group have the same priority: no ordering is expressed
915 * within a group.
916 *
917 * The values in |ciphers| are in one-to-one correspondence with
918 * |in_group_flags|. (That is, sk_SSL_CIPHER_num(ciphers) is the number of
919 * bytes in |in_group_flags|.) The bytes in |in_group_flags| are either 1, to
920 * indicate that the corresponding SSL_CIPHER is not the last element of a
921 * group, or 0 to indicate that it is.
922 *
923 * For example, if |in_group_flags| contains all zeros then that indicates a
924 * traditional, fully-ordered preference. Every SSL_CIPHER is the last element
925 * of the group (i.e. they are all in a one-element group).
926 *
927 * For a more complex example, consider:
928 * ciphers: A B C D E F
929 * in_group_flags: 1 1 0 0 1 0
930 *
931 * That would express the following, order:
932 *
933 * A E
934 * B -> D -> F
935 * C
936 */
937struct ssl_cipher_preference_list_st
938 {
939 STACK_OF(SSL_CIPHER) *ciphers;
940 unsigned char *in_group_flags;
941 };
942
Adam Langley95c29f32014-06-20 12:00:00 -0700943struct ssl_ctx_st
944 {
945 const SSL_METHOD *method;
946
Adam Langley858a88d2014-06-20 12:00:00 -0700947 struct ssl_cipher_preference_list_st *cipher_list;
Adam Langley95c29f32014-06-20 12:00:00 -0700948 /* same as above but sorted for lookup */
949 STACK_OF(SSL_CIPHER) *cipher_list_by_id;
Adam Langley0b5c1ac2014-06-20 12:00:00 -0700950 /* cipher_list_tls11 is the list of ciphers when TLS 1.1 or greater is
951 * in use. This only applies to server connections as, for clients, the
952 * version number is known at connect time and so the cipher list can
953 * be set then. */
Adam Langley858a88d2014-06-20 12:00:00 -0700954 struct ssl_cipher_preference_list_st *cipher_list_tls11;
Adam Langley95c29f32014-06-20 12:00:00 -0700955
956 struct x509_store_st /* X509_STORE */ *cert_store;
957 LHASH_OF(SSL_SESSION) *sessions;
958 /* Most session-ids that will be cached, default is
959 * SSL_SESSION_CACHE_MAX_SIZE_DEFAULT. 0 is unlimited. */
960 unsigned long session_cache_size;
961 struct ssl_session_st *session_cache_head;
962 struct ssl_session_st *session_cache_tail;
963
964 /* This can have one of 2 values, ored together,
965 * SSL_SESS_CACHE_CLIENT,
966 * SSL_SESS_CACHE_SERVER,
967 * Default is SSL_SESSION_CACHE_SERVER, which means only
968 * SSL_accept which cache SSL_SESSIONS. */
969 int session_cache_mode;
970
971 /* If timeout is not 0, it is the default timeout value set
972 * when SSL_new() is called. This has been put in to make
973 * life easier to set things up */
974 long session_timeout;
975
976 /* If this callback is not null, it will be called each
977 * time a session id is added to the cache. If this function
978 * returns 1, it means that the callback will do a
979 * SSL_SESSION_free() when it has finished using it. Otherwise,
980 * on 0, it means the callback has finished with it.
981 * If remove_session_cb is not null, it will be called when
982 * a session-id is removed from the cache. After the call,
983 * OpenSSL will SSL_SESSION_free() it. */
984 int (*new_session_cb)(struct ssl_st *ssl,SSL_SESSION *sess);
985 void (*remove_session_cb)(struct ssl_ctx_st *ctx,SSL_SESSION *sess);
986 SSL_SESSION *(*get_session_cb)(struct ssl_st *ssl,
987 unsigned char *data,int len,int *copy);
988
989 struct
990 {
991 int sess_connect; /* SSL new conn - started */
992 int sess_connect_renegotiate;/* SSL reneg - requested */
993 int sess_connect_good; /* SSL new conne/reneg - finished */
994 int sess_accept; /* SSL new accept - started */
995 int sess_accept_renegotiate;/* SSL reneg - requested */
996 int sess_accept_good; /* SSL accept/reneg - finished */
997 int sess_miss; /* session lookup misses */
998 int sess_timeout; /* reuse attempt on timeouted session */
999 int sess_cache_full; /* session removed due to full cache */
1000 int sess_hit; /* session reuse actually done */
1001 int sess_cb_hit; /* session-id that was not
1002 * in the cache was
1003 * passed back via the callback. This
1004 * indicates that the application is
1005 * supplying session-id's from other
1006 * processes - spooky :-) */
1007 } stats;
1008
1009 int references;
1010
1011 /* if defined, these override the X509_verify_cert() calls */
1012 int (*app_verify_callback)(X509_STORE_CTX *, void *);
1013 void *app_verify_arg;
1014 /* before OpenSSL 0.9.7, 'app_verify_arg' was ignored
1015 * ('app_verify_callback' was called with just one argument) */
1016
1017 /* Default password callback. */
1018 pem_password_cb *default_passwd_callback;
1019
1020 /* Default password callback user data. */
1021 void *default_passwd_callback_userdata;
1022
1023 /* get client cert callback */
1024 int (*client_cert_cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey);
1025
Adam Langley1258b6a2014-06-20 12:00:00 -07001026 /* get channel id callback */
1027 void (*channel_id_cb)(SSL *ssl, EVP_PKEY **pkey);
1028
Adam Langley95c29f32014-06-20 12:00:00 -07001029 /* cookie generate callback */
1030 int (*app_gen_cookie_cb)(SSL *ssl, unsigned char *cookie,
1031 unsigned int *cookie_len);
1032
1033 /* verify cookie callback */
1034 int (*app_verify_cookie_cb)(SSL *ssl, unsigned char *cookie,
1035 unsigned int cookie_len);
1036
1037 CRYPTO_EX_DATA ex_data;
1038
1039 const EVP_MD *rsa_md5;/* For SSLv2 - name is 'ssl2-md5' */
1040 const EVP_MD *md5; /* For SSLv3/TLSv1 'ssl3-md5' */
1041 const EVP_MD *sha1; /* For SSLv3/TLSv1 'ssl3->sha1' */
1042
1043 STACK_OF(X509) *extra_certs;
1044 STACK_OF(SSL_COMP) *comp_methods; /* stack of SSL_COMP, SSLv3/TLSv1 */
1045
1046
1047 /* Default values used when no per-SSL value is defined follow */
1048
1049 void (*info_callback)(const SSL *ssl,int type,int val); /* used if SSL's info_callback is NULL */
1050
1051 /* what we put in client cert requests */
1052 STACK_OF(X509_NAME) *client_CA;
1053
1054
1055 /* Default values to use in SSL structures follow (these are copied by SSL_new) */
1056
1057 unsigned long options;
1058 unsigned long mode;
1059 long max_cert_list;
1060
1061 struct cert_st /* CERT */ *cert;
1062 int read_ahead;
1063
1064 /* callback that allows applications to peek at protocol messages */
1065 void (*msg_callback)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg);
1066 void *msg_callback_arg;
1067
1068 int verify_mode;
1069 unsigned int sid_ctx_length;
1070 unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
1071 int (*default_verify_callback)(int ok,X509_STORE_CTX *ctx); /* called 'verify_callback' in the SSL */
1072
1073 /* Default generate session ID callback. */
1074 GEN_SESSION_CB generate_session_id;
1075
1076 X509_VERIFY_PARAM *param;
1077
Adam Langleydc9b1412014-06-20 12:00:00 -07001078 /* select_certificate_cb is called before most ClientHello processing
1079 * and before the decision whether to resume a session is made.
1080 * It may return one to continue the handshake or zero to cause the
1081 * handshake loop to return with an error and cause SSL_get_error to
1082 * return SSL_ERROR_PENDING_CERTIFICATE. */
1083 int (*select_certificate_cb) (const struct ssl_early_callback_ctx *);
1084
Adam Langley95c29f32014-06-20 12:00:00 -07001085#if 0
1086 int purpose; /* Purpose setting */
1087 int trust; /* Trust setting */
1088#endif
1089
1090 int quiet_shutdown;
1091
1092 /* Maximum amount of data to send in one fragment.
1093 * actual record size can be more than this due to
1094 * padding and MAC overheads.
1095 */
1096 unsigned int max_send_fragment;
1097
1098#ifndef OPENSSL_ENGINE
1099 /* Engine to pass requests for client certs to
1100 */
1101 ENGINE *client_cert_engine;
1102#endif
1103
1104#ifndef OPENSSL_NO_TLSEXT
1105 /* TLS extensions servername callback */
1106 int (*tlsext_servername_callback)(SSL*, int *, void *);
1107 void *tlsext_servername_arg;
1108 /* RFC 4507 session ticket keys */
1109 unsigned char tlsext_tick_key_name[16];
1110 unsigned char tlsext_tick_hmac_key[16];
1111 unsigned char tlsext_tick_aes_key[16];
1112 /* Callback to support customisation of ticket key setting */
1113 int (*tlsext_ticket_key_cb)(SSL *ssl,
1114 unsigned char *name, unsigned char *iv,
1115 EVP_CIPHER_CTX *ectx,
1116 HMAC_CTX *hctx, int enc);
1117
1118 /* certificate status request info */
1119 /* Callback for status request */
1120 int (*tlsext_status_cb)(SSL *ssl, void *arg);
1121 void *tlsext_status_arg;
1122
1123 /* draft-rescorla-tls-opaque-prf-input-00.txt information */
1124 int (*tlsext_opaque_prf_input_callback)(SSL *, void *peerinput, size_t len, void *arg);
1125 void *tlsext_opaque_prf_input_callback_arg;
1126#endif
1127
1128#ifndef OPENSSL_NO_PSK
1129 char *psk_identity_hint;
1130 unsigned int (*psk_client_callback)(SSL *ssl, const char *hint, char *identity,
1131 unsigned int max_identity_len, unsigned char *psk,
1132 unsigned int max_psk_len);
1133 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
1134 unsigned char *psk, unsigned int max_psk_len);
1135#endif
1136
1137#ifndef OPENSSL_NO_BUF_FREELISTS
1138#define SSL_MAX_BUF_FREELIST_LEN_DEFAULT 32
1139 unsigned int freelist_max_len;
1140 struct ssl3_buf_freelist_st *wbuf_freelist;
1141 struct ssl3_buf_freelist_st *rbuf_freelist;
Adam Langley75872532014-06-20 12:00:00 -07001142 /* retain_only_sha256_of_client_certs is true if we should compute the
1143 * SHA256 hash of the peer's certifiate and then discard it to save
1144 * memory and session space. Only effective on the server side. */
1145 char retain_only_sha256_of_client_certs;
Adam Langley95c29f32014-06-20 12:00:00 -07001146#endif
1147
1148#ifndef OPENSSL_NO_TLSEXT
1149
1150# ifndef OPENSSL_NO_NEXTPROTONEG
1151 /* Next protocol negotiation information */
1152 /* (for experimental NPN extension). */
1153
1154 /* For a server, this contains a callback function by which the set of
1155 * advertised protocols can be provided. */
1156 int (*next_protos_advertised_cb)(SSL *s, const unsigned char **buf,
1157 unsigned int *len, void *arg);
1158 void *next_protos_advertised_cb_arg;
1159 /* For a client, this contains a callback function that selects the
1160 * next protocol from the list provided by the server. */
1161 int (*next_proto_select_cb)(SSL *s, unsigned char **out,
1162 unsigned char *outlen,
1163 const unsigned char *in,
1164 unsigned int inlen,
1165 void *arg);
1166 void *next_proto_select_cb_arg;
1167# endif
1168
1169 /* ALPN information
1170 * (we are in the process of transitioning from NPN to ALPN.) */
1171
1172 /* For a server, this contains a callback function that allows the
1173 * server to select the protocol for the connection.
1174 * out: on successful return, this must point to the raw protocol
1175 * name (without the length prefix).
1176 * outlen: on successful return, this contains the length of |*out|.
1177 * in: points to the client's list of supported protocols in
1178 * wire-format.
1179 * inlen: the length of |in|. */
1180 int (*alpn_select_cb)(SSL *s,
1181 const unsigned char **out,
1182 unsigned char *outlen,
1183 const unsigned char* in,
1184 unsigned int inlen,
1185 void *arg);
1186 void *alpn_select_cb_arg;
1187
1188 /* For a client, this contains the list of supported protocols in wire
1189 * format. */
1190 unsigned char* alpn_client_proto_list;
1191 unsigned alpn_client_proto_list_len;
1192
1193 /* SRTP profiles we are willing to do from RFC 5764 */
1194 STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles;
1195# ifndef OPENSSL_NO_EC
1196 /* EC extension values inherited by SSL structure */
1197 size_t tlsext_ecpointformatlist_length;
1198 unsigned char *tlsext_ecpointformatlist;
1199 size_t tlsext_ellipticcurvelist_length;
1200 unsigned char *tlsext_ellipticcurvelist;
1201# endif /* OPENSSL_NO_EC */
1202 int (*tlsext_authz_server_audit_proof_cb)(SSL *s, void *arg);
1203 void *tlsext_authz_server_audit_proof_cb_arg;
1204#endif
1205
1206 /* Arrays containing the callbacks for custom TLS Extensions. */
1207 custom_cli_ext_record *custom_cli_ext_records;
1208 size_t custom_cli_ext_records_count;
1209 custom_srv_ext_record *custom_srv_ext_records;
1210 size_t custom_srv_ext_records_count;
Adam Langley1258b6a2014-06-20 12:00:00 -07001211
1212 /* If true, a client will advertise the Channel ID extension and a
1213 * server will echo it. */
1214 char tlsext_channel_id_enabled;
1215 /* tlsext_channel_id_enabled_new is a hack to support both old and new
1216 * ChannelID signatures. It indicates that a client should advertise the
1217 * new ChannelID extension number. */
1218 char tlsext_channel_id_enabled_new;
1219 /* The client's Channel ID private key. */
1220 EVP_PKEY *tlsext_channel_id_private;
1221
Adam Langley95c29f32014-06-20 12:00:00 -07001222 };
1223
1224#endif
1225
1226#define SSL_SESS_CACHE_OFF 0x0000
1227#define SSL_SESS_CACHE_CLIENT 0x0001
1228#define SSL_SESS_CACHE_SERVER 0x0002
1229#define SSL_SESS_CACHE_BOTH (SSL_SESS_CACHE_CLIENT|SSL_SESS_CACHE_SERVER)
1230#define SSL_SESS_CACHE_NO_AUTO_CLEAR 0x0080
1231/* enough comments already ... see SSL_CTX_set_session_cache_mode(3) */
1232#define SSL_SESS_CACHE_NO_INTERNAL_LOOKUP 0x0100
1233#define SSL_SESS_CACHE_NO_INTERNAL_STORE 0x0200
1234#define SSL_SESS_CACHE_NO_INTERNAL \
1235 (SSL_SESS_CACHE_NO_INTERNAL_LOOKUP|SSL_SESS_CACHE_NO_INTERNAL_STORE)
1236
1237LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx);
1238#define SSL_CTX_sess_number(ctx) \
1239 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_NUMBER,0,NULL)
1240#define SSL_CTX_sess_connect(ctx) \
1241 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT,0,NULL)
1242#define SSL_CTX_sess_connect_good(ctx) \
1243 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT_GOOD,0,NULL)
1244#define SSL_CTX_sess_connect_renegotiate(ctx) \
1245 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT_RENEGOTIATE,0,NULL)
1246#define SSL_CTX_sess_accept(ctx) \
1247 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT,0,NULL)
1248#define SSL_CTX_sess_accept_renegotiate(ctx) \
1249 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT_RENEGOTIATE,0,NULL)
1250#define SSL_CTX_sess_accept_good(ctx) \
1251 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT_GOOD,0,NULL)
1252#define SSL_CTX_sess_hits(ctx) \
1253 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_HIT,0,NULL)
1254#define SSL_CTX_sess_cb_hits(ctx) \
1255 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CB_HIT,0,NULL)
1256#define SSL_CTX_sess_misses(ctx) \
1257 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_MISSES,0,NULL)
1258#define SSL_CTX_sess_timeouts(ctx) \
1259 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_TIMEOUTS,0,NULL)
1260#define SSL_CTX_sess_cache_full(ctx) \
1261 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CACHE_FULL,0,NULL)
Adam Langley1258b6a2014-06-20 12:00:00 -07001262/* SSL_CTX_enable_tls_channel_id configures a TLS server to accept TLS client
1263 * IDs from clients. Returns 1 on success. */
1264#define SSL_CTX_enable_tls_channel_id(ctx) \
1265 SSL_CTX_ctrl(ctx,SSL_CTRL_CHANNEL_ID,0,NULL)
Adam Langley95c29f32014-06-20 12:00:00 -07001266
1267void SSL_CTX_sess_set_new_cb(SSL_CTX *ctx, int (*new_session_cb)(struct ssl_st *ssl,SSL_SESSION *sess));
1268int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx))(struct ssl_st *ssl, SSL_SESSION *sess);
1269void SSL_CTX_sess_set_remove_cb(SSL_CTX *ctx, void (*remove_session_cb)(struct ssl_ctx_st *ctx,SSL_SESSION *sess));
1270void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx))(struct ssl_ctx_st *ctx, SSL_SESSION *sess);
1271void SSL_CTX_sess_set_get_cb(SSL_CTX *ctx, SSL_SESSION *(*get_session_cb)(struct ssl_st *ssl, unsigned char *data,int len,int *copy));
1272SSL_SESSION *(*SSL_CTX_sess_get_get_cb(SSL_CTX *ctx))(struct ssl_st *ssl, unsigned char *Data, int len, int *copy);
Adam Langleyb2ce0582014-06-20 12:00:00 -07001273/* SSL_magic_pending_session_ptr returns a magic SSL_SESSION* which indicates
1274 * that the session isn't currently unavailable. SSL_get_error will then return
1275 * SSL_ERROR_PENDING_SESSION and the handshake can be retried later when the
1276 * lookup has completed. */
1277SSL_SESSION *SSL_magic_pending_session_ptr(void);
Adam Langley95c29f32014-06-20 12:00:00 -07001278void SSL_CTX_set_info_callback(SSL_CTX *ctx, void (*cb)(const SSL *ssl,int type,int val));
1279void (*SSL_CTX_get_info_callback(SSL_CTX *ctx))(const SSL *ssl,int type,int val);
1280void SSL_CTX_set_client_cert_cb(SSL_CTX *ctx, int (*client_cert_cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey));
1281int (*SSL_CTX_get_client_cert_cb(SSL_CTX *ctx))(SSL *ssl, X509 **x509, EVP_PKEY **pkey);
Adam Langley1258b6a2014-06-20 12:00:00 -07001282void SSL_CTX_set_channel_id_cb(SSL_CTX *ctx, void (*channel_id_cb)(SSL *ssl, EVP_PKEY **pkey));
1283void (*SSL_CTX_get_channel_id_cb(SSL_CTX *ctx))(SSL *ssl, EVP_PKEY **pkey);
Adam Langley95c29f32014-06-20 12:00:00 -07001284#ifndef OPENSSL_NO_ENGINE
1285int SSL_CTX_set_client_cert_engine(SSL_CTX *ctx, ENGINE *e);
1286#endif
1287void SSL_CTX_set_cookie_generate_cb(SSL_CTX *ctx, int (*app_gen_cookie_cb)(SSL *ssl, unsigned char *cookie, unsigned int *cookie_len));
1288void SSL_CTX_set_cookie_verify_cb(SSL_CTX *ctx, int (*app_verify_cookie_cb)(SSL *ssl, unsigned char *cookie, unsigned int cookie_len));
1289#ifndef OPENSSL_NO_NEXTPROTONEG
1290void SSL_CTX_set_next_protos_advertised_cb(SSL_CTX *s,
1291 int (*cb) (SSL *ssl,
1292 const unsigned char **out,
1293 unsigned int *outlen,
1294 void *arg), void *arg);
1295void SSL_CTX_set_next_proto_select_cb(SSL_CTX *s,
1296 int (*cb) (SSL *ssl, unsigned char **out,
1297 unsigned char *outlen,
1298 const unsigned char *in,
1299 unsigned int inlen, void *arg),
1300 void *arg);
1301void SSL_get0_next_proto_negotiated(const SSL *s,
1302 const unsigned char **data, unsigned *len);
1303#endif
1304
1305#ifndef OPENSSL_NO_TLSEXT
1306int SSL_select_next_proto(unsigned char **out, unsigned char *outlen,
1307 const unsigned char *in, unsigned int inlen,
1308 const unsigned char *client, unsigned int client_len);
1309#endif
1310
1311#define OPENSSL_NPN_UNSUPPORTED 0
1312#define OPENSSL_NPN_NEGOTIATED 1
1313#define OPENSSL_NPN_NO_OVERLAP 2
1314
1315int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const unsigned char* protos,
1316 unsigned protos_len);
1317int SSL_set_alpn_protos(SSL *ssl, const unsigned char* protos,
1318 unsigned protos_len);
1319void SSL_CTX_set_alpn_select_cb(SSL_CTX* ctx,
1320 int (*cb) (SSL *ssl,
1321 const unsigned char **out,
1322 unsigned char *outlen,
1323 const unsigned char *in,
1324 unsigned int inlen,
1325 void *arg),
1326 void *arg);
1327void SSL_get0_alpn_selected(const SSL *ssl, const unsigned char **data,
1328 unsigned *len);
1329
1330#ifndef OPENSSL_NO_PSK
1331/* the maximum length of the buffer given to callbacks containing the
1332 * resulting identity/psk */
1333#define PSK_MAX_IDENTITY_LEN 128
1334#define PSK_MAX_PSK_LEN 256
1335void SSL_CTX_set_psk_client_callback(SSL_CTX *ctx,
1336 unsigned int (*psk_client_callback)(SSL *ssl, const char *hint,
1337 char *identity, unsigned int max_identity_len, unsigned char *psk,
1338 unsigned int max_psk_len));
1339void SSL_set_psk_client_callback(SSL *ssl,
1340 unsigned int (*psk_client_callback)(SSL *ssl, const char *hint,
1341 char *identity, unsigned int max_identity_len, unsigned char *psk,
1342 unsigned int max_psk_len));
1343void SSL_CTX_set_psk_server_callback(SSL_CTX *ctx,
1344 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
1345 unsigned char *psk, unsigned int max_psk_len));
1346void SSL_set_psk_server_callback(SSL *ssl,
1347 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
1348 unsigned char *psk, unsigned int max_psk_len));
1349int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint);
1350int SSL_use_psk_identity_hint(SSL *s, const char *identity_hint);
1351const char *SSL_get_psk_identity_hint(const SSL *s);
1352const char *SSL_get_psk_identity(const SSL *s);
1353#endif
1354
1355#ifndef OPENSSL_NO_TLSEXT
1356/* Register callbacks to handle custom TLS Extensions as client or server.
1357 *
1358 * Returns nonzero on success. You cannot register twice for the same
1359 * extension number, and registering for an extension number already
1360 * handled by OpenSSL will succeed, but the callbacks will not be invoked.
1361 *
1362 * NULL can be registered for any callback function. For the client
1363 * functions, a NULL custom_cli_ext_first_cb_fn sends an empty ClientHello
1364 * Extension, and a NULL custom_cli_ext_second_cb_fn ignores the ServerHello
1365 * response (if any).
1366 *
1367 * For the server functions, a NULL custom_srv_ext_first_cb_fn means the
1368 * ClientHello extension's data will be ignored, but the extension will still
1369 * be noted and custom_srv_ext_second_cb_fn will still be invoked. A NULL
1370 * custom_srv_ext_second_cb doesn't send a ServerHello extension.
1371 */
1372int SSL_CTX_set_custom_cli_ext(SSL_CTX *ctx, unsigned short ext_type,
1373 custom_cli_ext_first_cb_fn fn1,
1374 custom_cli_ext_second_cb_fn fn2, void *arg);
1375
1376int SSL_CTX_set_custom_srv_ext(SSL_CTX *ctx, unsigned short ext_type,
1377 custom_srv_ext_first_cb_fn fn1,
1378 custom_srv_ext_second_cb_fn fn2, void *arg);
1379#endif
1380
1381#define SSL_NOTHING 1
1382#define SSL_WRITING 2
1383#define SSL_READING 3
1384#define SSL_X509_LOOKUP 4
Adam Langley1258b6a2014-06-20 12:00:00 -07001385#define SSL_CHANNEL_ID_LOOKUP 5
Adam Langleyb2ce0582014-06-20 12:00:00 -07001386#define SSL_PENDING_SESSION 7
Adam Langleydc9b1412014-06-20 12:00:00 -07001387#define SSL_CERTIFICATE_SELECTION_PENDING 8
Adam Langley95c29f32014-06-20 12:00:00 -07001388
1389/* These will only be used when doing non-blocking IO */
1390#define SSL_want_nothing(s) (SSL_want(s) == SSL_NOTHING)
1391#define SSL_want_read(s) (SSL_want(s) == SSL_READING)
1392#define SSL_want_write(s) (SSL_want(s) == SSL_WRITING)
1393#define SSL_want_x509_lookup(s) (SSL_want(s) == SSL_X509_LOOKUP)
Adam Langley1258b6a2014-06-20 12:00:00 -07001394#define SSL_want_channel_id_lookup(s) (SSL_want(s) == SSL_CHANNEL_ID_LOOKUP)
Adam Langleyb2ce0582014-06-20 12:00:00 -07001395#define SSL_want_session(s) (SSL_want(s) == SSL_PENDING_SESSION)
Adam Langleydc9b1412014-06-20 12:00:00 -07001396#define SSL_want_certificate(s) (SSL_want(s) == SSL_CERTIFICATE_SELECTION_PENDING)
Adam Langley95c29f32014-06-20 12:00:00 -07001397
1398#define SSL_MAC_FLAG_READ_MAC_STREAM 1
1399#define SSL_MAC_FLAG_WRITE_MAC_STREAM 2
1400
1401#ifndef OPENSSL_NO_SSL_INTERN
1402
1403struct ssl_st
1404 {
1405 /* protocol version
1406 * (one of SSL2_VERSION, SSL3_VERSION, TLS1_VERSION, DTLS1_VERSION)
1407 */
1408 int version;
1409 int type; /* SSL_ST_CONNECT or SSL_ST_ACCEPT */
1410
1411 const SSL_METHOD *method; /* SSLv3 */
1412
1413 /* There are 2 BIO's even though they are normally both the
1414 * same. This is so data can be read and written to different
1415 * handlers */
1416
1417#ifndef OPENSSL_NO_BIO
1418 BIO *rbio; /* used by SSL_read */
1419 BIO *wbio; /* used by SSL_write */
1420 BIO *bbio; /* used during session-id reuse to concatenate
1421 * messages */
1422#else
1423 char *rbio; /* used by SSL_read */
1424 char *wbio; /* used by SSL_write */
1425 char *bbio;
1426#endif
1427 /* This holds a variable that indicates what we were doing
1428 * when a 0 or -1 is returned. This is needed for
1429 * non-blocking IO so we know what request needs re-doing when
1430 * in SSL_accept or SSL_connect */
1431 int rwstate;
1432
1433 /* true when we are actually in SSL_accept() or SSL_connect() */
1434 int in_handshake;
1435 int (*handshake_func)(SSL *);
1436
1437 /* Imagine that here's a boolean member "init" that is
1438 * switched as soon as SSL_set_{accept/connect}_state
1439 * is called for the first time, so that "state" and
1440 * "handshake_func" are properly initialized. But as
1441 * handshake_func is == 0 until then, we use this
1442 * test instead of an "init" member.
1443 */
1444
1445 int server; /* are we the server side? - mostly used by SSL_clear*/
1446
1447 int new_session;/* Generate a new session or reuse an old one.
1448 * NB: For servers, the 'new' session may actually be a previously
1449 * cached session or even the previous session unless
1450 * SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION is set */
1451 int quiet_shutdown;/* don't send shutdown packets */
1452 int shutdown; /* we have shut things down, 0x01 sent, 0x02
1453 * for received */
1454 int state; /* where we are */
1455 int rstate; /* where we are when reading */
1456
1457 BUF_MEM *init_buf; /* buffer used during init */
1458 void *init_msg; /* pointer to handshake message body, set by ssl3_get_message() */
1459 int init_num; /* amount read/written */
1460 int init_off; /* amount read/written */
1461
1462 /* used internally to point at a raw packet */
1463 unsigned char *packet;
1464 unsigned int packet_length;
1465
1466 struct ssl2_state_st *s2; /* SSLv2 variables */
1467 struct ssl3_state_st *s3; /* SSLv3 variables */
1468 struct dtls1_state_st *d1; /* DTLSv1 variables */
1469
1470 int read_ahead; /* Read as many input bytes as possible
1471 * (for non-blocking reads) */
1472
1473 /* callback that allows applications to peek at protocol messages */
1474 void (*msg_callback)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg);
1475 void *msg_callback_arg;
1476
1477 int hit; /* reusing a previous session */
1478
1479 X509_VERIFY_PARAM *param;
1480
1481#if 0
1482 int purpose; /* Purpose setting */
1483 int trust; /* Trust setting */
1484#endif
1485
1486 /* crypto */
Adam Langley858a88d2014-06-20 12:00:00 -07001487 struct ssl_cipher_preference_list_st *cipher_list;
Adam Langley95c29f32014-06-20 12:00:00 -07001488 STACK_OF(SSL_CIPHER) *cipher_list_by_id;
1489
1490 /* These are the ones being used, the ones in SSL_SESSION are
1491 * the ones to be 'copied' into these ones */
1492 int mac_flags;
Adam Langleyc9fb3752014-06-20 12:00:00 -07001493 SSL_AEAD_CTX *aead_read_ctx; /* AEAD context. If non-NULL, then
1494 |enc_read_ctx| and |read_hash| are
1495 ignored. */
Adam Langley95c29f32014-06-20 12:00:00 -07001496 EVP_CIPHER_CTX *enc_read_ctx; /* cryptographic state */
1497 EVP_MD_CTX *read_hash; /* used for mac generation */
1498 char *expand;
1499
Adam Langleyc9fb3752014-06-20 12:00:00 -07001500 SSL_AEAD_CTX *aead_write_ctx; /* AEAD context. If non-NULL, then
1501 |enc_write_ctx| and |write_hash| are
1502 ignored. */
Adam Langley95c29f32014-06-20 12:00:00 -07001503 EVP_CIPHER_CTX *enc_write_ctx; /* cryptographic state */
1504 EVP_MD_CTX *write_hash; /* used for mac generation */
1505 char *compress;
1506
1507 /* session info */
1508
1509 /* client cert? */
1510 /* This is used to hold the server certificate used */
1511 struct cert_st /* CERT */ *cert;
1512
1513 /* the session_id_context is used to ensure sessions are only reused
1514 * in the appropriate context */
1515 unsigned int sid_ctx_length;
1516 unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
1517
1518 /* This can also be in the session once a session is established */
1519 SSL_SESSION *session;
1520
1521 /* Default generate session ID callback. */
1522 GEN_SESSION_CB generate_session_id;
1523
1524 /* Used in SSL2 and SSL3 */
1525 int verify_mode; /* 0 don't care about verify failure.
1526 * 1 fail if verify fails */
1527 int (*verify_callback)(int ok,X509_STORE_CTX *ctx); /* fail if callback returns 0 */
1528
1529 void (*info_callback)(const SSL *ssl,int type,int val); /* optional informational callback */
1530
1531 int error; /* error bytes to be written */
1532 int error_code; /* actual code */
1533
1534#ifndef OPENSSL_NO_PSK
1535 unsigned int (*psk_client_callback)(SSL *ssl, const char *hint, char *identity,
1536 unsigned int max_identity_len, unsigned char *psk,
1537 unsigned int max_psk_len);
1538 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
1539 unsigned char *psk, unsigned int max_psk_len);
1540#endif
1541
1542 SSL_CTX *ctx;
1543 /* set this flag to 1 and a sleep(1) is put into all SSL_read()
1544 * and SSL_write() calls, good for nbio debuging :-) */
1545 int debug;
1546
1547 /* extra application data */
1548 long verify_result;
1549 CRYPTO_EX_DATA ex_data;
1550
1551 /* for server side, keep the list of CA_dn we can use */
1552 STACK_OF(X509_NAME) *client_CA;
1553
1554 int references;
1555 unsigned long options; /* protocol behaviour */
1556 unsigned long mode; /* API behaviour */
1557 long max_cert_list;
1558 int first_packet;
1559 int client_version; /* what was passed, used for
1560 * SSLv3/TLS rollback check */
1561 unsigned int max_send_fragment;
1562#ifndef OPENSSL_NO_TLSEXT
1563 /* TLS extension debug callback */
1564 void (*tlsext_debug_cb)(SSL *s, int client_server, int type,
1565 unsigned char *data, int len,
1566 void *arg);
1567 void *tlsext_debug_arg;
1568 char *tlsext_hostname;
1569 int servername_done; /* no further mod of servername
1570 0 : call the servername extension callback.
1571 1 : prepare 2, allow last ack just after in server callback.
1572 2 : don't call servername callback, no ack in server hello
1573 */
1574 /* certificate status request info */
1575 /* Status type or -1 if no status type */
1576 int tlsext_status_type;
1577 /* Expect OCSP CertificateStatus message */
1578 int tlsext_status_expected;
1579 /* OCSP status request only */
1580 STACK_OF(OCSP_RESPID) *tlsext_ocsp_ids;
1581 X509_EXTENSIONS *tlsext_ocsp_exts;
1582 /* OCSP response received or to be sent */
1583 unsigned char *tlsext_ocsp_resp;
1584 int tlsext_ocsp_resplen;
1585
1586 /* RFC4507 session ticket expected to be received or sent */
1587 int tlsext_ticket_expected;
1588#ifndef OPENSSL_NO_EC
1589 size_t tlsext_ecpointformatlist_length;
1590 unsigned char *tlsext_ecpointformatlist; /* our list */
1591 size_t tlsext_ellipticcurvelist_length;
1592 unsigned char *tlsext_ellipticcurvelist; /* our list */
1593#endif /* OPENSSL_NO_EC */
1594
1595 /* draft-rescorla-tls-opaque-prf-input-00.txt information to be used for handshakes */
1596 void *tlsext_opaque_prf_input;
1597 size_t tlsext_opaque_prf_input_len;
1598
1599 /* TLS Session Ticket extension override */
1600 TLS_SESSION_TICKET_EXT *tlsext_session_ticket;
1601
1602 /* TLS Session Ticket extension callback */
1603 tls_session_ticket_ext_cb_fn tls_session_ticket_ext_cb;
1604 void *tls_session_ticket_ext_cb_arg;
1605
1606 /* TLS pre-shared secret session resumption */
1607 tls_session_secret_cb_fn tls_session_secret_cb;
1608 void *tls_session_secret_cb_arg;
1609
1610 SSL_CTX * initial_ctx; /* initial ctx, used to store sessions */
1611
1612#ifndef OPENSSL_NO_NEXTPROTONEG
1613 /* Next protocol negotiation. For the client, this is the protocol that
1614 * we sent in NextProtocol and is set when handling ServerHello
1615 * extensions.
1616 *
1617 * For a server, this is the client's selected_protocol from
1618 * NextProtocol and is set when handling the NextProtocol message,
1619 * before the Finished message. */
1620 unsigned char *next_proto_negotiated;
1621 unsigned char next_proto_negotiated_len;
1622#endif
1623
1624#define session_ctx initial_ctx
1625
1626 STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles; /* What we'll do */
1627 SRTP_PROTECTION_PROFILE *srtp_profile; /* What's been chosen */
1628
1629 unsigned int tlsext_heartbeat; /* Is use of the Heartbeat extension negotiated?
1630 0: disabled
1631 1: enabled
1632 2: enabled, but not allowed to send Requests
1633 */
1634 unsigned int tlsext_hb_pending; /* Indicates if a HeartbeatRequest is in flight */
1635 unsigned int tlsext_hb_seq; /* HeartbeatRequest sequence number */
1636
Adam Langley1258b6a2014-06-20 12:00:00 -07001637 /* Copied from the SSL_CTX. For a server, means that we'll accept
1638 * Channel IDs from clients. For a client, means that we'll advertise
1639 * support. */
1640 char tlsext_channel_id_enabled;
1641 /* The client's Channel ID private key. */
1642 EVP_PKEY *tlsext_channel_id_private;
1643
Adam Langley95c29f32014-06-20 12:00:00 -07001644 /* For a client, this contains the list of supported protocols in wire
1645 * format. */
1646 unsigned char* alpn_client_proto_list;
1647 unsigned alpn_client_proto_list_len;
1648#else
1649#define session_ctx ctx
1650#endif /* OPENSSL_NO_TLSEXT */
1651
1652 int renegotiate;/* 1 if we are renegotiating.
1653 * 2 if we are a server and are inside a handshake
1654 * (i.e. not just sending a HelloRequest) */
1655
1656#ifndef OPENSSL_NO_DANE
1657 unsigned char *tlsa_record;
1658 int tlsa_witness;
1659#endif
1660 };
1661
1662#endif
1663
1664#ifdef __cplusplus
1665}
1666#endif
1667
1668#include <openssl/ssl2.h>
1669#include <openssl/ssl3.h>
1670#include <openssl/tls1.h> /* This is mostly sslv3 with a few tweaks */
1671#include <openssl/dtls1.h> /* Datagram TLS */
1672#include <openssl/ssl23.h>
1673#include <openssl/srtp.h> /* Support for the use_srtp extension */
1674
1675#ifdef __cplusplus
1676extern "C" {
1677#endif
1678
1679/* compatibility */
1680#define SSL_set_app_data(s,arg) (SSL_set_ex_data(s,0,(char *)arg))
1681#define SSL_get_app_data(s) (SSL_get_ex_data(s,0))
1682#define SSL_SESSION_set_app_data(s,a) (SSL_SESSION_set_ex_data(s,0,(char *)a))
1683#define SSL_SESSION_get_app_data(s) (SSL_SESSION_get_ex_data(s,0))
1684#define SSL_CTX_get_app_data(ctx) (SSL_CTX_get_ex_data(ctx,0))
1685#define SSL_CTX_set_app_data(ctx,arg) (SSL_CTX_set_ex_data(ctx,0,(char *)arg))
1686
1687/* The following are the possible values for ssl->state are are
1688 * used to indicate where we are up to in the SSL connection establishment.
1689 * The macros that follow are about the only things you should need to use
1690 * and even then, only when using non-blocking IO.
1691 * It can also be useful to work out where you were when the connection
1692 * failed */
1693
1694#define SSL_ST_CONNECT 0x1000
1695#define SSL_ST_ACCEPT 0x2000
1696#define SSL_ST_MASK 0x0FFF
1697#define SSL_ST_INIT (SSL_ST_CONNECT|SSL_ST_ACCEPT)
1698#define SSL_ST_BEFORE 0x4000
1699#define SSL_ST_OK 0x03
1700#define SSL_ST_RENEGOTIATE (0x04|SSL_ST_INIT)
1701
1702#define SSL_CB_LOOP 0x01
1703#define SSL_CB_EXIT 0x02
1704#define SSL_CB_READ 0x04
1705#define SSL_CB_WRITE 0x08
1706#define SSL_CB_ALERT 0x4000 /* used in callback */
1707#define SSL_CB_READ_ALERT (SSL_CB_ALERT|SSL_CB_READ)
1708#define SSL_CB_WRITE_ALERT (SSL_CB_ALERT|SSL_CB_WRITE)
1709#define SSL_CB_ACCEPT_LOOP (SSL_ST_ACCEPT|SSL_CB_LOOP)
1710#define SSL_CB_ACCEPT_EXIT (SSL_ST_ACCEPT|SSL_CB_EXIT)
1711#define SSL_CB_CONNECT_LOOP (SSL_ST_CONNECT|SSL_CB_LOOP)
1712#define SSL_CB_CONNECT_EXIT (SSL_ST_CONNECT|SSL_CB_EXIT)
1713#define SSL_CB_HANDSHAKE_START 0x10
1714#define SSL_CB_HANDSHAKE_DONE 0x20
1715
1716/* Is the SSL_connection established? */
1717#define SSL_get_state(a) SSL_state(a)
1718#define SSL_is_init_finished(a) (SSL_state(a) == SSL_ST_OK)
Adam Langleyadb739e2014-06-20 12:00:00 -07001719#define SSL_in_init(a) ((SSL_state(a)&SSL_ST_INIT) && \
1720 !SSL_cutthrough_complete(a))
Adam Langley95c29f32014-06-20 12:00:00 -07001721#define SSL_in_before(a) (SSL_state(a)&SSL_ST_BEFORE)
1722#define SSL_in_connect_init(a) (SSL_state(a)&SSL_ST_CONNECT)
1723#define SSL_in_accept_init(a) (SSL_state(a)&SSL_ST_ACCEPT)
Adam Langleyadb739e2014-06-20 12:00:00 -07001724int SSL_cutthrough_complete(const SSL *s);
Adam Langley95c29f32014-06-20 12:00:00 -07001725
1726/* The following 2 states are kept in ssl->rstate when reads fail,
1727 * you should not need these */
1728#define SSL_ST_READ_HEADER 0xF0
1729#define SSL_ST_READ_BODY 0xF1
1730#define SSL_ST_READ_DONE 0xF2
1731
1732/* Obtain latest Finished message
1733 * -- that we sent (SSL_get_finished)
1734 * -- that we expected from peer (SSL_get_peer_finished).
1735 * Returns length (0 == no Finished so far), copies up to 'count' bytes. */
1736size_t SSL_get_finished(const SSL *s, void *buf, size_t count);
1737size_t SSL_get_peer_finished(const SSL *s, void *buf, size_t count);
1738
Adam Langley509e5ed2014-06-20 12:00:00 -07001739/* use either SSL_VERIFY_NONE or SSL_VERIFY_PEER, the last 3 options
Adam Langley95c29f32014-06-20 12:00:00 -07001740 * are 'ored' with SSL_VERIFY_PEER if they are desired */
1741#define SSL_VERIFY_NONE 0x00
1742#define SSL_VERIFY_PEER 0x01
1743#define SSL_VERIFY_FAIL_IF_NO_PEER_CERT 0x02
1744#define SSL_VERIFY_CLIENT_ONCE 0x04
Adam Langley509e5ed2014-06-20 12:00:00 -07001745#define SSL_VERIFY_PEER_IF_NO_OBC 0x08
Adam Langley95c29f32014-06-20 12:00:00 -07001746
1747#define OpenSSL_add_ssl_algorithms() SSL_library_init()
1748#define SSLeay_add_ssl_algorithms() SSL_library_init()
1749
1750/* this is for backward compatibility */
1751#if 0 /* NEW_SSLEAY */
1752#define SSL_CTX_set_default_verify(a,b,c) SSL_CTX_set_verify(a,b,c)
1753#define SSL_set_pref_cipher(c,n) SSL_set_cipher_list(c,n)
1754#define SSL_add_session(a,b) SSL_CTX_add_session((a),(b))
1755#define SSL_remove_session(a,b) SSL_CTX_remove_session((a),(b))
1756#define SSL_flush_sessions(a,b) SSL_CTX_flush_sessions((a),(b))
1757#endif
1758/* More backward compatibility */
1759#define SSL_get_cipher(s) \
1760 SSL_CIPHER_get_name(SSL_get_current_cipher(s))
1761#define SSL_get_cipher_bits(s,np) \
1762 SSL_CIPHER_get_bits(SSL_get_current_cipher(s),np)
1763#define SSL_get_cipher_version(s) \
1764 SSL_CIPHER_get_version(SSL_get_current_cipher(s))
1765#define SSL_get_cipher_name(s) \
1766 SSL_CIPHER_get_name(SSL_get_current_cipher(s))
1767#define SSL_get_time(a) SSL_SESSION_get_time(a)
1768#define SSL_set_time(a,b) SSL_SESSION_set_time((a),(b))
1769#define SSL_get_timeout(a) SSL_SESSION_get_timeout(a)
1770#define SSL_set_timeout(a,b) SSL_SESSION_set_timeout((a),(b))
1771
1772#define d2i_SSL_SESSION_bio(bp,s_id) ASN1_d2i_bio_of(SSL_SESSION,SSL_SESSION_new,d2i_SSL_SESSION,bp,s_id)
1773#define i2d_SSL_SESSION_bio(bp,s_id) ASN1_i2d_bio_of(SSL_SESSION,i2d_SSL_SESSION,bp,s_id)
1774
1775DECLARE_PEM_rw(SSL_SESSION, SSL_SESSION)
1776
1777#define SSL_AD_REASON_OFFSET 1000 /* offset to get SSL_R_... value from SSL_AD_... */
1778
1779/* These alert types are for SSLv3 and TLSv1 */
1780#define SSL_AD_CLOSE_NOTIFY SSL3_AD_CLOSE_NOTIFY
1781#define SSL_AD_UNEXPECTED_MESSAGE SSL3_AD_UNEXPECTED_MESSAGE /* fatal */
1782#define SSL_AD_BAD_RECORD_MAC SSL3_AD_BAD_RECORD_MAC /* fatal */
1783#define SSL_AD_DECRYPTION_FAILED TLS1_AD_DECRYPTION_FAILED
1784#define SSL_AD_RECORD_OVERFLOW TLS1_AD_RECORD_OVERFLOW
1785#define SSL_AD_DECOMPRESSION_FAILURE SSL3_AD_DECOMPRESSION_FAILURE/* fatal */
1786#define SSL_AD_HANDSHAKE_FAILURE SSL3_AD_HANDSHAKE_FAILURE/* fatal */
1787#define SSL_AD_NO_CERTIFICATE SSL3_AD_NO_CERTIFICATE /* Not for TLS */
1788#define SSL_AD_BAD_CERTIFICATE SSL3_AD_BAD_CERTIFICATE
1789#define SSL_AD_UNSUPPORTED_CERTIFICATE SSL3_AD_UNSUPPORTED_CERTIFICATE
1790#define SSL_AD_CERTIFICATE_REVOKED SSL3_AD_CERTIFICATE_REVOKED
1791#define SSL_AD_CERTIFICATE_EXPIRED SSL3_AD_CERTIFICATE_EXPIRED
1792#define SSL_AD_CERTIFICATE_UNKNOWN SSL3_AD_CERTIFICATE_UNKNOWN
1793#define SSL_AD_ILLEGAL_PARAMETER SSL3_AD_ILLEGAL_PARAMETER /* fatal */
1794#define SSL_AD_UNKNOWN_CA TLS1_AD_UNKNOWN_CA /* fatal */
1795#define SSL_AD_ACCESS_DENIED TLS1_AD_ACCESS_DENIED /* fatal */
1796#define SSL_AD_DECODE_ERROR TLS1_AD_DECODE_ERROR /* fatal */
1797#define SSL_AD_DECRYPT_ERROR TLS1_AD_DECRYPT_ERROR
1798#define SSL_AD_EXPORT_RESTRICTION TLS1_AD_EXPORT_RESTRICTION/* fatal */
1799#define SSL_AD_PROTOCOL_VERSION TLS1_AD_PROTOCOL_VERSION /* fatal */
1800#define SSL_AD_INSUFFICIENT_SECURITY TLS1_AD_INSUFFICIENT_SECURITY/* fatal */
1801#define SSL_AD_INTERNAL_ERROR TLS1_AD_INTERNAL_ERROR /* fatal */
1802#define SSL_AD_USER_CANCELLED TLS1_AD_USER_CANCELLED
1803#define SSL_AD_NO_RENEGOTIATION TLS1_AD_NO_RENEGOTIATION
1804#define SSL_AD_UNSUPPORTED_EXTENSION TLS1_AD_UNSUPPORTED_EXTENSION
1805#define SSL_AD_CERTIFICATE_UNOBTAINABLE TLS1_AD_CERTIFICATE_UNOBTAINABLE
1806#define SSL_AD_UNRECOGNIZED_NAME TLS1_AD_UNRECOGNIZED_NAME
1807#define SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE TLS1_AD_BAD_CERTIFICATE_STATUS_RESPONSE
1808#define SSL_AD_BAD_CERTIFICATE_HASH_VALUE TLS1_AD_BAD_CERTIFICATE_HASH_VALUE
1809#define SSL_AD_UNKNOWN_PSK_IDENTITY TLS1_AD_UNKNOWN_PSK_IDENTITY /* fatal */
Adam Langley29707792014-06-20 12:00:00 -07001810#define SSL_AD_INAPPROPRIATE_FALLBACK SSL3_AD_INAPPROPRIATE_FALLBACK /* fatal */
Adam Langley95c29f32014-06-20 12:00:00 -07001811
1812#define SSL_ERROR_NONE 0
1813#define SSL_ERROR_SSL 1
1814#define SSL_ERROR_WANT_READ 2
1815#define SSL_ERROR_WANT_WRITE 3
1816#define SSL_ERROR_WANT_X509_LOOKUP 4
1817#define SSL_ERROR_SYSCALL 5 /* look at error stack/return value/errno */
1818#define SSL_ERROR_ZERO_RETURN 6
1819#define SSL_ERROR_WANT_CONNECT 7
1820#define SSL_ERROR_WANT_ACCEPT 8
Adam Langley1258b6a2014-06-20 12:00:00 -07001821#define SSL_ERROR_WANT_CHANNEL_ID_LOOKUP 9
Adam Langleyb2ce0582014-06-20 12:00:00 -07001822#define SSL_ERROR_PENDING_SESSION 11
Adam Langleydc9b1412014-06-20 12:00:00 -07001823#define SSL_ERROR_PENDING_CERTIFICATE 12
Adam Langley95c29f32014-06-20 12:00:00 -07001824
1825#define SSL_CTRL_NEED_TMP_RSA 1
1826#define SSL_CTRL_SET_TMP_RSA 2
1827#define SSL_CTRL_SET_TMP_DH 3
1828#define SSL_CTRL_SET_TMP_ECDH 4
1829#define SSL_CTRL_SET_TMP_RSA_CB 5
1830#define SSL_CTRL_SET_TMP_DH_CB 6
1831#define SSL_CTRL_SET_TMP_ECDH_CB 7
1832
1833#define SSL_CTRL_GET_SESSION_REUSED 8
1834#define SSL_CTRL_GET_CLIENT_CERT_REQUEST 9
1835#define SSL_CTRL_GET_NUM_RENEGOTIATIONS 10
1836#define SSL_CTRL_CLEAR_NUM_RENEGOTIATIONS 11
1837#define SSL_CTRL_GET_TOTAL_RENEGOTIATIONS 12
1838#define SSL_CTRL_GET_FLAGS 13
1839#define SSL_CTRL_EXTRA_CHAIN_CERT 14
1840
1841#define SSL_CTRL_SET_MSG_CALLBACK 15
1842#define SSL_CTRL_SET_MSG_CALLBACK_ARG 16
1843
1844/* only applies to datagram connections */
1845#define SSL_CTRL_SET_MTU 17
1846/* Stats */
1847#define SSL_CTRL_SESS_NUMBER 20
1848#define SSL_CTRL_SESS_CONNECT 21
1849#define SSL_CTRL_SESS_CONNECT_GOOD 22
1850#define SSL_CTRL_SESS_CONNECT_RENEGOTIATE 23
1851#define SSL_CTRL_SESS_ACCEPT 24
1852#define SSL_CTRL_SESS_ACCEPT_GOOD 25
1853#define SSL_CTRL_SESS_ACCEPT_RENEGOTIATE 26
1854#define SSL_CTRL_SESS_HIT 27
1855#define SSL_CTRL_SESS_CB_HIT 28
1856#define SSL_CTRL_SESS_MISSES 29
1857#define SSL_CTRL_SESS_TIMEOUTS 30
1858#define SSL_CTRL_SESS_CACHE_FULL 31
1859#define SSL_CTRL_OPTIONS 32
1860#define SSL_CTRL_MODE 33
1861
1862#define SSL_CTRL_GET_READ_AHEAD 40
1863#define SSL_CTRL_SET_READ_AHEAD 41
1864#define SSL_CTRL_SET_SESS_CACHE_SIZE 42
1865#define SSL_CTRL_GET_SESS_CACHE_SIZE 43
1866#define SSL_CTRL_SET_SESS_CACHE_MODE 44
1867#define SSL_CTRL_GET_SESS_CACHE_MODE 45
1868
1869#define SSL_CTRL_GET_MAX_CERT_LIST 50
1870#define SSL_CTRL_SET_MAX_CERT_LIST 51
1871
1872#define SSL_CTRL_SET_MAX_SEND_FRAGMENT 52
1873
1874/* see tls1.h for macros based on these */
1875#ifndef OPENSSL_NO_TLSEXT
1876#define SSL_CTRL_SET_TLSEXT_SERVERNAME_CB 53
1877#define SSL_CTRL_SET_TLSEXT_SERVERNAME_ARG 54
1878#define SSL_CTRL_SET_TLSEXT_HOSTNAME 55
1879#define SSL_CTRL_SET_TLSEXT_DEBUG_CB 56
1880#define SSL_CTRL_SET_TLSEXT_DEBUG_ARG 57
1881#define SSL_CTRL_GET_TLSEXT_TICKET_KEYS 58
1882#define SSL_CTRL_SET_TLSEXT_TICKET_KEYS 59
1883#define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT 60
1884#define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT_CB 61
1885#define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT_CB_ARG 62
1886#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB 63
1887#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB_ARG 64
1888#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_TYPE 65
1889#define SSL_CTRL_GET_TLSEXT_STATUS_REQ_EXTS 66
1890#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_EXTS 67
1891#define SSL_CTRL_GET_TLSEXT_STATUS_REQ_IDS 68
1892#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_IDS 69
1893#define SSL_CTRL_GET_TLSEXT_STATUS_REQ_OCSP_RESP 70
1894#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_OCSP_RESP 71
1895
1896#define SSL_CTRL_SET_TLSEXT_TICKET_KEY_CB 72
1897
1898#define SSL_CTRL_SET_TLS_EXT_SRP_USERNAME_CB 75
1899#define SSL_CTRL_SET_SRP_VERIFY_PARAM_CB 76
1900#define SSL_CTRL_SET_SRP_GIVE_CLIENT_PWD_CB 77
1901
1902#define SSL_CTRL_SET_SRP_ARG 78
1903#define SSL_CTRL_SET_TLS_EXT_SRP_USERNAME 79
1904#define SSL_CTRL_SET_TLS_EXT_SRP_STRENGTH 80
1905#define SSL_CTRL_SET_TLS_EXT_SRP_PASSWORD 81
1906#ifndef OPENSSL_NO_HEARTBEATS
1907#define SSL_CTRL_TLS_EXT_SEND_HEARTBEAT 85
1908#define SSL_CTRL_GET_TLS_EXT_HEARTBEAT_PENDING 86
1909#define SSL_CTRL_SET_TLS_EXT_HEARTBEAT_NO_REQUESTS 87
1910#endif
1911/* Callback for verifying audit proofs (client only) */
1912#define SSL_CTRL_SET_TLSEXT_AUTHZ_SERVER_AUDIT_PROOF_CB 95
1913#define SSL_CTRL_SET_TLSEXT_AUTHZ_SERVER_AUDIT_PROOF_CB_ARG 96
1914#endif /* OPENSSL_NO_TLSEXT */
1915
1916#define DTLS_CTRL_GET_TIMEOUT 73
1917#define DTLS_CTRL_HANDLE_TIMEOUT 74
1918#define DTLS_CTRL_LISTEN 75
1919
1920#define SSL_CTRL_GET_RI_SUPPORT 76
1921#define SSL_CTRL_CLEAR_OPTIONS 77
1922#define SSL_CTRL_CLEAR_MODE 78
1923
1924#define SSL_CTRL_GET_EXTRA_CHAIN_CERTS 82
1925#define SSL_CTRL_CLEAR_EXTRA_CHAIN_CERTS 83
1926
1927#define SSL_CTRL_CHAIN 88
1928#define SSL_CTRL_CHAIN_CERT 89
1929
1930#define SSL_CTRL_GET_CURVES 90
1931#define SSL_CTRL_SET_CURVES 91
1932#define SSL_CTRL_SET_CURVES_LIST 92
1933#define SSL_CTRL_GET_SHARED_CURVE 93
1934#define SSL_CTRL_SET_ECDH_AUTO 94
1935#define SSL_CTRL_SET_SIGALGS 97
1936#define SSL_CTRL_SET_SIGALGS_LIST 98
1937#define SSL_CTRL_CERT_FLAGS 99
1938#define SSL_CTRL_CLEAR_CERT_FLAGS 100
1939#define SSL_CTRL_SET_CLIENT_SIGALGS 101
1940#define SSL_CTRL_SET_CLIENT_SIGALGS_LIST 102
1941#define SSL_CTRL_GET_CLIENT_CERT_TYPES 103
1942#define SSL_CTRL_SET_CLIENT_CERT_TYPES 104
1943#define SSL_CTRL_BUILD_CERT_CHAIN 105
1944#define SSL_CTRL_SET_VERIFY_CERT_STORE 106
1945#define SSL_CTRL_SET_CHAIN_CERT_STORE 107
1946#define SSL_CTRL_GET_PEER_SIGNATURE_NID 108
1947#define SSL_CTRL_GET_SERVER_TMP_KEY 109
1948#define SSL_CTRL_GET_RAW_CIPHERLIST 110
1949#define SSL_CTRL_GET_EC_POINT_FORMATS 111
1950#define SSL_CTRL_GET_TLSA_RECORD 112
1951#define SSL_CTRL_SET_TLSA_RECORD 113
1952#define SSL_CTRL_PULL_TLSA_RECORD 114
1953
1954#define SSL_CTRL_GET_CHAIN_CERTS 115
1955#define SSL_CTRL_SELECT_CURRENT_CERT 116
1956
Adam Langley1258b6a2014-06-20 12:00:00 -07001957#define SSL_CTRL_CHANNEL_ID 117
1958#define SSL_CTRL_GET_CHANNEL_ID 118
1959#define SSL_CTRL_SET_CHANNEL_ID 119
1960
Adam Langley95c29f32014-06-20 12:00:00 -07001961#define DTLSv1_get_timeout(ssl, arg) \
1962 SSL_ctrl(ssl,DTLS_CTRL_GET_TIMEOUT,0, (void *)arg)
1963#define DTLSv1_handle_timeout(ssl) \
1964 SSL_ctrl(ssl,DTLS_CTRL_HANDLE_TIMEOUT,0, NULL)
1965#define DTLSv1_listen(ssl, peer) \
1966 SSL_ctrl(ssl,DTLS_CTRL_LISTEN,0, (void *)peer)
1967
1968#define SSL_session_reused(ssl) \
1969 SSL_ctrl((ssl),SSL_CTRL_GET_SESSION_REUSED,0,NULL)
1970#define SSL_num_renegotiations(ssl) \
1971 SSL_ctrl((ssl),SSL_CTRL_GET_NUM_RENEGOTIATIONS,0,NULL)
1972#define SSL_clear_num_renegotiations(ssl) \
1973 SSL_ctrl((ssl),SSL_CTRL_CLEAR_NUM_RENEGOTIATIONS,0,NULL)
1974#define SSL_total_renegotiations(ssl) \
1975 SSL_ctrl((ssl),SSL_CTRL_GET_TOTAL_RENEGOTIATIONS,0,NULL)
1976
1977#define SSL_CTX_need_tmp_RSA(ctx) \
1978 SSL_CTX_ctrl(ctx,SSL_CTRL_NEED_TMP_RSA,0,NULL)
1979#define SSL_CTX_set_tmp_rsa(ctx,rsa) \
1980 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_RSA,0,(char *)rsa)
1981#define SSL_CTX_set_tmp_dh(ctx,dh) \
1982 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_DH,0,(char *)dh)
1983#define SSL_CTX_set_tmp_ecdh(ctx,ecdh) \
1984 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_ECDH,0,(char *)ecdh)
1985
1986#define SSL_need_tmp_RSA(ssl) \
1987 SSL_ctrl(ssl,SSL_CTRL_NEED_TMP_RSA,0,NULL)
1988#define SSL_set_tmp_rsa(ssl,rsa) \
1989 SSL_ctrl(ssl,SSL_CTRL_SET_TMP_RSA,0,(char *)rsa)
1990#define SSL_set_tmp_dh(ssl,dh) \
1991 SSL_ctrl(ssl,SSL_CTRL_SET_TMP_DH,0,(char *)dh)
1992#define SSL_set_tmp_ecdh(ssl,ecdh) \
1993 SSL_ctrl(ssl,SSL_CTRL_SET_TMP_ECDH,0,(char *)ecdh)
1994
Adam Langley1258b6a2014-06-20 12:00:00 -07001995/* SSL_enable_tls_channel_id either configures a TLS server to accept TLS client
1996 * IDs from clients, or configure a client to send TLS client IDs to server.
1997 * Returns 1 on success. */
1998#define SSL_enable_tls_channel_id(s) \
1999 SSL_ctrl(s,SSL_CTRL_CHANNEL_ID,0,NULL)
2000/* SSL_set1_tls_channel_id configures a TLS client to send a TLS Channel ID to
2001 * compatible servers. private_key must be a P-256 EVP_PKEY*. Returns 1 on
2002 * success. */
2003#define SSL_set1_tls_channel_id(s, private_key) \
2004 SSL_ctrl(s,SSL_CTRL_SET_CHANNEL_ID,0,(void*)private_key)
2005#define SSL_CTX_set1_tls_channel_id(ctx, private_key) \
2006 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CHANNEL_ID,0,(void*)private_key)
2007/* SSL_get_tls_channel_id gets the client's TLS Channel ID from a server SSL*
2008 * and copies up to the first |channel_id_len| bytes into |channel_id|. The
2009 * Channel ID consists of the client's P-256 public key as an (x,y) pair where
2010 * each is a 32-byte, big-endian field element. Returns 0 if the client didn't
2011 * offer a Channel ID and the length of the complete Channel ID otherwise. */
2012#define SSL_get_tls_channel_id(ctx, channel_id, channel_id_len) \
2013 SSL_ctrl(ctx,SSL_CTRL_GET_CHANNEL_ID,channel_id_len,(void*)channel_id)
2014
Adam Langley95c29f32014-06-20 12:00:00 -07002015#define SSL_CTX_add_extra_chain_cert(ctx,x509) \
2016 SSL_CTX_ctrl(ctx,SSL_CTRL_EXTRA_CHAIN_CERT,0,(char *)x509)
2017#define SSL_CTX_get_extra_chain_certs(ctx,px509) \
2018 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_EXTRA_CHAIN_CERTS,0,px509)
2019#define SSL_CTX_clear_extra_chain_certs(ctx) \
2020 SSL_CTX_ctrl(ctx,SSL_CTRL_CLEAR_EXTRA_CHAIN_CERTS,0,NULL)
2021
2022#define SSL_CTX_set0_chain(ctx,sk) \
2023 SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN,0,(char *)sk)
2024#define SSL_CTX_set1_chain(ctx,sk) \
2025 SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN,1,(char *)sk)
2026#define SSL_CTX_add0_chain_cert(ctx,x509) \
2027 SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN_CERT,0,(char *)x509)
2028#define SSL_CTX_add1_chain_cert(ctx,x509) \
2029 SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN_CERT,1,(char *)x509)
2030#define SSL_CTX_get0_chain_certs(ctx,px509) \
2031 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_CHAIN_CERTS,0,px509)
2032#define SSL_CTX_clear_chain_certs(ctx) \
2033 SSL_CTX_set0_chain(ctx,NULL)
2034#define SSL_CTX_build_cert_chain(ctx, flags) \
2035 SSL_CTX_ctrl(ctx,SSL_CTRL_BUILD_CERT_CHAIN, flags, NULL)
2036#define SSL_CTX_select_current_cert(ctx,x509) \
2037 SSL_CTX_ctrl(ctx,SSL_CTRL_SELECT_CURRENT_CERT,0,(char *)x509)
2038
2039#define SSL_CTX_set0_verify_cert_store(ctx,st) \
2040 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_VERIFY_CERT_STORE,0,(char *)st)
2041#define SSL_CTX_set1_verify_cert_store(ctx,st) \
2042 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_VERIFY_CERT_STORE,1,(char *)st)
2043#define SSL_CTX_set0_chain_cert_store(ctx,st) \
2044 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CHAIN_CERT_STORE,0,(char *)st)
2045#define SSL_CTX_set1_chain_cert_store(ctx,st) \
2046 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CHAIN_CERT_STORE,1,(char *)st)
2047
2048#define SSL_set0_chain(ctx,sk) \
2049 SSL_ctrl(ctx,SSL_CTRL_CHAIN,0,(char *)sk)
2050#define SSL_set1_chain(ctx,sk) \
2051 SSL_ctrl(ctx,SSL_CTRL_CHAIN,1,(char *)sk)
2052#define SSL_add0_chain_cert(ctx,x509) \
2053 SSL_ctrl(ctx,SSL_CTRL_CHAIN_CERT,0,(char *)x509)
2054#define SSL_add1_chain_cert(ctx,x509) \
2055 SSL_ctrl(ctx,SSL_CTRL_CHAIN_CERT,1,(char *)x509)
2056#define SSL_get0_chain_certs(ctx,px509) \
2057 SSL_ctrl(ctx,SSL_CTRL_GET_CHAIN_CERTS,0,px509)
2058#define SSL_clear_chain_certs(ctx) \
2059 SSL_set0_chain(ctx,NULL)
2060#define SSL_build_cert_chain(s, flags) \
2061 SSL_ctrl(s,SSL_CTRL_BUILD_CERT_CHAIN, flags, NULL)
2062#define SSL_select_current_cert(ctx,x509) \
2063 SSL_ctrl(ctx,SSL_CTRL_SELECT_CURRENT_CERT,0,(char *)x509)
2064
2065#define SSL_set0_verify_cert_store(s,st) \
2066 SSL_ctrl(s,SSL_CTRL_SET_VERIFY_CERT_STORE,0,(char *)st)
2067#define SSL_set1_verify_cert_store(s,st) \
2068 SSL_ctrl(s,SSL_CTRL_SET_VERIFY_CERT_STORE,1,(char *)st)
2069#define SSL_set0_chain_cert_store(s,st) \
2070 SSL_ctrl(s,SSL_CTRL_SET_CHAIN_CERT_STORE,0,(char *)st)
2071#define SSL_set1_chain_cert_store(s,st) \
2072 SSL_ctrl(s,SSL_CTRL_SET_CHAIN_CERT_STORE,1,(char *)st)
2073
2074#define SSL_get1_curves(ctx, s) \
2075 SSL_ctrl(ctx,SSL_CTRL_GET_CURVES,0,(char *)s)
2076#define SSL_CTX_set1_curves(ctx, clist, clistlen) \
2077 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CURVES,clistlen,(char *)clist)
2078#define SSL_CTX_set1_curves_list(ctx, s) \
2079 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CURVES_LIST,0,(char *)s)
2080#define SSL_set1_curves(ctx, clist, clistlen) \
2081 SSL_ctrl(ctx,SSL_CTRL_SET_CURVES,clistlen,(char *)clist)
2082#define SSL_set1_curves_list(ctx, s) \
2083 SSL_ctrl(ctx,SSL_CTRL_SET_CURVES_LIST,0,(char *)s)
2084#define SSL_get_shared_curve(s, n) \
2085 SSL_ctrl(s,SSL_CTRL_GET_SHARED_CURVE,n,NULL)
2086#define SSL_CTX_set_ecdh_auto(ctx, onoff) \
2087 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_ECDH_AUTO,onoff,NULL)
2088#define SSL_set_ecdh_auto(s, onoff) \
2089 SSL_ctrl(s,SSL_CTRL_SET_ECDH_AUTO,onoff,NULL)
2090
2091#define SSL_CTX_set1_sigalgs(ctx, slist, slistlen) \
2092 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SIGALGS,slistlen,(int *)slist)
2093#define SSL_CTX_set1_sigalgs_list(ctx, s) \
2094 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SIGALGS_LIST,0,(char *)s)
2095#define SSL_set1_sigalgs(ctx, slist, slistlen) \
2096 SSL_ctrl(ctx,SSL_CTRL_SET_SIGALGS,clistlen,(int *)slist)
2097#define SSL_set1_sigalgs_list(ctx, s) \
2098 SSL_ctrl(ctx,SSL_CTRL_SET_SIGALGS_LIST,0,(char *)s)
2099
2100#define SSL_CTX_set1_client_sigalgs(ctx, slist, slistlen) \
2101 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS,slistlen,(int *)slist)
2102#define SSL_CTX_set1_client_sigalgs_list(ctx, s) \
2103 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS_LIST,0,(char *)s)
2104#define SSL_set1_client_sigalgs(ctx, slist, slistlen) \
2105 SSL_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS,clistlen,(int *)slist)
2106#define SSL_set1_client_sigalgs_list(ctx, s) \
2107 SSL_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS_LIST,0,(char *)s)
2108
2109#define SSL_get0_certificate_types(s, clist) \
2110 SSL_ctrl(s, SSL_CTRL_GET_CLIENT_CERT_TYPES, 0, (char *)clist)
2111
2112#define SSL_CTX_set1_client_certificate_types(ctx, clist, clistlen) \
2113 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_CERT_TYPES,clistlen,(char *)clist)
2114#define SSL_set1_client_certificate_types(s, clist, clistlen) \
2115 SSL_ctrl(s,SSL_CTRL_SET_CLIENT_CERT_TYPES,clistlen,(char *)clist)
2116
2117#define SSL_get_peer_signature_nid(s, pn) \
2118 SSL_ctrl(s,SSL_CTRL_GET_PEER_SIGNATURE_NID,0,pn)
2119
2120#define SSL_get_server_tmp_key(s, pk) \
2121 SSL_ctrl(s,SSL_CTRL_GET_SERVER_TMP_KEY,0,pk)
2122
2123#define SSL_get0_raw_cipherlist(s, plst) \
2124 SSL_ctrl(s,SSL_CTRL_GET_RAW_CIPHERLIST,0,(char *)plst)
2125
2126#define SSL_get0_ec_point_formats(s, plst) \
2127 SSL_ctrl(s,SSL_CTRL_GET_EC_POINT_FORMATS,0,(char *)plst)
2128
2129#define SSL_set_tlsa_record(s,tlsa) \
2130 SSL_ctrl(s,SSL_CTRL_SET_TLSA_RECORD,0,(void *)tlsa)
2131#define SSL_pull_tlsa_record(s,host,port) \
2132 SSL_ctrl(s,SSL_CTRL_PULL_TLSA_RECORD,port,host)
2133
2134#ifndef OPENSSL_NO_BIO
2135BIO_METHOD *BIO_f_ssl(void);
2136BIO *BIO_new_ssl(SSL_CTX *ctx,int client);
2137BIO *BIO_new_ssl_connect(SSL_CTX *ctx);
2138BIO *BIO_new_buffer_ssl_connect(SSL_CTX *ctx);
2139int BIO_ssl_copy_session_id(BIO *to,BIO *from);
2140void BIO_ssl_shutdown(BIO *ssl_bio);
2141
2142#endif
2143
2144int SSL_CTX_set_cipher_list(SSL_CTX *,const char *str);
Adam Langley0b5c1ac2014-06-20 12:00:00 -07002145int SSL_CTX_set_cipher_list_tls11(SSL_CTX *,const char *str);
Adam Langley95c29f32014-06-20 12:00:00 -07002146SSL_CTX *SSL_CTX_new(const SSL_METHOD *meth);
2147void SSL_CTX_free(SSL_CTX *);
2148long SSL_CTX_set_timeout(SSL_CTX *ctx,long t);
2149long SSL_CTX_get_timeout(const SSL_CTX *ctx);
2150X509_STORE *SSL_CTX_get_cert_store(const SSL_CTX *);
2151void SSL_CTX_set_cert_store(SSL_CTX *,X509_STORE *);
2152int SSL_want(const SSL *s);
2153int SSL_clear(SSL *s);
2154
2155void SSL_CTX_flush_sessions(SSL_CTX *ctx,long tm);
2156
2157const SSL_CIPHER *SSL_get_current_cipher(const SSL *s);
2158int SSL_CIPHER_get_bits(const SSL_CIPHER *c,int *alg_bits);
Adam Langley73510762014-06-20 12:00:00 -07002159const char * SSL_CIPHER_get_version(const SSL_CIPHER *c);
Adam Langley95c29f32014-06-20 12:00:00 -07002160const char * SSL_CIPHER_get_name(const SSL_CIPHER *c);
2161unsigned long SSL_CIPHER_get_id(const SSL_CIPHER *c);
2162
2163int SSL_get_fd(const SSL *s);
2164int SSL_get_rfd(const SSL *s);
2165int SSL_get_wfd(const SSL *s);
2166const char * SSL_get_cipher_list(const SSL *s,int n);
2167char * SSL_get_shared_ciphers(const SSL *s, char *buf, int len);
2168int SSL_get_read_ahead(const SSL * s);
2169int SSL_pending(const SSL *s);
2170#ifndef OPENSSL_NO_SOCK
2171int SSL_set_fd(SSL *s, int fd);
2172int SSL_set_rfd(SSL *s, int fd);
2173int SSL_set_wfd(SSL *s, int fd);
2174#endif
2175#ifndef OPENSSL_NO_BIO
2176void SSL_set_bio(SSL *s, BIO *rbio,BIO *wbio);
2177BIO * SSL_get_rbio(const SSL *s);
2178BIO * SSL_get_wbio(const SSL *s);
2179#endif
2180int SSL_set_cipher_list(SSL *s, const char *str);
2181void SSL_set_read_ahead(SSL *s, int yes);
2182int SSL_get_verify_mode(const SSL *s);
2183int SSL_get_verify_depth(const SSL *s);
2184int (*SSL_get_verify_callback(const SSL *s))(int,X509_STORE_CTX *);
2185void SSL_set_verify(SSL *s, int mode,
2186 int (*callback)(int ok,X509_STORE_CTX *ctx));
2187void SSL_set_verify_depth(SSL *s, int depth);
2188void SSL_set_cert_cb(SSL *s, int (*cb)(SSL *ssl, void *arg), void *arg);
2189#ifndef OPENSSL_NO_RSA
2190int SSL_use_RSAPrivateKey(SSL *ssl, RSA *rsa);
2191#endif
2192int SSL_use_RSAPrivateKey_ASN1(SSL *ssl, unsigned char *d, long len);
2193int SSL_use_PrivateKey(SSL *ssl, EVP_PKEY *pkey);
2194int SSL_use_PrivateKey_ASN1(int pk,SSL *ssl, const unsigned char *d, long len);
2195int SSL_use_certificate(SSL *ssl, X509 *x);
2196int SSL_use_certificate_ASN1(SSL *ssl, const unsigned char *d, int len);
2197
2198#ifndef OPENSSL_NO_TLSEXT
2199/* Set authz data for the current active cert. */
2200int SSL_CTX_use_authz(SSL_CTX *ctx, unsigned char *authz, size_t authz_length);
2201int SSL_use_authz(SSL *ssl, unsigned char *authz, size_t authz_length);
2202/* Get the authz of type 'type' associated with the current active cert. */
2203const unsigned char *SSL_CTX_get_authz_data(SSL_CTX *ctx, unsigned char type,
2204 size_t *data_length);
2205#ifndef OPENSSL_NO_STDIO
2206int SSL_CTX_use_authz_file(SSL_CTX *ctx, const char *file);
2207int SSL_use_authz_file(SSL *ssl, const char *file);
2208#endif
2209
2210/* Set serverinfo data for the current active cert. */
2211int SSL_CTX_use_serverinfo(SSL_CTX *ctx, const unsigned char *serverinfo,
2212 size_t serverinfo_length);
2213#ifndef OPENSSL_NO_STDIO
2214int SSL_CTX_use_serverinfo_file(SSL_CTX *ctx, const char *file);
2215#endif /* NO_STDIO */
2216
2217#endif
2218
2219#ifndef OPENSSL_NO_STDIO
2220int SSL_use_RSAPrivateKey_file(SSL *ssl, const char *file, int type);
2221int SSL_use_PrivateKey_file(SSL *ssl, const char *file, int type);
2222int SSL_use_certificate_file(SSL *ssl, const char *file, int type);
2223int SSL_CTX_use_RSAPrivateKey_file(SSL_CTX *ctx, const char *file, int type);
2224int SSL_CTX_use_PrivateKey_file(SSL_CTX *ctx, const char *file, int type);
2225int SSL_CTX_use_certificate_file(SSL_CTX *ctx, const char *file, int type);
2226int SSL_CTX_use_certificate_chain_file(SSL_CTX *ctx, const char *file); /* PEM type */
2227STACK_OF(X509_NAME) *SSL_load_client_CA_file(const char *file);
2228int SSL_add_file_cert_subjects_to_stack(STACK_OF(X509_NAME) *stackCAs,
2229 const char *file);
2230#ifndef OPENSSL_SYS_VMS
2231#ifndef OPENSSL_SYS_MACINTOSH_CLASSIC /* XXXXX: Better scheme needed! [was: #ifndef MAC_OS_pre_X] */
2232int SSL_add_dir_cert_subjects_to_stack(STACK_OF(X509_NAME) *stackCAs,
2233 const char *dir);
2234#endif
2235#endif
2236
2237#endif
2238
2239void SSL_load_error_strings(void );
2240const char *SSL_state_string(const SSL *s);
2241const char *SSL_rstate_string(const SSL *s);
2242const char *SSL_state_string_long(const SSL *s);
2243const char *SSL_rstate_string_long(const SSL *s);
2244long SSL_SESSION_get_time(const SSL_SESSION *s);
2245long SSL_SESSION_set_time(SSL_SESSION *s, long t);
2246long SSL_SESSION_get_timeout(const SSL_SESSION *s);
2247long SSL_SESSION_set_timeout(SSL_SESSION *s, long t);
2248void SSL_copy_session_id(SSL *to,const SSL *from);
2249X509 *SSL_SESSION_get0_peer(SSL_SESSION *s);
2250int SSL_SESSION_set1_id_context(SSL_SESSION *s,const unsigned char *sid_ctx,
2251 unsigned int sid_ctx_len);
2252
2253SSL_SESSION *SSL_SESSION_new(void);
2254const unsigned char *SSL_SESSION_get_id(const SSL_SESSION *s,
2255 unsigned int *len);
2256unsigned int SSL_SESSION_get_compress_id(const SSL_SESSION *s);
2257#ifndef OPENSSL_NO_FP_API
2258int SSL_SESSION_print_fp(FILE *fp,const SSL_SESSION *ses);
2259#endif
2260#ifndef OPENSSL_NO_BIO
2261int SSL_SESSION_print(BIO *fp,const SSL_SESSION *ses);
2262#endif
2263#ifndef OPENSSL_NO_TLSEXT
2264unsigned char *SSL_SESSION_get_tlsext_authz_server_audit_proof(SSL_SESSION *s,
2265 size_t *proof_length);
2266#endif
2267void SSL_SESSION_free(SSL_SESSION *ses);
2268int i2d_SSL_SESSION(SSL_SESSION *in,unsigned char **pp);
2269int SSL_set_session(SSL *to, SSL_SESSION *session);
2270int SSL_CTX_add_session(SSL_CTX *s, SSL_SESSION *c);
2271int SSL_CTX_remove_session(SSL_CTX *,SSL_SESSION *c);
2272int SSL_CTX_set_generate_session_id(SSL_CTX *, GEN_SESSION_CB);
2273int SSL_set_generate_session_id(SSL *, GEN_SESSION_CB);
2274int SSL_has_matching_session_id(const SSL *ssl, const unsigned char *id,
2275 unsigned int id_len);
2276SSL_SESSION *d2i_SSL_SESSION(SSL_SESSION **a,const unsigned char **pp,
2277 long length);
2278
2279#ifdef HEADER_X509_H
2280X509 * SSL_get_peer_certificate(const SSL *s);
2281#endif
2282
2283STACK_OF(X509) *SSL_get_peer_cert_chain(const SSL *s);
2284
2285int SSL_CTX_get_verify_mode(const SSL_CTX *ctx);
2286int SSL_CTX_get_verify_depth(const SSL_CTX *ctx);
2287int (*SSL_CTX_get_verify_callback(const SSL_CTX *ctx))(int,X509_STORE_CTX *);
2288void SSL_CTX_set_verify(SSL_CTX *ctx,int mode,
2289 int (*callback)(int, X509_STORE_CTX *));
2290void SSL_CTX_set_verify_depth(SSL_CTX *ctx,int depth);
2291void SSL_CTX_set_cert_verify_callback(SSL_CTX *ctx, int (*cb)(X509_STORE_CTX *,void *), void *arg);
2292void SSL_CTX_set_cert_cb(SSL_CTX *c, int (*cb)(SSL *ssl, void *arg), void *arg);
2293#ifndef OPENSSL_NO_RSA
2294int SSL_CTX_use_RSAPrivateKey(SSL_CTX *ctx, RSA *rsa);
2295#endif
2296int SSL_CTX_use_RSAPrivateKey_ASN1(SSL_CTX *ctx, const unsigned char *d, long len);
2297int SSL_CTX_use_PrivateKey(SSL_CTX *ctx, EVP_PKEY *pkey);
2298int SSL_CTX_use_PrivateKey_ASN1(int pk,SSL_CTX *ctx,
2299 const unsigned char *d, long len);
2300int SSL_CTX_use_certificate(SSL_CTX *ctx, X509 *x);
2301int SSL_CTX_use_certificate_ASN1(SSL_CTX *ctx, int len, const unsigned char *d);
2302
2303void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, pem_password_cb *cb);
2304void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx, void *u);
2305
2306int SSL_CTX_check_private_key(const SSL_CTX *ctx);
2307int SSL_check_private_key(const SSL *ctx);
2308
2309int SSL_CTX_set_session_id_context(SSL_CTX *ctx,const unsigned char *sid_ctx,
2310 unsigned int sid_ctx_len);
2311
2312SSL * SSL_new(SSL_CTX *ctx);
2313int SSL_set_session_id_context(SSL *ssl,const unsigned char *sid_ctx,
2314 unsigned int sid_ctx_len);
2315
2316int SSL_CTX_set_purpose(SSL_CTX *s, int purpose);
2317int SSL_set_purpose(SSL *s, int purpose);
2318int SSL_CTX_set_trust(SSL_CTX *s, int trust);
2319int SSL_set_trust(SSL *s, int trust);
2320
2321int SSL_CTX_set1_param(SSL_CTX *ctx, X509_VERIFY_PARAM *vpm);
2322int SSL_set1_param(SSL *ssl, X509_VERIFY_PARAM *vpm);
2323
2324X509_VERIFY_PARAM *SSL_CTX_get0_param(SSL_CTX *ctx);
2325X509_VERIFY_PARAM *SSL_get0_param(SSL *ssl);
2326
2327void SSL_certs_clear(SSL *s);
2328void SSL_free(SSL *ssl);
2329int SSL_accept(SSL *ssl);
2330int SSL_connect(SSL *ssl);
2331int SSL_read(SSL *ssl,void *buf,int num);
2332int SSL_peek(SSL *ssl,void *buf,int num);
2333int SSL_write(SSL *ssl,const void *buf,int num);
2334long SSL_ctrl(SSL *ssl,int cmd, long larg, void *parg);
2335long SSL_callback_ctrl(SSL *, int, void (*)(void));
2336long SSL_CTX_ctrl(SSL_CTX *ctx,int cmd, long larg, void *parg);
2337long SSL_CTX_callback_ctrl(SSL_CTX *, int, void (*)(void));
2338
2339int SSL_get_error(const SSL *s,int ret_code);
2340const char *SSL_get_version(const SSL *s);
2341
Adam Langley4d4bff82014-06-20 12:00:00 -07002342int SSL_CIPHER_is_AES(const SSL_CIPHER *c);
2343int SSL_CIPHER_has_MD5_HMAC(const SSL_CIPHER *c);
2344int SSL_CIPHER_is_AESGCM(const SSL_CIPHER *c);
Adam Langleyde0b2022014-06-20 12:00:00 -07002345int SSL_CIPHER_is_CHACHA20POLY1305(const SSL_CIPHER *c);
Adam Langley4d4bff82014-06-20 12:00:00 -07002346
Adam Langley95c29f32014-06-20 12:00:00 -07002347/* This sets the 'default' SSL version that SSL_new() will create */
2348int SSL_CTX_set_ssl_version(SSL_CTX *ctx, const SSL_METHOD *meth);
2349
2350const SSL_METHOD *SSLv3_method(void); /* SSLv3 */
2351const SSL_METHOD *SSLv3_server_method(void); /* SSLv3 */
2352const SSL_METHOD *SSLv3_client_method(void); /* SSLv3 */
2353
2354const SSL_METHOD *SSLv23_method(void); /* SSLv3 but can rollback to v2 */
2355const SSL_METHOD *SSLv23_server_method(void); /* SSLv3 but can rollback to v2 */
2356const SSL_METHOD *SSLv23_client_method(void); /* SSLv3 but can rollback to v2 */
2357
2358const SSL_METHOD *TLSv1_method(void); /* TLSv1.0 */
2359const SSL_METHOD *TLSv1_server_method(void); /* TLSv1.0 */
2360const SSL_METHOD *TLSv1_client_method(void); /* TLSv1.0 */
2361
2362const SSL_METHOD *TLSv1_1_method(void); /* TLSv1.1 */
2363const SSL_METHOD *TLSv1_1_server_method(void); /* TLSv1.1 */
2364const SSL_METHOD *TLSv1_1_client_method(void); /* TLSv1.1 */
2365
2366const SSL_METHOD *TLSv1_2_method(void); /* TLSv1.2 */
2367const SSL_METHOD *TLSv1_2_server_method(void); /* TLSv1.2 */
2368const SSL_METHOD *TLSv1_2_client_method(void); /* TLSv1.2 */
2369
2370
2371const SSL_METHOD *DTLSv1_method(void); /* DTLSv1.0 */
2372const SSL_METHOD *DTLSv1_server_method(void); /* DTLSv1.0 */
2373const SSL_METHOD *DTLSv1_client_method(void); /* DTLSv1.0 */
2374
2375const SSL_METHOD *DTLSv1_2_method(void); /* DTLSv1.2 */
2376const SSL_METHOD *DTLSv1_2_server_method(void); /* DTLSv1.2 */
2377const SSL_METHOD *DTLSv1_2_client_method(void); /* DTLSv1.2 */
2378
2379const SSL_METHOD *DTLS_method(void); /* DTLS 1.0 and 1.2 */
2380const SSL_METHOD *DTLS_server_method(void); /* DTLS 1.0 and 1.2 */
2381const SSL_METHOD *DTLS_client_method(void); /* DTLS 1.0 and 1.2 */
2382
2383STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *s);
2384
2385int SSL_do_handshake(SSL *s);
2386int SSL_renegotiate(SSL *s);
2387int SSL_renegotiate_abbreviated(SSL *s);
2388int SSL_renegotiate_pending(SSL *s);
2389int SSL_shutdown(SSL *s);
2390
2391const SSL_METHOD *SSL_CTX_get_ssl_method(SSL_CTX *ctx);
2392const SSL_METHOD *SSL_get_ssl_method(SSL *s);
2393int SSL_set_ssl_method(SSL *s, const SSL_METHOD *method);
2394const char *SSL_alert_type_string_long(int value);
2395const char *SSL_alert_type_string(int value);
2396const char *SSL_alert_desc_string_long(int value);
2397const char *SSL_alert_desc_string(int value);
2398
2399void SSL_set_client_CA_list(SSL *s, STACK_OF(X509_NAME) *name_list);
2400void SSL_CTX_set_client_CA_list(SSL_CTX *ctx, STACK_OF(X509_NAME) *name_list);
2401STACK_OF(X509_NAME) *SSL_get_client_CA_list(const SSL *s);
2402STACK_OF(X509_NAME) *SSL_CTX_get_client_CA_list(const SSL_CTX *s);
2403int SSL_add_client_CA(SSL *ssl,X509 *x);
2404int SSL_CTX_add_client_CA(SSL_CTX *ctx,X509 *x);
2405
2406void SSL_set_connect_state(SSL *s);
2407void SSL_set_accept_state(SSL *s);
2408
2409long SSL_get_default_timeout(const SSL *s);
2410
2411int SSL_library_init(void );
2412
Adam Langley73510762014-06-20 12:00:00 -07002413const char *SSL_CIPHER_description(const SSL_CIPHER *,char *buf,int size);
Adam Langley95c29f32014-06-20 12:00:00 -07002414STACK_OF(X509_NAME) *SSL_dup_CA_list(STACK_OF(X509_NAME) *sk);
2415
2416X509 *SSL_get_certificate(const SSL *ssl);
2417/* EVP_PKEY */ struct evp_pkey_st *SSL_get_privatekey(const SSL *ssl);
2418
2419X509 *SSL_CTX_get0_certificate(const SSL_CTX *ctx);
2420EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx);
2421
2422void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx,int mode);
2423int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx);
2424void SSL_set_quiet_shutdown(SSL *ssl,int mode);
2425int SSL_get_quiet_shutdown(const SSL *ssl);
2426void SSL_set_shutdown(SSL *ssl,int mode);
2427int SSL_get_shutdown(const SSL *ssl);
2428int SSL_version(const SSL *ssl);
2429int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx);
2430int SSL_CTX_load_verify_locations(SSL_CTX *ctx, const char *CAfile,
2431 const char *CApath);
2432#define SSL_get0_session SSL_get_session /* just peek at pointer */
2433SSL_SESSION *SSL_get_session(const SSL *ssl);
2434SSL_SESSION *SSL_get1_session(SSL *ssl); /* obtain a reference count */
2435SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl);
2436SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX* ctx);
2437void SSL_set_info_callback(SSL *ssl,
2438 void (*cb)(const SSL *ssl,int type,int val));
2439void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl,int type,int val);
2440int SSL_state(const SSL *ssl);
2441void SSL_set_state(SSL *ssl, int state);
2442
2443void SSL_set_verify_result(SSL *ssl,long v);
2444long SSL_get_verify_result(const SSL *ssl);
2445
2446int SSL_set_ex_data(SSL *ssl,int idx,void *data);
2447void *SSL_get_ex_data(const SSL *ssl,int idx);
2448int SSL_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
2449 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
2450
2451int SSL_SESSION_set_ex_data(SSL_SESSION *ss,int idx,void *data);
2452void *SSL_SESSION_get_ex_data(const SSL_SESSION *ss,int idx);
2453int SSL_SESSION_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
2454 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
2455
2456int SSL_CTX_set_ex_data(SSL_CTX *ssl,int idx,void *data);
2457void *SSL_CTX_get_ex_data(const SSL_CTX *ssl,int idx);
2458int SSL_CTX_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
2459 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
2460
2461int SSL_get_ex_data_X509_STORE_CTX_idx(void );
2462
2463#define SSL_CTX_sess_set_cache_size(ctx,t) \
2464 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SESS_CACHE_SIZE,t,NULL)
2465#define SSL_CTX_sess_get_cache_size(ctx) \
2466 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_SESS_CACHE_SIZE,0,NULL)
2467#define SSL_CTX_set_session_cache_mode(ctx,m) \
2468 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SESS_CACHE_MODE,m,NULL)
2469#define SSL_CTX_get_session_cache_mode(ctx) \
2470 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_SESS_CACHE_MODE,0,NULL)
2471
2472#define SSL_CTX_get_default_read_ahead(ctx) SSL_CTX_get_read_ahead(ctx)
2473#define SSL_CTX_set_default_read_ahead(ctx,m) SSL_CTX_set_read_ahead(ctx,m)
2474#define SSL_CTX_get_read_ahead(ctx) \
2475 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_READ_AHEAD,0,NULL)
2476#define SSL_CTX_set_read_ahead(ctx,m) \
2477 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_READ_AHEAD,m,NULL)
2478#define SSL_CTX_get_max_cert_list(ctx) \
2479 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_MAX_CERT_LIST,0,NULL)
2480#define SSL_CTX_set_max_cert_list(ctx,m) \
2481 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_CERT_LIST,m,NULL)
2482#define SSL_get_max_cert_list(ssl) \
2483 SSL_ctrl(ssl,SSL_CTRL_GET_MAX_CERT_LIST,0,NULL)
2484#define SSL_set_max_cert_list(ssl,m) \
2485 SSL_ctrl(ssl,SSL_CTRL_SET_MAX_CERT_LIST,m,NULL)
2486
2487#define SSL_CTX_set_max_send_fragment(ctx,m) \
2488 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_SEND_FRAGMENT,m,NULL)
2489#define SSL_set_max_send_fragment(ssl,m) \
2490 SSL_ctrl(ssl,SSL_CTRL_SET_MAX_SEND_FRAGMENT,m,NULL)
2491
2492 /* NB: the keylength is only applicable when is_export is true */
2493#ifndef OPENSSL_NO_RSA
2494void SSL_CTX_set_tmp_rsa_callback(SSL_CTX *ctx,
2495 RSA *(*cb)(SSL *ssl,int is_export,
2496 int keylength));
2497
2498void SSL_set_tmp_rsa_callback(SSL *ssl,
2499 RSA *(*cb)(SSL *ssl,int is_export,
2500 int keylength));
2501#endif
2502#ifndef OPENSSL_NO_DH
2503void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
2504 DH *(*dh)(SSL *ssl,int is_export,
2505 int keylength));
2506void SSL_set_tmp_dh_callback(SSL *ssl,
2507 DH *(*dh)(SSL *ssl,int is_export,
2508 int keylength));
2509#endif
2510#ifndef OPENSSL_NO_ECDH
2511void SSL_CTX_set_tmp_ecdh_callback(SSL_CTX *ctx,
2512 EC_KEY *(*ecdh)(SSL *ssl,int is_export,
2513 int keylength));
2514void SSL_set_tmp_ecdh_callback(SSL *ssl,
2515 EC_KEY *(*ecdh)(SSL *ssl,int is_export,
2516 int keylength));
2517#endif
2518
2519const void *SSL_get_current_compression(SSL *s);
2520const void *SSL_get_current_expansion(SSL *s);
2521const char *SSL_COMP_get_name(const void *comp);
2522void *SSL_COMP_get_compression_methods(void);
2523int SSL_COMP_add_compression_method(int id,void *cm);
2524
2525const SSL_CIPHER *SSL_CIPHER_find(SSL *ssl, const unsigned char *ptr);
2526
2527/* TLS extensions functions */
2528int SSL_set_session_ticket_ext(SSL *s, void *ext_data, int ext_len);
2529
2530int SSL_set_session_ticket_ext_cb(SSL *s, tls_session_ticket_ext_cb_fn cb,
2531 void *arg);
2532
2533/* Pre-shared secret session resumption functions */
2534int SSL_set_session_secret_cb(SSL *s, tls_session_secret_cb_fn tls_session_secret_cb, void *arg);
2535
2536void SSL_set_debug(SSL *s, int debug);
2537int SSL_cache_hit(SSL *s);
2538int SSL_is_server(SSL *s);
2539
Adam Langley95f22882014-06-20 12:00:00 -07002540/* SSL_get_structure_sizes returns the sizes of the SSL, SSL_CTX and
2541 * SSL_SESSION structures so that a test can ensure that outside code agrees on
2542 * these values. */
2543void SSL_get_structure_sizes(size_t* ssl_size, size_t* ssl_ctx_size,
2544 size_t* ssl_session_size);
2545
Adam Langley95c29f32014-06-20 12:00:00 -07002546SSL_CONF_CTX *SSL_CONF_CTX_new(void);
2547int SSL_CONF_CTX_finish(SSL_CONF_CTX *cctx);
2548void SSL_CONF_CTX_free(SSL_CONF_CTX *cctx);
2549unsigned int SSL_CONF_CTX_set_flags(SSL_CONF_CTX *cctx, unsigned int flags);
2550unsigned int SSL_CONF_CTX_clear_flags(SSL_CONF_CTX *cctx, unsigned int flags);
2551int SSL_CONF_CTX_set1_prefix(SSL_CONF_CTX *cctx, const char *pre);
2552
2553void SSL_CONF_CTX_set_ssl(SSL_CONF_CTX *cctx, SSL *ssl);
2554void SSL_CONF_CTX_set_ssl_ctx(SSL_CONF_CTX *cctx, SSL_CTX *ctx);
2555
2556int SSL_CONF_cmd(SSL_CONF_CTX *cctx, const char *cmd, const char *value);
2557int SSL_CONF_cmd_argv(SSL_CONF_CTX *cctx, int *pargc, char ***pargv);
2558int SSL_CONF_cmd_value_type(SSL_CONF_CTX *cctx, const char *cmd);
2559
2560#ifndef OPENSSL_NO_SSL_TRACE
2561void SSL_trace(int write_p, int version, int content_type,
2562 const void *buf, size_t len, SSL *ssl, void *arg);
2563const char *SSL_CIPHER_standard_name(const SSL_CIPHER *c);
2564#endif
2565
2566unsigned char *SSL_get_tlsa_record_byname(const char *name,int port,int type);
2567
2568/* BEGIN ERROR CODES */
2569/* The following lines are auto generated by the script mkerr.pl. Any changes
2570 * made after this point may be overwritten when the script is next run.
2571 */
2572void ERR_load_SSL_strings(void);
2573
2574
2575#ifdef __cplusplus
2576}
2577#endif
2578#define SSL_F_SSL_use_PrivateKey_file 100
2579#define SSL_F_dtls1_write_app_data_bytes 101
2580#define SSL_F_ssl_cipher_process_rulestr 102
2581#define SSL_F_SSL_set_session_id_context 103
2582#define SSL_F_SSL_read 104
2583#define SSL_F_ssl_cert_new 105
2584#define SSL_F_dtls1_heartbeat 106
2585#define SSL_F_ssl3_digest_cached_records 107
2586#define SSL_F_SSL_set_wfd 108
2587#define SSL_F_SSL_CTX_use_serverinfo 109
2588#define SSL_F_ssl_set_pkey 110
2589#define SSL_F_SSL_CTX_use_certificate 111
2590#define SSL_F_dtls1_read_bytes 112
2591#define SSL_F_ssl23_write 113
2592#define SSL_F_ssl3_check_client_hello 114
2593#define SSL_F_SSL_use_certificate_ASN1 115
2594#define SSL_F_ssl_verify_cert_chain 116
2595#define SSL_F_ssl_parse_serverhello_renegotiate_ext 117
2596#define SSL_F_ssl_undefined_const_function 118
2597#define SSL_F_ssl3_get_server_certificate 119
2598#define SSL_F_tls1_get_server_supplemental_data 120
2599#define SSL_F_dtls1_buffer_record 121
2600#define SSL_F_ssl_prepare_clienthello_tlsext 122
2601#define SSL_F_ssl3_get_server_hello 123
2602#define SSL_F_ssl3_send_client_key_exchange 124
2603#define SSL_F_ssl3_write_bytes 125
2604#define SSL_F_SSL_use_RSAPrivateKey_file 126
2605#define SSL_F_ssl_bad_method 127
2606#define SSL_F_ssl3_connect 128
2607#define SSL_F_dtls1_connect 129
2608#define SSL_F_SSL_use_RSAPrivateKey 130
2609#define SSL_F_tls1_PRF 131
2610#define SSL_F_ssl_bytes_to_cipher_list 132
2611#define SSL_F_ssl3_do_change_cipher_spec 133
2612#define SSL_F_SSL_SESSION_set1_id_context 134
2613#define SSL_F_ssl_add_serverhello_tlsext 135
2614#define SSL_F_read_authz 136
2615#define SSL_F_ssl3_get_client_hello 137
2616#define SSL_F_ssl3_get_certificate_request 138
2617#define SSL_F_authz_find_data 139
2618#define SSL_F_ssl_add_cert_to_buf 140
2619#define SSL_F_ssl_add_serverhello_renegotiate_ext 141
2620#define SSL_F_ssl3_get_message 142
2621#define SSL_F_ssl_check_srvr_ecc_cert_and_alg 143
2622#define SSL_F_ssl_parse_clienthello_tlsext 144
2623#define SSL_F_SSL_add_file_cert_subjects_to_stack 145
2624#define SSL_F_ssl3_ctx_ctrl 146
2625#define SSL_F_ssl3_get_record 147
2626#define SSL_F_SSL_CTX_use_RSAPrivateKey 148
2627#define SSL_F_SSL_use_certificate_file 149
2628#define SSL_F_SSL_CTX_use_serverinfo_file 150
2629#define SSL_F_SSL_load_client_CA_file 151
2630#define SSL_F_dtls1_preprocess_fragment 152
2631#define SSL_F_SSL_CTX_check_private_key 153
2632#define SSL_F_ssl3_get_cert_status 154
2633#define SSL_F_printf 155
2634#define SSL_F_SSL_CTX_new 156
2635#define SSL_F_ssl23_accept 157
2636#define SSL_F_SSL_use_authz 158
2637#define SSL_F_ssl_undefined_function 159
2638#define SSL_F_dtls1_send_hello_verify_request 160
2639#define SSL_F_ssl_build_cert_chain 161
2640#define SSL_F_SSL_SESSION_print_fp 162
2641#define SSL_F_tls1_change_cipher_state 163
2642#define SSL_F_tls12_check_peer_sigalg 164
2643#define SSL_F_ssl_sess_cert_new 165
2644#define SSL_F_ssl3_read_bytes 166
2645#define SSL_F_dtls1_get_hello_verify 167
2646#define SSL_F_tls1_cert_verify_mac 168
2647#define SSL_F_ssl23_client_hello 169
2648#define SSL_F_SSL_shutdown 170
2649#define SSL_F_ssl_init_wbio_buffer 171
2650#define SSL_F_SSL_use_certificate 172
2651#define SSL_F_SSL_CTX_use_RSAPrivateKey_ASN1 173
2652#define SSL_F_ssl_set_authz 174
2653#define SSL_F_ssl23_peek 175
2654#define SSL_F_SSL_use_psk_identity_hint 176
2655#define SSL_F_ssl3_get_cert_verify 177
2656#define SSL_F_ssl_ctx_make_profiles 178
2657#define SSL_F_ssl_add_clienthello_use_srtp_ext 179
2658#define SSL_F_ssl3_get_client_key_exchange 180
2659#define SSL_F_do_ssl3_write 181
2660#define SSL_F_ssl3_handshake_mac 182
2661#define SSL_F_tls1_setup_key_block 183
2662#define SSL_F_SSL_set_fd 184
2663#define SSL_F_SSL_check_private_key 185
2664#define SSL_F_ssl3_send_client_verify 186
2665#define SSL_F_ssl3_write_pending 187
2666#define SSL_F_ssl_cert_inst 188
2667#define SSL_F_ssl3_change_cipher_state 189
2668#define SSL_F_ssl23_get_server_hello 190
2669#define SSL_F_SSL_write 191
2670#define SSL_F_ssl_get_sign_pkey 192
2671#define SSL_F_ssl_set_cert 193
2672#define SSL_F_SSL_CTX_use_RSAPrivateKey_file 194
2673#define SSL_F_SSL_CTX_use_authz 195
2674#define SSL_F_ssl_get_new_session 196
2675#define SSL_F_SSL_set_session_ticket_ext 197
2676#define SSL_F_ssl_add_clienthello_renegotiate_ext 198
2677#define SSL_F_ssl3_send_server_key_exchange 199
2678#define SSL_F_fprintf 200
2679#define SSL_F_ssl3_get_new_session_ticket 201
2680#define SSL_F_SSL_CTX_use_certificate_ASN1 202
2681#define SSL_F_ssl_add_cert_chain 203
2682#define SSL_F_ssl_create_cipher_list 204
2683#define SSL_F_ssl3_callback_ctrl 205
2684#define SSL_F_SSL_CTX_set_cipher_list 206
2685#define SSL_F_ssl3_send_certificate_request 207
2686#define SSL_F_SSL_use_PrivateKey_ASN1 208
2687#define SSL_F_SSL_CTX_use_certificate_chain_file 209
2688#define SSL_F_SSL_SESSION_new 210
2689#define SSL_F_check_suiteb_cipher_list 211
2690#define SSL_F_ssl_scan_clienthello_tlsext 212
2691#define SSL_F_ssl3_client_hello 213
2692#define SSL_F_SSL_use_RSAPrivateKey_ASN1 214
2693#define SSL_F_ssl3_ctrl 215
2694#define SSL_F_ssl3_setup_write_buffer 216
2695#define SSL_F_ssl_parse_serverhello_use_srtp_ext 217
2696#define SSL_F_ssl3_get_key_exchange 218
2697#define SSL_F_ssl3_send_server_hello 219
2698#define SSL_F_SSL_add_dir_cert_subjects_to_stack 220
2699#define SSL_F_ssl_check_serverhello_tlsext 221
2700#define SSL_F_ssl3_get_server_done 222
2701#define SSL_F_ssl3_check_cert_and_algorithm 223
2702#define SSL_F_do_dtls1_write 224
2703#define SSL_F_dtls1_check_timeout_num 225
2704#define SSL_F_tls1_export_keying_material 226
2705#define SSL_F_SSL_CTX_set_session_id_context 227
2706#define SSL_F_SSL_set_rfd 228
2707#define SSL_F_ssl3_send_client_certificate 229
2708#define SSL_F_ssl_cert_dup 230
2709#define SSL_F_dtls1_process_record 231
2710#define SSL_F_ssl_new 232
2711#define SSL_F_ssl_get_server_cert_index 233
2712#define SSL_F_tls1_send_server_supplemental_data 234
2713#define SSL_F_D2I_SSL_SESSION 235
2714#define SSL_F_ssl_cipher_strength_sort 236
2715#define SSL_F_dtls1_get_message 237
2716#define SSL_F_ssl23_connect 238
2717#define SSL_F_tls1_heartbeat 239
2718#define SSL_F_ssl3_read_n 240
2719#define SSL_F_ssl_get_prev_session 241
2720#define SSL_F_ssl_parse_clienthello_renegotiate_ext 242
2721#define SSL_F_ssl3_setup_read_buffer 243
2722#define SSL_F_SSL_CTX_set_ssl_version 244
2723#define SSL_F_SSL_peek 245
2724#define SSL_F_ssl3_send_server_certificate 246
2725#define SSL_F_SSL_do_handshake 247
2726#define SSL_F_ssl_undefined_void_function 248
2727#define SSL_F_ssl_add_serverhello_use_srtp_ext 249
2728#define SSL_F_fclose 250
2729#define SSL_F_SSL_use_PrivateKey 251
2730#define SSL_F_SSL_CTX_use_certificate_file 252
2731#define SSL_F_SSL_CTX_use_PrivateKey 253
2732#define SSL_F_SSL_set_session 254
2733#define SSL_F_SSL_CTX_use_psk_identity_hint 255
2734#define SSL_F_ssl_scan_serverhello_tlsext 256
2735#define SSL_F_ssl23_read 257
2736#define SSL_F_ssl_parse_clienthello_use_srtp_ext 258
2737#define SSL_F_ssl3_accept 259
2738#define SSL_F_ssl3_get_client_certificate 260
2739#define SSL_F_SSL_CTX_use_PrivateKey_ASN1 261
2740#define SSL_F_dtls1_get_message_fragment 262
2741#define SSL_F_SSL_clear 263
2742#define SSL_F_dtls1_accept 264
2743#define SSL_F_ssl3_get_next_proto 265
2744#define SSL_F_SSL_set_cipher_list 266
2745#define SSL_F_ssl_add_clienthello_tlsext 267
2746#define SSL_F_ssl23_get_client_hello 268
2747#define SSL_F_SSL_CTX_use_PrivateKey_file 269
2748#define SSL_F_ssl3_get_finished 270
2749#define SSL_F_ssl3_generate_key_block 271
2750#define SSL_F_ssl3_setup_key_block 272
2751#define SSL_F_SSL_new 273
2752#define SSL_F_ssl_parse_serverhello_tlsext 274
Adam Langley1258b6a2014-06-20 12:00:00 -07002753#define SSL_F_ssl3_get_channel_id 275
2754#define SSL_F_ssl3_send_channel_id 276
Adam Langley0b5c1ac2014-06-20 12:00:00 -07002755#define SSL_F_SSL_CTX_set_cipher_list_tls11 277
Adam Langleya5fa5b72014-06-20 12:00:00 -07002756#define SSL_F_tls1_change_cipher_state_cipher 278
Adam Langleyc9fb3752014-06-20 12:00:00 -07002757#define SSL_F_tls1_change_cipher_state_aead 279
2758#define SSL_F_tls1_aead_ctx_init 280
Adam Langley95c29f32014-06-20 12:00:00 -07002759#define SSL_R_UNABLE_TO_FIND_ECDH_PARAMETERS 100
2760#define SSL_R_DECRYPTION_FAILED_OR_BAD_RECORD_MAC 101
2761#define SSL_R_INVALID_NULL_CMD_NAME 102
2762#define SSL_R_BAD_RSA_DECRYPT 103
2763#define SSL_R_NO_SHARED_CIPHER 104
2764#define SSL_R_BAD_PSK_IDENTITY_HINT_LENGTH 105
2765#define SSL_R_SSL_HANDSHAKE_FAILURE 106
2766#define SSL_R_INVALID_TICKET_KEYS_LENGTH 107
2767#define SSL_R_PEER_ERROR 108
2768#define SSL_R_ECC_CERT_NOT_FOR_SIGNING 109
2769#define SSL_R_INCONSISTENT_COMPRESSION 110
2770#define SSL_R_BAD_HELLO_REQUEST 111
2771#define SSL_R_NULL_SSL_METHOD_PASSED 112
2772#define SSL_R_X509_VERIFICATION_SETUP_PROBLEMS 113
2773#define SSL_R_BAD_ECDSA_SIGNATURE 114
2774#define SSL_R_GOT_NEXT_PROTO_WITHOUT_EXTENSION 115
2775#define SSL_R_BAD_DH_PUB_KEY_LENGTH 116
2776#define SSL_R_COMPRESSED_LENGTH_TOO_LONG 117
2777#define SSL_R_APP_DATA_IN_HANDSHAKE 118
2778#define SSL_R_NO_PEM_EXTENSIONS 119
2779#define SSL_R_BAD_SRP_B_LENGTH 120
2780#define SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG 121
2781#define SSL_R_UNABLE_TO_DECODE_DH_CERTS 122
2782#define SSL_R_MISSING_SRP_PARAM 123
2783#define SSL_R_MISSING_RSA_SIGNING_CERT 124
2784#define SSL_R_MISSING_DSA_SIGNING_CERT 125
2785#define SSL_R_ONLY_TLS_1_2_ALLOWED_IN_SUITEB_MODE 126
2786#define SSL_R_UNEXPECTED_RECORD 127
2787#define SSL_R_BAD_DIGEST_LENGTH 128
2788#define SSL_R_READ_TIMEOUT_EXPIRED 129
2789#define SSL_R_KRB5_C_GET_CRED 130
2790#define SSL_R_NULL_SSL_CTX 131
2791#define SSL_R_TLSV1_ALERT_EXPORT_RESTRICTION 132
2792#define SSL_R_TLSV1_ALERT_INTERNAL_ERROR 133
2793#define SSL_R_ERROR_GENERATING_TMP_RSA_KEY 134
2794#define SSL_R_SSL3_SESSION_ID_TOO_LONG 135
2795#define SSL_R_BAD_DATA_RETURNED_BY_CALLBACK 136
2796#define SSL_R_REUSE_CERT_LENGTH_NOT_ZERO 137
2797#define SSL_R_SSLV3_ALERT_DECOMPRESSION_FAILURE 138
2798#define SSL_R_COOKIE_MISMATCH 139
2799#define SSL_R_UNINITIALIZED 140
2800#define SSL_R_BAD_CHANGE_CIPHER_SPEC 141
2801#define SSL_R_UNABLE_TO_LOAD_SSL3_SHA1_ROUTINES 142
2802#define SSL_R_BAD_SRP_G_LENGTH 143
2803#define SSL_R_NO_CERTIFICATE_ASSIGNED 144
2804#define SSL_R_UNABLE_TO_FIND_PUBLIC_KEY_PARAMETERS 145
2805#define SSL_R_PEM_NAME_TOO_SHORT 146
2806#define SSL_R_SSLV3_ALERT_CERTIFICATE_REVOKED 147
2807#define SSL_R_PROTOCOL_IS_SHUTDOWN 148
2808#define SSL_R_UNABLE_TO_FIND_SSL_METHOD 149
2809#define SSL_R_WRONG_MESSAGE_TYPE 150
2810#define SSL_R_BAD_RSA_MODULUS_LENGTH 151
2811#define SSL_R_PUBLIC_KEY_IS_NOT_RSA 152
2812#define SSL_R_COMPRESSION_ID_NOT_WITHIN_PRIVATE_RANGE 153
2813#define SSL_R_NO_CLIENT_CERT_RECEIVED 154
2814#define SSL_R_TLS_INVALID_ECPOINTFORMAT_LIST 155
2815#define SSL_R_CERT_LENGTH_MISMATCH 156
2816#define SSL_R_MISSING_EXPORT_TMP_DH_KEY 157
2817#define SSL_R_DUPLICATE_COMPRESSION_ID 158
2818#define SSL_R_SSL3_EXT_INVALID_ECPOINTFORMAT 159
2819#define SSL_R_REUSE_CIPHER_LIST_NOT_ZERO 160
2820#define SSL_R_DATA_LENGTH_TOO_LONG 161
2821#define SSL_R_ECGROUP_TOO_LARGE_FOR_CIPHER 162
2822#define SSL_R_WRONG_SIGNATURE_LENGTH 163
2823#define SSL_R_SSL2_CONNECTION_ID_TOO_LONG 164
2824#define SSL_R_WRONG_VERSION_NUMBER 165
2825#define SSL_R_RECORD_TOO_LARGE 166
2826#define SSL_R_BIO_NOT_SET 167
2827#define SSL_R_SRTP_COULD_NOT_ALLOCATE_PROFILES 168
2828#define SSL_R_TLSV1_ALERT_DECODE_ERROR 169
2829#define SSL_R_UNKNOWN_PKEY_TYPE 170
2830#define SSL_R_CIPHER_CODE_WRONG_LENGTH 171
2831#define SSL_R_SSL_SESSION_ID_CONFLICT 172
2832#define SSL_R_INVALID_COMMAND 173
2833#define SSL_R_NO_PROTOCOLS_AVAILABLE 174
2834#define SSL_R_ERROR_IN_RECEIVED_CIPHER_LIST 175
2835#define SSL_R_LIBRARY_BUG 176
2836#define SSL_R_UNSUPPORTED_CIPHER 177
2837#define SSL_R_REUSE_CERT_TYPE_NOT_ZERO 178
2838#define SSL_R_WRONG_SIGNATURE_TYPE 179
2839#define SSL_R_BAD_SRTP_PROTECTION_PROFILE_LIST 180
2840#define SSL_R_PSK_NO_SERVER_CB 181
2841#define SSL_R_BLOCK_CIPHER_PAD_IS_WRONG 182
2842#define SSL_R_INVALID_TRUST 183
2843#define SSL_R_PARSE_TLSEXT 184
2844#define SSL_R_NO_SRTP_PROFILES 185
2845#define SSL_R_UNSUPPORTED_ELLIPTIC_CURVE 186
2846#define SSL_R_UNKNOWN_STATE 187
2847#define SSL_R_UNKNOWN_CERTIFICATE_TYPE 188
Adam Langley1258b6a2014-06-20 12:00:00 -07002848#define SSL_R_WRONG_CIPHER_RETURNED 189
2849#define SSL_R_BAD_DH_G_LENGTH 190
2850#define SSL_R_BAD_ALERT_RECORD 191
2851#define SSL_R_CIPHER_TABLE_SRC_ERROR 192
2852#define SSL_R_SSLV3_ALERT_BAD_CERTIFICATE 193
2853#define SSL_R_UNKNOWN_REMOTE_ERROR_TYPE 194
2854#define SSL_R_SSL3_EXT_INVALID_SERVERNAME_TYPE 195
2855#define SSL_R_MESSAGE_TOO_LONG 196
2856#define SSL_R_BAD_RSA_SIGNATURE 197
2857#define SSL_R_X509_LIB 198
2858#define SSL_R_BAD_SRP_N_LENGTH 199
2859#define SSL_R_BAD_SSL_SESSION_ID_LENGTH 200
2860#define SSL_R_UNKNOWN_CIPHER_TYPE 201
2861#define SSL_R_BAD_DH_P_LENGTH 202
2862#define SSL_R_MISSING_DH_RSA_CERT 203
2863#define SSL_R_NO_METHOD_SPECIFIED 204
2864#define SSL_R_EMPTY_SRTP_PROTECTION_PROFILE_LIST 205
2865#define SSL_R_MULTIPLE_SGC_RESTARTS 206
2866#define SSL_R_UNABLE_TO_DECODE_ECDH_CERTS 207
2867#define SSL_R_ATTEMPT_TO_REUSE_SESSION_IN_DIFFERENT_CONTEXT 208
2868#define SSL_R_SSL3_EXT_INVALID_SERVERNAME 209
2869#define SSL_R_BAD_SRP_S_LENGTH 210
2870#define SSL_R_MISSING_TMP_RSA_KEY 211
2871#define SSL_R_PSK_NO_CLIENT_CB 212
2872#define SSL_R_PEM_NAME_BAD_PREFIX 213
2873#define SSL_R_BAD_CHECKSUM 214
2874#define SSL_R_TLSV1_ALERT_PROTOCOL_VERSION 215
2875#define SSL_R_NO_CIPHER_MATCH 216
2876#define SSL_R_MISSING_TMP_DH_KEY 217
2877#define SSL_R_UNSUPPORTED_STATUS_TYPE 218
2878#define SSL_R_UNKNOWN_AUTHZ_DATA_TYPE 219
2879#define SSL_R_CONNECTION_TYPE_NOT_SET 220
2880#define SSL_R_MISSING_DH_KEY 221
2881#define SSL_R_CHANNEL_ID_NOT_P256 222
2882#define SSL_R_UNKNOWN_SUPPLEMENTAL_DATA_TYPE 223
2883#define SSL_R_UNKNOWN_PROTOCOL 224
2884#define SSL_R_DATA_BETWEEN_CCS_AND_FINISHED 225
2885#define SSL_R_KRB5_S_TKT_SKEW 226
2886#define SSL_R_PUBLIC_KEY_NOT_RSA 227
2887#define SSL_R_SCSV_RECEIVED_WHEN_RENEGOTIATING 228
2888#define SSL_R_GOST_NOT_SUPPORTED 229
2889#define SSL_R_KRB5_C_CC_PRINC 230
2890#define SSL_R_SSLV3_ALERT_HANDSHAKE_FAILURE 231
2891#define SSL_R_TLSV1_ALERT_RECORD_OVERFLOW 232
2892#define SSL_R_TLSV1_BAD_CERTIFICATE_STATUS_RESPONSE 233
2893#define SSL_R_INVALID_PURPOSE 234
2894#define SSL_R_KRB5_C_MK_REQ 235
2895#define SSL_R_SSLV3_ALERT_BAD_RECORD_MAC 236
2896#define SSL_R_BAD_SRTP_MKI_VALUE 237
2897#define SSL_R_EVP_DIGESTSIGNINIT_FAILED 238
2898#define SSL_R_DIGEST_CHECK_FAILED 239
2899#define SSL_R_BAD_SRP_A_LENGTH 240
2900#define SSL_R_SERVERHELLO_TLSEXT 241
2901#define SSL_R_TLS_RSA_ENCRYPTED_VALUE_LENGTH_IS_WRONG 242
2902#define SSL_R_NO_CIPHERS_AVAILABLE 243
2903#define SSL_R_COMPRESSION_FAILURE 244
2904#define SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION 245
2905#define SSL_R_OLD_SESSION_CIPHER_NOT_RETURNED 246
2906#define SSL_R_BAD_RSA_ENCRYPT 247
2907#define SSL_R_EXCESSIVE_MESSAGE_SIZE 248
2908#define SSL_R_INVALID_COMPRESSION_ALGORITHM 249
2909#define SSL_R_SHORT_READ 250
2910#define SSL_R_TLSV1_ALERT_ACCESS_DENIED 251
2911#define SSL_R_CA_DN_LENGTH_MISMATCH 252
2912#define SSL_R_BAD_ECC_CERT 253
2913#define SSL_R_NON_SSLV2_INITIAL_PACKET 254
2914#define SSL_R_SSL_SESSION_ID_IS_DIFFERENT 255
2915#define SSL_R_MISSING_TMP_RSA_PKEY 256
2916#define SSL_R_BN_LIB 257
2917#define SSL_R_PEER_DID_NOT_RETURN_A_CERTIFICATE 258
2918#define SSL_R_MISSING_RSA_ENCRYPTING_CERT 259
2919#define SSL_R_NO_RENEGOTIATION 260
2920#define SSL_R_NO_COMPRESSION_SPECIFIED 261
2921#define SSL_R_WRONG_CERTIFICATE_TYPE 262
2922#define SSL_R_TLSV1_UNRECOGNIZED_NAME 263
2923#define SSL_R_CHANNEL_ID_SIGNATURE_INVALID 264
2924#define SSL_R_READ_BIO_NOT_SET 265
2925#define SSL_R_SSL23_DOING_SESSION_ID_REUSE 266
2926#define SSL_R_RENEGOTIATE_EXT_TOO_LONG 267
2927#define SSL_R_INVALID_CHALLENGE_LENGTH 268
2928#define SSL_R_TLSV1_ALERT_INSUFFICIENT_SECURITY 269
2929#define SSL_R_LIBRARY_HAS_NO_CIPHERS 270
2930#define SSL_R_WRONG_CURVE 271
2931#define SSL_R_SESSION_ID_CONTEXT_UNINITIALIZED 272
2932#define SSL_R_SSLV3_ALERT_UNEXPECTED_MESSAGE 273
2933#define SSL_R_TLSV1_UNSUPPORTED_EXTENSION 274
2934#define SSL_R_ECC_CERT_NOT_FOR_KEY_AGREEMENT 275
2935#define SSL_R_MISSING_RSA_CERTIFICATE 276
2936#define SSL_R_NO_P256_SUPPORT 277
2937#define SSL_R_UNSUPPORTED_COMPRESSION_ALGORITHM 278
2938#define SSL_R_INVALID_SERVERINFO_DATA 279
2939#define SSL_R_GOT_CHANNEL_ID_BEFORE_A_CCS 280
2940#define SSL_R_DH_PUBLIC_VALUE_LENGTH_IS_WRONG 281
2941#define SSL_R_KRB5_S_BAD_TICKET 282
2942#define SSL_R_EVP_DIGESTSIGNFINAL_FAILED 283
2943#define SSL_R_PACKET_LENGTH_TOO_LONG 284
2944#define SSL_R_BAD_STATE 285
2945#define SSL_R_USE_SRTP_NOT_NEGOTIATED 286
2946#define SSL_R_BAD_RSA_E_LENGTH 287
2947#define SSL_R_ILLEGAL_PADDING 288
2948#define SSL_R_SIGNATURE_FOR_NON_SIGNING_CERTIFICATE 289
2949#define SSL_R_BAD_VALUE 290
2950#define SSL_R_ECC_CERT_SHOULD_HAVE_RSA_SIGNATURE 291
2951#define SSL_R_COMPRESSION_DISABLED 292
2952#define SSL_R_BAD_DECOMPRESSION 293
2953#define SSL_R_CHALLENGE_IS_DIFFERENT 294
2954#define SSL_R_NO_CLIENT_CERT_METHOD 295
2955#define SSL_R_SRTP_PROTECTION_PROFILE_LIST_TOO_LONG 296
2956#define SSL_R_INVALID_MESSAGE 297
2957#define SSL_R_HTTPS_PROXY_REQUEST 298
2958#define SSL_R_AUTHZ_DATA_TOO_LARGE 299
2959#define SSL_R_KRB5_S_TKT_EXPIRED 300
2960#define SSL_R_NO_CERTIFICATE_SPECIFIED 301
2961#define SSL_R_ECC_CERT_SHOULD_HAVE_SHA1_SIGNATURE 302
2962#define SSL_R_TLS_PEER_DID_NOT_RESPOND_WITH_CERTIFICATE_LIST 303
2963#define SSL_R_INVALID_STATUS_RESPONSE 304
2964#define SSL_R_TLS_ILLEGAL_EXPORTER_LABEL 305
2965#define SSL_R_ONLY_DTLS_1_2_ALLOWED_IN_SUITEB_MODE 306
2966#define SSL_R_MISSING_TMP_ECDH_KEY 307
2967#define SSL_R_CERTIFICATE_VERIFY_FAILED 308
2968#define SSL_R_TRIED_TO_USE_UNSUPPORTED_CIPHER 309
2969#define SSL_R_RENEGOTIATION_ENCODING_ERR 310
2970#define SSL_R_NO_PRIVATEKEY 311
2971#define SSL_R_TLS_HEARTBEAT_PENDING 312
2972#define SSL_R_READ_WRONG_PACKET_TYPE 313
2973#define SSL_R_SSL3_SESSION_ID_TOO_SHORT 314
2974#define SSL_R_UNABLE_TO_LOAD_SSL2_MD5_ROUTINES 315
2975#define SSL_R_GOT_NEXT_PROTO_BEFORE_A_CCS 316
2976#define SSL_R_HTTP_REQUEST 317
2977#define SSL_R_KRB5_S_INIT 318
2978#define SSL_R_TLSV1_ALERT_USER_CANCELLED 319
2979#define SSL_R_RECORD_LENGTH_MISMATCH 320
2980#define SSL_R_BAD_LENGTH 321
2981#define SSL_R_NO_REQUIRED_DIGEST 322
2982#define SSL_R_KRB5 323
2983#define SSL_R_TLSV1_BAD_CERTIFICATE_HASH_VALUE 324
2984#define SSL_R_CCS_RECEIVED_EARLY 325
2985#define SSL_R_MISSING_ECDSA_SIGNING_CERT 326
2986#define SSL_R_D2I_ECDSA_SIG 327
2987#define SSL_R_PATH_TOO_LONG 328
2988#define SSL_R_CIPHER_OR_HASH_UNAVAILABLE 329
2989#define SSL_R_UNSUPPORTED_DIGEST_TYPE 330
2990#define SSL_R_OLD_SESSION_COMPRESSION_ALGORITHM_NOT_RETURNED 331
2991#define SSL_R_PEER_ERROR_CERTIFICATE 332
2992#define SSL_R_UNABLE_TO_FIND_DH_PARAMETERS 333
2993#define SSL_R_NO_CERTIFICATE_SET 334
2994#define SSL_R_SSL_SESSION_ID_CALLBACK_FAILED 335
2995#define SSL_R_SSLV3_ALERT_CERTIFICATE_EXPIRED 336
2996#define SSL_R_NO_CERTIFICATES_RETURNED 337
2997#define SSL_R_BAD_WRITE_RETRY 338
2998#define SSL_R_BAD_SSL_FILETYPE 339
2999#define SSL_R_SRTP_UNKNOWN_PROTECTION_PROFILE 340
3000#define SSL_R_NO_CIPHERS_SPECIFIED 341
3001#define SSL_R_LENGTH_MISMATCH 342
3002#define SSL_R_NO_CIPHERS_PASSED 343
3003#define SSL_R_NO_VERIFY_CALLBACK 344
3004#define SSL_R_PEER_ERROR_UNSUPPORTED_CERTIFICATE_TYPE 345
3005#define SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN 346
3006#define SSL_R_WRONG_NUMBER_OF_KEY_BITS 347
3007#define SSL_R_UNEXPECTED_MESSAGE 348
3008#define SSL_R_MISSING_DH_DSA_CERT 349
3009#define SSL_R_SSL_SESSION_ID_HAS_BAD_LENGTH 350
3010#define SSL_R_OPAQUE_PRF_INPUT_TOO_LONG 351
3011#define SSL_R_UNABLE_TO_LOAD_SSL3_MD5_ROUTINES 352
3012#define SSL_R_ILLEGAL_SUITEB_DIGEST 353
3013#define SSL_R_NO_SHARED_SIGATURE_ALGORITHMS 354
3014#define SSL_R_CLIENTHELLO_TLSEXT 355
3015#define SSL_R_INVALID_AUTHZ_DATA 356
3016#define SSL_R_BAD_RESPONSE_ARGUMENT 357
3017#define SSL_R_PUBLIC_KEY_ENCRYPT_ERROR 358
3018#define SSL_R_REQUIRED_CIPHER_MISSING 359
3019#define SSL_R_INVALID_AUDIT_PROOF 360
3020#define SSL_R_PSK_IDENTITY_NOT_FOUND 361
3021#define SSL_R_UNKNOWN_ALERT_TYPE 362
3022#define SSL_R_NO_GOST_CERTIFICATE_SENT_BY_PEER 363
3023#define SSL_R_TLSV1_ALERT_UNKNOWN_CA 364
3024#define SSL_R_BAD_AUTHENTICATION_TYPE 365
3025#define SSL_R_DECRYPTION_FAILED 366
3026#define SSL_R_WRONG_SSL_VERSION 367
3027#define SSL_R_NO_CERTIFICATE_RETURNED 368
3028#define SSL_R_SSLV3_ALERT_ILLEGAL_PARAMETER 369
3029#define SSL_R_CA_DN_TOO_LONG 370
3030#define SSL_R_GOT_A_FIN_BEFORE_A_CCS 371
3031#define SSL_R_COMPRESSION_LIBRARY_ERROR 372
3032#define SSL_R_TLSV1_ALERT_DECRYPT_ERROR 373
3033#define SSL_R_SSL_LIBRARY_HAS_NO_CIPHERS 374
3034#define SSL_R_UNSAFE_LEGACY_RENEGOTIATION_DISABLED 375
3035#define SSL_R_BAD_ECPOINT 376
3036#define SSL_R_BAD_HANDSHAKE_LENGTH 377
3037#define SSL_R_SSLV3_ALERT_UNSUPPORTED_CERTIFICATE 378
3038#define SSL_R_TLSV1_CERTIFICATE_UNOBTAINABLE 379
3039#define SSL_R_KRB5_S_RD_REQ 380
3040#define SSL_R_PEER_ERROR_NO_CERTIFICATE 381
3041#define SSL_R_PRE_MAC_LENGTH_TOO_LONG 382
3042#define SSL_R_PROBLEMS_MAPPING_CIPHER_FUNCTIONS 383
3043#define SSL_R_UNKNOWN_DIGEST 384
3044#define SSL_R_WRONG_SIGNATURE_SIZE 385
3045#define SSL_R_SIGNATURE_ALGORITHMS_ERROR 386
3046#define SSL_R_REQUIRED_COMPRESSSION_ALGORITHM_MISSING 387
3047#define SSL_R_BAD_SIGNATURE 388
3048#define SSL_R_BAD_PACKET_LENGTH 389
3049#define SSL_R_CANNOT_SERIALIZE_PUBLIC_KEY 390
3050#define SSL_R_RENEGOTIATION_MISMATCH 391
3051#define SSL_R_BAD_MAC_LENGTH 392
3052#define SSL_R_NO_PUBLICKEY 393
3053#define SSL_R_UNKNOWN_KEY_EXCHANGE_TYPE 394
3054#define SSL_R_BAD_MAC_DECODE 395
3055#define SSL_R_NO_PRIVATE_KEY_ASSIGNED 396
3056#define SSL_R_EXTRA_DATA_IN_MESSAGE 397
3057#define SSL_R_TLS_CLIENT_CERT_REQ_WITH_ANON_CIPHER 398
3058#define SSL_R_CONNECTION_ID_IS_DIFFERENT 399
3059#define SSL_R_SSLV3_ALERT_NO_CERTIFICATE 400
3060#define SSL_R_TLS_HEARTBEAT_PEER_DOESNT_ACCEPT 401
3061#define SSL_R_MISSING_VERIFY_MESSAGE 402
3062#define SSL_R_BAD_DSA_SIGNATURE 403
3063#define SSL_R_UNKNOWN_SSL_VERSION 404
3064#define SSL_R_KEY_ARG_TOO_LONG 405
3065#define SSL_R_KRB5_C_INIT 406
3066#define SSL_R_NO_CIPHER_LIST 407
3067#define SSL_R_PEER_ERROR_NO_CIPHER 408
3068#define SSL_R_UNKNOWN_CMD_NAME 409
3069#define SSL_R_UNKNOWN_CIPHER_RETURNED 410
3070#define SSL_R_RECORD_TOO_SMALL 411
3071#define SSL_R_ENCRYPTED_LENGTH_TOO_LONG 412
3072#define SSL_R_UNSUPPORTED_SSL_VERSION 413
3073#define SSL_R_TLSV1_ALERT_DECRYPTION_FAILED 414
3074#define SSL_R_UNABLE_TO_EXTRACT_PUBLIC_KEY 415
3075#define SSL_R_MISSING_EXPORT_TMP_RSA_KEY 416
3076#define SSL_R_BAD_DATA 417
3077#define SSL_R_KRB5_S_TKT_NYV 418
3078#define SSL_R_TLSV1_ALERT_NO_RENEGOTIATION 419
3079#define SSL_R_BAD_PROTOCOL_VERSION_NUMBER 420
3080#define SSL_R_BAD_MESSAGE_TYPE 421
3081#define SSL_R_MISSING_ECDH_CERT 422
3082#define SSL_R_UNSUPPORTED_PROTOCOL 423
3083#define SSL_R_SRP_A_CALC 424
3084#define SSL_R_WRITE_BIO_NOT_SET 425
3085#define SSL_R_ONLY_TLS_ALLOWED_IN_FIPS_MODE 426
3086#define SSL_R_LENGTH_TOO_SHORT 427
3087#define SSL_R_CERT_CB_ERROR 428
3088#define SSL_R_DTLS_MESSAGE_TOO_BIG 429
3089#define SSL_R_INVALID_SRP_USERNAME 430
Adam Langley48105fa2014-06-20 12:00:00 -07003090#define SSL_R_TOO_MANY_EMPTY_FRAGMENTS 431
Adam Langley858a88d2014-06-20 12:00:00 -07003091#define SSL_R_NESTED_GROUP 432
3092#define SSL_R_UNEXPECTED_GROUP_CLOSE 433
3093#define SSL_R_UNEXPECTED_OPERATOR_IN_GROUP 434
3094#define SSL_R_MIXED_SPECIAL_OPERATOR_WITH_GROUPS 435
Adam Langley29707792014-06-20 12:00:00 -07003095#define SSL_R_INAPPROPRIATE_FALLBACK 436
Adam Langleydc9b1412014-06-20 12:00:00 -07003096#define SSL_R_CLIENTHELLO_PARSE_FAILED 437
3097#define SSL_R_CONNECTION_REJECTED 438
Adam Langley95c29f32014-06-20 12:00:00 -07003098
3099#endif