ssl.h revision 674ff29eb647c577ba1ef822c373ead69dc386cf
1/* ssl/ssl.h */
2/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
3 * All rights reserved.
4 *
5 * This package is an SSL implementation written
6 * by Eric Young (eay@cryptsoft.com).
7 * The implementation was written so as to conform with Netscapes SSL.
8 *
9 * This library is free for commercial and non-commercial use as long as
10 * the following conditions are aheared to.  The following conditions
11 * apply to all code found in this distribution, be it the RC4, RSA,
12 * lhash, DES, etc., code; not just the SSL code.  The SSL documentation
13 * included with this distribution is covered by the same copyright terms
14 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
15 *
16 * Copyright remains Eric Young's, and as such any Copyright notices in
17 * the code are not to be removed.
18 * If this package is used in a product, Eric Young should be given attribution
19 * as the author of the parts of the library used.
20 * This can be in the form of a textual message at program startup or
21 * in documentation (online or textual) provided with the package.
22 *
23 * Redistribution and use in source and binary forms, with or without
24 * modification, are permitted provided that the following conditions
25 * are met:
26 * 1. Redistributions of source code must retain the copyright
27 *    notice, this list of conditions and the following disclaimer.
28 * 2. Redistributions in binary form must reproduce the above copyright
29 *    notice, this list of conditions and the following disclaimer in the
30 *    documentation and/or other materials provided with the distribution.
31 * 3. All advertising materials mentioning features or use of this software
32 *    must display the following acknowledgement:
33 *    "This product includes cryptographic software written by
34 *     Eric Young (eay@cryptsoft.com)"
35 *    The word 'cryptographic' can be left out if the rouines from the library
36 *    being used are not cryptographic related :-).
37 * 4. If you include any Windows specific code (or a derivative thereof) from
38 *    the apps directory (application code) you must include an acknowledgement:
39 *    "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
40 *
41 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
42 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
43 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
44 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
45 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
46 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
47 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
49 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
50 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
51 * SUCH DAMAGE.
52 *
53 * The licence and distribution terms for any publically available version or
54 * derivative of this code cannot be changed.  i.e. this code cannot simply be
55 * copied and put under another distribution licence
56 * [including the GNU Public Licence.]
57 */
58/* ====================================================================
59 * Copyright (c) 1998-2007 The OpenSSL Project.  All rights reserved.
60 *
61 * Redistribution and use in source and binary forms, with or without
62 * modification, are permitted provided that the following conditions
63 * are met:
64 *
65 * 1. Redistributions of source code must retain the above copyright
66 *    notice, this list of conditions and the following disclaimer.
67 *
68 * 2. Redistributions in binary form must reproduce the above copyright
69 *    notice, this list of conditions and the following disclaimer in
70 *    the documentation and/or other materials provided with the
71 *    distribution.
72 *
73 * 3. All advertising materials mentioning features or use of this
74 *    software must display the following acknowledgment:
75 *    "This product includes software developed by the OpenSSL Project
76 *    for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
77 *
78 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
79 *    endorse or promote products derived from this software without
80 *    prior written permission. For written permission, please contact
81 *    openssl-core@openssl.org.
82 *
83 * 5. Products derived from this software may not be called "OpenSSL"
84 *    nor may "OpenSSL" appear in their names without prior written
85 *    permission of the OpenSSL Project.
86 *
87 * 6. Redistributions of any form whatsoever must retain the following
88 *    acknowledgment:
89 *    "This product includes software developed by the OpenSSL Project
90 *    for use in the OpenSSL Toolkit (http://www.openssl.org/)"
91 *
92 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
93 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
94 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
95 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
96 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
97 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
98 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
99 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
100 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
101 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
102 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
103 * OF THE POSSIBILITY OF SUCH DAMAGE.
104 * ====================================================================
105 *
106 * This product includes cryptographic software written by Eric Young
107 * (eay@cryptsoft.com).  This product includes software written by Tim
108 * Hudson (tjh@cryptsoft.com).
109 *
110 */
111/* ====================================================================
112 * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
113 * ECC cipher suite support in OpenSSL originally developed by
114 * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project.
115 */
116/* ====================================================================
117 * Copyright 2005 Nokia. All rights reserved.
118 *
119 * The portions of the attached software ("Contribution") is developed by
120 * Nokia Corporation and is licensed pursuant to the OpenSSL open source
121 * license.
122 *
123 * The Contribution, originally written by Mika Kousa and Pasi Eronen of
124 * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
125 * support (see RFC 4279) to OpenSSL.
126 *
127 * No patent licenses or other rights except those expressly stated in
128 * the OpenSSL open source license shall be deemed granted or received
129 * expressly, by implication, estoppel, or otherwise.
130 *
131 * No assurances are provided by Nokia that the Contribution does not
132 * infringe the patent or other intellectual property rights of any third
133 * party or that the license provides you with all the necessary rights
134 * to make use of the Contribution.
135 *
136 * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
137 * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
138 * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
139 * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
140 * OTHERWISE.
141 */
142
143#ifndef HEADER_SSL_H
144#define HEADER_SSL_H
145
146#include <openssl/e_os2.h>
147
148#ifndef OPENSSL_NO_COMP
149#include <openssl/comp.h>
150#endif
151#ifndef OPENSSL_NO_BIO
152#include <openssl/bio.h>
153#endif
154#ifndef OPENSSL_NO_DEPRECATED
155#ifndef OPENSSL_NO_X509
156#include <openssl/x509.h>
157#endif
158#include <openssl/crypto.h>
159#include <openssl/lhash.h>
160#include <openssl/buffer.h>
161#endif
162#include <openssl/pem.h>
163#include <openssl/hmac.h>
164
165#include <openssl/kssl.h>
166#include <openssl/safestack.h>
167#include <openssl/symhacks.h>
168
169#ifdef  __cplusplus
170extern "C" {
171#endif
172
173/* SSLeay version number for ASN.1 encoding of the session information */
174/* Version 0 - initial version
175 * Version 1 - added the optional peer certificate
176 */
177#define SSL_SESSION_ASN1_VERSION 0x0001
178
179/* text strings for the ciphers */
180#define SSL_TXT_NULL_WITH_MD5		SSL2_TXT_NULL_WITH_MD5
181#define SSL_TXT_RC4_128_WITH_MD5	SSL2_TXT_RC4_128_WITH_MD5
182#define SSL_TXT_RC4_128_EXPORT40_WITH_MD5 SSL2_TXT_RC4_128_EXPORT40_WITH_MD5
183#define SSL_TXT_RC2_128_CBC_WITH_MD5	SSL2_TXT_RC2_128_CBC_WITH_MD5
184#define SSL_TXT_RC2_128_CBC_EXPORT40_WITH_MD5 SSL2_TXT_RC2_128_CBC_EXPORT40_WITH_MD5
185#define SSL_TXT_IDEA_128_CBC_WITH_MD5	SSL2_TXT_IDEA_128_CBC_WITH_MD5
186#define SSL_TXT_DES_64_CBC_WITH_MD5	SSL2_TXT_DES_64_CBC_WITH_MD5
187#define SSL_TXT_DES_64_CBC_WITH_SHA	SSL2_TXT_DES_64_CBC_WITH_SHA
188#define SSL_TXT_DES_192_EDE3_CBC_WITH_MD5 SSL2_TXT_DES_192_EDE3_CBC_WITH_MD5
189#define SSL_TXT_DES_192_EDE3_CBC_WITH_SHA SSL2_TXT_DES_192_EDE3_CBC_WITH_SHA
190
191/*    VRS Additional Kerberos5 entries
192 */
193#define SSL_TXT_KRB5_DES_64_CBC_SHA   SSL3_TXT_KRB5_DES_64_CBC_SHA
194#define SSL_TXT_KRB5_DES_192_CBC3_SHA SSL3_TXT_KRB5_DES_192_CBC3_SHA
195#define SSL_TXT_KRB5_RC4_128_SHA      SSL3_TXT_KRB5_RC4_128_SHA
196#define SSL_TXT_KRB5_IDEA_128_CBC_SHA SSL3_TXT_KRB5_IDEA_128_CBC_SHA
197#define SSL_TXT_KRB5_DES_64_CBC_MD5   SSL3_TXT_KRB5_DES_64_CBC_MD5
198#define SSL_TXT_KRB5_DES_192_CBC3_MD5 SSL3_TXT_KRB5_DES_192_CBC3_MD5
199#define SSL_TXT_KRB5_RC4_128_MD5      SSL3_TXT_KRB5_RC4_128_MD5
200#define SSL_TXT_KRB5_IDEA_128_CBC_MD5 SSL3_TXT_KRB5_IDEA_128_CBC_MD5
201
202#define SSL_TXT_KRB5_DES_40_CBC_SHA   SSL3_TXT_KRB5_DES_40_CBC_SHA
203#define SSL_TXT_KRB5_RC2_40_CBC_SHA   SSL3_TXT_KRB5_RC2_40_CBC_SHA
204#define SSL_TXT_KRB5_RC4_40_SHA	      SSL3_TXT_KRB5_RC4_40_SHA
205#define SSL_TXT_KRB5_DES_40_CBC_MD5   SSL3_TXT_KRB5_DES_40_CBC_MD5
206#define SSL_TXT_KRB5_RC2_40_CBC_MD5   SSL3_TXT_KRB5_RC2_40_CBC_MD5
207#define SSL_TXT_KRB5_RC4_40_MD5	      SSL3_TXT_KRB5_RC4_40_MD5
208
209#define SSL_TXT_KRB5_DES_40_CBC_SHA   SSL3_TXT_KRB5_DES_40_CBC_SHA
210#define SSL_TXT_KRB5_DES_40_CBC_MD5   SSL3_TXT_KRB5_DES_40_CBC_MD5
211#define SSL_TXT_KRB5_DES_64_CBC_SHA   SSL3_TXT_KRB5_DES_64_CBC_SHA
212#define SSL_TXT_KRB5_DES_64_CBC_MD5   SSL3_TXT_KRB5_DES_64_CBC_MD5
213#define SSL_TXT_KRB5_DES_192_CBC3_SHA SSL3_TXT_KRB5_DES_192_CBC3_SHA
214#define SSL_TXT_KRB5_DES_192_CBC3_MD5 SSL3_TXT_KRB5_DES_192_CBC3_MD5
215#define SSL_MAX_KRB5_PRINCIPAL_LENGTH  256
216
217#define SSL_MAX_SSL_SESSION_ID_LENGTH		32
218#define SSL_MAX_SID_CTX_LENGTH			32
219
220#define SSL_MIN_RSA_MODULUS_LENGTH_IN_BYTES	(512/8)
221#define SSL_MAX_KEY_ARG_LENGTH			8
222#define SSL_MAX_MASTER_KEY_LENGTH		48
223
224
225/* These are used to specify which ciphers to use and not to use */
226
227#define SSL_TXT_EXP40		"EXPORT40"
228#define SSL_TXT_EXP56		"EXPORT56"
229#define SSL_TXT_LOW		"LOW"
230#define SSL_TXT_MEDIUM		"MEDIUM"
231#define SSL_TXT_HIGH		"HIGH"
232#define SSL_TXT_FIPS		"FIPS"
233
234#define SSL_TXT_kFZA		"kFZA" /* unused! */
235#define	SSL_TXT_aFZA		"aFZA" /* unused! */
236#define SSL_TXT_eFZA		"eFZA" /* unused! */
237#define SSL_TXT_FZA		"FZA"  /* unused! */
238
239#define	SSL_TXT_aNULL		"aNULL"
240#define	SSL_TXT_eNULL		"eNULL"
241#define	SSL_TXT_NULL		"NULL"
242
243#define SSL_TXT_kRSA		"kRSA"
244#define SSL_TXT_kDHr		"kDHr" /* no such ciphersuites supported! */
245#define SSL_TXT_kDHd		"kDHd" /* no such ciphersuites supported! */
246#define SSL_TXT_kDH 		"kDH"  /* no such ciphersuites supported! */
247#define SSL_TXT_kEDH		"kEDH"
248#define SSL_TXT_kKRB5     	"kKRB5"
249#define SSL_TXT_kECDHr		"kECDHr"
250#define SSL_TXT_kECDHe		"kECDHe"
251#define SSL_TXT_kECDH		"kECDH"
252#define SSL_TXT_kEECDH		"kEECDH"
253#define SSL_TXT_kPSK            "kPSK"
254#define SSL_TXT_kGOST		"kGOST"
255
256#define	SSL_TXT_aRSA		"aRSA"
257#define	SSL_TXT_aDSS		"aDSS"
258#define	SSL_TXT_aDH		"aDH" /* no such ciphersuites supported! */
259#define	SSL_TXT_aECDH		"aECDH"
260#define SSL_TXT_aKRB5     	"aKRB5"
261#define SSL_TXT_aECDSA		"aECDSA"
262#define SSL_TXT_aPSK            "aPSK"
263#define SSL_TXT_aGOST94	"aGOST94"
264#define SSL_TXT_aGOST01 "aGOST01"
265#define SSL_TXT_aGOST  "aGOST"
266
267#define	SSL_TXT_DSS		"DSS"
268#define SSL_TXT_DH		"DH"
269#define SSL_TXT_EDH		"EDH" /* same as "kEDH:-ADH" */
270#define SSL_TXT_ADH		"ADH"
271#define SSL_TXT_RSA		"RSA"
272#define SSL_TXT_ECDH		"ECDH"
273#define SSL_TXT_EECDH		"EECDH" /* same as "kEECDH:-AECDH" */
274#define SSL_TXT_AECDH		"AECDH"
275#define SSL_TXT_ECDSA		"ECDSA"
276#define SSL_TXT_KRB5      	"KRB5"
277#define SSL_TXT_PSK             "PSK"
278
279#define SSL_TXT_DES		"DES"
280#define SSL_TXT_3DES		"3DES"
281#define SSL_TXT_RC4		"RC4"
282#define SSL_TXT_RC2		"RC2"
283#define SSL_TXT_IDEA		"IDEA"
284#define SSL_TXT_SEED		"SEED"
285#define SSL_TXT_AES128		"AES128"
286#define SSL_TXT_AES256		"AES256"
287#define SSL_TXT_AES		"AES"
288#define SSL_TXT_CAMELLIA128	"CAMELLIA128"
289#define SSL_TXT_CAMELLIA256	"CAMELLIA256"
290#define SSL_TXT_CAMELLIA	"CAMELLIA"
291
292#define SSL_TXT_MD5		"MD5"
293#define SSL_TXT_SHA1		"SHA1"
294#define SSL_TXT_SHA		"SHA" /* same as "SHA1" */
295#define SSL_TXT_GOST94		"GOST94"
296#define SSL_TXT_GOST89MAC		"GOST89MAC"
297
298#define SSL_TXT_SSLV2		"SSLv2"
299#define SSL_TXT_SSLV3		"SSLv3"
300#define SSL_TXT_TLSV1		"TLSv1"
301
302#define SSL_TXT_EXP		"EXP"
303#define SSL_TXT_EXPORT		"EXPORT"
304
305#define SSL_TXT_ALL		"ALL"
306
307/*
308 * COMPLEMENTOF* definitions. These identifiers are used to (de-select)
309 * ciphers normally not being used.
310 * Example: "RC4" will activate all ciphers using RC4 including ciphers
311 * without authentication, which would normally disabled by DEFAULT (due
312 * the "!ADH" being part of default). Therefore "RC4:!COMPLEMENTOFDEFAULT"
313 * will make sure that it is also disabled in the specific selection.
314 * COMPLEMENTOF* identifiers are portable between version, as adjustments
315 * to the default cipher setup will also be included here.
316 *
317 * COMPLEMENTOFDEFAULT does not experience the same special treatment that
318 * DEFAULT gets, as only selection is being done and no sorting as needed
319 * for DEFAULT.
320 */
321#define SSL_TXT_CMPALL		"COMPLEMENTOFALL"
322#define SSL_TXT_CMPDEF		"COMPLEMENTOFDEFAULT"
323
324/* The following cipher list is used by default.
325 * It also is substituted when an application-defined cipher list string
326 * starts with 'DEFAULT'. */
327#define SSL_DEFAULT_CIPHER_LIST	"ALL:!aNULL:!eNULL:!SSLv2"
328/* As of OpenSSL 1.0.0, ssl_create_cipher_list() in ssl/ssl_ciph.c always
329 * starts with a reasonable order, and all we have to do for DEFAULT is
330 * throwing out anonymous and unencrypted ciphersuites!
331 * (The latter are not actually enabled by ALL, but "ALL:RSA" would enable
332 * some of them.)
333 */
334
335/* Used in SSL_set_shutdown()/SSL_get_shutdown(); */
336#define SSL_SENT_SHUTDOWN	1
337#define SSL_RECEIVED_SHUTDOWN	2
338
339#ifdef __cplusplus
340}
341#endif
342
343#ifdef  __cplusplus
344extern "C" {
345#endif
346
347#if (defined(OPENSSL_NO_RSA) || defined(OPENSSL_NO_MD5)) && !defined(OPENSSL_NO_SSL2)
348#define OPENSSL_NO_SSL2
349#endif
350
351#define SSL_FILETYPE_ASN1	X509_FILETYPE_ASN1
352#define SSL_FILETYPE_PEM	X509_FILETYPE_PEM
353
354/* This is needed to stop compilers complaining about the
355 * 'struct ssl_st *' function parameters used to prototype callbacks
356 * in SSL_CTX. */
357typedef struct ssl_st *ssl_crock_st;
358typedef struct tls_session_ticket_ext_st TLS_SESSION_TICKET_EXT;
359
360/* used to hold info on the particular ciphers used */
361typedef struct ssl_cipher_st
362	{
363	int valid;
364	const char *name;		/* text name */
365	unsigned long id;		/* id, 4 bytes, first is version */
366
367	/* changed in 0.9.9: these four used to be portions of a single value 'algorithms' */
368	unsigned long algorithm_mkey;	/* key exchange algorithm */
369	unsigned long algorithm_auth;	/* server authentication */
370	unsigned long algorithm_enc;	/* symmetric encryption */
371	unsigned long algorithm_mac;	/* symmetric authentication */
372	unsigned long algorithm_ssl;	/* (major) protocol version */
373
374	unsigned long algo_strength;	/* strength and export flags */
375	unsigned long algorithm2;	/* Extra flags */
376	int strength_bits;		/* Number of bits really used */
377	int alg_bits;			/* Number of bits for algorithm */
378	} SSL_CIPHER;
379
380DECLARE_STACK_OF(SSL_CIPHER)
381
382typedef int (*tls_session_ticket_ext_cb_fn)(SSL *s, const unsigned char *data, int len, void *arg);
383typedef int (*tls_session_secret_cb_fn)(SSL *s, void *secret, int *secret_len, STACK_OF(SSL_CIPHER) *peer_ciphers, SSL_CIPHER **cipher, void *arg);
384
385/* Used to hold functions for SSLv2 or SSLv3/TLSv1 functions */
386typedef struct ssl_method_st
387	{
388	int version;
389	int (*ssl_new)(SSL *s);
390	void (*ssl_clear)(SSL *s);
391	void (*ssl_free)(SSL *s);
392	int (*ssl_accept)(SSL *s);
393	int (*ssl_connect)(SSL *s);
394	int (*ssl_read)(SSL *s,void *buf,int len);
395	int (*ssl_peek)(SSL *s,void *buf,int len);
396	int (*ssl_write)(SSL *s,const void *buf,int len);
397	int (*ssl_shutdown)(SSL *s);
398	int (*ssl_renegotiate)(SSL *s);
399	int (*ssl_renegotiate_check)(SSL *s);
400	long (*ssl_get_message)(SSL *s, int st1, int stn, int mt, long
401		max, int *ok);
402	int (*ssl_read_bytes)(SSL *s, int type, unsigned char *buf, int len,
403		int peek);
404	int (*ssl_write_bytes)(SSL *s, int type, const void *buf_, int len);
405	int (*ssl_dispatch_alert)(SSL *s);
406	long (*ssl_ctrl)(SSL *s,int cmd,long larg,void *parg);
407	long (*ssl_ctx_ctrl)(SSL_CTX *ctx,int cmd,long larg,void *parg);
408	const SSL_CIPHER *(*get_cipher_by_char)(const unsigned char *ptr);
409	int (*put_cipher_by_char)(const SSL_CIPHER *cipher,unsigned char *ptr);
410	int (*ssl_pending)(const SSL *s);
411	int (*num_ciphers)(void);
412	const SSL_CIPHER *(*get_cipher)(unsigned ncipher);
413	const struct ssl_method_st *(*get_ssl_method)(int version);
414	long (*get_timeout)(void);
415	struct ssl3_enc_method *ssl3_enc; /* Extra SSLv3/TLS stuff */
416	int (*ssl_version)(void);
417	long (*ssl_callback_ctrl)(SSL *s, int cb_id, void (*fp)(void));
418	long (*ssl_ctx_callback_ctrl)(SSL_CTX *s, int cb_id, void (*fp)(void));
419	} SSL_METHOD;
420
421/* Lets make this into an ASN.1 type structure as follows
422 * SSL_SESSION_ID ::= SEQUENCE {
423 *	version 		INTEGER,	-- structure version number
424 *	SSLversion 		INTEGER,	-- SSL version number
425 *	Cipher 			OCTET STRING,	-- the 3 byte cipher ID
426 *	Session_ID 		OCTET STRING,	-- the Session ID
427 *	Master_key 		OCTET STRING,	-- the master key
428 *	KRB5_principal		OCTET STRING	-- optional Kerberos principal
429 *	Key_Arg [ 0 ] IMPLICIT	OCTET STRING,	-- the optional Key argument
430 *	Time [ 1 ] EXPLICIT	INTEGER,	-- optional Start Time
431 *	Timeout [ 2 ] EXPLICIT	INTEGER,	-- optional Timeout ins seconds
432 *	Peer [ 3 ] EXPLICIT	X509,		-- optional Peer Certificate
433 *	Session_ID_context [ 4 ] EXPLICIT OCTET STRING,   -- the Session ID context
434 *	Verify_result [ 5 ] EXPLICIT INTEGER,   -- X509_V_... code for `Peer'
435 *	HostName [ 6 ] EXPLICIT OCTET STRING,   -- optional HostName from servername TLS extension
436 *	ECPointFormatList [ 7 ] OCTET STRING,     -- optional EC point format list from TLS extension
437 *	PSK_identity_hint [ 8 ] EXPLICIT OCTET STRING, -- optional PSK identity hint
438 *	PSK_identity [ 9 ] EXPLICIT OCTET STRING -- optional PSK identity
439 *	}
440 * Look in ssl/ssl_asn1.c for more details
441 * I'm using EXPLICIT tags so I can read the damn things using asn1parse :-).
442 */
443typedef struct ssl_session_st
444	{
445	int ssl_version;	/* what ssl version session info is
446				 * being kept in here? */
447
448	/* only really used in SSLv2 */
449	unsigned int key_arg_length;
450	unsigned char key_arg[SSL_MAX_KEY_ARG_LENGTH];
451	int master_key_length;
452	unsigned char master_key[SSL_MAX_MASTER_KEY_LENGTH];
453	/* session_id - valid? */
454	unsigned int session_id_length;
455	unsigned char session_id[SSL_MAX_SSL_SESSION_ID_LENGTH];
456	/* this is used to determine whether the session is being reused in
457	 * the appropriate context. It is up to the application to set this,
458	 * via SSL_new */
459	unsigned int sid_ctx_length;
460	unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
461
462#ifndef OPENSSL_NO_KRB5
463        unsigned int krb5_client_princ_len;
464        unsigned char krb5_client_princ[SSL_MAX_KRB5_PRINCIPAL_LENGTH];
465#endif /* OPENSSL_NO_KRB5 */
466#ifndef OPENSSL_NO_PSK
467	char *psk_identity_hint;
468	char *psk_identity;
469#endif
470	int not_resumable;
471
472	/* The cert is the certificate used to establish this connection */
473	struct sess_cert_st /* SESS_CERT */ *sess_cert;
474
475	/* This is the cert for the other end.
476	 * On clients, it will be the same as sess_cert->peer_key->x509
477	 * (the latter is not enough as sess_cert is not retained
478	 * in the external representation of sessions, see ssl_asn1.c). */
479	X509 *peer;
480	/* when app_verify_callback accepts a session where the peer's certificate
481	 * is not ok, we must remember the error for session reuse: */
482	long verify_result; /* only for servers */
483
484	int references;
485	long timeout;
486	long time;
487
488	unsigned int compress_meth;	/* Need to lookup the method */
489
490	const SSL_CIPHER *cipher;
491	unsigned long cipher_id;	/* when ASN.1 loaded, this
492					 * needs to be used to load
493					 * the 'cipher' structure */
494
495	STACK_OF(SSL_CIPHER) *ciphers; /* shared ciphers? */
496
497	CRYPTO_EX_DATA ex_data; /* application specific data */
498
499	/* These are used to make removal of session-ids more
500	 * efficient and to implement a maximum cache size. */
501	struct ssl_session_st *prev,*next;
502#ifndef OPENSSL_NO_TLSEXT
503	char *tlsext_hostname;
504#ifndef OPENSSL_NO_EC
505	size_t tlsext_ecpointformatlist_length;
506	unsigned char *tlsext_ecpointformatlist; /* peer's list */
507	size_t tlsext_ellipticcurvelist_length;
508	unsigned char *tlsext_ellipticcurvelist; /* peer's list */
509#endif /* OPENSSL_NO_EC */
510	/* RFC4507 info */
511	unsigned char *tlsext_tick;	/* Session ticket */
512	size_t	tlsext_ticklen;		/* Session ticket length */
513	long tlsext_tick_lifetime_hint;	/* Session lifetime hint in seconds */
514#endif
515	} SSL_SESSION;
516
517
518#define SSL_OP_MICROSOFT_SESS_ID_BUG			0x00000001L
519#define SSL_OP_NETSCAPE_CHALLENGE_BUG			0x00000002L
520/* Allow initial connection to servers that don't support RI */
521#define SSL_OP_LEGACY_SERVER_CONNECT			0x00000004L
522#define SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG		0x00000008L
523#define SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG		0x00000010L
524#define SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER		0x00000020L
525#define SSL_OP_MSIE_SSLV2_RSA_PADDING			0x00000040L /* no effect since 0.9.7h and 0.9.8b */
526#define SSL_OP_SSLEAY_080_CLIENT_DH_BUG			0x00000080L
527#define SSL_OP_TLS_D5_BUG				0x00000100L
528#define SSL_OP_TLS_BLOCK_PADDING_BUG			0x00000200L
529
530/* Disable SSL 3.0/TLS 1.0 CBC vulnerability workaround that was added
531 * in OpenSSL 0.9.6d.  Usually (depending on the application protocol)
532 * the workaround is not needed.  Unfortunately some broken SSL/TLS
533 * implementations cannot handle it at all, which is why we include
534 * it in SSL_OP_ALL. */
535#define SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS              0x00000800L /* added in 0.9.6e */
536
537/* SSL_OP_ALL: various bug workarounds that should be rather harmless.
538 *             This used to be 0x000FFFFFL before 0.9.7. */
539#define SSL_OP_ALL					0x80000FFFL
540
541/* DTLS options */
542#define SSL_OP_NO_QUERY_MTU                 0x00001000L
543/* Turn on Cookie Exchange (on relevant for servers) */
544#define SSL_OP_COOKIE_EXCHANGE              0x00002000L
545/* Don't use RFC4507 ticket extension */
546#define SSL_OP_NO_TICKET	            0x00004000L
547/* Use Cisco's "speshul" version of DTLS_BAD_VER (as client)  */
548#define SSL_OP_CISCO_ANYCONNECT		    0x00008000L
549
550/* As server, disallow session resumption on renegotiation */
551#define SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION	0x00010000L
552/* Don't use compression even if supported */
553#define SSL_OP_NO_COMPRESSION				0x00020000L
554/* Permit unsafe legacy renegotiation */
555#define SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION	0x00040000L
556/* If set, always create a new key when using tmp_ecdh parameters */
557#define SSL_OP_SINGLE_ECDH_USE				0x00080000L
558/* If set, always create a new key when using tmp_dh parameters */
559#define SSL_OP_SINGLE_DH_USE				0x00100000L
560/* Set to always use the tmp_rsa key when doing RSA operations,
561 * even when this violates protocol specs */
562#define SSL_OP_EPHEMERAL_RSA				0x00200000L
563/* Set on servers to choose the cipher according to the server's
564 * preferences */
565#define SSL_OP_CIPHER_SERVER_PREFERENCE			0x00400000L
566/* If set, a server will allow a client to issue a SSLv3.0 version number
567 * as latest version supported in the premaster secret, even when TLSv1.0
568 * (version 3.1) was announced in the client hello. Normally this is
569 * forbidden to prevent version rollback attacks. */
570#define SSL_OP_TLS_ROLLBACK_BUG				0x00800000L
571
572#define SSL_OP_NO_SSLv2					0x01000000L
573#define SSL_OP_NO_SSLv3					0x02000000L
574#define SSL_OP_NO_TLSv1					0x04000000L
575
576/* The next flag deliberately changes the ciphertest, this is a check
577 * for the PKCS#1 attack */
578#define SSL_OP_PKCS1_CHECK_1				0x08000000L
579#define SSL_OP_PKCS1_CHECK_2				0x10000000L
580#define SSL_OP_NETSCAPE_CA_DN_BUG			0x20000000L
581#define SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG		0x40000000L
582/* Make server add server-hello extension from early version of
583 * cryptopro draft, when GOST ciphersuite is negotiated.
584 * Required for interoperability with CryptoPro CSP 3.x
585 */
586#define SSL_OP_CRYPTOPRO_TLSEXT_BUG			0x80000000L
587
588/* Allow SSL_write(..., n) to return r with 0 < r < n (i.e. report success
589 * when just a single record has been written): */
590#define SSL_MODE_ENABLE_PARTIAL_WRITE       0x00000001L
591/* Make it possible to retry SSL_write() with changed buffer location
592 * (buffer contents must stay the same!); this is not the default to avoid
593 * the misconception that non-blocking SSL_write() behaves like
594 * non-blocking write(): */
595#define SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER 0x00000002L
596/* Never bother the application with retries if the transport
597 * is blocking: */
598#define SSL_MODE_AUTO_RETRY 0x00000004L
599/* Don't attempt to automatically build certificate chain */
600#define SSL_MODE_NO_AUTO_CHAIN 0x00000008L
601/* Save RAM by releasing read and write buffers when they're empty. (SSL3 and
602 * TLS only.)  "Released" buffers are put onto a free-list in the context
603 * or just freed (depending on the context's setting for freelist_max_len). */
604#define SSL_MODE_RELEASE_BUFFERS 0x00000010L
605/* Use small read and write buffers: (a) lazy allocate read buffers for
606 * large incoming records, and (b) limit the size of outgoing records. */
607#define SSL_MODE_SMALL_BUFFERS 0x00000020L
608
609/* Note: SSL[_CTX]_set_{options,mode} use |= op on the previous value,
610 * they cannot be used to clear bits. */
611
612#define SSL_CTX_set_options(ctx,op) \
613	SSL_CTX_ctrl((ctx),SSL_CTRL_OPTIONS,(op),NULL)
614#define SSL_CTX_clear_options(ctx,op) \
615	SSL_CTX_ctrl((ctx),SSL_CTRL_CLEAR_OPTIONS,(op),NULL)
616#define SSL_CTX_get_options(ctx) \
617	SSL_CTX_ctrl((ctx),SSL_CTRL_OPTIONS,0,NULL)
618#define SSL_set_options(ssl,op) \
619	SSL_ctrl((ssl),SSL_CTRL_OPTIONS,(op),NULL)
620#define SSL_clear_options(ssl,op) \
621	SSL_ctrl((ssl),SSL_CTRL_CLEAR_OPTIONS,(op),NULL)
622#define SSL_get_options(ssl) \
623        SSL_ctrl((ssl),SSL_CTRL_OPTIONS,0,NULL)
624
625#define SSL_CTX_set_mode(ctx,op) \
626	SSL_CTX_ctrl((ctx),SSL_CTRL_MODE,(op),NULL)
627#define SSL_CTX_clear_mode(ctx,op) \
628	SSL_CTX_ctrl((ctx),SSL_CTRL_CLEAR_MODE,(op),NULL)
629#define SSL_CTX_get_mode(ctx) \
630	SSL_CTX_ctrl((ctx),SSL_CTRL_MODE,0,NULL)
631#define SSL_clear_mode(ssl,op) \
632	SSL_ctrl((ssl),SSL_CTRL_CLEAR_MODE,(op),NULL)
633#define SSL_set_mode(ssl,op) \
634	SSL_ctrl((ssl),SSL_CTRL_MODE,(op),NULL)
635#define SSL_get_mode(ssl) \
636        SSL_ctrl((ssl),SSL_CTRL_MODE,0,NULL)
637#define SSL_set_mtu(ssl, mtu) \
638        SSL_ctrl((ssl),SSL_CTRL_SET_MTU,(mtu),NULL)
639
640#define SSL_get_secure_renegotiation_support(ssl) \
641	SSL_ctrl((ssl), SSL_CTRL_GET_RI_SUPPORT, 0, NULL)
642
643void 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));
644void 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));
645#define SSL_CTX_set_msg_callback_arg(ctx, arg) SSL_CTX_ctrl((ctx), SSL_CTRL_SET_MSG_CALLBACK_ARG, 0, (arg))
646#define SSL_set_msg_callback_arg(ssl, arg) SSL_ctrl((ssl), SSL_CTRL_SET_MSG_CALLBACK_ARG, 0, (arg))
647
648
649
650#if defined(OPENSSL_SYS_MSDOS) && !defined(OPENSSL_SYS_WIN32)
651#define SSL_MAX_CERT_LIST_DEFAULT 1024*30 /* 30k max cert list :-) */
652#else
653#define SSL_MAX_CERT_LIST_DEFAULT 1024*100 /* 100k max cert list :-) */
654#endif
655
656#define SSL_SESSION_CACHE_MAX_SIZE_DEFAULT	(1024*20)
657
658/* This callback type is used inside SSL_CTX, SSL, and in the functions that set
659 * them. It is used to override the generation of SSL/TLS session IDs in a
660 * server. Return value should be zero on an error, non-zero to proceed. Also,
661 * callbacks should themselves check if the id they generate is unique otherwise
662 * the SSL handshake will fail with an error - callbacks can do this using the
663 * 'ssl' value they're passed by;
664 *      SSL_has_matching_session_id(ssl, id, *id_len)
665 * The length value passed in is set at the maximum size the session ID can be.
666 * In SSLv2 this is 16 bytes, whereas SSLv3/TLSv1 it is 32 bytes. The callback
667 * can alter this length to be less if desired, but under SSLv2 session IDs are
668 * supposed to be fixed at 16 bytes so the id will be padded after the callback
669 * returns in this case. It is also an error for the callback to set the size to
670 * zero. */
671typedef int (*GEN_SESSION_CB)(const SSL *ssl, unsigned char *id,
672				unsigned int *id_len);
673
674typedef struct ssl_comp_st
675	{
676	int id;
677	const char *name;
678#ifndef OPENSSL_NO_COMP
679	COMP_METHOD *method;
680#else
681	char *method;
682#endif
683	} SSL_COMP;
684
685DECLARE_STACK_OF(SSL_COMP)
686DECLARE_LHASH_OF(SSL_SESSION);
687
688struct ssl_ctx_st
689	{
690	const SSL_METHOD *method;
691
692	STACK_OF(SSL_CIPHER) *cipher_list;
693	/* same as above but sorted for lookup */
694	STACK_OF(SSL_CIPHER) *cipher_list_by_id;
695
696	struct x509_store_st /* X509_STORE */ *cert_store;
697	LHASH_OF(SSL_SESSION) *sessions;
698	/* Most session-ids that will be cached, default is
699	 * SSL_SESSION_CACHE_MAX_SIZE_DEFAULT. 0 is unlimited. */
700	unsigned long session_cache_size;
701	struct ssl_session_st *session_cache_head;
702	struct ssl_session_st *session_cache_tail;
703
704	/* This can have one of 2 values, ored together,
705	 * SSL_SESS_CACHE_CLIENT,
706	 * SSL_SESS_CACHE_SERVER,
707	 * Default is SSL_SESSION_CACHE_SERVER, which means only
708	 * SSL_accept which cache SSL_SESSIONS. */
709	int session_cache_mode;
710
711	/* If timeout is not 0, it is the default timeout value set
712	 * when SSL_new() is called.  This has been put in to make
713	 * life easier to set things up */
714	long session_timeout;
715
716	/* If this callback is not null, it will be called each
717	 * time a session id is added to the cache.  If this function
718	 * returns 1, it means that the callback will do a
719	 * SSL_SESSION_free() when it has finished using it.  Otherwise,
720	 * on 0, it means the callback has finished with it.
721	 * If remove_session_cb is not null, it will be called when
722	 * a session-id is removed from the cache.  After the call,
723	 * OpenSSL will SSL_SESSION_free() it. */
724	int (*new_session_cb)(struct ssl_st *ssl,SSL_SESSION *sess);
725	void (*remove_session_cb)(struct ssl_ctx_st *ctx,SSL_SESSION *sess);
726	SSL_SESSION *(*get_session_cb)(struct ssl_st *ssl,
727		unsigned char *data,int len,int *copy);
728
729	struct
730		{
731		int sess_connect;	/* SSL new conn - started */
732		int sess_connect_renegotiate;/* SSL reneg - requested */
733		int sess_connect_good;	/* SSL new conne/reneg - finished */
734		int sess_accept;	/* SSL new accept - started */
735		int sess_accept_renegotiate;/* SSL reneg - requested */
736		int sess_accept_good;	/* SSL accept/reneg - finished */
737		int sess_miss;		/* session lookup misses  */
738		int sess_timeout;	/* reuse attempt on timeouted session */
739		int sess_cache_full;	/* session removed due to full cache */
740		int sess_hit;		/* session reuse actually done */
741		int sess_cb_hit;	/* session-id that was not
742					 * in the cache was
743					 * passed back via the callback.  This
744					 * indicates that the application is
745					 * supplying session-id's from other
746					 * processes - spooky :-) */
747		} stats;
748
749	int references;
750
751	/* if defined, these override the X509_verify_cert() calls */
752	int (*app_verify_callback)(X509_STORE_CTX *, void *);
753	void *app_verify_arg;
754	/* before OpenSSL 0.9.7, 'app_verify_arg' was ignored
755	 * ('app_verify_callback' was called with just one argument) */
756
757	/* Default password callback. */
758	pem_password_cb *default_passwd_callback;
759
760	/* Default password callback user data. */
761	void *default_passwd_callback_userdata;
762
763	/* get client cert callback */
764	int (*client_cert_cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey);
765
766    /* cookie generate callback */
767    int (*app_gen_cookie_cb)(SSL *ssl, unsigned char *cookie,
768        unsigned int *cookie_len);
769
770    /* verify cookie callback */
771    int (*app_verify_cookie_cb)(SSL *ssl, unsigned char *cookie,
772        unsigned int cookie_len);
773
774	CRYPTO_EX_DATA ex_data;
775
776	const EVP_MD *rsa_md5;/* For SSLv2 - name is 'ssl2-md5' */
777	const EVP_MD *md5;	/* For SSLv3/TLSv1 'ssl3-md5' */
778	const EVP_MD *sha1;   /* For SSLv3/TLSv1 'ssl3->sha1' */
779
780	STACK_OF(X509) *extra_certs;
781	STACK_OF(SSL_COMP) *comp_methods; /* stack of SSL_COMP, SSLv3/TLSv1 */
782
783
784	/* Default values used when no per-SSL value is defined follow */
785
786	void (*info_callback)(const SSL *ssl,int type,int val); /* used if SSL's info_callback is NULL */
787
788	/* what we put in client cert requests */
789	STACK_OF(X509_NAME) *client_CA;
790
791
792	/* Default values to use in SSL structures follow (these are copied by SSL_new) */
793
794	unsigned long options;
795	unsigned long mode;
796	long max_cert_list;
797
798	struct cert_st /* CERT */ *cert;
799	int read_ahead;
800
801	/* callback that allows applications to peek at protocol messages */
802	void (*msg_callback)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg);
803	void *msg_callback_arg;
804
805	int verify_mode;
806	unsigned int sid_ctx_length;
807	unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
808	int (*default_verify_callback)(int ok,X509_STORE_CTX *ctx); /* called 'verify_callback' in the SSL */
809
810	/* Default generate session ID callback. */
811	GEN_SESSION_CB generate_session_id;
812
813	X509_VERIFY_PARAM *param;
814
815#if 0
816	int purpose;		/* Purpose setting */
817	int trust;		/* Trust setting */
818#endif
819
820	int quiet_shutdown;
821
822	/* Maximum amount of data to send in one fragment.
823	 * actual record size can be more than this due to
824	 * padding and MAC overheads.
825	 */
826	unsigned int max_send_fragment;
827
828#ifndef OPENSSL_ENGINE
829	/* Engine to pass requests for client certs to
830	 */
831	ENGINE *client_cert_engine;
832#endif
833
834#ifndef OPENSSL_NO_TLSEXT
835	/* TLS extensions servername callback */
836	int (*tlsext_servername_callback)(SSL*, int *, void *);
837	void *tlsext_servername_arg;
838	/* RFC 4507 session ticket keys */
839	unsigned char tlsext_tick_key_name[16];
840	unsigned char tlsext_tick_hmac_key[16];
841	unsigned char tlsext_tick_aes_key[16];
842	/* Callback to support customisation of ticket key setting */
843	int (*tlsext_ticket_key_cb)(SSL *ssl,
844					unsigned char *name, unsigned char *iv,
845					EVP_CIPHER_CTX *ectx,
846 					HMAC_CTX *hctx, int enc);
847
848	/* certificate status request info */
849	/* Callback for status request */
850	int (*tlsext_status_cb)(SSL *ssl, void *arg);
851	void *tlsext_status_arg;
852
853	/* draft-rescorla-tls-opaque-prf-input-00.txt information */
854	int (*tlsext_opaque_prf_input_callback)(SSL *, void *peerinput, size_t len, void *arg);
855	void *tlsext_opaque_prf_input_callback_arg;
856#endif
857
858#ifndef OPENSSL_NO_PSK
859	char *psk_identity_hint;
860	unsigned int (*psk_client_callback)(SSL *ssl, const char *hint, char *identity,
861		unsigned int max_identity_len, unsigned char *psk,
862		unsigned int max_psk_len);
863	unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
864		unsigned char *psk, unsigned int max_psk_len);
865#endif
866
867#ifndef OPENSSL_NO_BUF_FREELISTS
868#define SSL_MAX_BUF_FREELIST_LEN_DEFAULT 32
869	unsigned int freelist_max_len;
870	struct ssl3_buf_freelist_st *wbuf_freelist;
871	struct ssl3_buf_freelist_st *rbuf_freelist;
872#endif
873	};
874
875#define SSL_SESS_CACHE_OFF			0x0000
876#define SSL_SESS_CACHE_CLIENT			0x0001
877#define SSL_SESS_CACHE_SERVER			0x0002
878#define SSL_SESS_CACHE_BOTH	(SSL_SESS_CACHE_CLIENT|SSL_SESS_CACHE_SERVER)
879#define SSL_SESS_CACHE_NO_AUTO_CLEAR		0x0080
880/* enough comments already ... see SSL_CTX_set_session_cache_mode(3) */
881#define SSL_SESS_CACHE_NO_INTERNAL_LOOKUP	0x0100
882#define SSL_SESS_CACHE_NO_INTERNAL_STORE	0x0200
883#define SSL_SESS_CACHE_NO_INTERNAL \
884	(SSL_SESS_CACHE_NO_INTERNAL_LOOKUP|SSL_SESS_CACHE_NO_INTERNAL_STORE)
885
886LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx);
887#define SSL_CTX_sess_number(ctx) \
888	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_NUMBER,0,NULL)
889#define SSL_CTX_sess_connect(ctx) \
890	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT,0,NULL)
891#define SSL_CTX_sess_connect_good(ctx) \
892	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT_GOOD,0,NULL)
893#define SSL_CTX_sess_connect_renegotiate(ctx) \
894	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CONNECT_RENEGOTIATE,0,NULL)
895#define SSL_CTX_sess_accept(ctx) \
896	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT,0,NULL)
897#define SSL_CTX_sess_accept_renegotiate(ctx) \
898	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT_RENEGOTIATE,0,NULL)
899#define SSL_CTX_sess_accept_good(ctx) \
900	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_ACCEPT_GOOD,0,NULL)
901#define SSL_CTX_sess_hits(ctx) \
902	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_HIT,0,NULL)
903#define SSL_CTX_sess_cb_hits(ctx) \
904	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CB_HIT,0,NULL)
905#define SSL_CTX_sess_misses(ctx) \
906	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_MISSES,0,NULL)
907#define SSL_CTX_sess_timeouts(ctx) \
908	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_TIMEOUTS,0,NULL)
909#define SSL_CTX_sess_cache_full(ctx) \
910	SSL_CTX_ctrl(ctx,SSL_CTRL_SESS_CACHE_FULL,0,NULL)
911
912void SSL_CTX_sess_set_new_cb(SSL_CTX *ctx, int (*new_session_cb)(struct ssl_st *ssl,SSL_SESSION *sess));
913int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx))(struct ssl_st *ssl, SSL_SESSION *sess);
914void SSL_CTX_sess_set_remove_cb(SSL_CTX *ctx, void (*remove_session_cb)(struct ssl_ctx_st *ctx,SSL_SESSION *sess));
915void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx))(struct ssl_ctx_st *ctx, SSL_SESSION *sess);
916void 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));
917SSL_SESSION *(*SSL_CTX_sess_get_get_cb(SSL_CTX *ctx))(struct ssl_st *ssl, unsigned char *Data, int len, int *copy);
918void SSL_CTX_set_info_callback(SSL_CTX *ctx, void (*cb)(const SSL *ssl,int type,int val));
919void (*SSL_CTX_get_info_callback(SSL_CTX *ctx))(const SSL *ssl,int type,int val);
920void SSL_CTX_set_client_cert_cb(SSL_CTX *ctx, int (*client_cert_cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey));
921int (*SSL_CTX_get_client_cert_cb(SSL_CTX *ctx))(SSL *ssl, X509 **x509, EVP_PKEY **pkey);
922#ifndef OPENSSL_NO_ENGINE
923int SSL_CTX_set_client_cert_engine(SSL_CTX *ctx, ENGINE *e);
924#endif
925void SSL_CTX_set_cookie_generate_cb(SSL_CTX *ctx, int (*app_gen_cookie_cb)(SSL *ssl, unsigned char *cookie, unsigned int *cookie_len));
926void SSL_CTX_set_cookie_verify_cb(SSL_CTX *ctx, int (*app_verify_cookie_cb)(SSL *ssl, unsigned char *cookie, unsigned int cookie_len));
927
928#ifndef OPENSSL_NO_PSK
929/* the maximum length of the buffer given to callbacks containing the
930 * resulting identity/psk */
931#define PSK_MAX_IDENTITY_LEN 128
932#define PSK_MAX_PSK_LEN 256
933void SSL_CTX_set_psk_client_callback(SSL_CTX *ctx,
934	unsigned int (*psk_client_callback)(SSL *ssl, const char *hint,
935		char *identity, unsigned int max_identity_len, unsigned char *psk,
936		unsigned int max_psk_len));
937void SSL_set_psk_client_callback(SSL *ssl,
938	unsigned int (*psk_client_callback)(SSL *ssl, const char *hint,
939		char *identity, unsigned int max_identity_len, unsigned char *psk,
940		unsigned int max_psk_len));
941void SSL_CTX_set_psk_server_callback(SSL_CTX *ctx,
942	unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
943		unsigned char *psk, unsigned int max_psk_len));
944void SSL_set_psk_server_callback(SSL *ssl,
945	unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
946		unsigned char *psk, unsigned int max_psk_len));
947int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint);
948int SSL_use_psk_identity_hint(SSL *s, const char *identity_hint);
949const char *SSL_get_psk_identity_hint(const SSL *s);
950const char *SSL_get_psk_identity(const SSL *s);
951#endif
952
953#define SSL_NOTHING	1
954#define SSL_WRITING	2
955#define SSL_READING	3
956#define SSL_X509_LOOKUP	4
957
958/* These will only be used when doing non-blocking IO */
959#define SSL_want_nothing(s)	(SSL_want(s) == SSL_NOTHING)
960#define SSL_want_read(s)	(SSL_want(s) == SSL_READING)
961#define SSL_want_write(s)	(SSL_want(s) == SSL_WRITING)
962#define SSL_want_x509_lookup(s)	(SSL_want(s) == SSL_X509_LOOKUP)
963
964#define SSL_MAC_FLAG_READ_MAC_STREAM 1
965#define SSL_MAC_FLAG_WRITE_MAC_STREAM 2
966
967struct ssl_st
968	{
969	/* protocol version
970	 * (one of SSL2_VERSION, SSL3_VERSION, TLS1_VERSION, DTLS1_VERSION)
971	 */
972	int version;
973	int type; /* SSL_ST_CONNECT or SSL_ST_ACCEPT */
974
975	const SSL_METHOD *method; /* SSLv3 */
976
977	/* There are 2 BIO's even though they are normally both the
978	 * same.  This is so data can be read and written to different
979	 * handlers */
980
981#ifndef OPENSSL_NO_BIO
982	BIO *rbio; /* used by SSL_read */
983	BIO *wbio; /* used by SSL_write */
984	BIO *bbio; /* used during session-id reuse to concatenate
985		    * messages */
986#else
987	char *rbio; /* used by SSL_read */
988	char *wbio; /* used by SSL_write */
989	char *bbio;
990#endif
991	/* This holds a variable that indicates what we were doing
992	 * when a 0 or -1 is returned.  This is needed for
993	 * non-blocking IO so we know what request needs re-doing when
994	 * in SSL_accept or SSL_connect */
995	int rwstate;
996
997	/* true when we are actually in SSL_accept() or SSL_connect() */
998	int in_handshake;
999	int (*handshake_func)(SSL *);
1000
1001	/* Imagine that here's a boolean member "init" that is
1002	 * switched as soon as SSL_set_{accept/connect}_state
1003	 * is called for the first time, so that "state" and
1004	 * "handshake_func" are properly initialized.  But as
1005	 * handshake_func is == 0 until then, we use this
1006	 * test instead of an "init" member.
1007	 */
1008
1009	int server;	/* are we the server side? - mostly used by SSL_clear*/
1010
1011	int new_session;/* 1 if we are to use a new session.
1012	                 * 2 if we are a server and are inside a handshake
1013	                 *   (i.e. not just sending a HelloRequest)
1014	                 * NB: For servers, the 'new' session may actually be a previously
1015	                 * cached session or even the previous session unless
1016	                 * SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION is set */
1017	int quiet_shutdown;/* don't send shutdown packets */
1018	int shutdown;	/* we have shut things down, 0x01 sent, 0x02
1019			 * for received */
1020	int state;	/* where we are */
1021	int rstate;	/* where we are when reading */
1022
1023	BUF_MEM *init_buf;	/* buffer used during init */
1024	void *init_msg;   	/* pointer to handshake message body, set by ssl3_get_message() */
1025	int init_num;		/* amount read/written */
1026	int init_off;		/* amount read/written */
1027
1028	/* used internally to point at a raw packet */
1029	unsigned char *packet;
1030	unsigned int packet_length;
1031
1032	struct ssl2_state_st *s2; /* SSLv2 variables */
1033	struct ssl3_state_st *s3; /* SSLv3 variables */
1034	struct dtls1_state_st *d1; /* DTLSv1 variables */
1035
1036	int read_ahead;		/* Read as many input bytes as possible
1037	               	 	 * (for non-blocking reads) */
1038
1039	/* callback that allows applications to peek at protocol messages */
1040	void (*msg_callback)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg);
1041	void *msg_callback_arg;
1042
1043	int hit;		/* reusing a previous session */
1044
1045	X509_VERIFY_PARAM *param;
1046
1047#if 0
1048	int purpose;		/* Purpose setting */
1049	int trust;		/* Trust setting */
1050#endif
1051
1052	/* crypto */
1053	STACK_OF(SSL_CIPHER) *cipher_list;
1054	STACK_OF(SSL_CIPHER) *cipher_list_by_id;
1055
1056	/* These are the ones being used, the ones in SSL_SESSION are
1057	 * the ones to be 'copied' into these ones */
1058	int mac_flags;
1059	EVP_CIPHER_CTX *enc_read_ctx;		/* cryptographic state */
1060	EVP_MD_CTX *read_hash;		/* used for mac generation */
1061#ifndef OPENSSL_NO_COMP
1062	COMP_CTX *expand;			/* uncompress */
1063#else
1064	char *expand;
1065#endif
1066
1067	EVP_CIPHER_CTX *enc_write_ctx;		/* cryptographic state */
1068	EVP_MD_CTX *write_hash;		/* used for mac generation */
1069#ifndef OPENSSL_NO_COMP
1070	COMP_CTX *compress;			/* compression */
1071#else
1072	char *compress;
1073#endif
1074
1075	/* session info */
1076
1077	/* client cert? */
1078	/* This is used to hold the server certificate used */
1079	struct cert_st /* CERT */ *cert;
1080
1081	/* the session_id_context is used to ensure sessions are only reused
1082	 * in the appropriate context */
1083	unsigned int sid_ctx_length;
1084	unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
1085
1086	/* This can also be in the session once a session is established */
1087	SSL_SESSION *session;
1088
1089	/* Default generate session ID callback. */
1090	GEN_SESSION_CB generate_session_id;
1091
1092	/* Used in SSL2 and SSL3 */
1093	int verify_mode;	/* 0 don't care about verify failure.
1094				 * 1 fail if verify fails */
1095	int (*verify_callback)(int ok,X509_STORE_CTX *ctx); /* fail if callback returns 0 */
1096
1097	void (*info_callback)(const SSL *ssl,int type,int val); /* optional informational callback */
1098
1099	int error;		/* error bytes to be written */
1100	int error_code;		/* actual code */
1101
1102#ifndef OPENSSL_NO_KRB5
1103	KSSL_CTX *kssl_ctx;     /* Kerberos 5 context */
1104#endif	/* OPENSSL_NO_KRB5 */
1105
1106#ifndef OPENSSL_NO_PSK
1107	unsigned int (*psk_client_callback)(SSL *ssl, const char *hint, char *identity,
1108		unsigned int max_identity_len, unsigned char *psk,
1109		unsigned int max_psk_len);
1110	unsigned int (*psk_server_callback)(SSL *ssl, const char *identity,
1111		unsigned char *psk, unsigned int max_psk_len);
1112#endif
1113
1114	SSL_CTX *ctx;
1115	/* set this flag to 1 and a sleep(1) is put into all SSL_read()
1116	 * and SSL_write() calls, good for nbio debuging :-) */
1117	int debug;
1118
1119	/* extra application data */
1120	long verify_result;
1121	CRYPTO_EX_DATA ex_data;
1122
1123	/* for server side, keep the list of CA_dn we can use */
1124	STACK_OF(X509_NAME) *client_CA;
1125
1126	int references;
1127	unsigned long options; /* protocol behaviour */
1128	unsigned long mode; /* API behaviour */
1129	long max_cert_list;
1130	int first_packet;
1131	int client_version;	/* what was passed, used for
1132				 * SSLv3/TLS rollback check */
1133	unsigned int max_send_fragment;
1134#ifndef OPENSSL_NO_TLSEXT
1135	/* TLS extension debug callback */
1136	void (*tlsext_debug_cb)(SSL *s, int client_server, int type,
1137					unsigned char *data, int len,
1138					void *arg);
1139	void *tlsext_debug_arg;
1140	char *tlsext_hostname;
1141	int servername_done;   /* no further mod of servername
1142	                          0 : call the servername extension callback.
1143	                          1 : prepare 2, allow last ack just after in server callback.
1144	                          2 : don't call servername callback, no ack in server hello
1145	                       */
1146	/* certificate status request info */
1147	/* Status type or -1 if no status type */
1148	int tlsext_status_type;
1149	/* Expect OCSP CertificateStatus message */
1150	int tlsext_status_expected;
1151	/* OCSP status request only */
1152	STACK_OF(OCSP_RESPID) *tlsext_ocsp_ids;
1153	X509_EXTENSIONS *tlsext_ocsp_exts;
1154	/* OCSP response received or to be sent */
1155	unsigned char *tlsext_ocsp_resp;
1156	int tlsext_ocsp_resplen;
1157
1158	/* RFC4507 session ticket expected to be received or sent */
1159	int tlsext_ticket_expected;
1160#ifndef OPENSSL_NO_EC
1161	size_t tlsext_ecpointformatlist_length;
1162	unsigned char *tlsext_ecpointformatlist; /* our list */
1163	size_t tlsext_ellipticcurvelist_length;
1164	unsigned char *tlsext_ellipticcurvelist; /* our list */
1165#endif /* OPENSSL_NO_EC */
1166
1167	/* draft-rescorla-tls-opaque-prf-input-00.txt information to be used for handshakes */
1168	void *tlsext_opaque_prf_input;
1169	size_t tlsext_opaque_prf_input_len;
1170
1171	/* TLS Session Ticket extension override */
1172	TLS_SESSION_TICKET_EXT *tlsext_session_ticket;
1173
1174	/* TLS Session Ticket extension callback */
1175	tls_session_ticket_ext_cb_fn tls_session_ticket_ext_cb;
1176	void *tls_session_ticket_ext_cb_arg;
1177
1178	/* TLS pre-shared secret session resumption */
1179	tls_session_secret_cb_fn tls_session_secret_cb;
1180	void *tls_session_secret_cb_arg;
1181
1182	SSL_CTX * initial_ctx; /* initial ctx, used to store sessions */
1183#define session_ctx initial_ctx
1184#else
1185#define session_ctx ctx
1186#endif /* OPENSSL_NO_TLSEXT */
1187	};
1188
1189#ifdef __cplusplus
1190}
1191#endif
1192
1193#include <openssl/ssl2.h>
1194#include <openssl/ssl3.h>
1195#include <openssl/tls1.h> /* This is mostly sslv3 with a few tweaks */
1196#include <openssl/dtls1.h> /* Datagram TLS */
1197#include <openssl/ssl23.h>
1198
1199#ifdef  __cplusplus
1200extern "C" {
1201#endif
1202
1203/* compatibility */
1204#define SSL_set_app_data(s,arg)		(SSL_set_ex_data(s,0,(char *)arg))
1205#define SSL_get_app_data(s)		(SSL_get_ex_data(s,0))
1206#define SSL_SESSION_set_app_data(s,a)	(SSL_SESSION_set_ex_data(s,0,(char *)a))
1207#define SSL_SESSION_get_app_data(s)	(SSL_SESSION_get_ex_data(s,0))
1208#define SSL_CTX_get_app_data(ctx)	(SSL_CTX_get_ex_data(ctx,0))
1209#define SSL_CTX_set_app_data(ctx,arg)	(SSL_CTX_set_ex_data(ctx,0,(char *)arg))
1210
1211/* The following are the possible values for ssl->state are are
1212 * used to indicate where we are up to in the SSL connection establishment.
1213 * The macros that follow are about the only things you should need to use
1214 * and even then, only when using non-blocking IO.
1215 * It can also be useful to work out where you were when the connection
1216 * failed */
1217
1218#define SSL_ST_CONNECT			0x1000
1219#define SSL_ST_ACCEPT			0x2000
1220#define SSL_ST_MASK			0x0FFF
1221#define SSL_ST_INIT			(SSL_ST_CONNECT|SSL_ST_ACCEPT)
1222#define SSL_ST_BEFORE			0x4000
1223#define SSL_ST_OK			0x03
1224#define SSL_ST_RENEGOTIATE		(0x04|SSL_ST_INIT)
1225
1226#define SSL_CB_LOOP			0x01
1227#define SSL_CB_EXIT			0x02
1228#define SSL_CB_READ			0x04
1229#define SSL_CB_WRITE			0x08
1230#define SSL_CB_ALERT			0x4000 /* used in callback */
1231#define SSL_CB_READ_ALERT		(SSL_CB_ALERT|SSL_CB_READ)
1232#define SSL_CB_WRITE_ALERT		(SSL_CB_ALERT|SSL_CB_WRITE)
1233#define SSL_CB_ACCEPT_LOOP		(SSL_ST_ACCEPT|SSL_CB_LOOP)
1234#define SSL_CB_ACCEPT_EXIT		(SSL_ST_ACCEPT|SSL_CB_EXIT)
1235#define SSL_CB_CONNECT_LOOP		(SSL_ST_CONNECT|SSL_CB_LOOP)
1236#define SSL_CB_CONNECT_EXIT		(SSL_ST_CONNECT|SSL_CB_EXIT)
1237#define SSL_CB_HANDSHAKE_START		0x10
1238#define SSL_CB_HANDSHAKE_DONE		0x20
1239
1240/* Is the SSL_connection established? */
1241#define SSL_get_state(a)		SSL_state(a)
1242#define SSL_is_init_finished(a)		(SSL_state(a) == SSL_ST_OK)
1243#define SSL_in_init(a)			(SSL_state(a)&SSL_ST_INIT)
1244#define SSL_in_before(a)		(SSL_state(a)&SSL_ST_BEFORE)
1245#define SSL_in_connect_init(a)		(SSL_state(a)&SSL_ST_CONNECT)
1246#define SSL_in_accept_init(a)		(SSL_state(a)&SSL_ST_ACCEPT)
1247
1248/* The following 2 states are kept in ssl->rstate when reads fail,
1249 * you should not need these */
1250#define SSL_ST_READ_HEADER			0xF0
1251#define SSL_ST_READ_BODY			0xF1
1252#define SSL_ST_READ_DONE			0xF2
1253
1254/* Obtain latest Finished message
1255 *   -- that we sent (SSL_get_finished)
1256 *   -- that we expected from peer (SSL_get_peer_finished).
1257 * Returns length (0 == no Finished so far), copies up to 'count' bytes. */
1258size_t SSL_get_finished(const SSL *s, void *buf, size_t count);
1259size_t SSL_get_peer_finished(const SSL *s, void *buf, size_t count);
1260
1261/* use either SSL_VERIFY_NONE or SSL_VERIFY_PEER, the last 2 options
1262 * are 'ored' with SSL_VERIFY_PEER if they are desired */
1263#define SSL_VERIFY_NONE			0x00
1264#define SSL_VERIFY_PEER			0x01
1265#define SSL_VERIFY_FAIL_IF_NO_PEER_CERT	0x02
1266#define SSL_VERIFY_CLIENT_ONCE		0x04
1267
1268#define OpenSSL_add_ssl_algorithms()	SSL_library_init()
1269#define SSLeay_add_ssl_algorithms()	SSL_library_init()
1270
1271/* this is for backward compatibility */
1272#if 0 /* NEW_SSLEAY */
1273#define SSL_CTX_set_default_verify(a,b,c) SSL_CTX_set_verify(a,b,c)
1274#define SSL_set_pref_cipher(c,n)	SSL_set_cipher_list(c,n)
1275#define SSL_add_session(a,b)            SSL_CTX_add_session((a),(b))
1276#define SSL_remove_session(a,b)		SSL_CTX_remove_session((a),(b))
1277#define SSL_flush_sessions(a,b)		SSL_CTX_flush_sessions((a),(b))
1278#endif
1279/* More backward compatibility */
1280#define SSL_get_cipher(s) \
1281		SSL_CIPHER_get_name(SSL_get_current_cipher(s))
1282#define SSL_get_cipher_bits(s,np) \
1283		SSL_CIPHER_get_bits(SSL_get_current_cipher(s),np)
1284#define SSL_get_cipher_version(s) \
1285		SSL_CIPHER_get_version(SSL_get_current_cipher(s))
1286#define SSL_get_cipher_name(s) \
1287		SSL_CIPHER_get_name(SSL_get_current_cipher(s))
1288#define SSL_get_time(a)		SSL_SESSION_get_time(a)
1289#define SSL_set_time(a,b)	SSL_SESSION_set_time((a),(b))
1290#define SSL_get_timeout(a)	SSL_SESSION_get_timeout(a)
1291#define SSL_set_timeout(a,b)	SSL_SESSION_set_timeout((a),(b))
1292
1293#define d2i_SSL_SESSION_bio(bp,s_id) ASN1_d2i_bio_of(SSL_SESSION,SSL_SESSION_new,d2i_SSL_SESSION,bp,s_id)
1294#define i2d_SSL_SESSION_bio(bp,s_id) ASN1_i2d_bio_of(SSL_SESSION,i2d_SSL_SESSION,bp,s_id)
1295
1296DECLARE_PEM_rw(SSL_SESSION, SSL_SESSION)
1297
1298#define SSL_AD_REASON_OFFSET		1000 /* offset to get SSL_R_... value from SSL_AD_... */
1299
1300/* These alert types are for SSLv3 and TLSv1 */
1301#define SSL_AD_CLOSE_NOTIFY		SSL3_AD_CLOSE_NOTIFY
1302#define SSL_AD_UNEXPECTED_MESSAGE	SSL3_AD_UNEXPECTED_MESSAGE /* fatal */
1303#define SSL_AD_BAD_RECORD_MAC		SSL3_AD_BAD_RECORD_MAC     /* fatal */
1304#define SSL_AD_DECRYPTION_FAILED	TLS1_AD_DECRYPTION_FAILED
1305#define SSL_AD_RECORD_OVERFLOW		TLS1_AD_RECORD_OVERFLOW
1306#define SSL_AD_DECOMPRESSION_FAILURE	SSL3_AD_DECOMPRESSION_FAILURE/* fatal */
1307#define SSL_AD_HANDSHAKE_FAILURE	SSL3_AD_HANDSHAKE_FAILURE/* fatal */
1308#define SSL_AD_NO_CERTIFICATE		SSL3_AD_NO_CERTIFICATE /* Not for TLS */
1309#define SSL_AD_BAD_CERTIFICATE		SSL3_AD_BAD_CERTIFICATE
1310#define SSL_AD_UNSUPPORTED_CERTIFICATE	SSL3_AD_UNSUPPORTED_CERTIFICATE
1311#define SSL_AD_CERTIFICATE_REVOKED	SSL3_AD_CERTIFICATE_REVOKED
1312#define SSL_AD_CERTIFICATE_EXPIRED	SSL3_AD_CERTIFICATE_EXPIRED
1313#define SSL_AD_CERTIFICATE_UNKNOWN	SSL3_AD_CERTIFICATE_UNKNOWN
1314#define SSL_AD_ILLEGAL_PARAMETER	SSL3_AD_ILLEGAL_PARAMETER   /* fatal */
1315#define SSL_AD_UNKNOWN_CA		TLS1_AD_UNKNOWN_CA	/* fatal */
1316#define SSL_AD_ACCESS_DENIED		TLS1_AD_ACCESS_DENIED	/* fatal */
1317#define SSL_AD_DECODE_ERROR		TLS1_AD_DECODE_ERROR	/* fatal */
1318#define SSL_AD_DECRYPT_ERROR		TLS1_AD_DECRYPT_ERROR
1319#define SSL_AD_EXPORT_RESTRICTION	TLS1_AD_EXPORT_RESTRICTION/* fatal */
1320#define SSL_AD_PROTOCOL_VERSION		TLS1_AD_PROTOCOL_VERSION /* fatal */
1321#define SSL_AD_INSUFFICIENT_SECURITY	TLS1_AD_INSUFFICIENT_SECURITY/* fatal */
1322#define SSL_AD_INTERNAL_ERROR		TLS1_AD_INTERNAL_ERROR	/* fatal */
1323#define SSL_AD_USER_CANCELLED		TLS1_AD_USER_CANCELLED
1324#define SSL_AD_NO_RENEGOTIATION		TLS1_AD_NO_RENEGOTIATION
1325#define SSL_AD_UNSUPPORTED_EXTENSION	TLS1_AD_UNSUPPORTED_EXTENSION
1326#define SSL_AD_CERTIFICATE_UNOBTAINABLE TLS1_AD_CERTIFICATE_UNOBTAINABLE
1327#define SSL_AD_UNRECOGNIZED_NAME	TLS1_AD_UNRECOGNIZED_NAME
1328#define SSL_AD_BAD_CERTIFICATE_STATUS_RESPONSE TLS1_AD_BAD_CERTIFICATE_STATUS_RESPONSE
1329#define SSL_AD_BAD_CERTIFICATE_HASH_VALUE TLS1_AD_BAD_CERTIFICATE_HASH_VALUE
1330#define SSL_AD_UNKNOWN_PSK_IDENTITY     TLS1_AD_UNKNOWN_PSK_IDENTITY /* fatal */
1331
1332#define SSL_ERROR_NONE			0
1333#define SSL_ERROR_SSL			1
1334#define SSL_ERROR_WANT_READ		2
1335#define SSL_ERROR_WANT_WRITE		3
1336#define SSL_ERROR_WANT_X509_LOOKUP	4
1337#define SSL_ERROR_SYSCALL		5 /* look at error stack/return value/errno */
1338#define SSL_ERROR_ZERO_RETURN		6
1339#define SSL_ERROR_WANT_CONNECT		7
1340#define SSL_ERROR_WANT_ACCEPT		8
1341
1342#define SSL_CTRL_NEED_TMP_RSA			1
1343#define SSL_CTRL_SET_TMP_RSA			2
1344#define SSL_CTRL_SET_TMP_DH			3
1345#define SSL_CTRL_SET_TMP_ECDH			4
1346#define SSL_CTRL_SET_TMP_RSA_CB			5
1347#define SSL_CTRL_SET_TMP_DH_CB			6
1348#define SSL_CTRL_SET_TMP_ECDH_CB		7
1349
1350#define SSL_CTRL_GET_SESSION_REUSED		8
1351#define SSL_CTRL_GET_CLIENT_CERT_REQUEST	9
1352#define SSL_CTRL_GET_NUM_RENEGOTIATIONS		10
1353#define SSL_CTRL_CLEAR_NUM_RENEGOTIATIONS	11
1354#define SSL_CTRL_GET_TOTAL_RENEGOTIATIONS	12
1355#define SSL_CTRL_GET_FLAGS			13
1356#define SSL_CTRL_EXTRA_CHAIN_CERT		14
1357
1358#define SSL_CTRL_SET_MSG_CALLBACK               15
1359#define SSL_CTRL_SET_MSG_CALLBACK_ARG           16
1360
1361/* only applies to datagram connections */
1362#define SSL_CTRL_SET_MTU                17
1363/* Stats */
1364#define SSL_CTRL_SESS_NUMBER			20
1365#define SSL_CTRL_SESS_CONNECT			21
1366#define SSL_CTRL_SESS_CONNECT_GOOD		22
1367#define SSL_CTRL_SESS_CONNECT_RENEGOTIATE	23
1368#define SSL_CTRL_SESS_ACCEPT			24
1369#define SSL_CTRL_SESS_ACCEPT_GOOD		25
1370#define SSL_CTRL_SESS_ACCEPT_RENEGOTIATE	26
1371#define SSL_CTRL_SESS_HIT			27
1372#define SSL_CTRL_SESS_CB_HIT			28
1373#define SSL_CTRL_SESS_MISSES			29
1374#define SSL_CTRL_SESS_TIMEOUTS			30
1375#define SSL_CTRL_SESS_CACHE_FULL		31
1376#define SSL_CTRL_OPTIONS			32
1377#define SSL_CTRL_MODE				33
1378
1379#define SSL_CTRL_GET_READ_AHEAD			40
1380#define SSL_CTRL_SET_READ_AHEAD			41
1381#define SSL_CTRL_SET_SESS_CACHE_SIZE		42
1382#define SSL_CTRL_GET_SESS_CACHE_SIZE		43
1383#define SSL_CTRL_SET_SESS_CACHE_MODE		44
1384#define SSL_CTRL_GET_SESS_CACHE_MODE		45
1385
1386#define SSL_CTRL_GET_MAX_CERT_LIST		50
1387#define SSL_CTRL_SET_MAX_CERT_LIST		51
1388
1389#define SSL_CTRL_SET_MAX_SEND_FRAGMENT		52
1390
1391/* see tls1.h for macros based on these */
1392#ifndef OPENSSL_NO_TLSEXT
1393#define SSL_CTRL_SET_TLSEXT_SERVERNAME_CB	53
1394#define SSL_CTRL_SET_TLSEXT_SERVERNAME_ARG	54
1395#define SSL_CTRL_SET_TLSEXT_HOSTNAME		55
1396#define SSL_CTRL_SET_TLSEXT_DEBUG_CB		56
1397#define SSL_CTRL_SET_TLSEXT_DEBUG_ARG		57
1398#define SSL_CTRL_GET_TLSEXT_TICKET_KEYS		58
1399#define SSL_CTRL_SET_TLSEXT_TICKET_KEYS		59
1400#define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT	60
1401#define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT_CB	61
1402#define SSL_CTRL_SET_TLSEXT_OPAQUE_PRF_INPUT_CB_ARG 62
1403#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB	63
1404#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_CB_ARG	64
1405#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_TYPE	65
1406#define SSL_CTRL_GET_TLSEXT_STATUS_REQ_EXTS	66
1407#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_EXTS	67
1408#define SSL_CTRL_GET_TLSEXT_STATUS_REQ_IDS	68
1409#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_IDS	69
1410#define SSL_CTRL_GET_TLSEXT_STATUS_REQ_OCSP_RESP	70
1411#define SSL_CTRL_SET_TLSEXT_STATUS_REQ_OCSP_RESP	71
1412
1413#define SSL_CTRL_SET_TLSEXT_TICKET_KEY_CB	72
1414#endif
1415
1416#define DTLS_CTRL_GET_TIMEOUT		73
1417#define DTLS_CTRL_HANDLE_TIMEOUT	74
1418#define DTLS_CTRL_LISTEN			75
1419
1420#define SSL_CTRL_GET_RI_SUPPORT			76
1421#define SSL_CTRL_CLEAR_OPTIONS			77
1422#define SSL_CTRL_CLEAR_MODE			78
1423
1424#define DTLSv1_get_timeout(ssl, arg) \
1425	SSL_ctrl(ssl,DTLS_CTRL_GET_TIMEOUT,0, (void *)arg)
1426#define DTLSv1_handle_timeout(ssl) \
1427	SSL_ctrl(ssl,DTLS_CTRL_HANDLE_TIMEOUT,0, NULL)
1428#define DTLSv1_listen(ssl, peer) \
1429	SSL_ctrl(ssl,DTLS_CTRL_LISTEN,0, (void *)peer)
1430
1431#define SSL_session_reused(ssl) \
1432	SSL_ctrl((ssl),SSL_CTRL_GET_SESSION_REUSED,0,NULL)
1433#define SSL_num_renegotiations(ssl) \
1434	SSL_ctrl((ssl),SSL_CTRL_GET_NUM_RENEGOTIATIONS,0,NULL)
1435#define SSL_clear_num_renegotiations(ssl) \
1436	SSL_ctrl((ssl),SSL_CTRL_CLEAR_NUM_RENEGOTIATIONS,0,NULL)
1437#define SSL_total_renegotiations(ssl) \
1438	SSL_ctrl((ssl),SSL_CTRL_GET_TOTAL_RENEGOTIATIONS,0,NULL)
1439
1440#define SSL_CTX_need_tmp_RSA(ctx) \
1441	SSL_CTX_ctrl(ctx,SSL_CTRL_NEED_TMP_RSA,0,NULL)
1442#define SSL_CTX_set_tmp_rsa(ctx,rsa) \
1443	SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_RSA,0,(char *)rsa)
1444#define SSL_CTX_set_tmp_dh(ctx,dh) \
1445	SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_DH,0,(char *)dh)
1446#define SSL_CTX_set_tmp_ecdh(ctx,ecdh) \
1447	SSL_CTX_ctrl(ctx,SSL_CTRL_SET_TMP_ECDH,0,(char *)ecdh)
1448
1449#define SSL_need_tmp_RSA(ssl) \
1450	SSL_ctrl(ssl,SSL_CTRL_NEED_TMP_RSA,0,NULL)
1451#define SSL_set_tmp_rsa(ssl,rsa) \
1452	SSL_ctrl(ssl,SSL_CTRL_SET_TMP_RSA,0,(char *)rsa)
1453#define SSL_set_tmp_dh(ssl,dh) \
1454	SSL_ctrl(ssl,SSL_CTRL_SET_TMP_DH,0,(char *)dh)
1455#define SSL_set_tmp_ecdh(ssl,ecdh) \
1456	SSL_ctrl(ssl,SSL_CTRL_SET_TMP_ECDH,0,(char *)ecdh)
1457
1458#define SSL_CTX_add_extra_chain_cert(ctx,x509) \
1459	SSL_CTX_ctrl(ctx,SSL_CTRL_EXTRA_CHAIN_CERT,0,(char *)x509)
1460
1461#ifndef OPENSSL_NO_BIO
1462BIO_METHOD *BIO_f_ssl(void);
1463BIO *BIO_new_ssl(SSL_CTX *ctx,int client);
1464BIO *BIO_new_ssl_connect(SSL_CTX *ctx);
1465BIO *BIO_new_buffer_ssl_connect(SSL_CTX *ctx);
1466int BIO_ssl_copy_session_id(BIO *to,BIO *from);
1467void BIO_ssl_shutdown(BIO *ssl_bio);
1468
1469#endif
1470
1471int	SSL_CTX_set_cipher_list(SSL_CTX *,const char *str);
1472SSL_CTX *SSL_CTX_new(const SSL_METHOD *meth);
1473void	SSL_CTX_free(SSL_CTX *);
1474long SSL_CTX_set_timeout(SSL_CTX *ctx,long t);
1475long SSL_CTX_get_timeout(const SSL_CTX *ctx);
1476X509_STORE *SSL_CTX_get_cert_store(const SSL_CTX *);
1477void SSL_CTX_set_cert_store(SSL_CTX *,X509_STORE *);
1478int SSL_want(const SSL *s);
1479int	SSL_clear(SSL *s);
1480
1481void	SSL_CTX_flush_sessions(SSL_CTX *ctx,long tm);
1482
1483const SSL_CIPHER *SSL_get_current_cipher(const SSL *s);
1484int	SSL_CIPHER_get_bits(const SSL_CIPHER *c,int *alg_bits);
1485char *	SSL_CIPHER_get_version(const SSL_CIPHER *c);
1486const char *	SSL_CIPHER_get_name(const SSL_CIPHER *c);
1487
1488int	SSL_get_fd(const SSL *s);
1489int	SSL_get_rfd(const SSL *s);
1490int	SSL_get_wfd(const SSL *s);
1491const char  * SSL_get_cipher_list(const SSL *s,int n);
1492char *	SSL_get_shared_ciphers(const SSL *s, char *buf, int len);
1493int	SSL_get_read_ahead(const SSL * s);
1494int	SSL_pending(const SSL *s);
1495#ifndef OPENSSL_NO_SOCK
1496int	SSL_set_fd(SSL *s, int fd);
1497int	SSL_set_rfd(SSL *s, int fd);
1498int	SSL_set_wfd(SSL *s, int fd);
1499#endif
1500#ifndef OPENSSL_NO_BIO
1501void	SSL_set_bio(SSL *s, BIO *rbio,BIO *wbio);
1502BIO *	SSL_get_rbio(const SSL *s);
1503BIO *	SSL_get_wbio(const SSL *s);
1504#endif
1505int	SSL_set_cipher_list(SSL *s, const char *str);
1506void	SSL_set_read_ahead(SSL *s, int yes);
1507int	SSL_get_verify_mode(const SSL *s);
1508int	SSL_get_verify_depth(const SSL *s);
1509int	(*SSL_get_verify_callback(const SSL *s))(int,X509_STORE_CTX *);
1510void	SSL_set_verify(SSL *s, int mode,
1511		       int (*callback)(int ok,X509_STORE_CTX *ctx));
1512void	SSL_set_verify_depth(SSL *s, int depth);
1513#ifndef OPENSSL_NO_RSA
1514int	SSL_use_RSAPrivateKey(SSL *ssl, RSA *rsa);
1515#endif
1516int	SSL_use_RSAPrivateKey_ASN1(SSL *ssl, unsigned char *d, long len);
1517int	SSL_use_PrivateKey(SSL *ssl, EVP_PKEY *pkey);
1518int	SSL_use_PrivateKey_ASN1(int pk,SSL *ssl, const unsigned char *d, long len);
1519int	SSL_use_certificate(SSL *ssl, X509 *x);
1520int	SSL_use_certificate_ASN1(SSL *ssl, const unsigned char *d, int len);
1521
1522#ifndef OPENSSL_NO_STDIO
1523int	SSL_use_RSAPrivateKey_file(SSL *ssl, const char *file, int type);
1524int	SSL_use_PrivateKey_file(SSL *ssl, const char *file, int type);
1525int	SSL_use_certificate_file(SSL *ssl, const char *file, int type);
1526int	SSL_CTX_use_RSAPrivateKey_file(SSL_CTX *ctx, const char *file, int type);
1527int	SSL_CTX_use_PrivateKey_file(SSL_CTX *ctx, const char *file, int type);
1528int	SSL_CTX_use_certificate_file(SSL_CTX *ctx, const char *file, int type);
1529int	SSL_CTX_use_certificate_chain_file(SSL_CTX *ctx, const char *file); /* PEM type */
1530STACK_OF(X509_NAME) *SSL_load_client_CA_file(const char *file);
1531int	SSL_add_file_cert_subjects_to_stack(STACK_OF(X509_NAME) *stackCAs,
1532					    const char *file);
1533#ifndef OPENSSL_SYS_VMS
1534#ifndef OPENSSL_SYS_MACINTOSH_CLASSIC /* XXXXX: Better scheme needed! [was: #ifndef MAC_OS_pre_X] */
1535int	SSL_add_dir_cert_subjects_to_stack(STACK_OF(X509_NAME) *stackCAs,
1536					   const char *dir);
1537#endif
1538#endif
1539
1540#endif
1541
1542void	SSL_load_error_strings(void );
1543const char *SSL_state_string(const SSL *s);
1544const char *SSL_rstate_string(const SSL *s);
1545const char *SSL_state_string_long(const SSL *s);
1546const char *SSL_rstate_string_long(const SSL *s);
1547long	SSL_SESSION_get_time(const SSL_SESSION *s);
1548long	SSL_SESSION_set_time(SSL_SESSION *s, long t);
1549long	SSL_SESSION_get_timeout(const SSL_SESSION *s);
1550long	SSL_SESSION_set_timeout(SSL_SESSION *s, long t);
1551void	SSL_copy_session_id(SSL *to,const SSL *from);
1552
1553SSL_SESSION *SSL_SESSION_new(void);
1554const unsigned char *SSL_SESSION_get_id(const SSL_SESSION *s,
1555					unsigned int *len);
1556#ifndef OPENSSL_NO_FP_API
1557int	SSL_SESSION_print_fp(FILE *fp,const SSL_SESSION *ses);
1558#endif
1559#ifndef OPENSSL_NO_BIO
1560int	SSL_SESSION_print(BIO *fp,const SSL_SESSION *ses);
1561#endif
1562void	SSL_SESSION_free(SSL_SESSION *ses);
1563int	i2d_SSL_SESSION(SSL_SESSION *in,unsigned char **pp);
1564int	SSL_set_session(SSL *to, SSL_SESSION *session);
1565int	SSL_CTX_add_session(SSL_CTX *s, SSL_SESSION *c);
1566int	SSL_CTX_remove_session(SSL_CTX *,SSL_SESSION *c);
1567int	SSL_CTX_set_generate_session_id(SSL_CTX *, GEN_SESSION_CB);
1568int	SSL_set_generate_session_id(SSL *, GEN_SESSION_CB);
1569int	SSL_has_matching_session_id(const SSL *ssl, const unsigned char *id,
1570					unsigned int id_len);
1571SSL_SESSION *d2i_SSL_SESSION(SSL_SESSION **a,const unsigned char **pp,
1572			     long length);
1573
1574#ifdef HEADER_X509_H
1575X509 *	SSL_get_peer_certificate(const SSL *s);
1576#endif
1577
1578STACK_OF(X509) *SSL_get_peer_cert_chain(const SSL *s);
1579
1580int SSL_CTX_get_verify_mode(const SSL_CTX *ctx);
1581int SSL_CTX_get_verify_depth(const SSL_CTX *ctx);
1582int (*SSL_CTX_get_verify_callback(const SSL_CTX *ctx))(int,X509_STORE_CTX *);
1583void SSL_CTX_set_verify(SSL_CTX *ctx,int mode,
1584			int (*callback)(int, X509_STORE_CTX *));
1585void SSL_CTX_set_verify_depth(SSL_CTX *ctx,int depth);
1586void SSL_CTX_set_cert_verify_callback(SSL_CTX *ctx, int (*cb)(X509_STORE_CTX *,void *), void *arg);
1587#ifndef OPENSSL_NO_RSA
1588int SSL_CTX_use_RSAPrivateKey(SSL_CTX *ctx, RSA *rsa);
1589#endif
1590int SSL_CTX_use_RSAPrivateKey_ASN1(SSL_CTX *ctx, const unsigned char *d, long len);
1591int SSL_CTX_use_PrivateKey(SSL_CTX *ctx, EVP_PKEY *pkey);
1592int SSL_CTX_use_PrivateKey_ASN1(int pk,SSL_CTX *ctx,
1593	const unsigned char *d, long len);
1594int SSL_CTX_use_certificate(SSL_CTX *ctx, X509 *x);
1595int SSL_CTX_use_certificate_ASN1(SSL_CTX *ctx, int len, const unsigned char *d);
1596
1597void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, pem_password_cb *cb);
1598void SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx, void *u);
1599
1600int SSL_CTX_check_private_key(const SSL_CTX *ctx);
1601int SSL_check_private_key(const SSL *ctx);
1602
1603int	SSL_CTX_set_session_id_context(SSL_CTX *ctx,const unsigned char *sid_ctx,
1604				       unsigned int sid_ctx_len);
1605
1606SSL *	SSL_new(SSL_CTX *ctx);
1607int	SSL_set_session_id_context(SSL *ssl,const unsigned char *sid_ctx,
1608				   unsigned int sid_ctx_len);
1609
1610int SSL_CTX_set_purpose(SSL_CTX *s, int purpose);
1611int SSL_set_purpose(SSL *s, int purpose);
1612int SSL_CTX_set_trust(SSL_CTX *s, int trust);
1613int SSL_set_trust(SSL *s, int trust);
1614
1615int SSL_CTX_set1_param(SSL_CTX *ctx, X509_VERIFY_PARAM *vpm);
1616int SSL_set1_param(SSL *ssl, X509_VERIFY_PARAM *vpm);
1617
1618void	SSL_free(SSL *ssl);
1619int 	SSL_accept(SSL *ssl);
1620int 	SSL_connect(SSL *ssl);
1621int 	SSL_read(SSL *ssl,void *buf,int num);
1622int 	SSL_peek(SSL *ssl,void *buf,int num);
1623int 	SSL_write(SSL *ssl,const void *buf,int num);
1624long	SSL_ctrl(SSL *ssl,int cmd, long larg, void *parg);
1625long	SSL_callback_ctrl(SSL *, int, void (*)(void));
1626long	SSL_CTX_ctrl(SSL_CTX *ctx,int cmd, long larg, void *parg);
1627long	SSL_CTX_callback_ctrl(SSL_CTX *, int, void (*)(void));
1628
1629int	SSL_get_error(const SSL *s,int ret_code);
1630const char *SSL_get_version(const SSL *s);
1631
1632/* This sets the 'default' SSL version that SSL_new() will create */
1633int SSL_CTX_set_ssl_version(SSL_CTX *ctx, const SSL_METHOD *meth);
1634
1635#ifndef OPENSSL_NO_SSL2
1636const SSL_METHOD *SSLv2_method(void);		/* SSLv2 */
1637const SSL_METHOD *SSLv2_server_method(void);	/* SSLv2 */
1638const SSL_METHOD *SSLv2_client_method(void);	/* SSLv2 */
1639#endif
1640
1641const SSL_METHOD *SSLv3_method(void);		/* SSLv3 */
1642const SSL_METHOD *SSLv3_server_method(void);	/* SSLv3 */
1643const SSL_METHOD *SSLv3_client_method(void);	/* SSLv3 */
1644
1645const SSL_METHOD *SSLv23_method(void);	/* SSLv3 but can rollback to v2 */
1646const SSL_METHOD *SSLv23_server_method(void);	/* SSLv3 but can rollback to v2 */
1647const SSL_METHOD *SSLv23_client_method(void);	/* SSLv3 but can rollback to v2 */
1648
1649const SSL_METHOD *TLSv1_method(void);		/* TLSv1.0 */
1650const SSL_METHOD *TLSv1_server_method(void);	/* TLSv1.0 */
1651const SSL_METHOD *TLSv1_client_method(void);	/* TLSv1.0 */
1652
1653const SSL_METHOD *DTLSv1_method(void);		/* DTLSv1.0 */
1654const SSL_METHOD *DTLSv1_server_method(void);	/* DTLSv1.0 */
1655const SSL_METHOD *DTLSv1_client_method(void);	/* DTLSv1.0 */
1656
1657STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *s);
1658
1659int SSL_do_handshake(SSL *s);
1660int SSL_renegotiate(SSL *s);
1661int SSL_renegotiate_pending(SSL *s);
1662int SSL_shutdown(SSL *s);
1663
1664const SSL_METHOD *SSL_get_ssl_method(SSL *s);
1665int SSL_set_ssl_method(SSL *s, const SSL_METHOD *method);
1666const char *SSL_alert_type_string_long(int value);
1667const char *SSL_alert_type_string(int value);
1668const char *SSL_alert_desc_string_long(int value);
1669const char *SSL_alert_desc_string(int value);
1670
1671void SSL_set_client_CA_list(SSL *s, STACK_OF(X509_NAME) *name_list);
1672void SSL_CTX_set_client_CA_list(SSL_CTX *ctx, STACK_OF(X509_NAME) *name_list);
1673STACK_OF(X509_NAME) *SSL_get_client_CA_list(const SSL *s);
1674STACK_OF(X509_NAME) *SSL_CTX_get_client_CA_list(const SSL_CTX *s);
1675int SSL_add_client_CA(SSL *ssl,X509 *x);
1676int SSL_CTX_add_client_CA(SSL_CTX *ctx,X509 *x);
1677
1678void SSL_set_connect_state(SSL *s);
1679void SSL_set_accept_state(SSL *s);
1680
1681long SSL_get_default_timeout(const SSL *s);
1682
1683int SSL_library_init(void );
1684
1685char *SSL_CIPHER_description(const SSL_CIPHER *,char *buf,int size);
1686STACK_OF(X509_NAME) *SSL_dup_CA_list(STACK_OF(X509_NAME) *sk);
1687
1688SSL *SSL_dup(SSL *ssl);
1689
1690X509 *SSL_get_certificate(const SSL *ssl);
1691/* EVP_PKEY */ struct evp_pkey_st *SSL_get_privatekey(SSL *ssl);
1692
1693void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx,int mode);
1694int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx);
1695void SSL_set_quiet_shutdown(SSL *ssl,int mode);
1696int SSL_get_quiet_shutdown(const SSL *ssl);
1697void SSL_set_shutdown(SSL *ssl,int mode);
1698int SSL_get_shutdown(const SSL *ssl);
1699int SSL_version(const SSL *ssl);
1700int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx);
1701int SSL_CTX_load_verify_locations(SSL_CTX *ctx, const char *CAfile,
1702	const char *CApath);
1703#define SSL_get0_session SSL_get_session /* just peek at pointer */
1704SSL_SESSION *SSL_get_session(const SSL *ssl);
1705SSL_SESSION *SSL_get1_session(SSL *ssl); /* obtain a reference count */
1706SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl);
1707SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX* ctx);
1708void SSL_set_info_callback(SSL *ssl,
1709			   void (*cb)(const SSL *ssl,int type,int val));
1710void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl,int type,int val);
1711int SSL_state(const SSL *ssl);
1712
1713void SSL_set_verify_result(SSL *ssl,long v);
1714long SSL_get_verify_result(const SSL *ssl);
1715
1716int SSL_set_ex_data(SSL *ssl,int idx,void *data);
1717void *SSL_get_ex_data(const SSL *ssl,int idx);
1718int SSL_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
1719	CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
1720
1721int SSL_SESSION_set_ex_data(SSL_SESSION *ss,int idx,void *data);
1722void *SSL_SESSION_get_ex_data(const SSL_SESSION *ss,int idx);
1723int SSL_SESSION_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
1724	CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
1725
1726int SSL_CTX_set_ex_data(SSL_CTX *ssl,int idx,void *data);
1727void *SSL_CTX_get_ex_data(const SSL_CTX *ssl,int idx);
1728int SSL_CTX_get_ex_new_index(long argl, void *argp, CRYPTO_EX_new *new_func,
1729	CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func);
1730
1731int SSL_get_ex_data_X509_STORE_CTX_idx(void );
1732
1733#define SSL_CTX_sess_set_cache_size(ctx,t) \
1734	SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SESS_CACHE_SIZE,t,NULL)
1735#define SSL_CTX_sess_get_cache_size(ctx) \
1736	SSL_CTX_ctrl(ctx,SSL_CTRL_GET_SESS_CACHE_SIZE,0,NULL)
1737#define SSL_CTX_set_session_cache_mode(ctx,m) \
1738	SSL_CTX_ctrl(ctx,SSL_CTRL_SET_SESS_CACHE_MODE,m,NULL)
1739#define SSL_CTX_get_session_cache_mode(ctx) \
1740	SSL_CTX_ctrl(ctx,SSL_CTRL_GET_SESS_CACHE_MODE,0,NULL)
1741
1742#define SSL_CTX_get_default_read_ahead(ctx) SSL_CTX_get_read_ahead(ctx)
1743#define SSL_CTX_set_default_read_ahead(ctx,m) SSL_CTX_set_read_ahead(ctx,m)
1744#define SSL_CTX_get_read_ahead(ctx) \
1745	SSL_CTX_ctrl(ctx,SSL_CTRL_GET_READ_AHEAD,0,NULL)
1746#define SSL_CTX_set_read_ahead(ctx,m) \
1747	SSL_CTX_ctrl(ctx,SSL_CTRL_SET_READ_AHEAD,m,NULL)
1748#define SSL_CTX_get_max_cert_list(ctx) \
1749	SSL_CTX_ctrl(ctx,SSL_CTRL_GET_MAX_CERT_LIST,0,NULL)
1750#define SSL_CTX_set_max_cert_list(ctx,m) \
1751	SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_CERT_LIST,m,NULL)
1752#define SSL_get_max_cert_list(ssl) \
1753	SSL_ctrl(ssl,SSL_CTRL_GET_MAX_CERT_LIST,0,NULL)
1754#define SSL_set_max_cert_list(ssl,m) \
1755	SSL_ctrl(ssl,SSL_CTRL_SET_MAX_CERT_LIST,m,NULL)
1756
1757#define SSL_CTX_set_max_send_fragment(ctx,m) \
1758	SSL_CTX_ctrl(ctx,SSL_CTRL_SET_MAX_SEND_FRAGMENT,m,NULL)
1759#define SSL_set_max_send_fragment(ssl,m) \
1760	SSL_ctrl(ssl,SSL_CTRL_SET_MAX_SEND_FRAGMENT,m,NULL)
1761
1762     /* NB: the keylength is only applicable when is_export is true */
1763#ifndef OPENSSL_NO_RSA
1764void SSL_CTX_set_tmp_rsa_callback(SSL_CTX *ctx,
1765				  RSA *(*cb)(SSL *ssl,int is_export,
1766					     int keylength));
1767
1768void SSL_set_tmp_rsa_callback(SSL *ssl,
1769				  RSA *(*cb)(SSL *ssl,int is_export,
1770					     int keylength));
1771#endif
1772#ifndef OPENSSL_NO_DH
1773void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
1774				 DH *(*dh)(SSL *ssl,int is_export,
1775					   int keylength));
1776void SSL_set_tmp_dh_callback(SSL *ssl,
1777				 DH *(*dh)(SSL *ssl,int is_export,
1778					   int keylength));
1779#endif
1780#ifndef OPENSSL_NO_ECDH
1781void SSL_CTX_set_tmp_ecdh_callback(SSL_CTX *ctx,
1782				 EC_KEY *(*ecdh)(SSL *ssl,int is_export,
1783					   int keylength));
1784void SSL_set_tmp_ecdh_callback(SSL *ssl,
1785				 EC_KEY *(*ecdh)(SSL *ssl,int is_export,
1786					   int keylength));
1787#endif
1788
1789#ifndef OPENSSL_NO_COMP
1790const COMP_METHOD *SSL_get_current_compression(SSL *s);
1791const COMP_METHOD *SSL_get_current_expansion(SSL *s);
1792const char *SSL_COMP_get_name(const COMP_METHOD *comp);
1793STACK_OF(SSL_COMP) *SSL_COMP_get_compression_methods(void);
1794int SSL_COMP_add_compression_method(int id,COMP_METHOD *cm);
1795#else
1796const void *SSL_get_current_compression(SSL *s);
1797const void *SSL_get_current_expansion(SSL *s);
1798const char *SSL_COMP_get_name(const void *comp);
1799void *SSL_COMP_get_compression_methods(void);
1800int SSL_COMP_add_compression_method(int id,void *cm);
1801#endif
1802
1803/* TLS extensions functions */
1804int SSL_set_session_ticket_ext(SSL *s, void *ext_data, int ext_len);
1805
1806int SSL_set_session_ticket_ext_cb(SSL *s, tls_session_ticket_ext_cb_fn cb,
1807				  void *arg);
1808
1809/* Pre-shared secret session resumption functions */
1810int SSL_set_session_secret_cb(SSL *s, tls_session_secret_cb_fn tls_session_secret_cb, void *arg);
1811
1812/* BEGIN ERROR CODES */
1813/* The following lines are auto generated by the script mkerr.pl. Any changes
1814 * made after this point may be overwritten when the script is next run.
1815 */
1816void ERR_load_SSL_strings(void);
1817
1818/* Error codes for the SSL functions. */
1819
1820/* Function codes. */
1821#define SSL_F_CLIENT_CERTIFICATE			 100
1822#define SSL_F_CLIENT_FINISHED				 167
1823#define SSL_F_CLIENT_HELLO				 101
1824#define SSL_F_CLIENT_MASTER_KEY				 102
1825#define SSL_F_D2I_SSL_SESSION				 103
1826#define SSL_F_DO_DTLS1_WRITE				 245
1827#define SSL_F_DO_SSL3_WRITE				 104
1828#define SSL_F_DTLS1_ACCEPT				 246
1829#define SSL_F_DTLS1_ADD_CERT_TO_BUF			 295
1830#define SSL_F_DTLS1_BUFFER_RECORD			 247
1831#define SSL_F_DTLS1_CLIENT_HELLO			 248
1832#define SSL_F_DTLS1_CONNECT				 249
1833#define SSL_F_DTLS1_ENC					 250
1834#define SSL_F_DTLS1_GET_HELLO_VERIFY			 251
1835#define SSL_F_DTLS1_GET_MESSAGE				 252
1836#define SSL_F_DTLS1_GET_MESSAGE_FRAGMENT		 253
1837#define SSL_F_DTLS1_GET_RECORD				 254
1838#define SSL_F_DTLS1_HANDLE_TIMEOUT			 297
1839#define SSL_F_DTLS1_OUTPUT_CERT_CHAIN			 255
1840#define SSL_F_DTLS1_PREPROCESS_FRAGMENT			 288
1841#define SSL_F_DTLS1_PROCESS_OUT_OF_SEQ_MESSAGE		 256
1842#define SSL_F_DTLS1_PROCESS_RECORD			 257
1843#define SSL_F_DTLS1_READ_BYTES				 258
1844#define SSL_F_DTLS1_READ_FAILED				 259
1845#define SSL_F_DTLS1_SEND_CERTIFICATE_REQUEST		 260
1846#define SSL_F_DTLS1_SEND_CLIENT_CERTIFICATE		 261
1847#define SSL_F_DTLS1_SEND_CLIENT_KEY_EXCHANGE		 262
1848#define SSL_F_DTLS1_SEND_CLIENT_VERIFY			 263
1849#define SSL_F_DTLS1_SEND_HELLO_VERIFY_REQUEST		 264
1850#define SSL_F_DTLS1_SEND_SERVER_CERTIFICATE		 265
1851#define SSL_F_DTLS1_SEND_SERVER_HELLO			 266
1852#define SSL_F_DTLS1_SEND_SERVER_KEY_EXCHANGE		 267
1853#define SSL_F_DTLS1_WRITE_APP_DATA_BYTES		 268
1854#define SSL_F_GET_CLIENT_FINISHED			 105
1855#define SSL_F_GET_CLIENT_HELLO				 106
1856#define SSL_F_GET_CLIENT_MASTER_KEY			 107
1857#define SSL_F_GET_SERVER_FINISHED			 108
1858#define SSL_F_GET_SERVER_HELLO				 109
1859#define SSL_F_GET_SERVER_VERIFY				 110
1860#define SSL_F_I2D_SSL_SESSION				 111
1861#define SSL_F_READ_N					 112
1862#define SSL_F_REQUEST_CERTIFICATE			 113
1863#define SSL_F_SERVER_FINISH				 239
1864#define SSL_F_SERVER_HELLO				 114
1865#define SSL_F_SERVER_VERIFY				 240
1866#define SSL_F_SSL23_ACCEPT				 115
1867#define SSL_F_SSL23_CLIENT_HELLO			 116
1868#define SSL_F_SSL23_CONNECT				 117
1869#define SSL_F_SSL23_GET_CLIENT_HELLO			 118
1870#define SSL_F_SSL23_GET_SERVER_HELLO			 119
1871#define SSL_F_SSL23_PEEK				 237
1872#define SSL_F_SSL23_READ				 120
1873#define SSL_F_SSL23_WRITE				 121
1874#define SSL_F_SSL2_ACCEPT				 122
1875#define SSL_F_SSL2_CONNECT				 123
1876#define SSL_F_SSL2_ENC_INIT				 124
1877#define SSL_F_SSL2_GENERATE_KEY_MATERIAL		 241
1878#define SSL_F_SSL2_PEEK					 234
1879#define SSL_F_SSL2_READ					 125
1880#define SSL_F_SSL2_READ_INTERNAL			 236
1881#define SSL_F_SSL2_SET_CERTIFICATE			 126
1882#define SSL_F_SSL2_WRITE				 127
1883#define SSL_F_SSL3_ACCEPT				 128
1884#define SSL_F_SSL3_ADD_CERT_TO_BUF			 296
1885#define SSL_F_SSL3_CALLBACK_CTRL			 233
1886#define SSL_F_SSL3_CHANGE_CIPHER_STATE			 129
1887#define SSL_F_SSL3_CHECK_CERT_AND_ALGORITHM		 130
1888#define SSL_F_SSL3_CLIENT_HELLO				 131
1889#define SSL_F_SSL3_CONNECT				 132
1890#define SSL_F_SSL3_CTRL					 213
1891#define SSL_F_SSL3_CTX_CTRL				 133
1892#define SSL_F_SSL3_DIGEST_CACHED_RECORDS		 293
1893#define SSL_F_SSL3_DO_CHANGE_CIPHER_SPEC		 292
1894#define SSL_F_SSL3_ENC					 134
1895#define SSL_F_SSL3_GENERATE_KEY_BLOCK			 238
1896#define SSL_F_SSL3_GET_CERTIFICATE_REQUEST		 135
1897#define SSL_F_SSL3_GET_CERT_STATUS			 289
1898#define SSL_F_SSL3_GET_CERT_VERIFY			 136
1899#define SSL_F_SSL3_GET_CLIENT_CERTIFICATE		 137
1900#define SSL_F_SSL3_GET_CLIENT_HELLO			 138
1901#define SSL_F_SSL3_GET_CLIENT_KEY_EXCHANGE		 139
1902#define SSL_F_SSL3_GET_FINISHED				 140
1903#define SSL_F_SSL3_GET_KEY_EXCHANGE			 141
1904#define SSL_F_SSL3_GET_MESSAGE				 142
1905#define SSL_F_SSL3_GET_NEW_SESSION_TICKET		 283
1906#define SSL_F_SSL3_GET_RECORD				 143
1907#define SSL_F_SSL3_GET_SERVER_CERTIFICATE		 144
1908#define SSL_F_SSL3_GET_SERVER_DONE			 145
1909#define SSL_F_SSL3_GET_SERVER_HELLO			 146
1910#define SSL_F_SSL3_HANDSHAKE_MAC			 285
1911#define SSL_F_SSL3_NEW_SESSION_TICKET			 287
1912#define SSL_F_SSL3_OUTPUT_CERT_CHAIN			 147
1913#define SSL_F_SSL3_PEEK					 235
1914#define SSL_F_SSL3_READ_BYTES				 148
1915#define SSL_F_SSL3_READ_N				 149
1916#define SSL_F_SSL3_SEND_CERTIFICATE_REQUEST		 150
1917#define SSL_F_SSL3_SEND_CLIENT_CERTIFICATE		 151
1918#define SSL_F_SSL3_SEND_CLIENT_KEY_EXCHANGE		 152
1919#define SSL_F_SSL3_SEND_CLIENT_VERIFY			 153
1920#define SSL_F_SSL3_SEND_SERVER_CERTIFICATE		 154
1921#define SSL_F_SSL3_SEND_SERVER_HELLO			 242
1922#define SSL_F_SSL3_SEND_SERVER_KEY_EXCHANGE		 155
1923#define SSL_F_SSL3_SETUP_KEY_BLOCK			 157
1924#define SSL_F_SSL3_SETUP_READ_BUFFER			 156
1925#define SSL_F_SSL3_SETUP_WRITE_BUFFER			 291
1926#define SSL_F_SSL3_WRITE_BYTES				 158
1927#define SSL_F_SSL3_WRITE_PENDING			 159
1928#define SSL_F_SSL_ADD_CLIENTHELLO_RENEGOTIATE_EXT	 298
1929#define SSL_F_SSL_ADD_CLIENTHELLO_TLSEXT		 277
1930#define SSL_F_SSL_ADD_DIR_CERT_SUBJECTS_TO_STACK	 215
1931#define SSL_F_SSL_ADD_FILE_CERT_SUBJECTS_TO_STACK	 216
1932#define SSL_F_SSL_ADD_SERVERHELLO_RENEGOTIATE_EXT	 299
1933#define SSL_F_SSL_ADD_SERVERHELLO_TLSEXT		 278
1934#define SSL_F_SSL_BAD_METHOD				 160
1935#define SSL_F_SSL_BYTES_TO_CIPHER_LIST			 161
1936#define SSL_F_SSL_CERT_DUP				 221
1937#define SSL_F_SSL_CERT_INST				 222
1938#define SSL_F_SSL_CERT_INSTANTIATE			 214
1939#define SSL_F_SSL_CERT_NEW				 162
1940#define SSL_F_SSL_CHECK_PRIVATE_KEY			 163
1941#define SSL_F_SSL_CHECK_SERVERHELLO_TLSEXT		 280
1942#define SSL_F_SSL_CHECK_SRVR_ECC_CERT_AND_ALG		 279
1943#define SSL_F_SSL_CIPHER_PROCESS_RULESTR		 230
1944#define SSL_F_SSL_CIPHER_STRENGTH_SORT			 231
1945#define SSL_F_SSL_CLEAR					 164
1946#define SSL_F_SSL_COMP_ADD_COMPRESSION_METHOD		 165
1947#define SSL_F_SSL_CREATE_CIPHER_LIST			 166
1948#define SSL_F_SSL_CTRL					 232
1949#define SSL_F_SSL_CTX_CHECK_PRIVATE_KEY			 168
1950#define SSL_F_SSL_CTX_NEW				 169
1951#define SSL_F_SSL_CTX_SET_CIPHER_LIST			 269
1952#define SSL_F_SSL_CTX_SET_CLIENT_CERT_ENGINE		 290
1953#define SSL_F_SSL_CTX_SET_PURPOSE			 226
1954#define SSL_F_SSL_CTX_SET_SESSION_ID_CONTEXT		 219
1955#define SSL_F_SSL_CTX_SET_SSL_VERSION			 170
1956#define SSL_F_SSL_CTX_SET_TRUST				 229
1957#define SSL_F_SSL_CTX_USE_CERTIFICATE			 171
1958#define SSL_F_SSL_CTX_USE_CERTIFICATE_ASN1		 172
1959#define SSL_F_SSL_CTX_USE_CERTIFICATE_CHAIN_FILE	 220
1960#define SSL_F_SSL_CTX_USE_CERTIFICATE_FILE		 173
1961#define SSL_F_SSL_CTX_USE_PRIVATEKEY			 174
1962#define SSL_F_SSL_CTX_USE_PRIVATEKEY_ASN1		 175
1963#define SSL_F_SSL_CTX_USE_PRIVATEKEY_FILE		 176
1964#define SSL_F_SSL_CTX_USE_PSK_IDENTITY_HINT		 272
1965#define SSL_F_SSL_CTX_USE_RSAPRIVATEKEY			 177
1966#define SSL_F_SSL_CTX_USE_RSAPRIVATEKEY_ASN1		 178
1967#define SSL_F_SSL_CTX_USE_RSAPRIVATEKEY_FILE		 179
1968#define SSL_F_SSL_DO_HANDSHAKE				 180
1969#define SSL_F_SSL_GET_NEW_SESSION			 181
1970#define SSL_F_SSL_GET_PREV_SESSION			 217
1971#define SSL_F_SSL_GET_SERVER_SEND_CERT			 182
1972#define SSL_F_SSL_GET_SIGN_PKEY				 183
1973#define SSL_F_SSL_INIT_WBIO_BUFFER			 184
1974#define SSL_F_SSL_LOAD_CLIENT_CA_FILE			 185
1975#define SSL_F_SSL_NEW					 186
1976#define SSL_F_SSL_PARSE_CLIENTHELLO_RENEGOTIATE_EXT	 300
1977#define SSL_F_SSL_PARSE_CLIENTHELLO_TLSEXT		 302
1978#define SSL_F_SSL_PARSE_SERVERHELLO_RENEGOTIATE_EXT	 301
1979#define SSL_F_SSL_PARSE_SERVERHELLO_TLSEXT		 303
1980#define SSL_F_SSL_PEEK					 270
1981#define SSL_F_SSL_PREPARE_CLIENTHELLO_TLSEXT		 281
1982#define SSL_F_SSL_PREPARE_SERVERHELLO_TLSEXT		 282
1983#define SSL_F_SSL_READ					 223
1984#define SSL_F_SSL_RSA_PRIVATE_DECRYPT			 187
1985#define SSL_F_SSL_RSA_PUBLIC_ENCRYPT			 188
1986#define SSL_F_SSL_SESSION_NEW				 189
1987#define SSL_F_SSL_SESSION_PRINT_FP			 190
1988#define SSL_F_SSL_SESS_CERT_NEW				 225
1989#define SSL_F_SSL_SET_CERT				 191
1990#define SSL_F_SSL_SET_CIPHER_LIST			 271
1991#define SSL_F_SSL_SET_FD				 192
1992#define SSL_F_SSL_SET_PKEY				 193
1993#define SSL_F_SSL_SET_PURPOSE				 227
1994#define SSL_F_SSL_SET_RFD				 194
1995#define SSL_F_SSL_SET_SESSION				 195
1996#define SSL_F_SSL_SET_SESSION_ID_CONTEXT		 218
1997#define SSL_F_SSL_SET_SESSION_TICKET_EXT		 294
1998#define SSL_F_SSL_SET_TRUST				 228
1999#define SSL_F_SSL_SET_WFD				 196
2000#define SSL_F_SSL_SHUTDOWN				 224
2001#define SSL_F_SSL_UNDEFINED_CONST_FUNCTION		 243
2002#define SSL_F_SSL_UNDEFINED_FUNCTION			 197
2003#define SSL_F_SSL_UNDEFINED_VOID_FUNCTION		 244
2004#define SSL_F_SSL_USE_CERTIFICATE			 198
2005#define SSL_F_SSL_USE_CERTIFICATE_ASN1			 199
2006#define SSL_F_SSL_USE_CERTIFICATE_FILE			 200
2007#define SSL_F_SSL_USE_PRIVATEKEY			 201
2008#define SSL_F_SSL_USE_PRIVATEKEY_ASN1			 202
2009#define SSL_F_SSL_USE_PRIVATEKEY_FILE			 203
2010#define SSL_F_SSL_USE_PSK_IDENTITY_HINT			 273
2011#define SSL_F_SSL_USE_RSAPRIVATEKEY			 204
2012#define SSL_F_SSL_USE_RSAPRIVATEKEY_ASN1		 205
2013#define SSL_F_SSL_USE_RSAPRIVATEKEY_FILE		 206
2014#define SSL_F_SSL_VERIFY_CERT_CHAIN			 207
2015#define SSL_F_SSL_WRITE					 208
2016#define SSL_F_TLS1_CERT_VERIFY_MAC			 286
2017#define SSL_F_TLS1_CHANGE_CIPHER_STATE			 209
2018#define SSL_F_TLS1_CHECK_SERVERHELLO_TLSEXT		 274
2019#define SSL_F_TLS1_ENC					 210
2020#define SSL_F_TLS1_PREPARE_CLIENTHELLO_TLSEXT		 275
2021#define SSL_F_TLS1_PREPARE_SERVERHELLO_TLSEXT		 276
2022#define SSL_F_TLS1_PRF					 284
2023#define SSL_F_TLS1_SETUP_KEY_BLOCK			 211
2024#define SSL_F_WRITE_PENDING				 212
2025
2026/* Reason codes. */
2027#define SSL_R_APP_DATA_IN_HANDSHAKE			 100
2028#define SSL_R_ATTEMPT_TO_REUSE_SESSION_IN_DIFFERENT_CONTEXT 272
2029#define SSL_R_BAD_ALERT_RECORD				 101
2030#define SSL_R_BAD_AUTHENTICATION_TYPE			 102
2031#define SSL_R_BAD_CHANGE_CIPHER_SPEC			 103
2032#define SSL_R_BAD_CHECKSUM				 104
2033#define SSL_R_BAD_DATA_RETURNED_BY_CALLBACK		 106
2034#define SSL_R_BAD_DECOMPRESSION				 107
2035#define SSL_R_BAD_DH_G_LENGTH				 108
2036#define SSL_R_BAD_DH_PUB_KEY_LENGTH			 109
2037#define SSL_R_BAD_DH_P_LENGTH				 110
2038#define SSL_R_BAD_DIGEST_LENGTH				 111
2039#define SSL_R_BAD_DSA_SIGNATURE				 112
2040#define SSL_R_BAD_ECC_CERT				 304
2041#define SSL_R_BAD_ECDSA_SIGNATURE			 305
2042#define SSL_R_BAD_ECPOINT				 306
2043#define SSL_R_BAD_HANDSHAKE_LENGTH			 332
2044#define SSL_R_BAD_HELLO_REQUEST				 105
2045#define SSL_R_BAD_LENGTH				 271
2046#define SSL_R_BAD_MAC_DECODE				 113
2047#define SSL_R_BAD_MAC_LENGTH				 333
2048#define SSL_R_BAD_MESSAGE_TYPE				 114
2049#define SSL_R_BAD_PACKET_LENGTH				 115
2050#define SSL_R_BAD_PROTOCOL_VERSION_NUMBER		 116
2051#define SSL_R_BAD_PSK_IDENTITY_HINT_LENGTH		 316
2052#define SSL_R_BAD_RESPONSE_ARGUMENT			 117
2053#define SSL_R_BAD_RSA_DECRYPT				 118
2054#define SSL_R_BAD_RSA_ENCRYPT				 119
2055#define SSL_R_BAD_RSA_E_LENGTH				 120
2056#define SSL_R_BAD_RSA_MODULUS_LENGTH			 121
2057#define SSL_R_BAD_RSA_SIGNATURE				 122
2058#define SSL_R_BAD_SIGNATURE				 123
2059#define SSL_R_BAD_SSL_FILETYPE				 124
2060#define SSL_R_BAD_SSL_SESSION_ID_LENGTH			 125
2061#define SSL_R_BAD_STATE					 126
2062#define SSL_R_BAD_WRITE_RETRY				 127
2063#define SSL_R_BIO_NOT_SET				 128
2064#define SSL_R_BLOCK_CIPHER_PAD_IS_WRONG			 129
2065#define SSL_R_BN_LIB					 130
2066#define SSL_R_CA_DN_LENGTH_MISMATCH			 131
2067#define SSL_R_CA_DN_TOO_LONG				 132
2068#define SSL_R_CCS_RECEIVED_EARLY			 133
2069#define SSL_R_CERTIFICATE_VERIFY_FAILED			 134
2070#define SSL_R_CERT_LENGTH_MISMATCH			 135
2071#define SSL_R_CHALLENGE_IS_DIFFERENT			 136
2072#define SSL_R_CIPHER_CODE_WRONG_LENGTH			 137
2073#define SSL_R_CIPHER_OR_HASH_UNAVAILABLE		 138
2074#define SSL_R_CIPHER_TABLE_SRC_ERROR			 139
2075#define SSL_R_CLIENTHELLO_TLSEXT			 226
2076#define SSL_R_COMPRESSED_LENGTH_TOO_LONG		 140
2077#define SSL_R_COMPRESSION_DISABLED			 343
2078#define SSL_R_COMPRESSION_FAILURE			 141
2079#define SSL_R_COMPRESSION_ID_NOT_WITHIN_PRIVATE_RANGE	 307
2080#define SSL_R_COMPRESSION_LIBRARY_ERROR			 142
2081#define SSL_R_CONNECTION_ID_IS_DIFFERENT		 143
2082#define SSL_R_CONNECTION_TYPE_NOT_SET			 144
2083#define SSL_R_COOKIE_MISMATCH				 308
2084#define SSL_R_DATA_BETWEEN_CCS_AND_FINISHED		 145
2085#define SSL_R_DATA_LENGTH_TOO_LONG			 146
2086#define SSL_R_DECRYPTION_FAILED				 147
2087#define SSL_R_DECRYPTION_FAILED_OR_BAD_RECORD_MAC	 281
2088#define SSL_R_DH_PUBLIC_VALUE_LENGTH_IS_WRONG		 148
2089#define SSL_R_DIGEST_CHECK_FAILED			 149
2090#define SSL_R_DTLS_MESSAGE_TOO_BIG			 334
2091#define SSL_R_DUPLICATE_COMPRESSION_ID			 309
2092#define SSL_R_ECC_CERT_NOT_FOR_KEY_AGREEMENT		 317
2093#define SSL_R_ECC_CERT_NOT_FOR_SIGNING			 318
2094#define SSL_R_ECC_CERT_SHOULD_HAVE_RSA_SIGNATURE	 322
2095#define SSL_R_ECC_CERT_SHOULD_HAVE_SHA1_SIGNATURE	 323
2096#define SSL_R_ECGROUP_TOO_LARGE_FOR_CIPHER		 310
2097#define SSL_R_ENCRYPTED_LENGTH_TOO_LONG			 150
2098#define SSL_R_ERROR_GENERATING_TMP_RSA_KEY		 282
2099#define SSL_R_ERROR_IN_RECEIVED_CIPHER_LIST		 151
2100#define SSL_R_EXCESSIVE_MESSAGE_SIZE			 152
2101#define SSL_R_EXTRA_DATA_IN_MESSAGE			 153
2102#define SSL_R_GOT_A_FIN_BEFORE_A_CCS			 154
2103#define SSL_R_HTTPS_PROXY_REQUEST			 155
2104#define SSL_R_HTTP_REQUEST				 156
2105#define SSL_R_ILLEGAL_PADDING				 283
2106#define SSL_R_INCONSISTENT_COMPRESSION			 340
2107#define SSL_R_INVALID_CHALLENGE_LENGTH			 158
2108#define SSL_R_INVALID_COMMAND				 280
2109#define SSL_R_INVALID_COMPRESSION_ALGORITHM		 341
2110#define SSL_R_INVALID_PURPOSE				 278
2111#define SSL_R_INVALID_STATUS_RESPONSE			 328
2112#define SSL_R_INVALID_TICKET_KEYS_LENGTH		 325
2113#define SSL_R_INVALID_TRUST				 279
2114#define SSL_R_KEY_ARG_TOO_LONG				 284
2115#define SSL_R_KRB5					 285
2116#define SSL_R_KRB5_C_CC_PRINC				 286
2117#define SSL_R_KRB5_C_GET_CRED				 287
2118#define SSL_R_KRB5_C_INIT				 288
2119#define SSL_R_KRB5_C_MK_REQ				 289
2120#define SSL_R_KRB5_S_BAD_TICKET				 290
2121#define SSL_R_KRB5_S_INIT				 291
2122#define SSL_R_KRB5_S_RD_REQ				 292
2123#define SSL_R_KRB5_S_TKT_EXPIRED			 293
2124#define SSL_R_KRB5_S_TKT_NYV				 294
2125#define SSL_R_KRB5_S_TKT_SKEW				 295
2126#define SSL_R_LENGTH_MISMATCH				 159
2127#define SSL_R_LENGTH_TOO_SHORT				 160
2128#define SSL_R_LIBRARY_BUG				 274
2129#define SSL_R_LIBRARY_HAS_NO_CIPHERS			 161
2130#define SSL_R_MESSAGE_TOO_LONG				 296
2131#define SSL_R_MISSING_DH_DSA_CERT			 162
2132#define SSL_R_MISSING_DH_KEY				 163
2133#define SSL_R_MISSING_DH_RSA_CERT			 164
2134#define SSL_R_MISSING_DSA_SIGNING_CERT			 165
2135#define SSL_R_MISSING_EXPORT_TMP_DH_KEY			 166
2136#define SSL_R_MISSING_EXPORT_TMP_RSA_KEY		 167
2137#define SSL_R_MISSING_RSA_CERTIFICATE			 168
2138#define SSL_R_MISSING_RSA_ENCRYPTING_CERT		 169
2139#define SSL_R_MISSING_RSA_SIGNING_CERT			 170
2140#define SSL_R_MISSING_TMP_DH_KEY			 171
2141#define SSL_R_MISSING_TMP_ECDH_KEY			 311
2142#define SSL_R_MISSING_TMP_RSA_KEY			 172
2143#define SSL_R_MISSING_TMP_RSA_PKEY			 173
2144#define SSL_R_MISSING_VERIFY_MESSAGE			 174
2145#define SSL_R_NON_SSLV2_INITIAL_PACKET			 175
2146#define SSL_R_NO_CERTIFICATES_RETURNED			 176
2147#define SSL_R_NO_CERTIFICATE_ASSIGNED			 177
2148#define SSL_R_NO_CERTIFICATE_RETURNED			 178
2149#define SSL_R_NO_CERTIFICATE_SET			 179
2150#define SSL_R_NO_CERTIFICATE_SPECIFIED			 180
2151#define SSL_R_NO_CIPHERS_AVAILABLE			 181
2152#define SSL_R_NO_CIPHERS_PASSED				 182
2153#define SSL_R_NO_CIPHERS_SPECIFIED			 183
2154#define SSL_R_NO_CIPHER_LIST				 184
2155#define SSL_R_NO_CIPHER_MATCH				 185
2156#define SSL_R_NO_CLIENT_CERT_METHOD			 331
2157#define SSL_R_NO_CLIENT_CERT_RECEIVED			 186
2158#define SSL_R_NO_COMPRESSION_SPECIFIED			 187
2159#define SSL_R_NO_GOST_CERTIFICATE_SENT_BY_PEER		 330
2160#define SSL_R_NO_METHOD_SPECIFIED			 188
2161#define SSL_R_NO_PRIVATEKEY				 189
2162#define SSL_R_NO_PRIVATE_KEY_ASSIGNED			 190
2163#define SSL_R_NO_PROTOCOLS_AVAILABLE			 191
2164#define SSL_R_NO_PUBLICKEY				 192
2165#define SSL_R_NO_RENEGOTIATION				 339
2166#define SSL_R_NO_REQUIRED_DIGEST			 324
2167#define SSL_R_NO_SHARED_CIPHER				 193
2168#define SSL_R_NO_VERIFY_CALLBACK			 194
2169#define SSL_R_NULL_SSL_CTX				 195
2170#define SSL_R_NULL_SSL_METHOD_PASSED			 196
2171#define SSL_R_OLD_SESSION_CIPHER_NOT_RETURNED		 197
2172#define SSL_R_OLD_SESSION_COMPRESSION_ALGORITHM_NOT_RETURNED 344
2173#define SSL_R_ONLY_TLS_ALLOWED_IN_FIPS_MODE		 297
2174#define SSL_R_OPAQUE_PRF_INPUT_TOO_LONG			 327
2175#define SSL_R_PACKET_LENGTH_TOO_LONG			 198
2176#define SSL_R_PARSE_TLSEXT				 227
2177#define SSL_R_PATH_TOO_LONG				 270
2178#define SSL_R_PEER_DID_NOT_RETURN_A_CERTIFICATE		 199
2179#define SSL_R_PEER_ERROR				 200
2180#define SSL_R_PEER_ERROR_CERTIFICATE			 201
2181#define SSL_R_PEER_ERROR_NO_CERTIFICATE			 202
2182#define SSL_R_PEER_ERROR_NO_CIPHER			 203
2183#define SSL_R_PEER_ERROR_UNSUPPORTED_CERTIFICATE_TYPE	 204
2184#define SSL_R_PRE_MAC_LENGTH_TOO_LONG			 205
2185#define SSL_R_PROBLEMS_MAPPING_CIPHER_FUNCTIONS		 206
2186#define SSL_R_PROTOCOL_IS_SHUTDOWN			 207
2187#define SSL_R_PSK_IDENTITY_NOT_FOUND			 223
2188#define SSL_R_PSK_NO_CLIENT_CB				 224
2189#define SSL_R_PSK_NO_SERVER_CB				 225
2190#define SSL_R_PUBLIC_KEY_ENCRYPT_ERROR			 208
2191#define SSL_R_PUBLIC_KEY_IS_NOT_RSA			 209
2192#define SSL_R_PUBLIC_KEY_NOT_RSA			 210
2193#define SSL_R_READ_BIO_NOT_SET				 211
2194#define SSL_R_READ_TIMEOUT_EXPIRED			 312
2195#define SSL_R_READ_WRONG_PACKET_TYPE			 212
2196#define SSL_R_RECORD_LENGTH_MISMATCH			 213
2197#define SSL_R_RECORD_TOO_LARGE				 214
2198#define SSL_R_RECORD_TOO_SMALL				 298
2199#define SSL_R_RENEGOTIATE_EXT_TOO_LONG			 335
2200#define SSL_R_RENEGOTIATION_ENCODING_ERR		 336
2201#define SSL_R_RENEGOTIATION_MISMATCH			 337
2202#define SSL_R_REQUIRED_CIPHER_MISSING			 215
2203#define SSL_R_REQUIRED_COMPRESSSION_ALGORITHM_MISSING	 342
2204#define SSL_R_REUSE_CERT_LENGTH_NOT_ZERO		 216
2205#define SSL_R_REUSE_CERT_TYPE_NOT_ZERO			 217
2206#define SSL_R_REUSE_CIPHER_LIST_NOT_ZERO		 218
2207#define SSL_R_SCSV_RECEIVED_WHEN_RENEGOTIATING		 345
2208#define SSL_R_SERVERHELLO_TLSEXT			 275
2209#define SSL_R_SESSION_ID_CONTEXT_UNINITIALIZED		 277
2210#define SSL_R_SHORT_READ				 219
2211#define SSL_R_SIGNATURE_FOR_NON_SIGNING_CERTIFICATE	 220
2212#define SSL_R_SSL23_DOING_SESSION_ID_REUSE		 221
2213#define SSL_R_SSL2_CONNECTION_ID_TOO_LONG		 299
2214#define SSL_R_SSL3_EXT_INVALID_ECPOINTFORMAT		 321
2215#define SSL_R_SSL3_EXT_INVALID_SERVERNAME		 319
2216#define SSL_R_SSL3_EXT_INVALID_SERVERNAME_TYPE		 320
2217#define SSL_R_SSL3_SESSION_ID_TOO_LONG			 300
2218#define SSL_R_SSL3_SESSION_ID_TOO_SHORT			 222
2219#define SSL_R_SSLV3_ALERT_BAD_CERTIFICATE		 1042
2220#define SSL_R_SSLV3_ALERT_BAD_RECORD_MAC		 1020
2221#define SSL_R_SSLV3_ALERT_CERTIFICATE_EXPIRED		 1045
2222#define SSL_R_SSLV3_ALERT_CERTIFICATE_REVOKED		 1044
2223#define SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN		 1046
2224#define SSL_R_SSLV3_ALERT_DECOMPRESSION_FAILURE		 1030
2225#define SSL_R_SSLV3_ALERT_HANDSHAKE_FAILURE		 1040
2226#define SSL_R_SSLV3_ALERT_ILLEGAL_PARAMETER		 1047
2227#define SSL_R_SSLV3_ALERT_NO_CERTIFICATE		 1041
2228#define SSL_R_SSLV3_ALERT_UNEXPECTED_MESSAGE		 1010
2229#define SSL_R_SSLV3_ALERT_UNSUPPORTED_CERTIFICATE	 1043
2230#define SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION	 228
2231#define SSL_R_SSL_HANDSHAKE_FAILURE			 229
2232#define SSL_R_SSL_LIBRARY_HAS_NO_CIPHERS		 230
2233#define SSL_R_SSL_SESSION_ID_CALLBACK_FAILED		 301
2234#define SSL_R_SSL_SESSION_ID_CONFLICT			 302
2235#define SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG		 273
2236#define SSL_R_SSL_SESSION_ID_HAS_BAD_LENGTH		 303
2237#define SSL_R_SSL_SESSION_ID_IS_DIFFERENT		 231
2238#define SSL_R_TLSV1_ALERT_ACCESS_DENIED			 1049
2239#define SSL_R_TLSV1_ALERT_DECODE_ERROR			 1050
2240#define SSL_R_TLSV1_ALERT_DECRYPTION_FAILED		 1021
2241#define SSL_R_TLSV1_ALERT_DECRYPT_ERROR			 1051
2242#define SSL_R_TLSV1_ALERT_EXPORT_RESTRICTION		 1060
2243#define SSL_R_TLSV1_ALERT_INSUFFICIENT_SECURITY		 1071
2244#define SSL_R_TLSV1_ALERT_INTERNAL_ERROR		 1080
2245#define SSL_R_TLSV1_ALERT_NO_RENEGOTIATION		 1100
2246#define SSL_R_TLSV1_ALERT_PROTOCOL_VERSION		 1070
2247#define SSL_R_TLSV1_ALERT_RECORD_OVERFLOW		 1022
2248#define SSL_R_TLSV1_ALERT_UNKNOWN_CA			 1048
2249#define SSL_R_TLSV1_ALERT_USER_CANCELLED		 1090
2250#define SSL_R_TLSV1_BAD_CERTIFICATE_HASH_VALUE		 1114
2251#define SSL_R_TLSV1_BAD_CERTIFICATE_STATUS_RESPONSE	 1113
2252#define SSL_R_TLSV1_CERTIFICATE_UNOBTAINABLE		 1111
2253#define SSL_R_TLSV1_UNRECOGNIZED_NAME			 1112
2254#define SSL_R_TLSV1_UNSUPPORTED_EXTENSION		 1110
2255#define SSL_R_TLS_CLIENT_CERT_REQ_WITH_ANON_CIPHER	 232
2256#define SSL_R_TLS_INVALID_ECPOINTFORMAT_LIST		 157
2257#define SSL_R_TLS_PEER_DID_NOT_RESPOND_WITH_CERTIFICATE_LIST 233
2258#define SSL_R_TLS_RSA_ENCRYPTED_VALUE_LENGTH_IS_WRONG	 234
2259#define SSL_R_TRIED_TO_USE_UNSUPPORTED_CIPHER		 235
2260#define SSL_R_UNABLE_TO_DECODE_DH_CERTS			 236
2261#define SSL_R_UNABLE_TO_DECODE_ECDH_CERTS		 313
2262#define SSL_R_UNABLE_TO_EXTRACT_PUBLIC_KEY		 237
2263#define SSL_R_UNABLE_TO_FIND_DH_PARAMETERS		 238
2264#define SSL_R_UNABLE_TO_FIND_ECDH_PARAMETERS		 314
2265#define SSL_R_UNABLE_TO_FIND_PUBLIC_KEY_PARAMETERS	 239
2266#define SSL_R_UNABLE_TO_FIND_SSL_METHOD			 240
2267#define SSL_R_UNABLE_TO_LOAD_SSL2_MD5_ROUTINES		 241
2268#define SSL_R_UNABLE_TO_LOAD_SSL3_MD5_ROUTINES		 242
2269#define SSL_R_UNABLE_TO_LOAD_SSL3_SHA1_ROUTINES		 243
2270#define SSL_R_UNEXPECTED_MESSAGE			 244
2271#define SSL_R_UNEXPECTED_RECORD				 245
2272#define SSL_R_UNINITIALIZED				 276
2273#define SSL_R_UNKNOWN_ALERT_TYPE			 246
2274#define SSL_R_UNKNOWN_CERTIFICATE_TYPE			 247
2275#define SSL_R_UNKNOWN_CIPHER_RETURNED			 248
2276#define SSL_R_UNKNOWN_CIPHER_TYPE			 249
2277#define SSL_R_UNKNOWN_KEY_EXCHANGE_TYPE			 250
2278#define SSL_R_UNKNOWN_PKEY_TYPE				 251
2279#define SSL_R_UNKNOWN_PROTOCOL				 252
2280#define SSL_R_UNKNOWN_REMOTE_ERROR_TYPE			 253
2281#define SSL_R_UNKNOWN_SSL_VERSION			 254
2282#define SSL_R_UNKNOWN_STATE				 255
2283#define SSL_R_UNSAFE_LEGACY_RENEGOTIATION_DISABLED	 338
2284#define SSL_R_UNSUPPORTED_CIPHER			 256
2285#define SSL_R_UNSUPPORTED_COMPRESSION_ALGORITHM		 257
2286#define SSL_R_UNSUPPORTED_DIGEST_TYPE			 326
2287#define SSL_R_UNSUPPORTED_ELLIPTIC_CURVE		 315
2288#define SSL_R_UNSUPPORTED_PROTOCOL			 258
2289#define SSL_R_UNSUPPORTED_SSL_VERSION			 259
2290#define SSL_R_UNSUPPORTED_STATUS_TYPE			 329
2291#define SSL_R_WRITE_BIO_NOT_SET				 260
2292#define SSL_R_WRONG_CIPHER_RETURNED			 261
2293#define SSL_R_WRONG_MESSAGE_TYPE			 262
2294#define SSL_R_WRONG_NUMBER_OF_KEY_BITS			 263
2295#define SSL_R_WRONG_SIGNATURE_LENGTH			 264
2296#define SSL_R_WRONG_SIGNATURE_SIZE			 265
2297#define SSL_R_WRONG_SSL_VERSION				 266
2298#define SSL_R_WRONG_VERSION_NUMBER			 267
2299#define SSL_R_X509_LIB					 268
2300#define SSL_R_X509_VERIFICATION_SETUP_PROBLEMS		 269
2301
2302#ifdef  __cplusplus
2303}
2304#endif
2305#endif
2306