3 * Copyright (C) 2006-2012 Sawtooth Consulting Ltd.
5 * This file is part of CyaSSL.
7 * CyaSSL is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * CyaSSL is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
29 /* for users not using preprocessor flags*/
30 #include <cyassl/ctaocrypt/settings.h>
31 #include <cyassl/version.h>
35 #include <stdio.h> /* ERR_printf */
39 #include "prefix_ssl.h"
42 #ifdef LIBCYASSL_VERSION_STRING
43 #define CYASSL_VERSION LIBCYASSL_VERSION_STRING
47 /* wincrypt.h clashes */
59 typedef struct CYASSL CYASSL;
60 typedef struct CYASSL_SESSION CYASSL_SESSION;
61 typedef struct CYASSL_METHOD CYASSL_METHOD;
62 typedef struct CYASSL_CTX CYASSL_CTX;
64 typedef struct CYASSL_X509 CYASSL_X509;
65 typedef struct CYASSL_X509_NAME CYASSL_X509_NAME;
66 typedef struct CYASSL_X509_CHAIN CYASSL_X509_CHAIN;
68 typedef struct CYASSL_CERT_MANAGER CYASSL_CERT_MANAGER;
71 #define CYASSL_TYPES_DEFINED
74 typedef struct CYASSL_RSA CYASSL_RSA;
75 typedef struct CYASSL_DSA CYASSL_DSA;
76 typedef struct CYASSL_CIPHER CYASSL_CIPHER;
77 typedef struct CYASSL_X509_LOOKUP CYASSL_X509_LOOKUP;
78 typedef struct CYASSL_X509_LOOKUP_METHOD CYASSL_X509_LOOKUP_METHOD;
79 typedef struct CYASSL_X509_CRL CYASSL_X509_CRL;
80 typedef struct CYASSL_BIO CYASSL_BIO;
81 typedef struct CYASSL_BIO_METHOD CYASSL_BIO_METHOD;
82 typedef struct CYASSL_X509_EXTENSION CYASSL_X509_EXTENSION;
83 typedef struct CYASSL_ASN1_TIME CYASSL_ASN1_TIME;
84 typedef struct CYASSL_ASN1_INTEGER CYASSL_ASN1_INTEGER;
85 typedef struct CYASSL_ASN1_OBJECT CYASSL_ASN1_OBJECT;
86 typedef struct CYASSL_ASN1_STRING CYASSL_ASN1_STRING;
87 typedef struct CYASSL_dynlock_value CYASSL_dynlock_value;
89 #define CYASSL_ASN1_UTCTIME CYASSL_ASN1_TIME
91 typedef struct CYASSL_EVP_PKEY {
92 int type; /* openssh dereference */
93 int save_type; /* openssh dereference */
96 typedef struct CYASSL_MD4_CTX {
97 int buffer[32]; /* big enough to hold, check size in Init */
101 typedef struct CYASSL_COMP_METHOD {
102 int type; /* stunnel dereference */
103 } CYASSL_COMP_METHOD;
106 typedef struct CYASSL_X509_STORE {
107 int cache; /* stunnel dereference */
111 typedef struct CYASSL_X509_REVOKED {
112 CYASSL_ASN1_INTEGER* serialNumber; /* stunnel dereference */
113 } CYASSL_X509_REVOKED;
116 typedef struct CYASSL_X509_OBJECT {
119 CYASSL_X509_CRL* crl; /* stunnel dereference */
121 } CYASSL_X509_OBJECT;
124 /* in internal.h too, change there !! */
125 typedef struct CYASSL_X509_STORE_CTX {
128 CYASSL_X509* current_cert; /* stunnel dereference */
129 char* domain; /* subject CN domain name */
130 void* ex_data; /* external data, for fortress build */
131 /* in internal.h too, change there !! */
132 } CYASSL_X509_STORE_CTX;
135 CYASSL_API CYASSL_METHOD *CyaSSLv3_server_method(void);
136 CYASSL_API CYASSL_METHOD *CyaSSLv3_client_method(void);
137 CYASSL_API CYASSL_METHOD *CyaTLSv1_server_method(void);
138 CYASSL_API CYASSL_METHOD *CyaTLSv1_client_method(void);
139 CYASSL_API CYASSL_METHOD *CyaTLSv1_1_server_method(void);
140 CYASSL_API CYASSL_METHOD *CyaTLSv1_1_client_method(void);
141 CYASSL_API CYASSL_METHOD *CyaTLSv1_2_server_method(void);
142 CYASSL_API CYASSL_METHOD *CyaTLSv1_2_client_method(void);
145 CYASSL_API CYASSL_METHOD *CyaDTLSv1_client_method(void);
146 CYASSL_API CYASSL_METHOD *CyaDTLSv1_server_method(void);
149 #ifndef NO_FILESYSTEM
151 CYASSL_API int CyaSSL_CTX_use_certificate_file(CYASSL_CTX*, const char*, int);
152 CYASSL_API int CyaSSL_CTX_use_PrivateKey_file(CYASSL_CTX*, const char*, int);
153 CYASSL_API int CyaSSL_CTX_load_verify_locations(CYASSL_CTX*, const char*,
155 CYASSL_API int CyaSSL_CTX_use_certificate_chain_file(CYASSL_CTX *,
157 CYASSL_API int CyaSSL_CTX_use_RSAPrivateKey_file(CYASSL_CTX*, const char*, int);
159 CYASSL_API int CyaSSL_use_certificate_file(CYASSL*, const char*, int);
160 CYASSL_API int CyaSSL_use_PrivateKey_file(CYASSL*, const char*, int);
161 CYASSL_API int CyaSSL_use_certificate_chain_file(CYASSL*, const char *file);
162 CYASSL_API int CyaSSL_use_RSAPrivateKey_file(CYASSL*, const char*, int);
164 #ifdef CYASSL_DER_LOAD
165 CYASSL_API int CyaSSL_CTX_der_load_verify_locations(CYASSL_CTX*,
170 CYASSL_API int CyaSSL_CTX_use_NTRUPrivateKey_file(CYASSL_CTX*, const char*);
171 /* load NTRU private key blob */
174 CYASSL_API int CyaSSL_PemCertToDer(const char*, unsigned char*, int);
176 #endif /* NO_FILESYSTEM */
178 CYASSL_API CYASSL_CTX* CyaSSL_CTX_new(CYASSL_METHOD*);
179 CYASSL_API CYASSL* CyaSSL_new(CYASSL_CTX*);
180 CYASSL_API int CyaSSL_set_fd (CYASSL*, int);
181 CYASSL_API int CyaSSL_get_fd(const CYASSL*);
182 CYASSL_API int CyaSSL_connect(CYASSL*); /* please see note at top of README
183 if you get an error from connect */
184 CYASSL_API int CyaSSL_write(CYASSL*, const void*, int);
185 CYASSL_API int CyaSSL_read(CYASSL*, void*, int);
186 CYASSL_API int CyaSSL_accept(CYASSL*);
187 CYASSL_API void CyaSSL_CTX_free(CYASSL_CTX*);
188 CYASSL_API void CyaSSL_free(CYASSL*);
189 CYASSL_API int CyaSSL_shutdown(CYASSL*);
191 CYASSL_API void CyaSSL_CTX_set_quiet_shutdown(CYASSL_CTX*, int);
192 CYASSL_API void CyaSSL_set_quiet_shutdown(CYASSL*, int);
194 CYASSL_API int CyaSSL_get_error(CYASSL*, int);
196 CYASSL_API int CyaSSL_set_session(CYASSL* ssl,CYASSL_SESSION* session);
197 CYASSL_API CYASSL_SESSION* CyaSSL_get_session(CYASSL* ssl);
198 CYASSL_API void CyaSSL_flush_sessions(CYASSL_CTX *ctx, long tm);
201 typedef int (*VerifyCallback)(int, CYASSL_X509_STORE_CTX*);
202 typedef int (*pem_password_cb)(char*, int, int, void*);
204 CYASSL_API void CyaSSL_CTX_set_verify(CYASSL_CTX*, int,
205 VerifyCallback verify_callback);
206 CYASSL_API void CyaSSL_set_verify(CYASSL*, int, VerifyCallback verify_callback);
208 CYASSL_API int CyaSSL_pending(CYASSL*);
210 CYASSL_API void CyaSSL_load_error_strings(void);
211 CYASSL_API int CyaSSL_library_init(void);
212 CYASSL_API long CyaSSL_CTX_set_session_cache_mode(CYASSL_CTX*, long);
214 /* only supports full name from cipher_name[] delimited by : */
215 CYASSL_API int CyaSSL_CTX_set_cipher_list(CYASSL_CTX*, const char*);
216 CYASSL_API int CyaSSL_set_cipher_list(CYASSL*, const char*);
218 CYASSL_API int CyaSSL_ERR_GET_REASON(int err);
219 CYASSL_API char* CyaSSL_ERR_error_string(unsigned long,char*);
220 CYASSL_API void CyaSSL_ERR_error_string_n(unsigned long e, char* buf,
225 #define STACK_OF(x) x
227 CYASSL_API int CyaSSL_set_ex_data(CYASSL*, int, void*);
228 CYASSL_API int CyaSSL_get_shutdown(const CYASSL*);
229 CYASSL_API int CyaSSL_set_rfd(CYASSL*, int);
230 CYASSL_API int CyaSSL_set_wfd(CYASSL*, int);
231 CYASSL_API void CyaSSL_set_shutdown(CYASSL*, int);
232 CYASSL_API int CyaSSL_set_session_id_context(CYASSL*, const unsigned char*,
234 CYASSL_API void CyaSSL_set_connect_state(CYASSL*);
235 CYASSL_API void CyaSSL_set_accept_state(CYASSL*);
236 CYASSL_API int CyaSSL_session_reused(CYASSL*);
237 CYASSL_API void CyaSSL_SESSION_free(CYASSL_SESSION* session);
238 CYASSL_API int CyaSSL_is_init_finished(CYASSL*);
240 CYASSL_API const char* CyaSSL_get_version(CYASSL*);
241 CYASSL_API CYASSL_CIPHER* CyaSSL_get_current_cipher(CYASSL*);
242 CYASSL_API char* CyaSSL_CIPHER_description(CYASSL_CIPHER*, char*, int);
243 CYASSL_API const char* CyaSSL_CIPHER_get_name(const CYASSL_CIPHER* cipher);
244 CYASSL_API const char* CyaSSL_get_cipher(CYASSL*);
245 CYASSL_API CYASSL_SESSION* CyaSSL_get1_session(CYASSL* ssl);
246 /* what's ref count */
248 CYASSL_API void CyaSSL_X509_free(CYASSL_X509*);
249 CYASSL_API void CyaSSL_OPENSSL_free(void*);
251 CYASSL_API int CyaSSL_OCSP_parse_url(char* url, char** host, char** port,
252 char** path, int* ssl);
254 CYASSL_API CYASSL_METHOD* CyaSSLv23_client_method(void);
255 CYASSL_API CYASSL_METHOD* CyaSSLv2_client_method(void);
256 CYASSL_API CYASSL_METHOD* CyaSSLv2_server_method(void);
258 CYASSL_API void CyaSSL_MD4_Init(CYASSL_MD4_CTX*);
259 CYASSL_API void CyaSSL_MD4_Update(CYASSL_MD4_CTX*, const void*, unsigned long);
260 CYASSL_API void CyaSSL_MD4_Final(unsigned char*, CYASSL_MD4_CTX*);
263 CYASSL_API CYASSL_BIO* CyaSSL_BIO_new(CYASSL_BIO_METHOD*);
264 CYASSL_API int CyaSSL_BIO_free(CYASSL_BIO*);
265 CYASSL_API int CyaSSL_BIO_free_all(CYASSL_BIO*);
266 CYASSL_API int CyaSSL_BIO_read(CYASSL_BIO*, void*, int);
267 CYASSL_API int CyaSSL_BIO_write(CYASSL_BIO*, const void*, int);
268 CYASSL_API CYASSL_BIO* CyaSSL_BIO_push(CYASSL_BIO*, CYASSL_BIO* append);
269 CYASSL_API CYASSL_BIO* CyaSSL_BIO_pop(CYASSL_BIO*);
270 CYASSL_API int CyaSSL_BIO_flush(CYASSL_BIO*);
271 CYASSL_API int CyaSSL_BIO_pending(CYASSL_BIO*);
273 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_f_buffer(void);
274 CYASSL_API long CyaSSL_BIO_set_write_buffer_size(CYASSL_BIO*, long size);
275 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_f_ssl(void);
276 CYASSL_API CYASSL_BIO* CyaSSL_BIO_new_socket(int sfd, int flag);
277 CYASSL_API int CyaSSL_BIO_eof(CYASSL_BIO*);
279 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_s_mem(void);
280 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_f_base64(void);
281 CYASSL_API void CyaSSL_BIO_set_flags(CYASSL_BIO*, int);
283 CYASSL_API int CyaSSL_BIO_get_mem_data(CYASSL_BIO* bio,const unsigned char** p);
284 CYASSL_API CYASSL_BIO* CyaSSL_BIO_new_mem_buf(void* buf, int len);
287 CYASSL_API long CyaSSL_BIO_set_ssl(CYASSL_BIO*, CYASSL*, int flag);
288 CYASSL_API void CyaSSL_set_bio(CYASSL*, CYASSL_BIO* rd, CYASSL_BIO* wr);
290 CYASSL_API int CyaSSL_add_all_algorithms(void);
292 CYASSL_API void CyaSSL_RAND_screen(void);
293 CYASSL_API const char* CyaSSL_RAND_file_name(char*, unsigned long);
294 CYASSL_API int CyaSSL_RAND_write_file(const char*);
295 CYASSL_API int CyaSSL_RAND_load_file(const char*, long);
296 CYASSL_API int CyaSSL_RAND_egd(const char*);
297 CYASSL_API int CyaSSL_RAND_seed(const void*, int);
298 CYASSL_API void CyaSSL_RAND_add(const void*, int, double);
300 CYASSL_API CYASSL_COMP_METHOD* CyaSSL_COMP_zlib(void);
301 CYASSL_API CYASSL_COMP_METHOD* CyaSSL_COMP_rle(void);
302 CYASSL_API int CyaSSL_COMP_add_compression_method(int, void*);
304 CYASSL_API int CyaSSL_get_ex_new_index(long, void*, void*, void*, void*);
306 CYASSL_API void CyaSSL_set_id_callback(unsigned long (*f)(void));
307 CYASSL_API void CyaSSL_set_locking_callback(void (*f)(int, int, const char*,
309 CYASSL_API void CyaSSL_set_dynlock_create_callback(CYASSL_dynlock_value* (*f)
311 CYASSL_API void CyaSSL_set_dynlock_lock_callback(void (*f)(int,
312 CYASSL_dynlock_value*, const char*, int));
313 CYASSL_API void CyaSSL_set_dynlock_destroy_callback(void (*f)
314 (CYASSL_dynlock_value*, const char*, int));
315 CYASSL_API int CyaSSL_num_locks(void);
317 CYASSL_API CYASSL_X509* CyaSSL_X509_STORE_CTX_get_current_cert(
318 CYASSL_X509_STORE_CTX*);
319 CYASSL_API int CyaSSL_X509_STORE_CTX_get_error(CYASSL_X509_STORE_CTX*);
320 CYASSL_API int CyaSSL_X509_STORE_CTX_get_error_depth(CYASSL_X509_STORE_CTX*);
322 CYASSL_API char* CyaSSL_X509_NAME_oneline(CYASSL_X509_NAME*, char*, int);
323 CYASSL_API CYASSL_X509_NAME* CyaSSL_X509_get_issuer_name(CYASSL_X509*);
324 CYASSL_API CYASSL_X509_NAME* CyaSSL_X509_get_subject_name(CYASSL_X509*);
325 CYASSL_API const char* CyaSSL_X509_verify_cert_error_string(long);
327 CYASSL_API int CyaSSL_X509_LOOKUP_add_dir(CYASSL_X509_LOOKUP*,const char*,long);
328 CYASSL_API int CyaSSL_X509_LOOKUP_load_file(CYASSL_X509_LOOKUP*, const char*,
330 CYASSL_API CYASSL_X509_LOOKUP_METHOD* CyaSSL_X509_LOOKUP_hash_dir(void);
331 CYASSL_API CYASSL_X509_LOOKUP_METHOD* CyaSSL_X509_LOOKUP_file(void);
333 CYASSL_API CYASSL_X509_LOOKUP* CyaSSL_X509_STORE_add_lookup(CYASSL_X509_STORE*,
334 CYASSL_X509_LOOKUP_METHOD*);
335 CYASSL_API CYASSL_X509_STORE* CyaSSL_X509_STORE_new(void);
336 CYASSL_API int CyaSSL_X509_STORE_get_by_subject(CYASSL_X509_STORE_CTX*,
337 int, CYASSL_X509_NAME*, CYASSL_X509_OBJECT*);
338 CYASSL_API int CyaSSL_X509_STORE_CTX_init(CYASSL_X509_STORE_CTX*,
339 CYASSL_X509_STORE*, CYASSL_X509*, STACK_OF(CYASSL_X509)*);
340 CYASSL_API void CyaSSL_X509_STORE_CTX_cleanup(CYASSL_X509_STORE_CTX*);
342 CYASSL_API CYASSL_ASN1_TIME* CyaSSL_X509_CRL_get_lastUpdate(CYASSL_X509_CRL*);
343 CYASSL_API CYASSL_ASN1_TIME* CyaSSL_X509_CRL_get_nextUpdate(CYASSL_X509_CRL*);
345 CYASSL_API CYASSL_EVP_PKEY* CyaSSL_X509_get_pubkey(CYASSL_X509*);
346 CYASSL_API int CyaSSL_X509_CRL_verify(CYASSL_X509_CRL*, CYASSL_EVP_PKEY*);
347 CYASSL_API void CyaSSL_X509_STORE_CTX_set_error(CYASSL_X509_STORE_CTX*,
349 CYASSL_API void CyaSSL_X509_OBJECT_free_contents(CYASSL_X509_OBJECT*);
350 CYASSL_API void CyaSSL_EVP_PKEY_free(CYASSL_EVP_PKEY*);
351 CYASSL_API int CyaSSL_X509_cmp_current_time(const CYASSL_ASN1_TIME*);
352 CYASSL_API int CyaSSL_sk_X509_REVOKED_num(CYASSL_X509_REVOKED*);
354 CYASSL_API CYASSL_X509_REVOKED* CyaSSL_X509_CRL_get_REVOKED(CYASSL_X509_CRL*);
355 CYASSL_API CYASSL_X509_REVOKED* CyaSSL_sk_X509_REVOKED_value(
356 CYASSL_X509_REVOKED*,int);
357 CYASSL_API CYASSL_ASN1_INTEGER* CyaSSL_X509_get_serialNumber(CYASSL_X509*);
359 CYASSL_API int CyaSSL_ASN1_TIME_print(CYASSL_BIO*, const CYASSL_ASN1_TIME*);
361 CYASSL_API int CyaSSL_ASN1_INTEGER_cmp(const CYASSL_ASN1_INTEGER*,
362 const CYASSL_ASN1_INTEGER*);
363 CYASSL_API long CyaSSL_ASN1_INTEGER_get(const CYASSL_ASN1_INTEGER*);
365 CYASSL_API STACK_OF(CYASSL_X509_NAME)* CyaSSL_load_client_CA_file(const char*);
367 CYASSL_API void CyaSSL_CTX_set_client_CA_list(CYASSL_CTX*,
368 STACK_OF(CYASSL_X509_NAME)*);
369 CYASSL_API void* CyaSSL_X509_STORE_CTX_get_ex_data(CYASSL_X509_STORE_CTX*, int);
370 CYASSL_API int CyaSSL_get_ex_data_X509_STORE_CTX_idx(void);
371 CYASSL_API void* CyaSSL_get_ex_data(const CYASSL*, int);
373 CYASSL_API void CyaSSL_CTX_set_default_passwd_cb_userdata(CYASSL_CTX*,
375 CYASSL_API void CyaSSL_CTX_set_default_passwd_cb(CYASSL_CTX*, pem_password_cb);
378 CYASSL_API void CyaSSL_CTX_set_info_callback(CYASSL_CTX*, void (*)(void));
380 CYASSL_API unsigned long CyaSSL_ERR_peek_error(void);
381 CYASSL_API int CyaSSL_GET_REASON(int);
383 CYASSL_API char* CyaSSL_alert_type_string_long(int);
384 CYASSL_API char* CyaSSL_alert_desc_string_long(int);
385 CYASSL_API char* CyaSSL_state_string_long(CYASSL*);
387 CYASSL_API CYASSL_RSA* CyaSSL_RSA_generate_key(int, unsigned long,
388 void(*)(int, int, void*), void*);
389 CYASSL_API void CyaSSL_CTX_set_tmp_rsa_callback(CYASSL_CTX*,
390 CYASSL_RSA*(*)(CYASSL*, int, int));
392 CYASSL_API int CyaSSL_PEM_def_callback(char*, int num, int w, void* key);
394 CYASSL_API long CyaSSL_CTX_sess_accept(CYASSL_CTX*);
395 CYASSL_API long CyaSSL_CTX_sess_connect(CYASSL_CTX*);
396 CYASSL_API long CyaSSL_CTX_sess_accept_good(CYASSL_CTX*);
397 CYASSL_API long CyaSSL_CTX_sess_connect_good(CYASSL_CTX*);
398 CYASSL_API long CyaSSL_CTX_sess_accept_renegotiate(CYASSL_CTX*);
399 CYASSL_API long CyaSSL_CTX_sess_connect_renegotiate(CYASSL_CTX*);
400 CYASSL_API long CyaSSL_CTX_sess_hits(CYASSL_CTX*);
401 CYASSL_API long CyaSSL_CTX_sess_cb_hits(CYASSL_CTX*);
402 CYASSL_API long CyaSSL_CTX_sess_cache_full(CYASSL_CTX*);
403 CYASSL_API long CyaSSL_CTX_sess_misses(CYASSL_CTX*);
404 CYASSL_API long CyaSSL_CTX_sess_timeouts(CYASSL_CTX*);
405 CYASSL_API long CyaSSL_CTX_sess_number(CYASSL_CTX*);
406 CYASSL_API long CyaSSL_CTX_sess_get_cache_size(CYASSL_CTX*);
409 #define CYASSL_DEFAULT_CIPHER_LIST "" /* default all */
410 #define CYASSL_RSA_F4 0x10001L
418 OCSP_NOEXPLICIT = 32,
420 OCSP_NODELEGATED = 128,
422 OCSP_TRUSTOTHER = 512,
423 OCSP_RESPID_KEY = 1024,
431 CYASSL_CRL_CHECKALL = 1,
433 ASN1_GENERALIZEDTIME = 4,
435 SSL_OP_MICROSOFT_SESS_ID_BUG = 1,
436 SSL_OP_NETSCAPE_CHALLENGE_BUG = 2,
437 SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG = 3,
438 SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG = 4,
439 SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER = 5,
440 SSL_OP_MSIE_SSLV2_RSA_PADDING = 6,
441 SSL_OP_SSLEAY_080_CLIENT_DH_BUG = 7,
442 SSL_OP_TLS_D5_BUG = 8,
443 SSL_OP_TLS_BLOCK_PADDING_BUG = 9,
444 SSL_OP_TLS_ROLLBACK_BUG = 10,
446 SSL_OP_EPHEMERAL_RSA = 12,
447 SSL_OP_NO_SSLv3 = 13,
448 SSL_OP_NO_TLSv1 = 14,
449 SSL_OP_PKCS1_CHECK_1 = 15,
450 SSL_OP_PKCS1_CHECK_2 = 16,
451 SSL_OP_NETSCAPE_CA_DN_BUG = 17,
452 SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG = 18,
453 SSL_OP_SINGLE_DH_USE = 19,
454 SSL_OP_NO_TICKET = 20,
455 SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS = 21,
456 SSL_OP_NO_QUERY_MTU = 22,
457 SSL_OP_COOKIE_EXCHANGE = 23,
458 SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION = 24,
459 SSL_OP_SINGLE_ECDH_USE = 25,
460 SSL_OP_CIPHER_SERVER_PREFERENCE = 26,
462 SSL_MAX_SSL_SESSION_ID_LENGTH = 32,
464 EVP_R_BAD_DECRYPT = 2,
471 SSL_CB_HANDSHAKE_DONE = 9,
473 SSL_MODE_ENABLE_PARTIAL_WRITE = 2,
475 BIO_FLAGS_BASE64_NO_NL = 1,
481 X509_FILETYPE_PEM = 8,
485 X509_V_ERR_CRL_SIGNATURE_FAILURE = 13,
486 X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD = 14,
487 X509_V_ERR_CRL_HAS_EXPIRED = 15,
488 X509_V_ERR_CERT_REVOKED = 16,
489 X509_V_ERR_CERT_CHAIN_TOO_LONG = 17,
490 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT = 18,
491 X509_V_ERR_CERT_NOT_YET_VALID = 19,
492 X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD = 20,
493 X509_V_ERR_CERT_HAS_EXPIRED = 21,
494 X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD = 22,
499 CRYPTO_NUM_LOCKS = 10
504 #ifndef NO_FILESYSTEM
505 /* CyaSSL extension, provide last error from SSL_get_error
506 since not using thread storage error queue */
507 CYASSL_API void CyaSSL_ERR_print_errors_fp(FILE*, int err);
510 enum { /* ssl Constants */
511 SSL_ERROR_NONE = 0, /* for most functions */
512 SSL_FAILURE = 0, /* for some functions */
515 SSL_BAD_CERTTYPE = -8,
518 SSL_BAD_FILETYPE = -5,
520 SSL_NOT_IMPLEMENTED = -3,
522 SSL_FATAL_ERROR = -1,
524 SSL_FILETYPE_ASN1 = 2,
525 SSL_FILETYPE_PEM = 1,
526 SSL_FILETYPE_DEFAULT = 2, /* ASN1 */
527 SSL_FILETYPE_RAW = 3, /* NTRU raw key blob */
531 SSL_VERIFY_FAIL_IF_NO_PEER_CERT = 2,
532 SSL_VERIFY_CLIENT_ONCE = 4,
534 SSL_SESS_CACHE_OFF = 30,
535 SSL_SESS_CACHE_CLIENT = 31,
536 SSL_SESS_CACHE_SERVER = 32,
537 SSL_SESS_CACHE_BOTH = 33,
538 SSL_SESS_CACHE_NO_AUTO_CLEAR = 34,
539 SSL_SESS_CACHE_NO_INTERNAL_LOOKUP = 35,
541 SSL_ERROR_WANT_READ = 2,
542 SSL_ERROR_WANT_WRITE = 3,
543 SSL_ERROR_WANT_CONNECT = 7,
544 SSL_ERROR_WANT_ACCEPT = 8,
545 SSL_ERROR_SYSCALL = 5,
546 SSL_ERROR_WANT_X509_LOOKUP = 83,
547 SSL_ERROR_ZERO_RETURN = 6,
550 SSL_SENT_SHUTDOWN = 1,
551 SSL_RECEIVED_SHUTDOWN = 2,
552 SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER = 4,
555 SSL_R_SSL_HANDSHAKE_FAILURE = 101,
556 SSL_R_TLSV1_ALERT_UNKNOWN_CA = 102,
557 SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN = 103,
558 SSL_R_SSLV3_ALERT_BAD_CERTIFICATE = 104,
565 typedef unsigned int (*psk_client_callback)(CYASSL*, const char*, char*,
566 unsigned int, unsigned char*, unsigned int);
567 CYASSL_API void CyaSSL_CTX_set_psk_client_callback(CYASSL_CTX*,
568 psk_client_callback);
569 CYASSL_API void CyaSSL_set_psk_client_callback(CYASSL*,psk_client_callback);
571 CYASSL_API const char* CyaSSL_get_psk_identity_hint(const CYASSL*);
572 CYASSL_API const char* CyaSSL_get_psk_identity(const CYASSL*);
574 CYASSL_API int CyaSSL_CTX_use_psk_identity_hint(CYASSL_CTX*, const char*);
575 CYASSL_API int CyaSSL_use_psk_identity_hint(CYASSL*, const char*);
577 typedef unsigned int (*psk_server_callback)(CYASSL*, const char*,
578 unsigned char*, unsigned int);
579 CYASSL_API void CyaSSL_CTX_set_psk_server_callback(CYASSL_CTX*,
580 psk_server_callback);
581 CYASSL_API void CyaSSL_set_psk_server_callback(CYASSL*,psk_server_callback);
583 #define PSK_TYPES_DEFINED
589 enum { /* ERR Constants */
593 CYASSL_API unsigned long CyaSSL_ERR_get_error_line_data(const char**, int*,
594 const char**, int *);
596 CYASSL_API unsigned long CyaSSL_ERR_get_error(void);
597 CYASSL_API void CyaSSL_ERR_clear_error(void);
600 CYASSL_API int CyaSSL_RAND_status(void);
601 CYASSL_API int CyaSSL_RAND_bytes(unsigned char* buf, int num);
602 CYASSL_API CYASSL_METHOD *CyaSSLv23_server_method(void);
603 CYASSL_API long CyaSSL_CTX_set_options(CYASSL_CTX*, long);
604 CYASSL_API int CyaSSL_CTX_check_private_key(CYASSL_CTX*);
607 CYASSL_API void CyaSSL_ERR_free_strings(void);
608 CYASSL_API void CyaSSL_ERR_remove_state(unsigned long);
609 CYASSL_API void CyaSSL_EVP_cleanup(void);
611 CYASSL_API void CyaSSL_cleanup_all_ex_data(void);
612 CYASSL_API long CyaSSL_CTX_set_mode(CYASSL_CTX* ctx, long mode);
613 CYASSL_API long CyaSSL_CTX_get_mode(CYASSL_CTX* ctx);
614 CYASSL_API void CyaSSL_CTX_set_default_read_ahead(CYASSL_CTX* ctx, int m);
616 CYASSL_API long CyaSSL_CTX_sess_set_cache_size(CYASSL_CTX*, long);
618 CYASSL_API int CyaSSL_CTX_set_default_verify_paths(CYASSL_CTX*);
619 CYASSL_API int CyaSSL_CTX_set_session_id_context(CYASSL_CTX*,
620 const unsigned char*, unsigned int);
621 CYASSL_API CYASSL_X509* CyaSSL_get_peer_certificate(CYASSL* ssl);
623 CYASSL_API int CyaSSL_want_read(CYASSL*);
624 CYASSL_API int CyaSSL_want_write(CYASSL*);
626 CYASSL_API int CyaSSL_BIO_printf(CYASSL_BIO*, const char*, ...);
627 CYASSL_API int CyaSSL_ASN1_UTCTIME_print(CYASSL_BIO*,
628 const CYASSL_ASN1_UTCTIME*);
629 CYASSL_API int CyaSSL_sk_num(CYASSL_X509_REVOKED*);
630 CYASSL_API void* CyaSSL_sk_value(CYASSL_X509_REVOKED*, int);
632 /* stunnel 4.28 needs */
633 CYASSL_API void* CyaSSL_CTX_get_ex_data(const CYASSL_CTX*, int);
634 CYASSL_API int CyaSSL_CTX_set_ex_data(CYASSL_CTX*, int, void*);
635 CYASSL_API void CyaSSL_CTX_sess_set_get_cb(CYASSL_CTX*,
636 CYASSL_SESSION*(*f)(CYASSL*, unsigned char*, int, int*));
637 CYASSL_API void CyaSSL_CTX_sess_set_new_cb(CYASSL_CTX*,
638 int (*f)(CYASSL*, CYASSL_SESSION*));
639 CYASSL_API void CyaSSL_CTX_sess_set_remove_cb(CYASSL_CTX*,
640 void (*f)(CYASSL_CTX*, CYASSL_SESSION*));
642 CYASSL_API int CyaSSL_i2d_SSL_SESSION(CYASSL_SESSION*,unsigned char**);
643 CYASSL_API CYASSL_SESSION* CyaSSL_d2i_SSL_SESSION(CYASSL_SESSION**,const unsigned char**,
646 CYASSL_API long CyaSSL_SESSION_get_timeout(const CYASSL_SESSION*);
647 CYASSL_API long CyaSSL_SESSION_get_time(const CYASSL_SESSION*);
648 CYASSL_API int CyaSSL_CTX_get_ex_new_index(long, void*, void*, void*, void*);
653 /* CyaSSL extensions */
655 /* call before SSL_connect, if verifying will add name check to
656 date check and signature check */
657 CYASSL_API int CyaSSL_check_domain_name(CYASSL* ssl, const char* dn);
659 /* need to call once to load library (session cache) */
660 CYASSL_API int CyaSSL_Init(void);
661 /* call when done to cleanup/free session cache mutex / resources */
662 CYASSL_API int CyaSSL_Cleanup(void);
664 /* turn logging on, only if compiled in */
665 CYASSL_API int CyaSSL_Debugging_ON(void);
666 /* turn logging off */
667 CYASSL_API void CyaSSL_Debugging_OFF(void);
669 /* do accept or connect depedning on side */
670 CYASSL_API int CyaSSL_negotiate(CYASSL* ssl);
671 /* turn on CyaSSL data compression */
672 CYASSL_API int CyaSSL_set_compression(CYASSL* ssl);
674 CYASSL_API int CyaSSL_set_timeout(CYASSL*, unsigned int);
675 CYASSL_API int CyaSSL_CTX_set_timeout(CYASSL_CTX*, unsigned int);
677 /* get CyaSSL peer X509_CHAIN */
678 CYASSL_API CYASSL_X509_CHAIN* CyaSSL_get_peer_chain(CYASSL* ssl);
679 /* peer chain count */
680 CYASSL_API int CyaSSL_get_chain_count(CYASSL_X509_CHAIN* chain);
681 /* index cert length */
682 CYASSL_API int CyaSSL_get_chain_length(CYASSL_X509_CHAIN*, int idx);
684 CYASSL_API unsigned char* CyaSSL_get_chain_cert(CYASSL_X509_CHAIN*, int idx);
685 /* get index cert in PEM */
686 CYASSL_API int CyaSSL_get_chain_cert_pem(CYASSL_X509_CHAIN*, int idx,
687 unsigned char* buffer, int inLen, int* outLen);
688 CYASSL_API const unsigned char* CyaSSL_get_sessionID(const CYASSL_SESSION* s);
689 CYASSL_API int CyaSSL_X509_get_serial_number(CYASSL_X509*,unsigned char*,int*);
690 CYASSL_API char* CyaSSL_X509_get_subjectCN(CYASSL_X509*);
691 CYASSL_API const unsigned char* CyaSSL_X509_get_der(CYASSL_X509*, int*);
693 CYASSL_API int CyaSSL_cmp_peer_cert_to_file(CYASSL*, const char*);
695 CYASSL_API char* CyaSSL_X509_get_next_altname(CYASSL_X509*);
697 /* connect enough to get peer cert */
698 CYASSL_API int CyaSSL_connect_cert(CYASSL* ssl);
700 /* server Diffie-Hellman parameters */
701 CYASSL_API int CyaSSL_SetTmpDH(CYASSL*, const unsigned char* p, int pSz,
702 const unsigned char* g, int gSz);
703 CYASSL_API int CyaSSL_SetTmpDH_buffer(CYASSL*, const unsigned char* b, long sz,
705 CYASSL_API int CyaSSL_SetTmpEC_DHE_Sz(CYASSL*, unsigned short);
706 #ifndef NO_FILESYSTEM
707 CYASSL_API int CyaSSL_SetTmpDH_file(CYASSL*, const char* f, int format);
710 /* server ctx Diffie-Hellman parameters */
711 CYASSL_API int CyaSSL_CTX_SetTmpDH(CYASSL_CTX*, const unsigned char* p,
712 int pSz, const unsigned char* g, int gSz);
713 CYASSL_API int CyaSSL_CTX_SetTmpDH_buffer(CYASSL_CTX*, const unsigned char* b,
714 long sz, int format);
715 CYASSL_API int CyaSSL_CTX_SetTmpEC_DHE_Sz(CYASSL_CTX*, unsigned short);
716 #ifndef NO_FILESYSTEM
717 CYASSL_API int CyaSSL_CTX_SetTmpDH_file(CYASSL_CTX*, const char* f,
721 /* keyblock size in bytes or -1 */
722 CYASSL_API int CyaSSL_get_keyblock_size(CYASSL*);
723 CYASSL_API int CyaSSL_get_keys(CYASSL*,unsigned char** ms, unsigned int* msLen,
724 unsigned char** sr, unsigned int* srLen,
725 unsigned char** cr, unsigned int* crLen);
730 #include <sys/types.h>
731 #include <sys/socket.h>
735 /* allow writev style writing */
736 CYASSL_API int CyaSSL_writev(CYASSL* ssl, const struct iovec* iov,
742 /* SSL_CTX versions */
743 CYASSL_API int CyaSSL_CTX_load_verify_buffer(CYASSL_CTX*, const unsigned char*,
745 CYASSL_API int CyaSSL_CTX_use_certificate_buffer(CYASSL_CTX*,
746 const unsigned char*, long, int);
747 CYASSL_API int CyaSSL_CTX_use_PrivateKey_buffer(CYASSL_CTX*,
748 const unsigned char*, long, int);
749 CYASSL_API int CyaSSL_CTX_use_certificate_chain_buffer(CYASSL_CTX*,
750 const unsigned char*, long);
751 CYASSL_API int CyaSSL_CTX_set_group_messages(CYASSL_CTX*);
754 CYASSL_API int CyaSSL_use_certificate_buffer(CYASSL*, const unsigned char*,
756 CYASSL_API int CyaSSL_use_PrivateKey_buffer(CYASSL*, const unsigned char*, long,
758 CYASSL_API int CyaSSL_use_certificate_chain_buffer(CYASSL*,
759 const unsigned char*, long);
760 CYASSL_API int CyaSSL_set_group_messages(CYASSL*);
763 typedef int (*CallbackIORecv)(char *buf, int sz, void *ctx);
764 typedef int (*CallbackIOSend)(char *buf, int sz, void *ctx);
766 CYASSL_API void CyaSSL_SetIORecv(CYASSL_CTX*, CallbackIORecv);
767 CYASSL_API void CyaSSL_SetIOSend(CYASSL_CTX*, CallbackIOSend);
769 CYASSL_API void CyaSSL_SetIOReadCtx(CYASSL* ssl, void *ctx);
770 CYASSL_API void CyaSSL_SetIOWriteCtx(CYASSL* ssl, void *ctx);
772 /* CA cache callbacks */
778 CYASSL_USER_CA = 1, /* user added as trusted */
779 CYASSL_CHAIN_CA = 2 /* added to cache from trusted chain */
782 CYASSL_API int CyaSSL_SetVersion(CYASSL* ssl, int version);
783 CYASSL_API int CyaSSL_KeyPemToDer(const unsigned char*, int sz, unsigned char*,
786 typedef void (*CallbackCACache)(unsigned char* der, int sz, int type);
787 typedef void (*CbMissingCRL)(const char* url);
789 CYASSL_API void CyaSSL_CTX_SetCACb(CYASSL_CTX*, CallbackCACache);
792 CYASSL_API CYASSL_CERT_MANAGER* CyaSSL_CertManagerNew(void);
793 CYASSL_API void CyaSSL_CertManagerFree(CYASSL_CERT_MANAGER*);
795 CYASSL_API int CyaSSL_CertManagerLoadCA(CYASSL_CERT_MANAGER*, const char* f,
797 CYASSL_API int CyaSSL_CertManagerVerify(CYASSL_CERT_MANAGER*, const char* f,
799 CYASSL_API int CyaSSL_CertManagerVerifyBuffer(CYASSL_CERT_MANAGER* cm,
800 const unsigned char* buff, int sz, int format);
801 CYASSL_API int CyaSSL_CertManagerCheckCRL(CYASSL_CERT_MANAGER*, unsigned char*,
803 CYASSL_API int CyaSSL_CertManagerEnableCRL(CYASSL_CERT_MANAGER*, int options);
804 CYASSL_API int CyaSSL_CertManagerDisableCRL(CYASSL_CERT_MANAGER*);
805 CYASSL_API int CyaSSL_CertManagerLoadCRL(CYASSL_CERT_MANAGER*, const char*, int,
807 CYASSL_API int CyaSSL_CertManagerSetCRL_Cb(CYASSL_CERT_MANAGER*, CbMissingCRL);
809 CYASSL_API int CyaSSL_EnableCRL(CYASSL* ssl, int options);
810 CYASSL_API int CyaSSL_DisableCRL(CYASSL* ssl);
811 CYASSL_API int CyaSSL_LoadCRL(CYASSL*, const char*, int, int);
812 CYASSL_API int CyaSSL_SetCRL_Cb(CYASSL*, CbMissingCRL);
814 CYASSL_API int CyaSSL_CTX_EnableCRL(CYASSL_CTX* ctx, int options);
815 CYASSL_API int CyaSSL_CTX_DisableCRL(CYASSL_CTX* ctx);
816 CYASSL_API int CyaSSL_CTX_LoadCRL(CYASSL_CTX*, const char*, int, int);
817 CYASSL_API int CyaSSL_CTX_SetCRL_Cb(CYASSL_CTX*, CbMissingCRL);
819 #define CYASSL_CRL_MONITOR 0x01 /* monitor this dir flag */
820 #define CYASSL_CRL_START_MON 0x02 /* start monitoring flag */
822 #ifdef CYASSL_CALLBACKS
824 /* used internally by CyaSSL while OpenSSL types aren't */
825 #include <cyassl/callbacks.h>
827 typedef int (*HandShakeCallBack)(HandShakeInfo*);
828 typedef int (*TimeoutCallBack)(TimeoutInfo*);
830 /* CyaSSL connect extension allowing HandShakeCallBack and/or TimeoutCallBack
832 CYASSL_API int CyaSSL_connect_ex(CYASSL*, HandShakeCallBack, TimeoutCallBack,
834 CYASSL_API int CyaSSL_accept_ex(CYASSL*, HandShakeCallBack, TimeoutCallBack,
837 #endif /* CYASSL_CALLBACKS */
840 CYASSL_API long CyaSSL_CTX_OCSP_set_options(CYASSL_CTX*, long);
841 CYASSL_API int CyaSSL_CTX_OCSP_set_override_url(CYASSL_CTX*, const char*);
844 #define CYASSL_OCSP_ENABLE 0x0001 /* Enable OCSP lookups */
845 #define CYASSL_OCSP_URL_OVERRIDE 0x0002 /* Use the override URL instead of URL
854 #endif /* CYASSL_SSL_H */