blob: 4aa6d228949cb48d96531da57c2fdb987c78afbc [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
868typedef struct ssl_comp_st SSL_COMP;
869
870#ifndef OPENSSL_NO_SSL_INTERN
871
872struct ssl_comp_st
873 {
874 int id;
875 const char *name;
876 char *method;
877 };
878
879DECLARE_STACK_OF(SSL_COMP)
880DECLARE_LHASH_OF(SSL_SESSION);
881
Adam Langley858a88d2014-06-20 12:00:00 -0700882/* ssl_cipher_preference_list_st contains a list of SSL_CIPHERs with
883 * equal-preference groups. For TLS clients, the groups are moot because the
884 * server picks the cipher and groups cannot be expressed on the wire. However,
885 * for servers, the equal-preference groups allow the client's preferences to
886 * be partially respected. (This only has an effect with
887 * SSL_OP_CIPHER_SERVER_PREFERENCE).
888 *
889 * The equal-preference groups are expressed by grouping SSL_CIPHERs together.
890 * All elements of a group have the same priority: no ordering is expressed
891 * within a group.
892 *
893 * The values in |ciphers| are in one-to-one correspondence with
894 * |in_group_flags|. (That is, sk_SSL_CIPHER_num(ciphers) is the number of
895 * bytes in |in_group_flags|.) The bytes in |in_group_flags| are either 1, to
896 * indicate that the corresponding SSL_CIPHER is not the last element of a
897 * group, or 0 to indicate that it is.
898 *
899 * For example, if |in_group_flags| contains all zeros then that indicates a
900 * traditional, fully-ordered preference. Every SSL_CIPHER is the last element
901 * of the group (i.e. they are all in a one-element group).
902 *
903 * For a more complex example, consider:
904 * ciphers: A B C D E F
905 * in_group_flags: 1 1 0 0 1 0
906 *
907 * That would express the following, order:
908 *
909 * A E
910 * B -> D -> F
911 * C
912 */
913struct ssl_cipher_preference_list_st
914 {
915 STACK_OF(SSL_CIPHER) *ciphers;
916 unsigned char *in_group_flags;
917 };
918
Adam Langley95c29f32014-06-20 12:00:00 -0700919struct ssl_ctx_st
920 {
921 const SSL_METHOD *method;
922
Adam Langley858a88d2014-06-20 12:00:00 -0700923 struct ssl_cipher_preference_list_st *cipher_list;
Adam Langley95c29f32014-06-20 12:00:00 -0700924 /* same as above but sorted for lookup */
925 STACK_OF(SSL_CIPHER) *cipher_list_by_id;
Adam Langley0b5c1ac2014-06-20 12:00:00 -0700926 /* cipher_list_tls11 is the list of ciphers when TLS 1.1 or greater is
927 * in use. This only applies to server connections as, for clients, the
928 * version number is known at connect time and so the cipher list can
929 * be set then. */
Adam Langley858a88d2014-06-20 12:00:00 -0700930 struct ssl_cipher_preference_list_st *cipher_list_tls11;
Adam Langley95c29f32014-06-20 12:00:00 -0700931
932 struct x509_store_st /* X509_STORE */ *cert_store;
933 LHASH_OF(SSL_SESSION) *sessions;
934 /* Most session-ids that will be cached, default is
935 * SSL_SESSION_CACHE_MAX_SIZE_DEFAULT. 0 is unlimited. */
936 unsigned long session_cache_size;
937 struct ssl_session_st *session_cache_head;
938 struct ssl_session_st *session_cache_tail;
939
940 /* This can have one of 2 values, ored together,
941 * SSL_SESS_CACHE_CLIENT,
942 * SSL_SESS_CACHE_SERVER,
943 * Default is SSL_SESSION_CACHE_SERVER, which means only
944 * SSL_accept which cache SSL_SESSIONS. */
945 int session_cache_mode;
946
947 /* If timeout is not 0, it is the default timeout value set
948 * when SSL_new() is called. This has been put in to make
949 * life easier to set things up */
950 long session_timeout;
951
952 /* If this callback is not null, it will be called each
953 * time a session id is added to the cache. If this function
954 * returns 1, it means that the callback will do a
955 * SSL_SESSION_free() when it has finished using it. Otherwise,
956 * on 0, it means the callback has finished with it.
957 * If remove_session_cb is not null, it will be called when
958 * a session-id is removed from the cache. After the call,
959 * OpenSSL will SSL_SESSION_free() it. */
960 int (*new_session_cb)(struct ssl_st *ssl,SSL_SESSION *sess);
961 void (*remove_session_cb)(struct ssl_ctx_st *ctx,SSL_SESSION *sess);
962 SSL_SESSION *(*get_session_cb)(struct ssl_st *ssl,
963 unsigned char *data,int len,int *copy);
964
965 struct
966 {
967 int sess_connect; /* SSL new conn - started */
968 int sess_connect_renegotiate;/* SSL reneg - requested */
969 int sess_connect_good; /* SSL new conne/reneg - finished */
970 int sess_accept; /* SSL new accept - started */
971 int sess_accept_renegotiate;/* SSL reneg - requested */
972 int sess_accept_good; /* SSL accept/reneg - finished */
973 int sess_miss; /* session lookup misses */
974 int sess_timeout; /* reuse attempt on timeouted session */
975 int sess_cache_full; /* session removed due to full cache */
976 int sess_hit; /* session reuse actually done */
977 int sess_cb_hit; /* session-id that was not
978 * in the cache was
979 * passed back via the callback. This
980 * indicates that the application is
981 * supplying session-id's from other
982 * processes - spooky :-) */
983 } stats;
984
985 int references;
986
987 /* if defined, these override the X509_verify_cert() calls */
988 int (*app_verify_callback)(X509_STORE_CTX *, void *);
989 void *app_verify_arg;
990 /* before OpenSSL 0.9.7, 'app_verify_arg' was ignored
991 * ('app_verify_callback' was called with just one argument) */
992
993 /* Default password callback. */
994 pem_password_cb *default_passwd_callback;
995
996 /* Default password callback user data. */
997 void *default_passwd_callback_userdata;
998
999 /* get client cert callback */
1000 int (*client_cert_cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey);
1001
Adam Langley1258b6a2014-06-20 12:00:00 -07001002 /* get channel id callback */
1003 void (*channel_id_cb)(SSL *ssl, EVP_PKEY **pkey);
1004
Adam Langley95c29f32014-06-20 12:00:00 -07001005 /* cookie generate callback */
1006 int (*app_gen_cookie_cb)(SSL *ssl, unsigned char *cookie,
1007 unsigned int *cookie_len);
1008
1009 /* verify cookie callback */
1010 int (*app_verify_cookie_cb)(SSL *ssl, unsigned char *cookie,
1011 unsigned int cookie_len);
1012
1013 CRYPTO_EX_DATA ex_data;
1014
1015 const EVP_MD *rsa_md5;/* For SSLv2 - name is 'ssl2-md5' */
1016 const EVP_MD *md5; /* For SSLv3/TLSv1 'ssl3-md5' */
1017 const EVP_MD *sha1; /* For SSLv3/TLSv1 'ssl3->sha1' */
1018
1019 STACK_OF(X509) *extra_certs;
1020 STACK_OF(SSL_COMP) *comp_methods; /* stack of SSL_COMP, SSLv3/TLSv1 */
1021
1022
1023 /* Default values used when no per-SSL value is defined follow */
1024
1025 void (*info_callback)(const SSL *ssl,int type,int val); /* used if SSL's info_callback is NULL */
1026
1027 /* what we put in client cert requests */
1028 STACK_OF(X509_NAME) *client_CA;
1029
1030
1031 /* Default values to use in SSL structures follow (these are copied by SSL_new) */
1032
1033 unsigned long options;
1034 unsigned long mode;
1035 long max_cert_list;
1036
1037 struct cert_st /* CERT */ *cert;
1038 int read_ahead;
1039
1040 /* callback that allows applications to peek at protocol messages */
1041 void (*msg_callback)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg);
1042 void *msg_callback_arg;
1043
1044 int verify_mode;
1045 unsigned int sid_ctx_length;
1046 unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
1047 int (*default_verify_callback)(int ok,X509_STORE_CTX *ctx); /* called 'verify_callback' in the SSL */
1048
1049 /* Default generate session ID callback. */
1050 GEN_SESSION_CB generate_session_id;
1051
1052 X509_VERIFY_PARAM *param;
1053
1054#if 0
1055 int purpose; /* Purpose setting */
1056 int trust; /* Trust setting */
1057#endif
1058
1059 int quiet_shutdown;
1060
1061 /* Maximum amount of data to send in one fragment.
1062 * actual record size can be more than this due to
1063 * padding and MAC overheads.
1064 */
1065 unsigned int max_send_fragment;
1066
1067#ifndef OPENSSL_ENGINE
1068 /* Engine to pass requests for client certs to
1069 */
1070 ENGINE *client_cert_engine;
1071#endif
1072
1073#ifndef OPENSSL_NO_TLSEXT
1074 /* TLS extensions servername callback */
1075 int (*tlsext_servername_callback)(SSL*, int *, void *);
1076 void *tlsext_servername_arg;
1077 /* RFC 4507 session ticket keys */
1078 unsigned char tlsext_tick_key_name[16];
1079 unsigned char tlsext_tick_hmac_key[16];
1080 unsigned char tlsext_tick_aes_key[16];
1081 /* Callback to support customisation of ticket key setting */
1082 int (*tlsext_ticket_key_cb)(SSL *ssl,
1083 unsigned char *name, unsigned char *iv,
1084 EVP_CIPHER_CTX *ectx,
1085 HMAC_CTX *hctx, int enc);
1086
1087 /* certificate status request info */
1088 /* Callback for status request */
1089 int (*tlsext_status_cb)(SSL *ssl, void *arg);
1090 void *tlsext_status_arg;
1091
1092 /* draft-rescorla-tls-opaque-prf-input-00.txt information */
1093 int (*tlsext_opaque_prf_input_callback)(SSL *, void *peerinput, size_t len, void *arg);
1094 void *tlsext_opaque_prf_input_callback_arg;
1095#endif
1096
1097#ifndef OPENSSL_NO_PSK
1098 char *psk_identity_hint;
1099 unsigned int (*psk_client_callback)(SSL *ssl, const char *hint, char *identity,
1100 unsigned int max_identity_len, unsigned char *psk,
1101 unsigned int max_psk_len);
1102 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
1103 unsigned char *psk, unsigned int max_psk_len);
1104#endif
1105
1106#ifndef OPENSSL_NO_BUF_FREELISTS
1107#define SSL_MAX_BUF_FREELIST_LEN_DEFAULT 32
1108 unsigned int freelist_max_len;
1109 struct ssl3_buf_freelist_st *wbuf_freelist;
1110 struct ssl3_buf_freelist_st *rbuf_freelist;
Adam Langley75872532014-06-20 12:00:00 -07001111 /* retain_only_sha256_of_client_certs is true if we should compute the
1112 * SHA256 hash of the peer's certifiate and then discard it to save
1113 * memory and session space. Only effective on the server side. */
1114 char retain_only_sha256_of_client_certs;
Adam Langley95c29f32014-06-20 12:00:00 -07001115#endif
1116
1117#ifndef OPENSSL_NO_TLSEXT
1118
1119# ifndef OPENSSL_NO_NEXTPROTONEG
1120 /* Next protocol negotiation information */
1121 /* (for experimental NPN extension). */
1122
1123 /* For a server, this contains a callback function by which the set of
1124 * advertised protocols can be provided. */
1125 int (*next_protos_advertised_cb)(SSL *s, const unsigned char **buf,
1126 unsigned int *len, void *arg);
1127 void *next_protos_advertised_cb_arg;
1128 /* For a client, this contains a callback function that selects the
1129 * next protocol from the list provided by the server. */
1130 int (*next_proto_select_cb)(SSL *s, unsigned char **out,
1131 unsigned char *outlen,
1132 const unsigned char *in,
1133 unsigned int inlen,
1134 void *arg);
1135 void *next_proto_select_cb_arg;
1136# endif
1137
1138 /* ALPN information
1139 * (we are in the process of transitioning from NPN to ALPN.) */
1140
1141 /* For a server, this contains a callback function that allows the
1142 * server to select the protocol for the connection.
1143 * out: on successful return, this must point to the raw protocol
1144 * name (without the length prefix).
1145 * outlen: on successful return, this contains the length of |*out|.
1146 * in: points to the client's list of supported protocols in
1147 * wire-format.
1148 * inlen: the length of |in|. */
1149 int (*alpn_select_cb)(SSL *s,
1150 const unsigned char **out,
1151 unsigned char *outlen,
1152 const unsigned char* in,
1153 unsigned int inlen,
1154 void *arg);
1155 void *alpn_select_cb_arg;
1156
1157 /* For a client, this contains the list of supported protocols in wire
1158 * format. */
1159 unsigned char* alpn_client_proto_list;
1160 unsigned alpn_client_proto_list_len;
1161
1162 /* SRTP profiles we are willing to do from RFC 5764 */
1163 STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles;
1164# ifndef OPENSSL_NO_EC
1165 /* EC extension values inherited by SSL structure */
1166 size_t tlsext_ecpointformatlist_length;
1167 unsigned char *tlsext_ecpointformatlist;
1168 size_t tlsext_ellipticcurvelist_length;
1169 unsigned char *tlsext_ellipticcurvelist;
1170# endif /* OPENSSL_NO_EC */
1171 int (*tlsext_authz_server_audit_proof_cb)(SSL *s, void *arg);
1172 void *tlsext_authz_server_audit_proof_cb_arg;
1173#endif
1174
1175 /* Arrays containing the callbacks for custom TLS Extensions. */
1176 custom_cli_ext_record *custom_cli_ext_records;
1177 size_t custom_cli_ext_records_count;
1178 custom_srv_ext_record *custom_srv_ext_records;
1179 size_t custom_srv_ext_records_count;
Adam Langley1258b6a2014-06-20 12:00:00 -07001180
1181 /* If true, a client will advertise the Channel ID extension and a
1182 * server will echo it. */
1183 char tlsext_channel_id_enabled;
1184 /* tlsext_channel_id_enabled_new is a hack to support both old and new
1185 * ChannelID signatures. It indicates that a client should advertise the
1186 * new ChannelID extension number. */
1187 char tlsext_channel_id_enabled_new;
1188 /* The client's Channel ID private key. */
1189 EVP_PKEY *tlsext_channel_id_private;
1190
Adam Langley95c29f32014-06-20 12:00:00 -07001191 };
1192
1193#endif
1194
1195#define SSL_SESS_CACHE_OFF 0x0000
1196#define SSL_SESS_CACHE_CLIENT 0x0001
1197#define SSL_SESS_CACHE_SERVER 0x0002
1198#define SSL_SESS_CACHE_BOTH (SSL_SESS_CACHE_CLIENT|SSL_SESS_CACHE_SERVER)
1199#define SSL_SESS_CACHE_NO_AUTO_CLEAR 0x0080
1200/* enough comments already ... see SSL_CTX_set_session_cache_mode(3) */
1201#define SSL_SESS_CACHE_NO_INTERNAL_LOOKUP 0x0100
1202#define SSL_SESS_CACHE_NO_INTERNAL_STORE 0x0200
1203#define SSL_SESS_CACHE_NO_INTERNAL \
1204 (SSL_SESS_CACHE_NO_INTERNAL_LOOKUP|SSL_SESS_CACHE_NO_INTERNAL_STORE)
1205
1206LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx);
1207#define SSL_CTX_sess_number(ctx) \
1208 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_NUMBER,0,NULL)
1209#define SSL_CTX_sess_connect(ctx) \
1210 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT,0,NULL)
1211#define SSL_CTX_sess_connect_good(ctx) \
1212 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT_GOOD,0,NULL)
1213#define SSL_CTX_sess_connect_renegotiate(ctx) \
1214 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT_RENEGOTIATE,0,NULL)
1215#define SSL_CTX_sess_accept(ctx) \
1216 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT,0,NULL)
1217#define SSL_CTX_sess_accept_renegotiate(ctx) \
1218 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT_RENEGOTIATE,0,NULL)
1219#define SSL_CTX_sess_accept_good(ctx) \
1220 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT_GOOD,0,NULL)
1221#define SSL_CTX_sess_hits(ctx) \
1222 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_HIT,0,NULL)
1223#define SSL_CTX_sess_cb_hits(ctx) \
1224 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CB_HIT,0,NULL)
1225#define SSL_CTX_sess_misses(ctx) \
1226 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_MISSES,0,NULL)
1227#define SSL_CTX_sess_timeouts(ctx) \
1228 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_TIMEOUTS,0,NULL)
1229#define SSL_CTX_sess_cache_full(ctx) \
1230 SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CACHE_FULL,0,NULL)
Adam Langley1258b6a2014-06-20 12:00:00 -07001231/* SSL_CTX_enable_tls_channel_id configures a TLS server to accept TLS client
1232 * IDs from clients. Returns 1 on success. */
1233#define SSL_CTX_enable_tls_channel_id(ctx) \
1234 SSL_CTX_ctrl(ctx,SSL_CTRL_CHANNEL_ID,0,NULL)
Adam Langley95c29f32014-06-20 12:00:00 -07001235
1236void SSL_CTX_sess_set_new_cb(SSL_CTX *ctx, int (*new_session_cb)(struct ssl_st *ssl,SSL_SESSION *sess));
1237int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx))(struct ssl_st *ssl, SSL_SESSION *sess);
1238void SSL_CTX_sess_set_remove_cb(SSL_CTX *ctx, void (*remove_session_cb)(struct ssl_ctx_st *ctx,SSL_SESSION *sess));
1239void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx))(struct ssl_ctx_st *ctx, SSL_SESSION *sess);
1240void 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));
1241SSL_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 -07001242/* SSL_magic_pending_session_ptr returns a magic SSL_SESSION* which indicates
1243 * that the session isn't currently unavailable. SSL_get_error will then return
1244 * SSL_ERROR_PENDING_SESSION and the handshake can be retried later when the
1245 * lookup has completed. */
1246SSL_SESSION *SSL_magic_pending_session_ptr(void);
Adam Langley95c29f32014-06-20 12:00:00 -07001247void SSL_CTX_set_info_callback(SSL_CTX *ctx, void (*cb)(const SSL *ssl,int type,int val));
1248void (*SSL_CTX_get_info_callback(SSL_CTX *ctx))(const SSL *ssl,int type,int val);
1249void SSL_CTX_set_client_cert_cb(SSL_CTX *ctx, int (*client_cert_cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey));
1250int (*SSL_CTX_get_client_cert_cb(SSL_CTX *ctx))(SSL *ssl, X509 **x509, EVP_PKEY **pkey);
Adam Langley1258b6a2014-06-20 12:00:00 -07001251void SSL_CTX_set_channel_id_cb(SSL_CTX *ctx, void (*channel_id_cb)(SSL *ssl, EVP_PKEY **pkey));
1252void (*SSL_CTX_get_channel_id_cb(SSL_CTX *ctx))(SSL *ssl, EVP_PKEY **pkey);
Adam Langley95c29f32014-06-20 12:00:00 -07001253#ifndef OPENSSL_NO_ENGINE
1254int SSL_CTX_set_client_cert_engine(SSL_CTX *ctx, ENGINE *e);
1255#endif
1256void SSL_CTX_set_cookie_generate_cb(SSL_CTX *ctx, int (*app_gen_cookie_cb)(SSL *ssl, unsigned char *cookie, unsigned int *cookie_len));
1257void SSL_CTX_set_cookie_verify_cb(SSL_CTX *ctx, int (*app_verify_cookie_cb)(SSL *ssl, unsigned char *cookie, unsigned int cookie_len));
1258#ifndef OPENSSL_NO_NEXTPROTONEG
1259void SSL_CTX_set_next_protos_advertised_cb(SSL_CTX *s,
1260 int (*cb) (SSL *ssl,
1261 const unsigned char **out,
1262 unsigned int *outlen,
1263 void *arg), void *arg);
1264void SSL_CTX_set_next_proto_select_cb(SSL_CTX *s,
1265 int (*cb) (SSL *ssl, unsigned char **out,
1266 unsigned char *outlen,
1267 const unsigned char *in,
1268 unsigned int inlen, void *arg),
1269 void *arg);
1270void SSL_get0_next_proto_negotiated(const SSL *s,
1271 const unsigned char **data, unsigned *len);
1272#endif
1273
1274#ifndef OPENSSL_NO_TLSEXT
1275int SSL_select_next_proto(unsigned char **out, unsigned char *outlen,
1276 const unsigned char *in, unsigned int inlen,
1277 const unsigned char *client, unsigned int client_len);
1278#endif
1279
1280#define OPENSSL_NPN_UNSUPPORTED 0
1281#define OPENSSL_NPN_NEGOTIATED 1
1282#define OPENSSL_NPN_NO_OVERLAP 2
1283
1284int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const unsigned char* protos,
1285 unsigned protos_len);
1286int SSL_set_alpn_protos(SSL *ssl, const unsigned char* protos,
1287 unsigned protos_len);
1288void SSL_CTX_set_alpn_select_cb(SSL_CTX* ctx,
1289 int (*cb) (SSL *ssl,
1290 const unsigned char **out,
1291 unsigned char *outlen,
1292 const unsigned char *in,
1293 unsigned int inlen,
1294 void *arg),
1295 void *arg);
1296void SSL_get0_alpn_selected(const SSL *ssl, const unsigned char **data,
1297 unsigned *len);
1298
1299#ifndef OPENSSL_NO_PSK
1300/* the maximum length of the buffer given to callbacks containing the
1301 * resulting identity/psk */
1302#define PSK_MAX_IDENTITY_LEN 128
1303#define PSK_MAX_PSK_LEN 256
1304void SSL_CTX_set_psk_client_callback(SSL_CTX *ctx,
1305 unsigned int (*psk_client_callback)(SSL *ssl, const char *hint,
1306 char *identity, unsigned int max_identity_len, unsigned char *psk,
1307 unsigned int max_psk_len));
1308void SSL_set_psk_client_callback(SSL *ssl,
1309 unsigned int (*psk_client_callback)(SSL *ssl, const char *hint,
1310 char *identity, unsigned int max_identity_len, unsigned char *psk,
1311 unsigned int max_psk_len));
1312void SSL_CTX_set_psk_server_callback(SSL_CTX *ctx,
1313 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
1314 unsigned char *psk, unsigned int max_psk_len));
1315void SSL_set_psk_server_callback(SSL *ssl,
1316 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
1317 unsigned char *psk, unsigned int max_psk_len));
1318int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint);
1319int SSL_use_psk_identity_hint(SSL *s, const char *identity_hint);
1320const char *SSL_get_psk_identity_hint(const SSL *s);
1321const char *SSL_get_psk_identity(const SSL *s);
1322#endif
1323
1324#ifndef OPENSSL_NO_TLSEXT
1325/* Register callbacks to handle custom TLS Extensions as client or server.
1326 *
1327 * Returns nonzero on success. You cannot register twice for the same
1328 * extension number, and registering for an extension number already
1329 * handled by OpenSSL will succeed, but the callbacks will not be invoked.
1330 *
1331 * NULL can be registered for any callback function. For the client
1332 * functions, a NULL custom_cli_ext_first_cb_fn sends an empty ClientHello
1333 * Extension, and a NULL custom_cli_ext_second_cb_fn ignores the ServerHello
1334 * response (if any).
1335 *
1336 * For the server functions, a NULL custom_srv_ext_first_cb_fn means the
1337 * ClientHello extension's data will be ignored, but the extension will still
1338 * be noted and custom_srv_ext_second_cb_fn will still be invoked. A NULL
1339 * custom_srv_ext_second_cb doesn't send a ServerHello extension.
1340 */
1341int SSL_CTX_set_custom_cli_ext(SSL_CTX *ctx, unsigned short ext_type,
1342 custom_cli_ext_first_cb_fn fn1,
1343 custom_cli_ext_second_cb_fn fn2, void *arg);
1344
1345int SSL_CTX_set_custom_srv_ext(SSL_CTX *ctx, unsigned short ext_type,
1346 custom_srv_ext_first_cb_fn fn1,
1347 custom_srv_ext_second_cb_fn fn2, void *arg);
1348#endif
1349
1350#define SSL_NOTHING 1
1351#define SSL_WRITING 2
1352#define SSL_READING 3
1353#define SSL_X509_LOOKUP 4
Adam Langley1258b6a2014-06-20 12:00:00 -07001354#define SSL_CHANNEL_ID_LOOKUP 5
Adam Langleyb2ce0582014-06-20 12:00:00 -07001355#define SSL_PENDING_SESSION 7
Adam Langley95c29f32014-06-20 12:00:00 -07001356
1357/* These will only be used when doing non-blocking IO */
1358#define SSL_want_nothing(s) (SSL_want(s) == SSL_NOTHING)
1359#define SSL_want_read(s) (SSL_want(s) == SSL_READING)
1360#define SSL_want_write(s) (SSL_want(s) == SSL_WRITING)
1361#define SSL_want_x509_lookup(s) (SSL_want(s) == SSL_X509_LOOKUP)
Adam Langley1258b6a2014-06-20 12:00:00 -07001362#define SSL_want_channel_id_lookup(s) (SSL_want(s) == SSL_CHANNEL_ID_LOOKUP)
Adam Langleyb2ce0582014-06-20 12:00:00 -07001363#define SSL_want_session(s) (SSL_want(s) == SSL_PENDING_SESSION)
Adam Langley95c29f32014-06-20 12:00:00 -07001364
1365#define SSL_MAC_FLAG_READ_MAC_STREAM 1
1366#define SSL_MAC_FLAG_WRITE_MAC_STREAM 2
1367
1368#ifndef OPENSSL_NO_SSL_INTERN
1369
1370struct ssl_st
1371 {
1372 /* protocol version
1373 * (one of SSL2_VERSION, SSL3_VERSION, TLS1_VERSION, DTLS1_VERSION)
1374 */
1375 int version;
1376 int type; /* SSL_ST_CONNECT or SSL_ST_ACCEPT */
1377
1378 const SSL_METHOD *method; /* SSLv3 */
1379
1380 /* There are 2 BIO's even though they are normally both the
1381 * same. This is so data can be read and written to different
1382 * handlers */
1383
1384#ifndef OPENSSL_NO_BIO
1385 BIO *rbio; /* used by SSL_read */
1386 BIO *wbio; /* used by SSL_write */
1387 BIO *bbio; /* used during session-id reuse to concatenate
1388 * messages */
1389#else
1390 char *rbio; /* used by SSL_read */
1391 char *wbio; /* used by SSL_write */
1392 char *bbio;
1393#endif
1394 /* This holds a variable that indicates what we were doing
1395 * when a 0 or -1 is returned. This is needed for
1396 * non-blocking IO so we know what request needs re-doing when
1397 * in SSL_accept or SSL_connect */
1398 int rwstate;
1399
1400 /* true when we are actually in SSL_accept() or SSL_connect() */
1401 int in_handshake;
1402 int (*handshake_func)(SSL *);
1403
1404 /* Imagine that here's a boolean member "init" that is
1405 * switched as soon as SSL_set_{accept/connect}_state
1406 * is called for the first time, so that "state" and
1407 * "handshake_func" are properly initialized. But as
1408 * handshake_func is == 0 until then, we use this
1409 * test instead of an "init" member.
1410 */
1411
1412 int server; /* are we the server side? - mostly used by SSL_clear*/
1413
1414 int new_session;/* Generate a new session or reuse an old one.
1415 * NB: For servers, the 'new' session may actually be a previously
1416 * cached session or even the previous session unless
1417 * SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION is set */
1418 int quiet_shutdown;/* don't send shutdown packets */
1419 int shutdown; /* we have shut things down, 0x01 sent, 0x02
1420 * for received */
1421 int state; /* where we are */
1422 int rstate; /* where we are when reading */
1423
1424 BUF_MEM *init_buf; /* buffer used during init */
1425 void *init_msg; /* pointer to handshake message body, set by ssl3_get_message() */
1426 int init_num; /* amount read/written */
1427 int init_off; /* amount read/written */
1428
1429 /* used internally to point at a raw packet */
1430 unsigned char *packet;
1431 unsigned int packet_length;
1432
1433 struct ssl2_state_st *s2; /* SSLv2 variables */
1434 struct ssl3_state_st *s3; /* SSLv3 variables */
1435 struct dtls1_state_st *d1; /* DTLSv1 variables */
1436
1437 int read_ahead; /* Read as many input bytes as possible
1438 * (for non-blocking reads) */
1439
1440 /* callback that allows applications to peek at protocol messages */
1441 void (*msg_callback)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg);
1442 void *msg_callback_arg;
1443
1444 int hit; /* reusing a previous session */
1445
1446 X509_VERIFY_PARAM *param;
1447
1448#if 0
1449 int purpose; /* Purpose setting */
1450 int trust; /* Trust setting */
1451#endif
1452
1453 /* crypto */
Adam Langley858a88d2014-06-20 12:00:00 -07001454 struct ssl_cipher_preference_list_st *cipher_list;
Adam Langley95c29f32014-06-20 12:00:00 -07001455 STACK_OF(SSL_CIPHER) *cipher_list_by_id;
1456
1457 /* These are the ones being used, the ones in SSL_SESSION are
1458 * the ones to be 'copied' into these ones */
1459 int mac_flags;
Adam Langleyc9fb3752014-06-20 12:00:00 -07001460 SSL_AEAD_CTX *aead_read_ctx; /* AEAD context. If non-NULL, then
1461 |enc_read_ctx| and |read_hash| are
1462 ignored. */
Adam Langley95c29f32014-06-20 12:00:00 -07001463 EVP_CIPHER_CTX *enc_read_ctx; /* cryptographic state */
1464 EVP_MD_CTX *read_hash; /* used for mac generation */
1465 char *expand;
1466
Adam Langleyc9fb3752014-06-20 12:00:00 -07001467 SSL_AEAD_CTX *aead_write_ctx; /* AEAD context. If non-NULL, then
1468 |enc_write_ctx| and |write_hash| are
1469 ignored. */
Adam Langley95c29f32014-06-20 12:00:00 -07001470 EVP_CIPHER_CTX *enc_write_ctx; /* cryptographic state */
1471 EVP_MD_CTX *write_hash; /* used for mac generation */
1472 char *compress;
1473
1474 /* session info */
1475
1476 /* client cert? */
1477 /* This is used to hold the server certificate used */
1478 struct cert_st /* CERT */ *cert;
1479
1480 /* the session_id_context is used to ensure sessions are only reused
1481 * in the appropriate context */
1482 unsigned int sid_ctx_length;
1483 unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
1484
1485 /* This can also be in the session once a session is established */
1486 SSL_SESSION *session;
1487
1488 /* Default generate session ID callback. */
1489 GEN_SESSION_CB generate_session_id;
1490
1491 /* Used in SSL2 and SSL3 */
1492 int verify_mode; /* 0 don't care about verify failure.
1493 * 1 fail if verify fails */
1494 int (*verify_callback)(int ok,X509_STORE_CTX *ctx); /* fail if callback returns 0 */
1495
1496 void (*info_callback)(const SSL *ssl,int type,int val); /* optional informational callback */
1497
1498 int error; /* error bytes to be written */
1499 int error_code; /* actual code */
1500
1501#ifndef OPENSSL_NO_PSK
1502 unsigned int (*psk_client_callback)(SSL *ssl, const char *hint, char *identity,
1503 unsigned int max_identity_len, unsigned char *psk,
1504 unsigned int max_psk_len);
1505 unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
1506 unsigned char *psk, unsigned int max_psk_len);
1507#endif
1508
1509 SSL_CTX *ctx;
1510 /* set this flag to 1 and a sleep(1) is put into all SSL_read()
1511 * and SSL_write() calls, good for nbio debuging :-) */
1512 int debug;
1513
1514 /* extra application data */
1515 long verify_result;
1516 CRYPTO_EX_DATA ex_data;
1517
1518 /* for server side, keep the list of CA_dn we can use */
1519 STACK_OF(X509_NAME) *client_CA;
1520
1521 int references;
1522 unsigned long options; /* protocol behaviour */
1523 unsigned long mode; /* API behaviour */
1524 long max_cert_list;
1525 int first_packet;
1526 int client_version; /* what was passed, used for
1527 * SSLv3/TLS rollback check */
1528 unsigned int max_send_fragment;
1529#ifndef OPENSSL_NO_TLSEXT
1530 /* TLS extension debug callback */
1531 void (*tlsext_debug_cb)(SSL *s, int client_server, int type,
1532 unsigned char *data, int len,
1533 void *arg);
1534 void *tlsext_debug_arg;
1535 char *tlsext_hostname;
1536 int servername_done; /* no further mod of servername
1537 0 : call the servername extension callback.
1538 1 : prepare 2, allow last ack just after in server callback.
1539 2 : don't call servername callback, no ack in server hello
1540 */
1541 /* certificate status request info */
1542 /* Status type or -1 if no status type */
1543 int tlsext_status_type;
1544 /* Expect OCSP CertificateStatus message */
1545 int tlsext_status_expected;
1546 /* OCSP status request only */
1547 STACK_OF(OCSP_RESPID) *tlsext_ocsp_ids;
1548 X509_EXTENSIONS *tlsext_ocsp_exts;
1549 /* OCSP response received or to be sent */
1550 unsigned char *tlsext_ocsp_resp;
1551 int tlsext_ocsp_resplen;
1552
1553 /* RFC4507 session ticket expected to be received or sent */
1554 int tlsext_ticket_expected;
1555#ifndef OPENSSL_NO_EC
1556 size_t tlsext_ecpointformatlist_length;
1557 unsigned char *tlsext_ecpointformatlist; /* our list */
1558 size_t tlsext_ellipticcurvelist_length;
1559 unsigned char *tlsext_ellipticcurvelist; /* our list */
1560#endif /* OPENSSL_NO_EC */
1561
1562 /* draft-rescorla-tls-opaque-prf-input-00.txt information to be used for handshakes */
1563 void *tlsext_opaque_prf_input;
1564 size_t tlsext_opaque_prf_input_len;
1565
1566 /* TLS Session Ticket extension override */
1567 TLS_SESSION_TICKET_EXT *tlsext_session_ticket;
1568
1569 /* TLS Session Ticket extension callback */
1570 tls_session_ticket_ext_cb_fn tls_session_ticket_ext_cb;
1571 void *tls_session_ticket_ext_cb_arg;
1572
1573 /* TLS pre-shared secret session resumption */
1574 tls_session_secret_cb_fn tls_session_secret_cb;
1575 void *tls_session_secret_cb_arg;
1576
1577 SSL_CTX * initial_ctx; /* initial ctx, used to store sessions */
1578
1579#ifndef OPENSSL_NO_NEXTPROTONEG
1580 /* Next protocol negotiation. For the client, this is the protocol that
1581 * we sent in NextProtocol and is set when handling ServerHello
1582 * extensions.
1583 *
1584 * For a server, this is the client's selected_protocol from
1585 * NextProtocol and is set when handling the NextProtocol message,
1586 * before the Finished message. */
1587 unsigned char *next_proto_negotiated;
1588 unsigned char next_proto_negotiated_len;
1589#endif
1590
1591#define session_ctx initial_ctx
1592
1593 STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles; /* What we'll do */
1594 SRTP_PROTECTION_PROFILE *srtp_profile; /* What's been chosen */
1595
1596 unsigned int tlsext_heartbeat; /* Is use of the Heartbeat extension negotiated?
1597 0: disabled
1598 1: enabled
1599 2: enabled, but not allowed to send Requests
1600 */
1601 unsigned int tlsext_hb_pending; /* Indicates if a HeartbeatRequest is in flight */
1602 unsigned int tlsext_hb_seq; /* HeartbeatRequest sequence number */
1603
Adam Langley1258b6a2014-06-20 12:00:00 -07001604 /* Copied from the SSL_CTX. For a server, means that we'll accept
1605 * Channel IDs from clients. For a client, means that we'll advertise
1606 * support. */
1607 char tlsext_channel_id_enabled;
1608 /* The client's Channel ID private key. */
1609 EVP_PKEY *tlsext_channel_id_private;
1610
Adam Langley95c29f32014-06-20 12:00:00 -07001611 /* For a client, this contains the list of supported protocols in wire
1612 * format. */
1613 unsigned char* alpn_client_proto_list;
1614 unsigned alpn_client_proto_list_len;
1615#else
1616#define session_ctx ctx
1617#endif /* OPENSSL_NO_TLSEXT */
1618
1619 int renegotiate;/* 1 if we are renegotiating.
1620 * 2 if we are a server and are inside a handshake
1621 * (i.e. not just sending a HelloRequest) */
1622
1623#ifndef OPENSSL_NO_DANE
1624 unsigned char *tlsa_record;
1625 int tlsa_witness;
1626#endif
1627 };
1628
1629#endif
1630
1631#ifdef __cplusplus
1632}
1633#endif
1634
1635#include <openssl/ssl2.h>
1636#include <openssl/ssl3.h>
1637#include <openssl/tls1.h> /* This is mostly sslv3 with a few tweaks */
1638#include <openssl/dtls1.h> /* Datagram TLS */
1639#include <openssl/ssl23.h>
1640#include <openssl/srtp.h> /* Support for the use_srtp extension */
1641
1642#ifdef __cplusplus
1643extern "C" {
1644#endif
1645
1646/* compatibility */
1647#define SSL_set_app_data(s,arg) (SSL_set_ex_data(s,0,(char *)arg))
1648#define SSL_get_app_data(s) (SSL_get_ex_data(s,0))
1649#define SSL_SESSION_set_app_data(s,a) (SSL_SESSION_set_ex_data(s,0,(char *)a))
1650#define SSL_SESSION_get_app_data(s) (SSL_SESSION_get_ex_data(s,0))
1651#define SSL_CTX_get_app_data(ctx) (SSL_CTX_get_ex_data(ctx,0))
1652#define SSL_CTX_set_app_data(ctx,arg) (SSL_CTX_set_ex_data(ctx,0,(char *)arg))
1653
1654/* The following are the possible values for ssl->state are are
1655 * used to indicate where we are up to in the SSL connection establishment.
1656 * The macros that follow are about the only things you should need to use
1657 * and even then, only when using non-blocking IO.
1658 * It can also be useful to work out where you were when the connection
1659 * failed */
1660
1661#define SSL_ST_CONNECT 0x1000
1662#define SSL_ST_ACCEPT 0x2000
1663#define SSL_ST_MASK 0x0FFF
1664#define SSL_ST_INIT (SSL_ST_CONNECT|SSL_ST_ACCEPT)
1665#define SSL_ST_BEFORE 0x4000
1666#define SSL_ST_OK 0x03
1667#define SSL_ST_RENEGOTIATE (0x04|SSL_ST_INIT)
1668
1669#define SSL_CB_LOOP 0x01
1670#define SSL_CB_EXIT 0x02
1671#define SSL_CB_READ 0x04
1672#define SSL_CB_WRITE 0x08
1673#define SSL_CB_ALERT 0x4000 /* used in callback */
1674#define SSL_CB_READ_ALERT (SSL_CB_ALERT|SSL_CB_READ)
1675#define SSL_CB_WRITE_ALERT (SSL_CB_ALERT|SSL_CB_WRITE)
1676#define SSL_CB_ACCEPT_LOOP (SSL_ST_ACCEPT|SSL_CB_LOOP)
1677#define SSL_CB_ACCEPT_EXIT (SSL_ST_ACCEPT|SSL_CB_EXIT)
1678#define SSL_CB_CONNECT_LOOP (SSL_ST_CONNECT|SSL_CB_LOOP)
1679#define SSL_CB_CONNECT_EXIT (SSL_ST_CONNECT|SSL_CB_EXIT)
1680#define SSL_CB_HANDSHAKE_START 0x10
1681#define SSL_CB_HANDSHAKE_DONE 0x20
1682
1683/* Is the SSL_connection established? */
1684#define SSL_get_state(a) SSL_state(a)
1685#define SSL_is_init_finished(a) (SSL_state(a) == SSL_ST_OK)
Adam Langleyadb739e2014-06-20 12:00:00 -07001686#define SSL_in_init(a) ((SSL_state(a)&SSL_ST_INIT) && \
1687 !SSL_cutthrough_complete(a))
Adam Langley95c29f32014-06-20 12:00:00 -07001688#define SSL_in_before(a) (SSL_state(a)&SSL_ST_BEFORE)
1689#define SSL_in_connect_init(a) (SSL_state(a)&SSL_ST_CONNECT)
1690#define SSL_in_accept_init(a) (SSL_state(a)&SSL_ST_ACCEPT)
Adam Langleyadb739e2014-06-20 12:00:00 -07001691int SSL_cutthrough_complete(const SSL *s);
Adam Langley95c29f32014-06-20 12:00:00 -07001692
1693/* The following 2 states are kept in ssl->rstate when reads fail,
1694 * you should not need these */
1695#define SSL_ST_READ_HEADER 0xF0
1696#define SSL_ST_READ_BODY 0xF1
1697#define SSL_ST_READ_DONE 0xF2
1698
1699/* Obtain latest Finished message
1700 * -- that we sent (SSL_get_finished)
1701 * -- that we expected from peer (SSL_get_peer_finished).
1702 * Returns length (0 == no Finished so far), copies up to 'count' bytes. */
1703size_t SSL_get_finished(const SSL *s, void *buf, size_t count);
1704size_t SSL_get_peer_finished(const SSL *s, void *buf, size_t count);
1705
Adam Langley509e5ed2014-06-20 12:00:00 -07001706/* use either SSL_VERIFY_NONE or SSL_VERIFY_PEER, the last 3 options
Adam Langley95c29f32014-06-20 12:00:00 -07001707 * are 'ored' with SSL_VERIFY_PEER if they are desired */
1708#define SSL_VERIFY_NONE 0x00
1709#define SSL_VERIFY_PEER 0x01
1710#define SSL_VERIFY_FAIL_IF_NO_PEER_CERT 0x02
1711#define SSL_VERIFY_CLIENT_ONCE 0x04
Adam Langley509e5ed2014-06-20 12:00:00 -07001712#define SSL_VERIFY_PEER_IF_NO_OBC 0x08
Adam Langley95c29f32014-06-20 12:00:00 -07001713
1714#define OpenSSL_add_ssl_algorithms() SSL_library_init()
1715#define SSLeay_add_ssl_algorithms() SSL_library_init()
1716
1717/* this is for backward compatibility */
1718#if 0 /* NEW_SSLEAY */
1719#define SSL_CTX_set_default_verify(a,b,c) SSL_CTX_set_verify(a,b,c)
1720#define SSL_set_pref_cipher(c,n) SSL_set_cipher_list(c,n)
1721#define SSL_add_session(a,b) SSL_CTX_add_session((a),(b))
1722#define SSL_remove_session(a,b) SSL_CTX_remove_session((a),(b))
1723#define SSL_flush_sessions(a,b) SSL_CTX_flush_sessions((a),(b))
1724#endif
1725/* More backward compatibility */
1726#define SSL_get_cipher(s) \
1727 SSL_CIPHER_get_name(SSL_get_current_cipher(s))
1728#define SSL_get_cipher_bits(s,np) \
1729 SSL_CIPHER_get_bits(SSL_get_current_cipher(s),np)
1730#define SSL_get_cipher_version(s) \
1731 SSL_CIPHER_get_version(SSL_get_current_cipher(s))
1732#define SSL_get_cipher_name(s) \
1733 SSL_CIPHER_get_name(SSL_get_current_cipher(s))
1734#define SSL_get_time(a) SSL_SESSION_get_time(a)
1735#define SSL_set_time(a,b) SSL_SESSION_set_time((a),(b))
1736#define SSL_get_timeout(a) SSL_SESSION_get_timeout(a)
1737#define SSL_set_timeout(a,b) SSL_SESSION_set_timeout((a),(b))
1738
1739#define d2i_SSL_SESSION_bio(bp,s_id) ASN1_d2i_bio_of(SSL_SESSION,SSL_SESSION_new,d2i_SSL_SESSION,bp,s_id)
1740#define i2d_SSL_SESSION_bio(bp,s_id) ASN1_i2d_bio_of(SSL_SESSION,i2d_SSL_SESSION,bp,s_id)
1741
1742DECLARE_PEM_rw(SSL_SESSION, SSL_SESSION)
1743
1744#define SSL_AD_REASON_OFFSET 1000 /* offset to get SSL_R_... value from SSL_AD_... */
1745
1746/* These alert types are for SSLv3 and TLSv1 */
1747#define SSL_AD_CLOSE_NOTIFY SSL3_AD_CLOSE_NOTIFY
1748#define SSL_AD_UNEXPECTED_MESSAGE SSL3_AD_UNEXPECTED_MESSAGE /* fatal */
1749#define SSL_AD_BAD_RECORD_MAC SSL3_AD_BAD_RECORD_MAC /* fatal */
1750#define SSL_AD_DECRYPTION_FAILED TLS1_AD_DECRYPTION_FAILED
1751#define SSL_AD_RECORD_OVERFLOW TLS1_AD_RECORD_OVERFLOW
1752#define SSL_AD_DECOMPRESSION_FAILURE SSL3_AD_DECOMPRESSION_FAILURE/* fatal */
1753#define SSL_AD_HANDSHAKE_FAILURE SSL3_AD_HANDSHAKE_FAILURE/* fatal */
1754#define SSL_AD_NO_CERTIFICATE SSL3_AD_NO_CERTIFICATE /* Not for TLS */
1755#define SSL_AD_BAD_CERTIFICATE SSL3_AD_BAD_CERTIFICATE
1756#define SSL_AD_UNSUPPORTED_CERTIFICATE SSL3_AD_UNSUPPORTED_CERTIFICATE
1757#define SSL_AD_CERTIFICATE_REVOKED SSL3_AD_CERTIFICATE_REVOKED
1758#define SSL_AD_CERTIFICATE_EXPIRED SSL3_AD_CERTIFICATE_EXPIRED
1759#define SSL_AD_CERTIFICATE_UNKNOWN SSL3_AD_CERTIFICATE_UNKNOWN
1760#define SSL_AD_ILLEGAL_PARAMETER SSL3_AD_ILLEGAL_PARAMETER /* fatal */
1761#define SSL_AD_UNKNOWN_CA TLS1_AD_UNKNOWN_CA /* fatal */
1762#define SSL_AD_ACCESS_DENIED TLS1_AD_ACCESS_DENIED /* fatal */
1763#define SSL_AD_DECODE_ERROR TLS1_AD_DECODE_ERROR /* fatal */
1764#define SSL_AD_DECRYPT_ERROR TLS1_AD_DECRYPT_ERROR
1765#define SSL_AD_EXPORT_RESTRICTION TLS1_AD_EXPORT_RESTRICTION/* fatal */
1766#define SSL_AD_PROTOCOL_VERSION TLS1_AD_PROTOCOL_VERSION /* fatal */
1767#define SSL_AD_INSUFFICIENT_SECURITY TLS1_AD_INSUFFICIENT_SECURITY/* fatal */
1768#define SSL_AD_INTERNAL_ERROR TLS1_AD_INTERNAL_ERROR /* fatal */
1769#define SSL_AD_USER_CANCELLED TLS1_AD_USER_CANCELLED
1770#define SSL_AD_NO_RENEGOTIATION TLS1_AD_NO_RENEGOTIATION
1771#define SSL_AD_UNSUPPORTED_EXTENSION TLS1_AD_UNSUPPORTED_EXTENSION
1772#define SSL_AD_CERTIFICATE_UNOBTAINABLE TLS1_AD_CERTIFICATE_UNOBTAINABLE
1773#define SSL_AD_UNRECOGNIZED_NAME TLS1_AD_UNRECOGNIZED_NAME
1774#define SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE TLS1_AD_BAD_CERTIFICATE_STATUS_RESPONSE
1775#define SSL_AD_BAD_CERTIFICATE_HASH_VALUE TLS1_AD_BAD_CERTIFICATE_HASH_VALUE
1776#define SSL_AD_UNKNOWN_PSK_IDENTITY TLS1_AD_UNKNOWN_PSK_IDENTITY /* fatal */
1777
1778#define SSL_ERROR_NONE 0
1779#define SSL_ERROR_SSL 1
1780#define SSL_ERROR_WANT_READ 2
1781#define SSL_ERROR_WANT_WRITE 3
1782#define SSL_ERROR_WANT_X509_LOOKUP 4
1783#define SSL_ERROR_SYSCALL 5 /* look at error stack/return value/errno */
1784#define SSL_ERROR_ZERO_RETURN 6
1785#define SSL_ERROR_WANT_CONNECT 7
1786#define SSL_ERROR_WANT_ACCEPT 8
Adam Langley1258b6a2014-06-20 12:00:00 -07001787#define SSL_ERROR_WANT_CHANNEL_ID_LOOKUP 9
Adam Langleyb2ce0582014-06-20 12:00:00 -07001788#define SSL_ERROR_PENDING_SESSION 11
Adam Langley95c29f32014-06-20 12:00:00 -07001789
1790#define SSL_CTRL_NEED_TMP_RSA 1
1791#define SSL_CTRL_SET_TMP_RSA 2
1792#define SSL_CTRL_SET_TMP_DH 3
1793#define SSL_CTRL_SET_TMP_ECDH 4
1794#define SSL_CTRL_SET_TMP_RSA_CB 5
1795#define SSL_CTRL_SET_TMP_DH_CB 6
1796#define SSL_CTRL_SET_TMP_ECDH_CB 7
1797
1798#define SSL_CTRL_GET_SESSION_REUSED 8
1799#define SSL_CTRL_GET_CLIENT_CERT_REQUEST 9
1800#define SSL_CTRL_GET_NUM_RENEGOTIATIONS 10
1801#define SSL_CTRL_CLEAR_NUM_RENEGOTIATIONS 11
1802#define SSL_CTRL_GET_TOTAL_RENEGOTIATIONS 12
1803#define SSL_CTRL_GET_FLAGS 13
1804#define SSL_CTRL_EXTRA_CHAIN_CERT 14
1805
1806#define SSL_CTRL_SET_MSG_CALLBACK 15
1807#define SSL_CTRL_SET_MSG_CALLBACK_ARG 16
1808
1809/* only applies to datagram connections */
1810#define SSL_CTRL_SET_MTU 17
1811/* Stats */
1812#define SSL_CTRL_SESS_NUMBER 20
1813#define SSL_CTRL_SESS_CONNECT 21
1814#define SSL_CTRL_SESS_CONNECT_GOOD 22
1815#define SSL_CTRL_SESS_CONNECT_RENEGOTIATE 23
1816#define SSL_CTRL_SESS_ACCEPT 24
1817#define SSL_CTRL_SESS_ACCEPT_GOOD 25
1818#define SSL_CTRL_SESS_ACCEPT_RENEGOTIATE 26
1819#define SSL_CTRL_SESS_HIT 27
1820#define SSL_CTRL_SESS_CB_HIT 28
1821#define SSL_CTRL_SESS_MISSES 29
1822#define SSL_CTRL_SESS_TIMEOUTS 30
1823#define SSL_CTRL_SESS_CACHE_FULL 31
1824#define SSL_CTRL_OPTIONS 32
1825#define SSL_CTRL_MODE 33
1826
1827#define SSL_CTRL_GET_READ_AHEAD 40
1828#define SSL_CTRL_SET_READ_AHEAD 41
1829#define SSL_CTRL_SET_SESS_CACHE_SIZE 42
1830#define SSL_CTRL_GET_SESS_CACHE_SIZE 43
1831#define SSL_CTRL_SET_SESS_CACHE_MODE 44
1832#define SSL_CTRL_GET_SESS_CACHE_MODE 45
1833
1834#define SSL_CTRL_GET_MAX_CERT_LIST 50
1835#define SSL_CTRL_SET_MAX_CERT_LIST 51
1836
1837#define SSL_CTRL_SET_MAX_SEND_FRAGMENT 52
1838
1839/* see tls1.h for macros based on these */
1840#ifndef OPENSSL_NO_TLSEXT
1841#define SSL_CTRL_SET_TLSEXT_SERVERNAME_CB 53
1842#define SSL_CTRL_SET_TLSEXT_SERVERNAME_ARG 54
1843#define SSL_CTRL_SET_TLSEXT_HOSTNAME 55
1844#define SSL_CTRL_SET_TLSEXT_DEBUG_CB 56
1845#define SSL_CTRL_SET_TLSEXT_DEBUG_ARG 57
1846#define SSL_CTRL_GET_TLSEXT_TICKET_KEYS 58
1847#define SSL_CTRL_SET_TLSEXT_TICKET_KEYS 59
1848#define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT 60
1849#define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT_CB 61
1850#define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT_CB_ARG 62
1851#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB 63
1852#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB_ARG 64
1853#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_TYPE 65
1854#define SSL_CTRL_GET_TLSEXT_STATUS_REQ_EXTS 66
1855#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_EXTS 67
1856#define SSL_CTRL_GET_TLSEXT_STATUS_REQ_IDS 68
1857#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_IDS 69
1858#define SSL_CTRL_GET_TLSEXT_STATUS_REQ_OCSP_RESP 70
1859#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_OCSP_RESP 71
1860
1861#define SSL_CTRL_SET_TLSEXT_TICKET_KEY_CB 72
1862
1863#define SSL_CTRL_SET_TLS_EXT_SRP_USERNAME_CB 75
1864#define SSL_CTRL_SET_SRP_VERIFY_PARAM_CB 76
1865#define SSL_CTRL_SET_SRP_GIVE_CLIENT_PWD_CB 77
1866
1867#define SSL_CTRL_SET_SRP_ARG 78
1868#define SSL_CTRL_SET_TLS_EXT_SRP_USERNAME 79
1869#define SSL_CTRL_SET_TLS_EXT_SRP_STRENGTH 80
1870#define SSL_CTRL_SET_TLS_EXT_SRP_PASSWORD 81
1871#ifndef OPENSSL_NO_HEARTBEATS
1872#define SSL_CTRL_TLS_EXT_SEND_HEARTBEAT 85
1873#define SSL_CTRL_GET_TLS_EXT_HEARTBEAT_PENDING 86
1874#define SSL_CTRL_SET_TLS_EXT_HEARTBEAT_NO_REQUESTS 87
1875#endif
1876/* Callback for verifying audit proofs (client only) */
1877#define SSL_CTRL_SET_TLSEXT_AUTHZ_SERVER_AUDIT_PROOF_CB 95
1878#define SSL_CTRL_SET_TLSEXT_AUTHZ_SERVER_AUDIT_PROOF_CB_ARG 96
1879#endif /* OPENSSL_NO_TLSEXT */
1880
1881#define DTLS_CTRL_GET_TIMEOUT 73
1882#define DTLS_CTRL_HANDLE_TIMEOUT 74
1883#define DTLS_CTRL_LISTEN 75
1884
1885#define SSL_CTRL_GET_RI_SUPPORT 76
1886#define SSL_CTRL_CLEAR_OPTIONS 77
1887#define SSL_CTRL_CLEAR_MODE 78
1888
1889#define SSL_CTRL_GET_EXTRA_CHAIN_CERTS 82
1890#define SSL_CTRL_CLEAR_EXTRA_CHAIN_CERTS 83
1891
1892#define SSL_CTRL_CHAIN 88
1893#define SSL_CTRL_CHAIN_CERT 89
1894
1895#define SSL_CTRL_GET_CURVES 90
1896#define SSL_CTRL_SET_CURVES 91
1897#define SSL_CTRL_SET_CURVES_LIST 92
1898#define SSL_CTRL_GET_SHARED_CURVE 93
1899#define SSL_CTRL_SET_ECDH_AUTO 94
1900#define SSL_CTRL_SET_SIGALGS 97
1901#define SSL_CTRL_SET_SIGALGS_LIST 98
1902#define SSL_CTRL_CERT_FLAGS 99
1903#define SSL_CTRL_CLEAR_CERT_FLAGS 100
1904#define SSL_CTRL_SET_CLIENT_SIGALGS 101
1905#define SSL_CTRL_SET_CLIENT_SIGALGS_LIST 102
1906#define SSL_CTRL_GET_CLIENT_CERT_TYPES 103
1907#define SSL_CTRL_SET_CLIENT_CERT_TYPES 104
1908#define SSL_CTRL_BUILD_CERT_CHAIN 105
1909#define SSL_CTRL_SET_VERIFY_CERT_STORE 106
1910#define SSL_CTRL_SET_CHAIN_CERT_STORE 107
1911#define SSL_CTRL_GET_PEER_SIGNATURE_NID 108
1912#define SSL_CTRL_GET_SERVER_TMP_KEY 109
1913#define SSL_CTRL_GET_RAW_CIPHERLIST 110
1914#define SSL_CTRL_GET_EC_POINT_FORMATS 111
1915#define SSL_CTRL_GET_TLSA_RECORD 112
1916#define SSL_CTRL_SET_TLSA_RECORD 113
1917#define SSL_CTRL_PULL_TLSA_RECORD 114
1918
1919#define SSL_CTRL_GET_CHAIN_CERTS 115
1920#define SSL_CTRL_SELECT_CURRENT_CERT 116
1921
Adam Langley1258b6a2014-06-20 12:00:00 -07001922#define SSL_CTRL_CHANNEL_ID 117
1923#define SSL_CTRL_GET_CHANNEL_ID 118
1924#define SSL_CTRL_SET_CHANNEL_ID 119
1925
Adam Langley95c29f32014-06-20 12:00:00 -07001926#define DTLSv1_get_timeout(ssl, arg) \
1927 SSL_ctrl(ssl,DTLS_CTRL_GET_TIMEOUT,0, (void *)arg)
1928#define DTLSv1_handle_timeout(ssl) \
1929 SSL_ctrl(ssl,DTLS_CTRL_HANDLE_TIMEOUT,0, NULL)
1930#define DTLSv1_listen(ssl, peer) \
1931 SSL_ctrl(ssl,DTLS_CTRL_LISTEN,0, (void *)peer)
1932
1933#define SSL_session_reused(ssl) \
1934 SSL_ctrl((ssl),SSL_CTRL_GET_SESSION_REUSED,0,NULL)
1935#define SSL_num_renegotiations(ssl) \
1936 SSL_ctrl((ssl),SSL_CTRL_GET_NUM_RENEGOTIATIONS,0,NULL)
1937#define SSL_clear_num_renegotiations(ssl) \
1938 SSL_ctrl((ssl),SSL_CTRL_CLEAR_NUM_RENEGOTIATIONS,0,NULL)
1939#define SSL_total_renegotiations(ssl) \
1940 SSL_ctrl((ssl),SSL_CTRL_GET_TOTAL_RENEGOTIATIONS,0,NULL)
1941
1942#define SSL_CTX_need_tmp_RSA(ctx) \
1943 SSL_CTX_ctrl(ctx,SSL_CTRL_NEED_TMP_RSA,0,NULL)
1944#define SSL_CTX_set_tmp_rsa(ctx,rsa) \
1945 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_RSA,0,(char *)rsa)
1946#define SSL_CTX_set_tmp_dh(ctx,dh) \
1947 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_DH,0,(char *)dh)
1948#define SSL_CTX_set_tmp_ecdh(ctx,ecdh) \
1949 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_ECDH,0,(char *)ecdh)
1950
1951#define SSL_need_tmp_RSA(ssl) \
1952 SSL_ctrl(ssl,SSL_CTRL_NEED_TMP_RSA,0,NULL)
1953#define SSL_set_tmp_rsa(ssl,rsa) \
1954 SSL_ctrl(ssl,SSL_CTRL_SET_TMP_RSA,0,(char *)rsa)
1955#define SSL_set_tmp_dh(ssl,dh) \
1956 SSL_ctrl(ssl,SSL_CTRL_SET_TMP_DH,0,(char *)dh)
1957#define SSL_set_tmp_ecdh(ssl,ecdh) \
1958 SSL_ctrl(ssl,SSL_CTRL_SET_TMP_ECDH,0,(char *)ecdh)
1959
Adam Langley1258b6a2014-06-20 12:00:00 -07001960/* SSL_enable_tls_channel_id either configures a TLS server to accept TLS client
1961 * IDs from clients, or configure a client to send TLS client IDs to server.
1962 * Returns 1 on success. */
1963#define SSL_enable_tls_channel_id(s) \
1964 SSL_ctrl(s,SSL_CTRL_CHANNEL_ID,0,NULL)
1965/* SSL_set1_tls_channel_id configures a TLS client to send a TLS Channel ID to
1966 * compatible servers. private_key must be a P-256 EVP_PKEY*. Returns 1 on
1967 * success. */
1968#define SSL_set1_tls_channel_id(s, private_key) \
1969 SSL_ctrl(s,SSL_CTRL_SET_CHANNEL_ID,0,(void*)private_key)
1970#define SSL_CTX_set1_tls_channel_id(ctx, private_key) \
1971 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CHANNEL_ID,0,(void*)private_key)
1972/* SSL_get_tls_channel_id gets the client's TLS Channel ID from a server SSL*
1973 * and copies up to the first |channel_id_len| bytes into |channel_id|. The
1974 * Channel ID consists of the client's P-256 public key as an (x,y) pair where
1975 * each is a 32-byte, big-endian field element. Returns 0 if the client didn't
1976 * offer a Channel ID and the length of the complete Channel ID otherwise. */
1977#define SSL_get_tls_channel_id(ctx, channel_id, channel_id_len) \
1978 SSL_ctrl(ctx,SSL_CTRL_GET_CHANNEL_ID,channel_id_len,(void*)channel_id)
1979
Adam Langley95c29f32014-06-20 12:00:00 -07001980#define SSL_CTX_add_extra_chain_cert(ctx,x509) \
1981 SSL_CTX_ctrl(ctx,SSL_CTRL_EXTRA_CHAIN_CERT,0,(char *)x509)
1982#define SSL_CTX_get_extra_chain_certs(ctx,px509) \
1983 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_EXTRA_CHAIN_CERTS,0,px509)
1984#define SSL_CTX_clear_extra_chain_certs(ctx) \
1985 SSL_CTX_ctrl(ctx,SSL_CTRL_CLEAR_EXTRA_CHAIN_CERTS,0,NULL)
1986
1987#define SSL_CTX_set0_chain(ctx,sk) \
1988 SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN,0,(char *)sk)
1989#define SSL_CTX_set1_chain(ctx,sk) \
1990 SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN,1,(char *)sk)
1991#define SSL_CTX_add0_chain_cert(ctx,x509) \
1992 SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN_CERT,0,(char *)x509)
1993#define SSL_CTX_add1_chain_cert(ctx,x509) \
1994 SSL_CTX_ctrl(ctx,SSL_CTRL_CHAIN_CERT,1,(char *)x509)
1995#define SSL_CTX_get0_chain_certs(ctx,px509) \
1996 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_CHAIN_CERTS,0,px509)
1997#define SSL_CTX_clear_chain_certs(ctx) \
1998 SSL_CTX_set0_chain(ctx,NULL)
1999#define SSL_CTX_build_cert_chain(ctx, flags) \
2000 SSL_CTX_ctrl(ctx,SSL_CTRL_BUILD_CERT_CHAIN, flags, NULL)
2001#define SSL_CTX_select_current_cert(ctx,x509) \
2002 SSL_CTX_ctrl(ctx,SSL_CTRL_SELECT_CURRENT_CERT,0,(char *)x509)
2003
2004#define SSL_CTX_set0_verify_cert_store(ctx,st) \
2005 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_VERIFY_CERT_STORE,0,(char *)st)
2006#define SSL_CTX_set1_verify_cert_store(ctx,st) \
2007 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_VERIFY_CERT_STORE,1,(char *)st)
2008#define SSL_CTX_set0_chain_cert_store(ctx,st) \
2009 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CHAIN_CERT_STORE,0,(char *)st)
2010#define SSL_CTX_set1_chain_cert_store(ctx,st) \
2011 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CHAIN_CERT_STORE,1,(char *)st)
2012
2013#define SSL_set0_chain(ctx,sk) \
2014 SSL_ctrl(ctx,SSL_CTRL_CHAIN,0,(char *)sk)
2015#define SSL_set1_chain(ctx,sk) \
2016 SSL_ctrl(ctx,SSL_CTRL_CHAIN,1,(char *)sk)
2017#define SSL_add0_chain_cert(ctx,x509) \
2018 SSL_ctrl(ctx,SSL_CTRL_CHAIN_CERT,0,(char *)x509)
2019#define SSL_add1_chain_cert(ctx,x509) \
2020 SSL_ctrl(ctx,SSL_CTRL_CHAIN_CERT,1,(char *)x509)
2021#define SSL_get0_chain_certs(ctx,px509) \
2022 SSL_ctrl(ctx,SSL_CTRL_GET_CHAIN_CERTS,0,px509)
2023#define SSL_clear_chain_certs(ctx) \
2024 SSL_set0_chain(ctx,NULL)
2025#define SSL_build_cert_chain(s, flags) \
2026 SSL_ctrl(s,SSL_CTRL_BUILD_CERT_CHAIN, flags, NULL)
2027#define SSL_select_current_cert(ctx,x509) \
2028 SSL_ctrl(ctx,SSL_CTRL_SELECT_CURRENT_CERT,0,(char *)x509)
2029
2030#define SSL_set0_verify_cert_store(s,st) \
2031 SSL_ctrl(s,SSL_CTRL_SET_VERIFY_CERT_STORE,0,(char *)st)
2032#define SSL_set1_verify_cert_store(s,st) \
2033 SSL_ctrl(s,SSL_CTRL_SET_VERIFY_CERT_STORE,1,(char *)st)
2034#define SSL_set0_chain_cert_store(s,st) \
2035 SSL_ctrl(s,SSL_CTRL_SET_CHAIN_CERT_STORE,0,(char *)st)
2036#define SSL_set1_chain_cert_store(s,st) \
2037 SSL_ctrl(s,SSL_CTRL_SET_CHAIN_CERT_STORE,1,(char *)st)
2038
2039#define SSL_get1_curves(ctx, s) \
2040 SSL_ctrl(ctx,SSL_CTRL_GET_CURVES,0,(char *)s)
2041#define SSL_CTX_set1_curves(ctx, clist, clistlen) \
2042 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CURVES,clistlen,(char *)clist)
2043#define SSL_CTX_set1_curves_list(ctx, s) \
2044 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CURVES_LIST,0,(char *)s)
2045#define SSL_set1_curves(ctx, clist, clistlen) \
2046 SSL_ctrl(ctx,SSL_CTRL_SET_CURVES,clistlen,(char *)clist)
2047#define SSL_set1_curves_list(ctx, s) \
2048 SSL_ctrl(ctx,SSL_CTRL_SET_CURVES_LIST,0,(char *)s)
2049#define SSL_get_shared_curve(s, n) \
2050 SSL_ctrl(s,SSL_CTRL_GET_SHARED_CURVE,n,NULL)
2051#define SSL_CTX_set_ecdh_auto(ctx, onoff) \
2052 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_ECDH_AUTO,onoff,NULL)
2053#define SSL_set_ecdh_auto(s, onoff) \
2054 SSL_ctrl(s,SSL_CTRL_SET_ECDH_AUTO,onoff,NULL)
2055
2056#define SSL_CTX_set1_sigalgs(ctx, slist, slistlen) \
2057 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SIGALGS,slistlen,(int *)slist)
2058#define SSL_CTX_set1_sigalgs_list(ctx, s) \
2059 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SIGALGS_LIST,0,(char *)s)
2060#define SSL_set1_sigalgs(ctx, slist, slistlen) \
2061 SSL_ctrl(ctx,SSL_CTRL_SET_SIGALGS,clistlen,(int *)slist)
2062#define SSL_set1_sigalgs_list(ctx, s) \
2063 SSL_ctrl(ctx,SSL_CTRL_SET_SIGALGS_LIST,0,(char *)s)
2064
2065#define SSL_CTX_set1_client_sigalgs(ctx, slist, slistlen) \
2066 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS,slistlen,(int *)slist)
2067#define SSL_CTX_set1_client_sigalgs_list(ctx, s) \
2068 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS_LIST,0,(char *)s)
2069#define SSL_set1_client_sigalgs(ctx, slist, slistlen) \
2070 SSL_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS,clistlen,(int *)slist)
2071#define SSL_set1_client_sigalgs_list(ctx, s) \
2072 SSL_ctrl(ctx,SSL_CTRL_SET_CLIENT_SIGALGS_LIST,0,(char *)s)
2073
2074#define SSL_get0_certificate_types(s, clist) \
2075 SSL_ctrl(s, SSL_CTRL_GET_CLIENT_CERT_TYPES, 0, (char *)clist)
2076
2077#define SSL_CTX_set1_client_certificate_types(ctx, clist, clistlen) \
2078 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_CLIENT_CERT_TYPES,clistlen,(char *)clist)
2079#define SSL_set1_client_certificate_types(s, clist, clistlen) \
2080 SSL_ctrl(s,SSL_CTRL_SET_CLIENT_CERT_TYPES,clistlen,(char *)clist)
2081
2082#define SSL_get_peer_signature_nid(s, pn) \
2083 SSL_ctrl(s,SSL_CTRL_GET_PEER_SIGNATURE_NID,0,pn)
2084
2085#define SSL_get_server_tmp_key(s, pk) \
2086 SSL_ctrl(s,SSL_CTRL_GET_SERVER_TMP_KEY,0,pk)
2087
2088#define SSL_get0_raw_cipherlist(s, plst) \
2089 SSL_ctrl(s,SSL_CTRL_GET_RAW_CIPHERLIST,0,(char *)plst)
2090
2091#define SSL_get0_ec_point_formats(s, plst) \
2092 SSL_ctrl(s,SSL_CTRL_GET_EC_POINT_FORMATS,0,(char *)plst)
2093
2094#define SSL_set_tlsa_record(s,tlsa) \
2095 SSL_ctrl(s,SSL_CTRL_SET_TLSA_RECORD,0,(void *)tlsa)
2096#define SSL_pull_tlsa_record(s,host,port) \
2097 SSL_ctrl(s,SSL_CTRL_PULL_TLSA_RECORD,port,host)
2098
2099#ifndef OPENSSL_NO_BIO
2100BIO_METHOD *BIO_f_ssl(void);
2101BIO *BIO_new_ssl(SSL_CTX *ctx,int client);
2102BIO *BIO_new_ssl_connect(SSL_CTX *ctx);
2103BIO *BIO_new_buffer_ssl_connect(SSL_CTX *ctx);
2104int BIO_ssl_copy_session_id(BIO *to,BIO *from);
2105void BIO_ssl_shutdown(BIO *ssl_bio);
2106
2107#endif
2108
2109int SSL_CTX_set_cipher_list(SSL_CTX *,const char *str);
Adam Langley0b5c1ac2014-06-20 12:00:00 -07002110int SSL_CTX_set_cipher_list_tls11(SSL_CTX *,const char *str);
Adam Langley95c29f32014-06-20 12:00:00 -07002111SSL_CTX *SSL_CTX_new(const SSL_METHOD *meth);
2112void SSL_CTX_free(SSL_CTX *);
2113long SSL_CTX_set_timeout(SSL_CTX *ctx,long t);
2114long SSL_CTX_get_timeout(const SSL_CTX *ctx);
2115X509_STORE *SSL_CTX_get_cert_store(const SSL_CTX *);
2116void SSL_CTX_set_cert_store(SSL_CTX *,X509_STORE *);
2117int SSL_want(const SSL *s);
2118int SSL_clear(SSL *s);
2119
2120void SSL_CTX_flush_sessions(SSL_CTX *ctx,long tm);
2121
2122const SSL_CIPHER *SSL_get_current_cipher(const SSL *s);
2123int SSL_CIPHER_get_bits(const SSL_CIPHER *c,int *alg_bits);
2124char * SSL_CIPHER_get_version(const SSL_CIPHER *c);
2125const char * SSL_CIPHER_get_name(const SSL_CIPHER *c);
2126unsigned long SSL_CIPHER_get_id(const SSL_CIPHER *c);
2127
2128int SSL_get_fd(const SSL *s);
2129int SSL_get_rfd(const SSL *s);
2130int SSL_get_wfd(const SSL *s);
2131const char * SSL_get_cipher_list(const SSL *s,int n);
2132char * SSL_get_shared_ciphers(const SSL *s, char *buf, int len);
2133int SSL_get_read_ahead(const SSL * s);
2134int SSL_pending(const SSL *s);
2135#ifndef OPENSSL_NO_SOCK
2136int SSL_set_fd(SSL *s, int fd);
2137int SSL_set_rfd(SSL *s, int fd);
2138int SSL_set_wfd(SSL *s, int fd);
2139#endif
2140#ifndef OPENSSL_NO_BIO
2141void SSL_set_bio(SSL *s, BIO *rbio,BIO *wbio);
2142BIO * SSL_get_rbio(const SSL *s);
2143BIO * SSL_get_wbio(const SSL *s);
2144#endif
2145int SSL_set_cipher_list(SSL *s, const char *str);
2146void SSL_set_read_ahead(SSL *s, int yes);
2147int SSL_get_verify_mode(const SSL *s);
2148int SSL_get_verify_depth(const SSL *s);
2149int (*SSL_get_verify_callback(const SSL *s))(int,X509_STORE_CTX *);
2150void SSL_set_verify(SSL *s, int mode,
2151 int (*callback)(int ok,X509_STORE_CTX *ctx));
2152void SSL_set_verify_depth(SSL *s, int depth);
2153void SSL_set_cert_cb(SSL *s, int (*cb)(SSL *ssl, void *arg), void *arg);
2154#ifndef OPENSSL_NO_RSA
2155int SSL_use_RSAPrivateKey(SSL *ssl, RSA *rsa);
2156#endif
2157int SSL_use_RSAPrivateKey_ASN1(SSL *ssl, unsigned char *d, long len);
2158int SSL_use_PrivateKey(SSL *ssl, EVP_PKEY *pkey);
2159int SSL_use_PrivateKey_ASN1(int pk,SSL *ssl, const unsigned char *d, long len);
2160int SSL_use_certificate(SSL *ssl, X509 *x);
2161int SSL_use_certificate_ASN1(SSL *ssl, const unsigned char *d, int len);
2162
2163#ifndef OPENSSL_NO_TLSEXT
2164/* Set authz data for the current active cert. */
2165int SSL_CTX_use_authz(SSL_CTX *ctx, unsigned char *authz, size_t authz_length);
2166int SSL_use_authz(SSL *ssl, unsigned char *authz, size_t authz_length);
2167/* Get the authz of type 'type' associated with the current active cert. */
2168const unsigned char *SSL_CTX_get_authz_data(SSL_CTX *ctx, unsigned char type,
2169 size_t *data_length);
2170#ifndef OPENSSL_NO_STDIO
2171int SSL_CTX_use_authz_file(SSL_CTX *ctx, const char *file);
2172int SSL_use_authz_file(SSL *ssl, const char *file);
2173#endif
2174
2175/* Set serverinfo data for the current active cert. */
2176int SSL_CTX_use_serverinfo(SSL_CTX *ctx, const unsigned char *serverinfo,
2177 size_t serverinfo_length);
2178#ifndef OPENSSL_NO_STDIO
2179int SSL_CTX_use_serverinfo_file(SSL_CTX *ctx, const char *file);
2180#endif /* NO_STDIO */
2181
2182#endif
2183
2184#ifndef OPENSSL_NO_STDIO
2185int SSL_use_RSAPrivateKey_file(SSL *ssl, const char *file, int type);
2186int SSL_use_PrivateKey_file(SSL *ssl, const char *file, int type);
2187int SSL_use_certificate_file(SSL *ssl, const char *file, int type);
2188int SSL_CTX_use_RSAPrivateKey_file(SSL_CTX *ctx, const char *file, int type);
2189int SSL_CTX_use_PrivateKey_file(SSL_CTX *ctx, const char *file, int type);
2190int SSL_CTX_use_certificate_file(SSL_CTX *ctx, const char *file, int type);
2191int SSL_CTX_use_certificate_chain_file(SSL_CTX *ctx, const char *file); /* PEM type */
2192STACK_OF(X509_NAME) *SSL_load_client_CA_file(const char *file);
2193int SSL_add_file_cert_subjects_to_stack(STACK_OF(X509_NAME) *stackCAs,
2194 const char *file);
2195#ifndef OPENSSL_SYS_VMS
2196#ifndef OPENSSL_SYS_MACINTOSH_CLASSIC /* XXXXX: Better scheme needed! [was: #ifndef MAC_OS_pre_X] */
2197int SSL_add_dir_cert_subjects_to_stack(STACK_OF(X509_NAME) *stackCAs,
2198 const char *dir);
2199#endif
2200#endif
2201
2202#endif
2203
2204void SSL_load_error_strings(void );
2205const char *SSL_state_string(const SSL *s);
2206const char *SSL_rstate_string(const SSL *s);
2207const char *SSL_state_string_long(const SSL *s);
2208const char *SSL_rstate_string_long(const SSL *s);
2209long SSL_SESSION_get_time(const SSL_SESSION *s);
2210long SSL_SESSION_set_time(SSL_SESSION *s, long t);
2211long SSL_SESSION_get_timeout(const SSL_SESSION *s);
2212long SSL_SESSION_set_timeout(SSL_SESSION *s, long t);
2213void SSL_copy_session_id(SSL *to,const SSL *from);
2214X509 *SSL_SESSION_get0_peer(SSL_SESSION *s);
2215int SSL_SESSION_set1_id_context(SSL_SESSION *s,const unsigned char *sid_ctx,
2216 unsigned int sid_ctx_len);
2217
2218SSL_SESSION *SSL_SESSION_new(void);
2219const unsigned char *SSL_SESSION_get_id(const SSL_SESSION *s,
2220 unsigned int *len);
2221unsigned int SSL_SESSION_get_compress_id(const SSL_SESSION *s);
2222#ifndef OPENSSL_NO_FP_API
2223int SSL_SESSION_print_fp(FILE *fp,const SSL_SESSION *ses);
2224#endif
2225#ifndef OPENSSL_NO_BIO
2226int SSL_SESSION_print(BIO *fp,const SSL_SESSION *ses);
2227#endif
2228#ifndef OPENSSL_NO_TLSEXT
2229unsigned char *SSL_SESSION_get_tlsext_authz_server_audit_proof(SSL_SESSION *s,
2230 size_t *proof_length);
2231#endif
2232void SSL_SESSION_free(SSL_SESSION *ses);
2233int i2d_SSL_SESSION(SSL_SESSION *in,unsigned char **pp);
2234int SSL_set_session(SSL *to, SSL_SESSION *session);
2235int SSL_CTX_add_session(SSL_CTX *s, SSL_SESSION *c);
2236int SSL_CTX_remove_session(SSL_CTX *,SSL_SESSION *c);
2237int SSL_CTX_set_generate_session_id(SSL_CTX *, GEN_SESSION_CB);
2238int SSL_set_generate_session_id(SSL *, GEN_SESSION_CB);
2239int SSL_has_matching_session_id(const SSL *ssl, const unsigned char *id,
2240 unsigned int id_len);
2241SSL_SESSION *d2i_SSL_SESSION(SSL_SESSION **a,const unsigned char **pp,
2242 long length);
2243
2244#ifdef HEADER_X509_H
2245X509 * SSL_get_peer_certificate(const SSL *s);
2246#endif
2247
2248STACK_OF(X509) *SSL_get_peer_cert_chain(const SSL *s);
2249
2250int SSL_CTX_get_verify_mode(const SSL_CTX *ctx);
2251int SSL_CTX_get_verify_depth(const SSL_CTX *ctx);
2252int (*SSL_CTX_get_verify_callback(const SSL_CTX *ctx))(int,X509_STORE_CTX *);
2253void SSL_CTX_set_verify(SSL_CTX *ctx,int mode,
2254 int (*callback)(int, X509_STORE_CTX *));
2255void SSL_CTX_set_verify_depth(SSL_CTX *ctx,int depth);
2256void SSL_CTX_set_cert_verify_callback(SSL_CTX *ctx, int (*cb)(X509_STORE_CTX *,void *), void *arg);
2257void SSL_CTX_set_cert_cb(SSL_CTX *c, int (*cb)(SSL *ssl, void *arg), void *arg);
2258#ifndef OPENSSL_NO_RSA
2259int SSL_CTX_use_RSAPrivateKey(SSL_CTX *ctx, RSA *rsa);
2260#endif
2261int SSL_CTX_use_RSAPrivateKey_ASN1(SSL_CTX *ctx, const unsigned char *d, long len);
2262int SSL_CTX_use_PrivateKey(SSL_CTX *ctx, EVP_PKEY *pkey);
2263int SSL_CTX_use_PrivateKey_ASN1(int pk,SSL_CTX *ctx,
2264 const unsigned char *d, long len);
2265int SSL_CTX_use_certificate(SSL_CTX *ctx, X509 *x);
2266int SSL_CTX_use_certificate_ASN1(SSL_CTX *ctx, int len, const unsigned char *d);
2267
2268void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, pem_password_cb *cb);
2269void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx, void *u);
2270
2271int SSL_CTX_check_private_key(const SSL_CTX *ctx);
2272int SSL_check_private_key(const SSL *ctx);
2273
2274int SSL_CTX_set_session_id_context(SSL_CTX *ctx,const unsigned char *sid_ctx,
2275 unsigned int sid_ctx_len);
2276
2277SSL * SSL_new(SSL_CTX *ctx);
2278int SSL_set_session_id_context(SSL *ssl,const unsigned char *sid_ctx,
2279 unsigned int sid_ctx_len);
2280
2281int SSL_CTX_set_purpose(SSL_CTX *s, int purpose);
2282int SSL_set_purpose(SSL *s, int purpose);
2283int SSL_CTX_set_trust(SSL_CTX *s, int trust);
2284int SSL_set_trust(SSL *s, int trust);
2285
2286int SSL_CTX_set1_param(SSL_CTX *ctx, X509_VERIFY_PARAM *vpm);
2287int SSL_set1_param(SSL *ssl, X509_VERIFY_PARAM *vpm);
2288
2289X509_VERIFY_PARAM *SSL_CTX_get0_param(SSL_CTX *ctx);
2290X509_VERIFY_PARAM *SSL_get0_param(SSL *ssl);
2291
2292void SSL_certs_clear(SSL *s);
2293void SSL_free(SSL *ssl);
2294int SSL_accept(SSL *ssl);
2295int SSL_connect(SSL *ssl);
2296int SSL_read(SSL *ssl,void *buf,int num);
2297int SSL_peek(SSL *ssl,void *buf,int num);
2298int SSL_write(SSL *ssl,const void *buf,int num);
2299long SSL_ctrl(SSL *ssl,int cmd, long larg, void *parg);
2300long SSL_callback_ctrl(SSL *, int, void (*)(void));
2301long SSL_CTX_ctrl(SSL_CTX *ctx,int cmd, long larg, void *parg);
2302long SSL_CTX_callback_ctrl(SSL_CTX *, int, void (*)(void));
2303
2304int SSL_get_error(const SSL *s,int ret_code);
2305const char *SSL_get_version(const SSL *s);
2306
Adam Langley4d4bff82014-06-20 12:00:00 -07002307int SSL_CIPHER_is_AES(const SSL_CIPHER *c);
2308int SSL_CIPHER_has_MD5_HMAC(const SSL_CIPHER *c);
2309int SSL_CIPHER_is_AESGCM(const SSL_CIPHER *c);
Adam Langleyde0b2022014-06-20 12:00:00 -07002310int SSL_CIPHER_is_CHACHA20POLY1305(const SSL_CIPHER *c);
Adam Langley4d4bff82014-06-20 12:00:00 -07002311
Adam Langley95c29f32014-06-20 12:00:00 -07002312/* This sets the 'default' SSL version that SSL_new() will create */
2313int SSL_CTX_set_ssl_version(SSL_CTX *ctx, const SSL_METHOD *meth);
2314
2315const SSL_METHOD *SSLv3_method(void); /* SSLv3 */
2316const SSL_METHOD *SSLv3_server_method(void); /* SSLv3 */
2317const SSL_METHOD *SSLv3_client_method(void); /* SSLv3 */
2318
2319const SSL_METHOD *SSLv23_method(void); /* SSLv3 but can rollback to v2 */
2320const SSL_METHOD *SSLv23_server_method(void); /* SSLv3 but can rollback to v2 */
2321const SSL_METHOD *SSLv23_client_method(void); /* SSLv3 but can rollback to v2 */
2322
2323const SSL_METHOD *TLSv1_method(void); /* TLSv1.0 */
2324const SSL_METHOD *TLSv1_server_method(void); /* TLSv1.0 */
2325const SSL_METHOD *TLSv1_client_method(void); /* TLSv1.0 */
2326
2327const SSL_METHOD *TLSv1_1_method(void); /* TLSv1.1 */
2328const SSL_METHOD *TLSv1_1_server_method(void); /* TLSv1.1 */
2329const SSL_METHOD *TLSv1_1_client_method(void); /* TLSv1.1 */
2330
2331const SSL_METHOD *TLSv1_2_method(void); /* TLSv1.2 */
2332const SSL_METHOD *TLSv1_2_server_method(void); /* TLSv1.2 */
2333const SSL_METHOD *TLSv1_2_client_method(void); /* TLSv1.2 */
2334
2335
2336const SSL_METHOD *DTLSv1_method(void); /* DTLSv1.0 */
2337const SSL_METHOD *DTLSv1_server_method(void); /* DTLSv1.0 */
2338const SSL_METHOD *DTLSv1_client_method(void); /* DTLSv1.0 */
2339
2340const SSL_METHOD *DTLSv1_2_method(void); /* DTLSv1.2 */
2341const SSL_METHOD *DTLSv1_2_server_method(void); /* DTLSv1.2 */
2342const SSL_METHOD *DTLSv1_2_client_method(void); /* DTLSv1.2 */
2343
2344const SSL_METHOD *DTLS_method(void); /* DTLS 1.0 and 1.2 */
2345const SSL_METHOD *DTLS_server_method(void); /* DTLS 1.0 and 1.2 */
2346const SSL_METHOD *DTLS_client_method(void); /* DTLS 1.0 and 1.2 */
2347
2348STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *s);
2349
2350int SSL_do_handshake(SSL *s);
2351int SSL_renegotiate(SSL *s);
2352int SSL_renegotiate_abbreviated(SSL *s);
2353int SSL_renegotiate_pending(SSL *s);
2354int SSL_shutdown(SSL *s);
2355
2356const SSL_METHOD *SSL_CTX_get_ssl_method(SSL_CTX *ctx);
2357const SSL_METHOD *SSL_get_ssl_method(SSL *s);
2358int SSL_set_ssl_method(SSL *s, const SSL_METHOD *method);
2359const char *SSL_alert_type_string_long(int value);
2360const char *SSL_alert_type_string(int value);
2361const char *SSL_alert_desc_string_long(int value);
2362const char *SSL_alert_desc_string(int value);
2363
2364void SSL_set_client_CA_list(SSL *s, STACK_OF(X509_NAME) *name_list);
2365void SSL_CTX_set_client_CA_list(SSL_CTX *ctx, STACK_OF(X509_NAME) *name_list);
2366STACK_OF(X509_NAME) *SSL_get_client_CA_list(const SSL *s);
2367STACK_OF(X509_NAME) *SSL_CTX_get_client_CA_list(const SSL_CTX *s);
2368int SSL_add_client_CA(SSL *ssl,X509 *x);
2369int SSL_CTX_add_client_CA(SSL_CTX *ctx,X509 *x);
2370
2371void SSL_set_connect_state(SSL *s);
2372void SSL_set_accept_state(SSL *s);
2373
2374long SSL_get_default_timeout(const SSL *s);
2375
2376int SSL_library_init(void );
2377
2378char *SSL_CIPHER_description(const SSL_CIPHER *,char *buf,int size);
2379STACK_OF(X509_NAME) *SSL_dup_CA_list(STACK_OF(X509_NAME) *sk);
2380
2381X509 *SSL_get_certificate(const SSL *ssl);
2382/* EVP_PKEY */ struct evp_pkey_st *SSL_get_privatekey(const SSL *ssl);
2383
2384X509 *SSL_CTX_get0_certificate(const SSL_CTX *ctx);
2385EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx);
2386
2387void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx,int mode);
2388int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx);
2389void SSL_set_quiet_shutdown(SSL *ssl,int mode);
2390int SSL_get_quiet_shutdown(const SSL *ssl);
2391void SSL_set_shutdown(SSL *ssl,int mode);
2392int SSL_get_shutdown(const SSL *ssl);
2393int SSL_version(const SSL *ssl);
2394int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx);
2395int SSL_CTX_load_verify_locations(SSL_CTX *ctx, const char *CAfile,
2396 const char *CApath);
2397#define SSL_get0_session SSL_get_session /* just peek at pointer */
2398SSL_SESSION *SSL_get_session(const SSL *ssl);
2399SSL_SESSION *SSL_get1_session(SSL *ssl); /* obtain a reference count */
2400SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl);
2401SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX* ctx);
2402void SSL_set_info_callback(SSL *ssl,
2403 void (*cb)(const SSL *ssl,int type,int val));
2404void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl,int type,int val);
2405int SSL_state(const SSL *ssl);
2406void SSL_set_state(SSL *ssl, int state);
2407
2408void SSL_set_verify_result(SSL *ssl,long v);
2409long SSL_get_verify_result(const SSL *ssl);
2410
2411int SSL_set_ex_data(SSL *ssl,int idx,void *data);
2412void *SSL_get_ex_data(const SSL *ssl,int idx);
2413int SSL_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
2414 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
2415
2416int SSL_SESSION_set_ex_data(SSL_SESSION *ss,int idx,void *data);
2417void *SSL_SESSION_get_ex_data(const SSL_SESSION *ss,int idx);
2418int SSL_SESSION_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
2419 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
2420
2421int SSL_CTX_set_ex_data(SSL_CTX *ssl,int idx,void *data);
2422void *SSL_CTX_get_ex_data(const SSL_CTX *ssl,int idx);
2423int SSL_CTX_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
2424 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
2425
2426int SSL_get_ex_data_X509_STORE_CTX_idx(void );
2427
2428#define SSL_CTX_sess_set_cache_size(ctx,t) \
2429 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SESS_CACHE_SIZE,t,NULL)
2430#define SSL_CTX_sess_get_cache_size(ctx) \
2431 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_SESS_CACHE_SIZE,0,NULL)
2432#define SSL_CTX_set_session_cache_mode(ctx,m) \
2433 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SESS_CACHE_MODE,m,NULL)
2434#define SSL_CTX_get_session_cache_mode(ctx) \
2435 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_SESS_CACHE_MODE,0,NULL)
2436
2437#define SSL_CTX_get_default_read_ahead(ctx) SSL_CTX_get_read_ahead(ctx)
2438#define SSL_CTX_set_default_read_ahead(ctx,m) SSL_CTX_set_read_ahead(ctx,m)
2439#define SSL_CTX_get_read_ahead(ctx) \
2440 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_READ_AHEAD,0,NULL)
2441#define SSL_CTX_set_read_ahead(ctx,m) \
2442 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_READ_AHEAD,m,NULL)
2443#define SSL_CTX_get_max_cert_list(ctx) \
2444 SSL_CTX_ctrl(ctx,SSL_CTRL_GET_MAX_CERT_LIST,0,NULL)
2445#define SSL_CTX_set_max_cert_list(ctx,m) \
2446 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_CERT_LIST,m,NULL)
2447#define SSL_get_max_cert_list(ssl) \
2448 SSL_ctrl(ssl,SSL_CTRL_GET_MAX_CERT_LIST,0,NULL)
2449#define SSL_set_max_cert_list(ssl,m) \
2450 SSL_ctrl(ssl,SSL_CTRL_SET_MAX_CERT_LIST,m,NULL)
2451
2452#define SSL_CTX_set_max_send_fragment(ctx,m) \
2453 SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_SEND_FRAGMENT,m,NULL)
2454#define SSL_set_max_send_fragment(ssl,m) \
2455 SSL_ctrl(ssl,SSL_CTRL_SET_MAX_SEND_FRAGMENT,m,NULL)
2456
2457 /* NB: the keylength is only applicable when is_export is true */
2458#ifndef OPENSSL_NO_RSA
2459void SSL_CTX_set_tmp_rsa_callback(SSL_CTX *ctx,
2460 RSA *(*cb)(SSL *ssl,int is_export,
2461 int keylength));
2462
2463void SSL_set_tmp_rsa_callback(SSL *ssl,
2464 RSA *(*cb)(SSL *ssl,int is_export,
2465 int keylength));
2466#endif
2467#ifndef OPENSSL_NO_DH
2468void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
2469 DH *(*dh)(SSL *ssl,int is_export,
2470 int keylength));
2471void SSL_set_tmp_dh_callback(SSL *ssl,
2472 DH *(*dh)(SSL *ssl,int is_export,
2473 int keylength));
2474#endif
2475#ifndef OPENSSL_NO_ECDH
2476void SSL_CTX_set_tmp_ecdh_callback(SSL_CTX *ctx,
2477 EC_KEY *(*ecdh)(SSL *ssl,int is_export,
2478 int keylength));
2479void SSL_set_tmp_ecdh_callback(SSL *ssl,
2480 EC_KEY *(*ecdh)(SSL *ssl,int is_export,
2481 int keylength));
2482#endif
2483
2484const void *SSL_get_current_compression(SSL *s);
2485const void *SSL_get_current_expansion(SSL *s);
2486const char *SSL_COMP_get_name(const void *comp);
2487void *SSL_COMP_get_compression_methods(void);
2488int SSL_COMP_add_compression_method(int id,void *cm);
2489
2490const SSL_CIPHER *SSL_CIPHER_find(SSL *ssl, const unsigned char *ptr);
2491
2492/* TLS extensions functions */
2493int SSL_set_session_ticket_ext(SSL *s, void *ext_data, int ext_len);
2494
2495int SSL_set_session_ticket_ext_cb(SSL *s, tls_session_ticket_ext_cb_fn cb,
2496 void *arg);
2497
2498/* Pre-shared secret session resumption functions */
2499int SSL_set_session_secret_cb(SSL *s, tls_session_secret_cb_fn tls_session_secret_cb, void *arg);
2500
2501void SSL_set_debug(SSL *s, int debug);
2502int SSL_cache_hit(SSL *s);
2503int SSL_is_server(SSL *s);
2504
Adam Langley95f22882014-06-20 12:00:00 -07002505/* SSL_get_structure_sizes returns the sizes of the SSL, SSL_CTX and
2506 * SSL_SESSION structures so that a test can ensure that outside code agrees on
2507 * these values. */
2508void SSL_get_structure_sizes(size_t* ssl_size, size_t* ssl_ctx_size,
2509 size_t* ssl_session_size);
2510
Adam Langley95c29f32014-06-20 12:00:00 -07002511SSL_CONF_CTX *SSL_CONF_CTX_new(void);
2512int SSL_CONF_CTX_finish(SSL_CONF_CTX *cctx);
2513void SSL_CONF_CTX_free(SSL_CONF_CTX *cctx);
2514unsigned int SSL_CONF_CTX_set_flags(SSL_CONF_CTX *cctx, unsigned int flags);
2515unsigned int SSL_CONF_CTX_clear_flags(SSL_CONF_CTX *cctx, unsigned int flags);
2516int SSL_CONF_CTX_set1_prefix(SSL_CONF_CTX *cctx, const char *pre);
2517
2518void SSL_CONF_CTX_set_ssl(SSL_CONF_CTX *cctx, SSL *ssl);
2519void SSL_CONF_CTX_set_ssl_ctx(SSL_CONF_CTX *cctx, SSL_CTX *ctx);
2520
2521int SSL_CONF_cmd(SSL_CONF_CTX *cctx, const char *cmd, const char *value);
2522int SSL_CONF_cmd_argv(SSL_CONF_CTX *cctx, int *pargc, char ***pargv);
2523int SSL_CONF_cmd_value_type(SSL_CONF_CTX *cctx, const char *cmd);
2524
2525#ifndef OPENSSL_NO_SSL_TRACE
2526void SSL_trace(int write_p, int version, int content_type,
2527 const void *buf, size_t len, SSL *ssl, void *arg);
2528const char *SSL_CIPHER_standard_name(const SSL_CIPHER *c);
2529#endif
2530
2531unsigned char *SSL_get_tlsa_record_byname(const char *name,int port,int type);
2532
2533/* BEGIN ERROR CODES */
2534/* The following lines are auto generated by the script mkerr.pl. Any changes
2535 * made after this point may be overwritten when the script is next run.
2536 */
2537void ERR_load_SSL_strings(void);
2538
2539
2540#ifdef __cplusplus
2541}
2542#endif
2543#define SSL_F_SSL_use_PrivateKey_file 100
2544#define SSL_F_dtls1_write_app_data_bytes 101
2545#define SSL_F_ssl_cipher_process_rulestr 102
2546#define SSL_F_SSL_set_session_id_context 103
2547#define SSL_F_SSL_read 104
2548#define SSL_F_ssl_cert_new 105
2549#define SSL_F_dtls1_heartbeat 106
2550#define SSL_F_ssl3_digest_cached_records 107
2551#define SSL_F_SSL_set_wfd 108
2552#define SSL_F_SSL_CTX_use_serverinfo 109
2553#define SSL_F_ssl_set_pkey 110
2554#define SSL_F_SSL_CTX_use_certificate 111
2555#define SSL_F_dtls1_read_bytes 112
2556#define SSL_F_ssl23_write 113
2557#define SSL_F_ssl3_check_client_hello 114
2558#define SSL_F_SSL_use_certificate_ASN1 115
2559#define SSL_F_ssl_verify_cert_chain 116
2560#define SSL_F_ssl_parse_serverhello_renegotiate_ext 117
2561#define SSL_F_ssl_undefined_const_function 118
2562#define SSL_F_ssl3_get_server_certificate 119
2563#define SSL_F_tls1_get_server_supplemental_data 120
2564#define SSL_F_dtls1_buffer_record 121
2565#define SSL_F_ssl_prepare_clienthello_tlsext 122
2566#define SSL_F_ssl3_get_server_hello 123
2567#define SSL_F_ssl3_send_client_key_exchange 124
2568#define SSL_F_ssl3_write_bytes 125
2569#define SSL_F_SSL_use_RSAPrivateKey_file 126
2570#define SSL_F_ssl_bad_method 127
2571#define SSL_F_ssl3_connect 128
2572#define SSL_F_dtls1_connect 129
2573#define SSL_F_SSL_use_RSAPrivateKey 130
2574#define SSL_F_tls1_PRF 131
2575#define SSL_F_ssl_bytes_to_cipher_list 132
2576#define SSL_F_ssl3_do_change_cipher_spec 133
2577#define SSL_F_SSL_SESSION_set1_id_context 134
2578#define SSL_F_ssl_add_serverhello_tlsext 135
2579#define SSL_F_read_authz 136
2580#define SSL_F_ssl3_get_client_hello 137
2581#define SSL_F_ssl3_get_certificate_request 138
2582#define SSL_F_authz_find_data 139
2583#define SSL_F_ssl_add_cert_to_buf 140
2584#define SSL_F_ssl_add_serverhello_renegotiate_ext 141
2585#define SSL_F_ssl3_get_message 142
2586#define SSL_F_ssl_check_srvr_ecc_cert_and_alg 143
2587#define SSL_F_ssl_parse_clienthello_tlsext 144
2588#define SSL_F_SSL_add_file_cert_subjects_to_stack 145
2589#define SSL_F_ssl3_ctx_ctrl 146
2590#define SSL_F_ssl3_get_record 147
2591#define SSL_F_SSL_CTX_use_RSAPrivateKey 148
2592#define SSL_F_SSL_use_certificate_file 149
2593#define SSL_F_SSL_CTX_use_serverinfo_file 150
2594#define SSL_F_SSL_load_client_CA_file 151
2595#define SSL_F_dtls1_preprocess_fragment 152
2596#define SSL_F_SSL_CTX_check_private_key 153
2597#define SSL_F_ssl3_get_cert_status 154
2598#define SSL_F_printf 155
2599#define SSL_F_SSL_CTX_new 156
2600#define SSL_F_ssl23_accept 157
2601#define SSL_F_SSL_use_authz 158
2602#define SSL_F_ssl_undefined_function 159
2603#define SSL_F_dtls1_send_hello_verify_request 160
2604#define SSL_F_ssl_build_cert_chain 161
2605#define SSL_F_SSL_SESSION_print_fp 162
2606#define SSL_F_tls1_change_cipher_state 163
2607#define SSL_F_tls12_check_peer_sigalg 164
2608#define SSL_F_ssl_sess_cert_new 165
2609#define SSL_F_ssl3_read_bytes 166
2610#define SSL_F_dtls1_get_hello_verify 167
2611#define SSL_F_tls1_cert_verify_mac 168
2612#define SSL_F_ssl23_client_hello 169
2613#define SSL_F_SSL_shutdown 170
2614#define SSL_F_ssl_init_wbio_buffer 171
2615#define SSL_F_SSL_use_certificate 172
2616#define SSL_F_SSL_CTX_use_RSAPrivateKey_ASN1 173
2617#define SSL_F_ssl_set_authz 174
2618#define SSL_F_ssl23_peek 175
2619#define SSL_F_SSL_use_psk_identity_hint 176
2620#define SSL_F_ssl3_get_cert_verify 177
2621#define SSL_F_ssl_ctx_make_profiles 178
2622#define SSL_F_ssl_add_clienthello_use_srtp_ext 179
2623#define SSL_F_ssl3_get_client_key_exchange 180
2624#define SSL_F_do_ssl3_write 181
2625#define SSL_F_ssl3_handshake_mac 182
2626#define SSL_F_tls1_setup_key_block 183
2627#define SSL_F_SSL_set_fd 184
2628#define SSL_F_SSL_check_private_key 185
2629#define SSL_F_ssl3_send_client_verify 186
2630#define SSL_F_ssl3_write_pending 187
2631#define SSL_F_ssl_cert_inst 188
2632#define SSL_F_ssl3_change_cipher_state 189
2633#define SSL_F_ssl23_get_server_hello 190
2634#define SSL_F_SSL_write 191
2635#define SSL_F_ssl_get_sign_pkey 192
2636#define SSL_F_ssl_set_cert 193
2637#define SSL_F_SSL_CTX_use_RSAPrivateKey_file 194
2638#define SSL_F_SSL_CTX_use_authz 195
2639#define SSL_F_ssl_get_new_session 196
2640#define SSL_F_SSL_set_session_ticket_ext 197
2641#define SSL_F_ssl_add_clienthello_renegotiate_ext 198
2642#define SSL_F_ssl3_send_server_key_exchange 199
2643#define SSL_F_fprintf 200
2644#define SSL_F_ssl3_get_new_session_ticket 201
2645#define SSL_F_SSL_CTX_use_certificate_ASN1 202
2646#define SSL_F_ssl_add_cert_chain 203
2647#define SSL_F_ssl_create_cipher_list 204
2648#define SSL_F_ssl3_callback_ctrl 205
2649#define SSL_F_SSL_CTX_set_cipher_list 206
2650#define SSL_F_ssl3_send_certificate_request 207
2651#define SSL_F_SSL_use_PrivateKey_ASN1 208
2652#define SSL_F_SSL_CTX_use_certificate_chain_file 209
2653#define SSL_F_SSL_SESSION_new 210
2654#define SSL_F_check_suiteb_cipher_list 211
2655#define SSL_F_ssl_scan_clienthello_tlsext 212
2656#define SSL_F_ssl3_client_hello 213
2657#define SSL_F_SSL_use_RSAPrivateKey_ASN1 214
2658#define SSL_F_ssl3_ctrl 215
2659#define SSL_F_ssl3_setup_write_buffer 216
2660#define SSL_F_ssl_parse_serverhello_use_srtp_ext 217
2661#define SSL_F_ssl3_get_key_exchange 218
2662#define SSL_F_ssl3_send_server_hello 219
2663#define SSL_F_SSL_add_dir_cert_subjects_to_stack 220
2664#define SSL_F_ssl_check_serverhello_tlsext 221
2665#define SSL_F_ssl3_get_server_done 222
2666#define SSL_F_ssl3_check_cert_and_algorithm 223
2667#define SSL_F_do_dtls1_write 224
2668#define SSL_F_dtls1_check_timeout_num 225
2669#define SSL_F_tls1_export_keying_material 226
2670#define SSL_F_SSL_CTX_set_session_id_context 227
2671#define SSL_F_SSL_set_rfd 228
2672#define SSL_F_ssl3_send_client_certificate 229
2673#define SSL_F_ssl_cert_dup 230
2674#define SSL_F_dtls1_process_record 231
2675#define SSL_F_ssl_new 232
2676#define SSL_F_ssl_get_server_cert_index 233
2677#define SSL_F_tls1_send_server_supplemental_data 234
2678#define SSL_F_D2I_SSL_SESSION 235
2679#define SSL_F_ssl_cipher_strength_sort 236
2680#define SSL_F_dtls1_get_message 237
2681#define SSL_F_ssl23_connect 238
2682#define SSL_F_tls1_heartbeat 239
2683#define SSL_F_ssl3_read_n 240
2684#define SSL_F_ssl_get_prev_session 241
2685#define SSL_F_ssl_parse_clienthello_renegotiate_ext 242
2686#define SSL_F_ssl3_setup_read_buffer 243
2687#define SSL_F_SSL_CTX_set_ssl_version 244
2688#define SSL_F_SSL_peek 245
2689#define SSL_F_ssl3_send_server_certificate 246
2690#define SSL_F_SSL_do_handshake 247
2691#define SSL_F_ssl_undefined_void_function 248
2692#define SSL_F_ssl_add_serverhello_use_srtp_ext 249
2693#define SSL_F_fclose 250
2694#define SSL_F_SSL_use_PrivateKey 251
2695#define SSL_F_SSL_CTX_use_certificate_file 252
2696#define SSL_F_SSL_CTX_use_PrivateKey 253
2697#define SSL_F_SSL_set_session 254
2698#define SSL_F_SSL_CTX_use_psk_identity_hint 255
2699#define SSL_F_ssl_scan_serverhello_tlsext 256
2700#define SSL_F_ssl23_read 257
2701#define SSL_F_ssl_parse_clienthello_use_srtp_ext 258
2702#define SSL_F_ssl3_accept 259
2703#define SSL_F_ssl3_get_client_certificate 260
2704#define SSL_F_SSL_CTX_use_PrivateKey_ASN1 261
2705#define SSL_F_dtls1_get_message_fragment 262
2706#define SSL_F_SSL_clear 263
2707#define SSL_F_dtls1_accept 264
2708#define SSL_F_ssl3_get_next_proto 265
2709#define SSL_F_SSL_set_cipher_list 266
2710#define SSL_F_ssl_add_clienthello_tlsext 267
2711#define SSL_F_ssl23_get_client_hello 268
2712#define SSL_F_SSL_CTX_use_PrivateKey_file 269
2713#define SSL_F_ssl3_get_finished 270
2714#define SSL_F_ssl3_generate_key_block 271
2715#define SSL_F_ssl3_setup_key_block 272
2716#define SSL_F_SSL_new 273
2717#define SSL_F_ssl_parse_serverhello_tlsext 274
Adam Langley1258b6a2014-06-20 12:00:00 -07002718#define SSL_F_ssl3_get_channel_id 275
2719#define SSL_F_ssl3_send_channel_id 276
Adam Langley0b5c1ac2014-06-20 12:00:00 -07002720#define SSL_F_SSL_CTX_set_cipher_list_tls11 277
Adam Langleya5fa5b72014-06-20 12:00:00 -07002721#define SSL_F_tls1_change_cipher_state_cipher 278
Adam Langleyc9fb3752014-06-20 12:00:00 -07002722#define SSL_F_tls1_change_cipher_state_aead 279
2723#define SSL_F_tls1_aead_ctx_init 280
Adam Langley95c29f32014-06-20 12:00:00 -07002724#define SSL_R_UNABLE_TO_FIND_ECDH_PARAMETERS 100
2725#define SSL_R_DECRYPTION_FAILED_OR_BAD_RECORD_MAC 101
2726#define SSL_R_INVALID_NULL_CMD_NAME 102
2727#define SSL_R_BAD_RSA_DECRYPT 103
2728#define SSL_R_NO_SHARED_CIPHER 104
2729#define SSL_R_BAD_PSK_IDENTITY_HINT_LENGTH 105
2730#define SSL_R_SSL_HANDSHAKE_FAILURE 106
2731#define SSL_R_INVALID_TICKET_KEYS_LENGTH 107
2732#define SSL_R_PEER_ERROR 108
2733#define SSL_R_ECC_CERT_NOT_FOR_SIGNING 109
2734#define SSL_R_INCONSISTENT_COMPRESSION 110
2735#define SSL_R_BAD_HELLO_REQUEST 111
2736#define SSL_R_NULL_SSL_METHOD_PASSED 112
2737#define SSL_R_X509_VERIFICATION_SETUP_PROBLEMS 113
2738#define SSL_R_BAD_ECDSA_SIGNATURE 114
2739#define SSL_R_GOT_NEXT_PROTO_WITHOUT_EXTENSION 115
2740#define SSL_R_BAD_DH_PUB_KEY_LENGTH 116
2741#define SSL_R_COMPRESSED_LENGTH_TOO_LONG 117
2742#define SSL_R_APP_DATA_IN_HANDSHAKE 118
2743#define SSL_R_NO_PEM_EXTENSIONS 119
2744#define SSL_R_BAD_SRP_B_LENGTH 120
2745#define SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG 121
2746#define SSL_R_UNABLE_TO_DECODE_DH_CERTS 122
2747#define SSL_R_MISSING_SRP_PARAM 123
2748#define SSL_R_MISSING_RSA_SIGNING_CERT 124
2749#define SSL_R_MISSING_DSA_SIGNING_CERT 125
2750#define SSL_R_ONLY_TLS_1_2_ALLOWED_IN_SUITEB_MODE 126
2751#define SSL_R_UNEXPECTED_RECORD 127
2752#define SSL_R_BAD_DIGEST_LENGTH 128
2753#define SSL_R_READ_TIMEOUT_EXPIRED 129
2754#define SSL_R_KRB5_C_GET_CRED 130
2755#define SSL_R_NULL_SSL_CTX 131
2756#define SSL_R_TLSV1_ALERT_EXPORT_RESTRICTION 132
2757#define SSL_R_TLSV1_ALERT_INTERNAL_ERROR 133
2758#define SSL_R_ERROR_GENERATING_TMP_RSA_KEY 134
2759#define SSL_R_SSL3_SESSION_ID_TOO_LONG 135
2760#define SSL_R_BAD_DATA_RETURNED_BY_CALLBACK 136
2761#define SSL_R_REUSE_CERT_LENGTH_NOT_ZERO 137
2762#define SSL_R_SSLV3_ALERT_DECOMPRESSION_FAILURE 138
2763#define SSL_R_COOKIE_MISMATCH 139
2764#define SSL_R_UNINITIALIZED 140
2765#define SSL_R_BAD_CHANGE_CIPHER_SPEC 141
2766#define SSL_R_UNABLE_TO_LOAD_SSL3_SHA1_ROUTINES 142
2767#define SSL_R_BAD_SRP_G_LENGTH 143
2768#define SSL_R_NO_CERTIFICATE_ASSIGNED 144
2769#define SSL_R_UNABLE_TO_FIND_PUBLIC_KEY_PARAMETERS 145
2770#define SSL_R_PEM_NAME_TOO_SHORT 146
2771#define SSL_R_SSLV3_ALERT_CERTIFICATE_REVOKED 147
2772#define SSL_R_PROTOCOL_IS_SHUTDOWN 148
2773#define SSL_R_UNABLE_TO_FIND_SSL_METHOD 149
2774#define SSL_R_WRONG_MESSAGE_TYPE 150
2775#define SSL_R_BAD_RSA_MODULUS_LENGTH 151
2776#define SSL_R_PUBLIC_KEY_IS_NOT_RSA 152
2777#define SSL_R_COMPRESSION_ID_NOT_WITHIN_PRIVATE_RANGE 153
2778#define SSL_R_NO_CLIENT_CERT_RECEIVED 154
2779#define SSL_R_TLS_INVALID_ECPOINTFORMAT_LIST 155
2780#define SSL_R_CERT_LENGTH_MISMATCH 156
2781#define SSL_R_MISSING_EXPORT_TMP_DH_KEY 157
2782#define SSL_R_DUPLICATE_COMPRESSION_ID 158
2783#define SSL_R_SSL3_EXT_INVALID_ECPOINTFORMAT 159
2784#define SSL_R_REUSE_CIPHER_LIST_NOT_ZERO 160
2785#define SSL_R_DATA_LENGTH_TOO_LONG 161
2786#define SSL_R_ECGROUP_TOO_LARGE_FOR_CIPHER 162
2787#define SSL_R_WRONG_SIGNATURE_LENGTH 163
2788#define SSL_R_SSL2_CONNECTION_ID_TOO_LONG 164
2789#define SSL_R_WRONG_VERSION_NUMBER 165
2790#define SSL_R_RECORD_TOO_LARGE 166
2791#define SSL_R_BIO_NOT_SET 167
2792#define SSL_R_SRTP_COULD_NOT_ALLOCATE_PROFILES 168
2793#define SSL_R_TLSV1_ALERT_DECODE_ERROR 169
2794#define SSL_R_UNKNOWN_PKEY_TYPE 170
2795#define SSL_R_CIPHER_CODE_WRONG_LENGTH 171
2796#define SSL_R_SSL_SESSION_ID_CONFLICT 172
2797#define SSL_R_INVALID_COMMAND 173
2798#define SSL_R_NO_PROTOCOLS_AVAILABLE 174
2799#define SSL_R_ERROR_IN_RECEIVED_CIPHER_LIST 175
2800#define SSL_R_LIBRARY_BUG 176
2801#define SSL_R_UNSUPPORTED_CIPHER 177
2802#define SSL_R_REUSE_CERT_TYPE_NOT_ZERO 178
2803#define SSL_R_WRONG_SIGNATURE_TYPE 179
2804#define SSL_R_BAD_SRTP_PROTECTION_PROFILE_LIST 180
2805#define SSL_R_PSK_NO_SERVER_CB 181
2806#define SSL_R_BLOCK_CIPHER_PAD_IS_WRONG 182
2807#define SSL_R_INVALID_TRUST 183
2808#define SSL_R_PARSE_TLSEXT 184
2809#define SSL_R_NO_SRTP_PROFILES 185
2810#define SSL_R_UNSUPPORTED_ELLIPTIC_CURVE 186
2811#define SSL_R_UNKNOWN_STATE 187
2812#define SSL_R_UNKNOWN_CERTIFICATE_TYPE 188
Adam Langley1258b6a2014-06-20 12:00:00 -07002813#define SSL_R_WRONG_CIPHER_RETURNED 189
2814#define SSL_R_BAD_DH_G_LENGTH 190
2815#define SSL_R_BAD_ALERT_RECORD 191
2816#define SSL_R_CIPHER_TABLE_SRC_ERROR 192
2817#define SSL_R_SSLV3_ALERT_BAD_CERTIFICATE 193
2818#define SSL_R_UNKNOWN_REMOTE_ERROR_TYPE 194
2819#define SSL_R_SSL3_EXT_INVALID_SERVERNAME_TYPE 195
2820#define SSL_R_MESSAGE_TOO_LONG 196
2821#define SSL_R_BAD_RSA_SIGNATURE 197
2822#define SSL_R_X509_LIB 198
2823#define SSL_R_BAD_SRP_N_LENGTH 199
2824#define SSL_R_BAD_SSL_SESSION_ID_LENGTH 200
2825#define SSL_R_UNKNOWN_CIPHER_TYPE 201
2826#define SSL_R_BAD_DH_P_LENGTH 202
2827#define SSL_R_MISSING_DH_RSA_CERT 203
2828#define SSL_R_NO_METHOD_SPECIFIED 204
2829#define SSL_R_EMPTY_SRTP_PROTECTION_PROFILE_LIST 205
2830#define SSL_R_MULTIPLE_SGC_RESTARTS 206
2831#define SSL_R_UNABLE_TO_DECODE_ECDH_CERTS 207
2832#define SSL_R_ATTEMPT_TO_REUSE_SESSION_IN_DIFFERENT_CONTEXT 208
2833#define SSL_R_SSL3_EXT_INVALID_SERVERNAME 209
2834#define SSL_R_BAD_SRP_S_LENGTH 210
2835#define SSL_R_MISSING_TMP_RSA_KEY 211
2836#define SSL_R_PSK_NO_CLIENT_CB 212
2837#define SSL_R_PEM_NAME_BAD_PREFIX 213
2838#define SSL_R_BAD_CHECKSUM 214
2839#define SSL_R_TLSV1_ALERT_PROTOCOL_VERSION 215
2840#define SSL_R_NO_CIPHER_MATCH 216
2841#define SSL_R_MISSING_TMP_DH_KEY 217
2842#define SSL_R_UNSUPPORTED_STATUS_TYPE 218
2843#define SSL_R_UNKNOWN_AUTHZ_DATA_TYPE 219
2844#define SSL_R_CONNECTION_TYPE_NOT_SET 220
2845#define SSL_R_MISSING_DH_KEY 221
2846#define SSL_R_CHANNEL_ID_NOT_P256 222
2847#define SSL_R_UNKNOWN_SUPPLEMENTAL_DATA_TYPE 223
2848#define SSL_R_UNKNOWN_PROTOCOL 224
2849#define SSL_R_DATA_BETWEEN_CCS_AND_FINISHED 225
2850#define SSL_R_KRB5_S_TKT_SKEW 226
2851#define SSL_R_PUBLIC_KEY_NOT_RSA 227
2852#define SSL_R_SCSV_RECEIVED_WHEN_RENEGOTIATING 228
2853#define SSL_R_GOST_NOT_SUPPORTED 229
2854#define SSL_R_KRB5_C_CC_PRINC 230
2855#define SSL_R_SSLV3_ALERT_HANDSHAKE_FAILURE 231
2856#define SSL_R_TLSV1_ALERT_RECORD_OVERFLOW 232
2857#define SSL_R_TLSV1_BAD_CERTIFICATE_STATUS_RESPONSE 233
2858#define SSL_R_INVALID_PURPOSE 234
2859#define SSL_R_KRB5_C_MK_REQ 235
2860#define SSL_R_SSLV3_ALERT_BAD_RECORD_MAC 236
2861#define SSL_R_BAD_SRTP_MKI_VALUE 237
2862#define SSL_R_EVP_DIGESTSIGNINIT_FAILED 238
2863#define SSL_R_DIGEST_CHECK_FAILED 239
2864#define SSL_R_BAD_SRP_A_LENGTH 240
2865#define SSL_R_SERVERHELLO_TLSEXT 241
2866#define SSL_R_TLS_RSA_ENCRYPTED_VALUE_LENGTH_IS_WRONG 242
2867#define SSL_R_NO_CIPHERS_AVAILABLE 243
2868#define SSL_R_COMPRESSION_FAILURE 244
2869#define SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION 245
2870#define SSL_R_OLD_SESSION_CIPHER_NOT_RETURNED 246
2871#define SSL_R_BAD_RSA_ENCRYPT 247
2872#define SSL_R_EXCESSIVE_MESSAGE_SIZE 248
2873#define SSL_R_INVALID_COMPRESSION_ALGORITHM 249
2874#define SSL_R_SHORT_READ 250
2875#define SSL_R_TLSV1_ALERT_ACCESS_DENIED 251
2876#define SSL_R_CA_DN_LENGTH_MISMATCH 252
2877#define SSL_R_BAD_ECC_CERT 253
2878#define SSL_R_NON_SSLV2_INITIAL_PACKET 254
2879#define SSL_R_SSL_SESSION_ID_IS_DIFFERENT 255
2880#define SSL_R_MISSING_TMP_RSA_PKEY 256
2881#define SSL_R_BN_LIB 257
2882#define SSL_R_PEER_DID_NOT_RETURN_A_CERTIFICATE 258
2883#define SSL_R_MISSING_RSA_ENCRYPTING_CERT 259
2884#define SSL_R_NO_RENEGOTIATION 260
2885#define SSL_R_NO_COMPRESSION_SPECIFIED 261
2886#define SSL_R_WRONG_CERTIFICATE_TYPE 262
2887#define SSL_R_TLSV1_UNRECOGNIZED_NAME 263
2888#define SSL_R_CHANNEL_ID_SIGNATURE_INVALID 264
2889#define SSL_R_READ_BIO_NOT_SET 265
2890#define SSL_R_SSL23_DOING_SESSION_ID_REUSE 266
2891#define SSL_R_RENEGOTIATE_EXT_TOO_LONG 267
2892#define SSL_R_INVALID_CHALLENGE_LENGTH 268
2893#define SSL_R_TLSV1_ALERT_INSUFFICIENT_SECURITY 269
2894#define SSL_R_LIBRARY_HAS_NO_CIPHERS 270
2895#define SSL_R_WRONG_CURVE 271
2896#define SSL_R_SESSION_ID_CONTEXT_UNINITIALIZED 272
2897#define SSL_R_SSLV3_ALERT_UNEXPECTED_MESSAGE 273
2898#define SSL_R_TLSV1_UNSUPPORTED_EXTENSION 274
2899#define SSL_R_ECC_CERT_NOT_FOR_KEY_AGREEMENT 275
2900#define SSL_R_MISSING_RSA_CERTIFICATE 276
2901#define SSL_R_NO_P256_SUPPORT 277
2902#define SSL_R_UNSUPPORTED_COMPRESSION_ALGORITHM 278
2903#define SSL_R_INVALID_SERVERINFO_DATA 279
2904#define SSL_R_GOT_CHANNEL_ID_BEFORE_A_CCS 280
2905#define SSL_R_DH_PUBLIC_VALUE_LENGTH_IS_WRONG 281
2906#define SSL_R_KRB5_S_BAD_TICKET 282
2907#define SSL_R_EVP_DIGESTSIGNFINAL_FAILED 283
2908#define SSL_R_PACKET_LENGTH_TOO_LONG 284
2909#define SSL_R_BAD_STATE 285
2910#define SSL_R_USE_SRTP_NOT_NEGOTIATED 286
2911#define SSL_R_BAD_RSA_E_LENGTH 287
2912#define SSL_R_ILLEGAL_PADDING 288
2913#define SSL_R_SIGNATURE_FOR_NON_SIGNING_CERTIFICATE 289
2914#define SSL_R_BAD_VALUE 290
2915#define SSL_R_ECC_CERT_SHOULD_HAVE_RSA_SIGNATURE 291
2916#define SSL_R_COMPRESSION_DISABLED 292
2917#define SSL_R_BAD_DECOMPRESSION 293
2918#define SSL_R_CHALLENGE_IS_DIFFERENT 294
2919#define SSL_R_NO_CLIENT_CERT_METHOD 295
2920#define SSL_R_SRTP_PROTECTION_PROFILE_LIST_TOO_LONG 296
2921#define SSL_R_INVALID_MESSAGE 297
2922#define SSL_R_HTTPS_PROXY_REQUEST 298
2923#define SSL_R_AUTHZ_DATA_TOO_LARGE 299
2924#define SSL_R_KRB5_S_TKT_EXPIRED 300
2925#define SSL_R_NO_CERTIFICATE_SPECIFIED 301
2926#define SSL_R_ECC_CERT_SHOULD_HAVE_SHA1_SIGNATURE 302
2927#define SSL_R_TLS_PEER_DID_NOT_RESPOND_WITH_CERTIFICATE_LIST 303
2928#define SSL_R_INVALID_STATUS_RESPONSE 304
2929#define SSL_R_TLS_ILLEGAL_EXPORTER_LABEL 305
2930#define SSL_R_ONLY_DTLS_1_2_ALLOWED_IN_SUITEB_MODE 306
2931#define SSL_R_MISSING_TMP_ECDH_KEY 307
2932#define SSL_R_CERTIFICATE_VERIFY_FAILED 308
2933#define SSL_R_TRIED_TO_USE_UNSUPPORTED_CIPHER 309
2934#define SSL_R_RENEGOTIATION_ENCODING_ERR 310
2935#define SSL_R_NO_PRIVATEKEY 311
2936#define SSL_R_TLS_HEARTBEAT_PENDING 312
2937#define SSL_R_READ_WRONG_PACKET_TYPE 313
2938#define SSL_R_SSL3_SESSION_ID_TOO_SHORT 314
2939#define SSL_R_UNABLE_TO_LOAD_SSL2_MD5_ROUTINES 315
2940#define SSL_R_GOT_NEXT_PROTO_BEFORE_A_CCS 316
2941#define SSL_R_HTTP_REQUEST 317
2942#define SSL_R_KRB5_S_INIT 318
2943#define SSL_R_TLSV1_ALERT_USER_CANCELLED 319
2944#define SSL_R_RECORD_LENGTH_MISMATCH 320
2945#define SSL_R_BAD_LENGTH 321
2946#define SSL_R_NO_REQUIRED_DIGEST 322
2947#define SSL_R_KRB5 323
2948#define SSL_R_TLSV1_BAD_CERTIFICATE_HASH_VALUE 324
2949#define SSL_R_CCS_RECEIVED_EARLY 325
2950#define SSL_R_MISSING_ECDSA_SIGNING_CERT 326
2951#define SSL_R_D2I_ECDSA_SIG 327
2952#define SSL_R_PATH_TOO_LONG 328
2953#define SSL_R_CIPHER_OR_HASH_UNAVAILABLE 329
2954#define SSL_R_UNSUPPORTED_DIGEST_TYPE 330
2955#define SSL_R_OLD_SESSION_COMPRESSION_ALGORITHM_NOT_RETURNED 331
2956#define SSL_R_PEER_ERROR_CERTIFICATE 332
2957#define SSL_R_UNABLE_TO_FIND_DH_PARAMETERS 333
2958#define SSL_R_NO_CERTIFICATE_SET 334
2959#define SSL_R_SSL_SESSION_ID_CALLBACK_FAILED 335
2960#define SSL_R_SSLV3_ALERT_CERTIFICATE_EXPIRED 336
2961#define SSL_R_NO_CERTIFICATES_RETURNED 337
2962#define SSL_R_BAD_WRITE_RETRY 338
2963#define SSL_R_BAD_SSL_FILETYPE 339
2964#define SSL_R_SRTP_UNKNOWN_PROTECTION_PROFILE 340
2965#define SSL_R_NO_CIPHERS_SPECIFIED 341
2966#define SSL_R_LENGTH_MISMATCH 342
2967#define SSL_R_NO_CIPHERS_PASSED 343
2968#define SSL_R_NO_VERIFY_CALLBACK 344
2969#define SSL_R_PEER_ERROR_UNSUPPORTED_CERTIFICATE_TYPE 345
2970#define SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN 346
2971#define SSL_R_WRONG_NUMBER_OF_KEY_BITS 347
2972#define SSL_R_UNEXPECTED_MESSAGE 348
2973#define SSL_R_MISSING_DH_DSA_CERT 349
2974#define SSL_R_SSL_SESSION_ID_HAS_BAD_LENGTH 350
2975#define SSL_R_OPAQUE_PRF_INPUT_TOO_LONG 351
2976#define SSL_R_UNABLE_TO_LOAD_SSL3_MD5_ROUTINES 352
2977#define SSL_R_ILLEGAL_SUITEB_DIGEST 353
2978#define SSL_R_NO_SHARED_SIGATURE_ALGORITHMS 354
2979#define SSL_R_CLIENTHELLO_TLSEXT 355
2980#define SSL_R_INVALID_AUTHZ_DATA 356
2981#define SSL_R_BAD_RESPONSE_ARGUMENT 357
2982#define SSL_R_PUBLIC_KEY_ENCRYPT_ERROR 358
2983#define SSL_R_REQUIRED_CIPHER_MISSING 359
2984#define SSL_R_INVALID_AUDIT_PROOF 360
2985#define SSL_R_PSK_IDENTITY_NOT_FOUND 361
2986#define SSL_R_UNKNOWN_ALERT_TYPE 362
2987#define SSL_R_NO_GOST_CERTIFICATE_SENT_BY_PEER 363
2988#define SSL_R_TLSV1_ALERT_UNKNOWN_CA 364
2989#define SSL_R_BAD_AUTHENTICATION_TYPE 365
2990#define SSL_R_DECRYPTION_FAILED 366
2991#define SSL_R_WRONG_SSL_VERSION 367
2992#define SSL_R_NO_CERTIFICATE_RETURNED 368
2993#define SSL_R_SSLV3_ALERT_ILLEGAL_PARAMETER 369
2994#define SSL_R_CA_DN_TOO_LONG 370
2995#define SSL_R_GOT_A_FIN_BEFORE_A_CCS 371
2996#define SSL_R_COMPRESSION_LIBRARY_ERROR 372
2997#define SSL_R_TLSV1_ALERT_DECRYPT_ERROR 373
2998#define SSL_R_SSL_LIBRARY_HAS_NO_CIPHERS 374
2999#define SSL_R_UNSAFE_LEGACY_RENEGOTIATION_DISABLED 375
3000#define SSL_R_BAD_ECPOINT 376
3001#define SSL_R_BAD_HANDSHAKE_LENGTH 377
3002#define SSL_R_SSLV3_ALERT_UNSUPPORTED_CERTIFICATE 378
3003#define SSL_R_TLSV1_CERTIFICATE_UNOBTAINABLE 379
3004#define SSL_R_KRB5_S_RD_REQ 380
3005#define SSL_R_PEER_ERROR_NO_CERTIFICATE 381
3006#define SSL_R_PRE_MAC_LENGTH_TOO_LONG 382
3007#define SSL_R_PROBLEMS_MAPPING_CIPHER_FUNCTIONS 383
3008#define SSL_R_UNKNOWN_DIGEST 384
3009#define SSL_R_WRONG_SIGNATURE_SIZE 385
3010#define SSL_R_SIGNATURE_ALGORITHMS_ERROR 386
3011#define SSL_R_REQUIRED_COMPRESSSION_ALGORITHM_MISSING 387
3012#define SSL_R_BAD_SIGNATURE 388
3013#define SSL_R_BAD_PACKET_LENGTH 389
3014#define SSL_R_CANNOT_SERIALIZE_PUBLIC_KEY 390
3015#define SSL_R_RENEGOTIATION_MISMATCH 391
3016#define SSL_R_BAD_MAC_LENGTH 392
3017#define SSL_R_NO_PUBLICKEY 393
3018#define SSL_R_UNKNOWN_KEY_EXCHANGE_TYPE 394
3019#define SSL_R_BAD_MAC_DECODE 395
3020#define SSL_R_NO_PRIVATE_KEY_ASSIGNED 396
3021#define SSL_R_EXTRA_DATA_IN_MESSAGE 397
3022#define SSL_R_TLS_CLIENT_CERT_REQ_WITH_ANON_CIPHER 398
3023#define SSL_R_CONNECTION_ID_IS_DIFFERENT 399
3024#define SSL_R_SSLV3_ALERT_NO_CERTIFICATE 400
3025#define SSL_R_TLS_HEARTBEAT_PEER_DOESNT_ACCEPT 401
3026#define SSL_R_MISSING_VERIFY_MESSAGE 402
3027#define SSL_R_BAD_DSA_SIGNATURE 403
3028#define SSL_R_UNKNOWN_SSL_VERSION 404
3029#define SSL_R_KEY_ARG_TOO_LONG 405
3030#define SSL_R_KRB5_C_INIT 406
3031#define SSL_R_NO_CIPHER_LIST 407
3032#define SSL_R_PEER_ERROR_NO_CIPHER 408
3033#define SSL_R_UNKNOWN_CMD_NAME 409
3034#define SSL_R_UNKNOWN_CIPHER_RETURNED 410
3035#define SSL_R_RECORD_TOO_SMALL 411
3036#define SSL_R_ENCRYPTED_LENGTH_TOO_LONG 412
3037#define SSL_R_UNSUPPORTED_SSL_VERSION 413
3038#define SSL_R_TLSV1_ALERT_DECRYPTION_FAILED 414
3039#define SSL_R_UNABLE_TO_EXTRACT_PUBLIC_KEY 415
3040#define SSL_R_MISSING_EXPORT_TMP_RSA_KEY 416
3041#define SSL_R_BAD_DATA 417
3042#define SSL_R_KRB5_S_TKT_NYV 418
3043#define SSL_R_TLSV1_ALERT_NO_RENEGOTIATION 419
3044#define SSL_R_BAD_PROTOCOL_VERSION_NUMBER 420
3045#define SSL_R_BAD_MESSAGE_TYPE 421
3046#define SSL_R_MISSING_ECDH_CERT 422
3047#define SSL_R_UNSUPPORTED_PROTOCOL 423
3048#define SSL_R_SRP_A_CALC 424
3049#define SSL_R_WRITE_BIO_NOT_SET 425
3050#define SSL_R_ONLY_TLS_ALLOWED_IN_FIPS_MODE 426
3051#define SSL_R_LENGTH_TOO_SHORT 427
3052#define SSL_R_CERT_CB_ERROR 428
3053#define SSL_R_DTLS_MESSAGE_TOO_BIG 429
3054#define SSL_R_INVALID_SRP_USERNAME 430
Adam Langley48105fa2014-06-20 12:00:00 -07003055#define SSL_R_TOO_MANY_EMPTY_FRAGMENTS 431
Adam Langley858a88d2014-06-20 12:00:00 -07003056#define SSL_R_NESTED_GROUP 432
3057#define SSL_R_UNEXPECTED_GROUP_CLOSE 433
3058#define SSL_R_UNEXPECTED_OPERATOR_IN_GROUP 434
3059#define SSL_R_MIXED_SPECIAL_OPERATOR_WITH_GROUPS 435
Adam Langley95c29f32014-06-20 12:00:00 -07003060
3061#endif