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