3 * Copyright (C) 2006-2015 wolfSSL Inc.
5 * This file is part of wolfSSL. (formerly known as CyaSSL)
7 * wolfSSL 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 * wolfSSL 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
29 /* for users not using preprocessor flags*/
30 #include <wolfssl/wolfcrypt/settings.h>
31 #include <wolfssl/version.h>
37 #include <stdio.h> /* ERR_printf */
42 #include "prefix_ssl.h"
45 #ifdef LIBWOLFSSL_VERSION_STRING
46 #define WOLFSSL_VERSION LIBWOLFSSL_VERSION_STRING
50 /* wincrypt.h clashes */
61 typedef struct WOLFSSL WOLFSSL;
62 typedef struct WOLFSSL_SESSION WOLFSSL_SESSION;
63 typedef struct WOLFSSL_METHOD WOLFSSL_METHOD;
64 typedef struct WOLFSSL_CTX WOLFSSL_CTX;
66 typedef struct WOLFSSL_X509 WOLFSSL_X509;
67 typedef struct WOLFSSL_X509_NAME WOLFSSL_X509_NAME;
68 typedef struct WOLFSSL_X509_CHAIN WOLFSSL_X509_CHAIN;
70 typedef struct WOLFSSL_CERT_MANAGER WOLFSSL_CERT_MANAGER;
71 typedef struct WOLFSSL_SOCKADDR WOLFSSL_SOCKADDR;
74 #define WOLFSSL_TYPES_DEFINED
77 typedef struct WOLFSSL_RSA WOLFSSL_RSA;
78 typedef struct WOLFSSL_DSA WOLFSSL_DSA;
79 typedef struct WOLFSSL_CIPHER WOLFSSL_CIPHER;
80 typedef struct WOLFSSL_X509_LOOKUP WOLFSSL_X509_LOOKUP;
81 typedef struct WOLFSSL_X509_LOOKUP_METHOD WOLFSSL_X509_LOOKUP_METHOD;
82 typedef struct WOLFSSL_X509_CRL WOLFSSL_X509_CRL;
83 typedef struct WOLFSSL_BIO WOLFSSL_BIO;
84 typedef struct WOLFSSL_BIO_METHOD WOLFSSL_BIO_METHOD;
85 typedef struct WOLFSSL_X509_EXTENSION WOLFSSL_X509_EXTENSION;
86 typedef struct WOLFSSL_ASN1_TIME WOLFSSL_ASN1_TIME;
87 typedef struct WOLFSSL_ASN1_INTEGER WOLFSSL_ASN1_INTEGER;
88 typedef struct WOLFSSL_ASN1_OBJECT WOLFSSL_ASN1_OBJECT;
89 typedef struct WOLFSSL_ASN1_STRING WOLFSSL_ASN1_STRING;
90 typedef struct WOLFSSL_dynlock_value WOLFSSL_dynlock_value;
92 #define WOLFSSL_ASN1_UTCTIME WOLFSSL_ASN1_TIME
94 typedef struct WOLFSSL_EVP_PKEY {
95 int type; /* openssh dereference */
96 int save_type; /* openssh dereference */
106 typedef struct WOLFSSL_MD4_CTX {
107 int buffer[32]; /* big enough to hold, check size in Init */
111 typedef struct WOLFSSL_COMP_METHOD {
112 int type; /* stunnel dereference */
113 } WOLFSSL_COMP_METHOD;
116 typedef struct WOLFSSL_X509_STORE {
117 int cache; /* stunnel dereference */
118 WOLFSSL_CERT_MANAGER* cm;
119 } WOLFSSL_X509_STORE;
121 typedef struct WOLFSSL_ALERT {
126 typedef struct WOLFSSL_ALERT_HISTORY {
127 WOLFSSL_ALERT last_rx;
128 WOLFSSL_ALERT last_tx;
129 } WOLFSSL_ALERT_HISTORY;
131 typedef struct WOLFSSL_X509_REVOKED {
132 WOLFSSL_ASN1_INTEGER* serialNumber; /* stunnel dereference */
133 } WOLFSSL_X509_REVOKED;
136 typedef struct WOLFSSL_X509_OBJECT {
139 WOLFSSL_X509_CRL* crl; /* stunnel dereference */
141 } WOLFSSL_X509_OBJECT;
144 typedef struct WOLFSSL_X509_STORE_CTX {
145 WOLFSSL_X509_STORE* store; /* Store full of a CA cert chain */
146 WOLFSSL_X509* current_cert; /* stunnel dereference */
147 char* domain; /* subject CN domain name */
148 void* ex_data; /* external data, for fortress build */
149 void* userCtx; /* user ctx */
150 int error; /* current error */
151 int error_depth; /* cert depth for this error */
152 int discardSessionCerts; /* so verify callback can flag for discard */
153 } WOLFSSL_X509_STORE_CTX;
156 /* Valid Alert types from page 16/17 */
157 enum AlertDescription {
159 unexpected_message = 10,
161 record_overflow = 22,
162 decompression_failure = 30,
163 handshake_failure = 40,
165 bad_certificate = 42,
166 unsupported_certificate = 43,
167 certificate_revoked = 44,
168 certificate_expired = 45,
169 certificate_unknown = 46,
170 illegal_parameter = 47,
172 #ifdef WOLFSSL_MYSQL_COMPATIBLE
173 /* catch name conflict for enum protocol with MYSQL build */
174 wc_protocol_version = 70,
176 protocol_version = 70,
178 no_renegotiation = 100,
179 unrecognized_name = 112
189 WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_server_method(void);
190 WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_client_method(void);
191 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_server_method(void);
192 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_client_method(void);
193 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_server_method(void);
194 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_client_method(void);
195 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_server_method(void);
196 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_client_method(void);
199 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_client_method(void);
200 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_server_method(void);
201 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_client_method(void);
202 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_server_method(void);
206 WOLFSSL_API int wolfSSL_use_old_poly(WOLFSSL*, int);
209 #if !defined(NO_FILESYSTEM) && !defined(NO_CERTS)
211 WOLFSSL_API int wolfSSL_CTX_use_certificate_file(WOLFSSL_CTX*, const char*, int);
212 WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_file(WOLFSSL_CTX*, const char*, int);
213 WOLFSSL_API int wolfSSL_CTX_load_verify_locations(WOLFSSL_CTX*, const char*,
215 WOLFSSL_API int wolfSSL_CTX_use_certificate_chain_file(WOLFSSL_CTX *,
217 WOLFSSL_API int wolfSSL_CTX_use_RSAPrivateKey_file(WOLFSSL_CTX*, const char*, int);
219 WOLFSSL_API long wolfSSL_get_verify_depth(WOLFSSL* ssl);
220 WOLFSSL_API long wolfSSL_CTX_get_verify_depth(WOLFSSL_CTX* ctx);
221 WOLFSSL_API int wolfSSL_use_certificate_file(WOLFSSL*, const char*, int);
222 WOLFSSL_API int wolfSSL_use_PrivateKey_file(WOLFSSL*, const char*, int);
223 WOLFSSL_API int wolfSSL_use_certificate_chain_file(WOLFSSL*, const char *file);
224 WOLFSSL_API int wolfSSL_use_RSAPrivateKey_file(WOLFSSL*, const char*, int);
226 #ifdef WOLFSSL_DER_LOAD
227 WOLFSSL_API int wolfSSL_CTX_der_load_verify_locations(WOLFSSL_CTX*,
232 WOLFSSL_API int wolfSSL_CTX_use_NTRUPrivateKey_file(WOLFSSL_CTX*, const char*);
233 /* load NTRU private key blob */
236 #ifndef WOLFSSL_PEMCERT_TODER_DEFINED
237 WOLFSSL_API int wolfSSL_PemCertToDer(const char*, unsigned char*, int);
238 #define WOLFSSL_PEMCERT_TODER_DEFINED
241 #endif /* !NO_FILESYSTEM && !NO_CERTS */
243 WOLFSSL_API WOLFSSL_CTX* wolfSSL_CTX_new(WOLFSSL_METHOD*);
244 WOLFSSL_API WOLFSSL* wolfSSL_new(WOLFSSL_CTX*);
245 WOLFSSL_API int wolfSSL_set_fd (WOLFSSL*, int);
246 WOLFSSL_API char* wolfSSL_get_cipher_list(int priority);
247 WOLFSSL_API int wolfSSL_get_ciphers(char*, int);
248 WOLFSSL_API int wolfSSL_get_fd(const WOLFSSL*);
249 WOLFSSL_API void wolfSSL_set_using_nonblock(WOLFSSL*, int);
250 WOLFSSL_API int wolfSSL_get_using_nonblock(WOLFSSL*);
251 WOLFSSL_API int wolfSSL_connect(WOLFSSL*); /* please see note at top of README
252 if you get an error from connect */
253 WOLFSSL_API int wolfSSL_write(WOLFSSL*, const void*, int);
254 WOLFSSL_API int wolfSSL_read(WOLFSSL*, void*, int);
255 WOLFSSL_API int wolfSSL_peek(WOLFSSL*, void*, int);
256 WOLFSSL_API int wolfSSL_accept(WOLFSSL*);
257 WOLFSSL_API void wolfSSL_CTX_free(WOLFSSL_CTX*);
258 WOLFSSL_API void wolfSSL_free(WOLFSSL*);
259 WOLFSSL_API int wolfSSL_shutdown(WOLFSSL*);
260 WOLFSSL_API int wolfSSL_send(WOLFSSL*, const void*, int sz, int flags);
261 WOLFSSL_API int wolfSSL_recv(WOLFSSL*, void*, int sz, int flags);
263 WOLFSSL_API void wolfSSL_CTX_set_quiet_shutdown(WOLFSSL_CTX*, int);
264 WOLFSSL_API void wolfSSL_set_quiet_shutdown(WOLFSSL*, int);
266 WOLFSSL_API int wolfSSL_get_error(WOLFSSL*, int);
267 WOLFSSL_API int wolfSSL_get_alert_history(WOLFSSL*, WOLFSSL_ALERT_HISTORY *);
269 WOLFSSL_API int wolfSSL_set_session(WOLFSSL* ssl,WOLFSSL_SESSION* session);
270 WOLFSSL_API long wolfSSL_SSL_SESSION_set_timeout(WOLFSSL_SESSION* session, long t);
271 WOLFSSL_API WOLFSSL_SESSION* wolfSSL_get_session(WOLFSSL* ssl);
272 WOLFSSL_API void wolfSSL_flush_sessions(WOLFSSL_CTX *ctx, long tm);
273 WOLFSSL_API int wolfSSL_SetServerID(WOLFSSL* ssl, const unsigned char*,
277 WOLFSSL_API int wolfSSL_GetSessionIndex(WOLFSSL* ssl);
278 WOLFSSL_API int wolfSSL_GetSessionAtIndex(int index, WOLFSSL_SESSION* session);
279 #endif /* SESSION_INDEX */
281 #if defined(SESSION_INDEX) && defined(SESSION_CERTS)
283 WOLFSSL_X509_CHAIN* wolfSSL_SESSION_get_peer_chain(WOLFSSL_SESSION* session);
284 #endif /* SESSION_INDEX && SESSION_CERTS */
286 typedef int (*VerifyCallback)(int, WOLFSSL_X509_STORE_CTX*);
287 typedef int (*pem_password_cb)(char*, int, int, void*);
289 WOLFSSL_API void wolfSSL_CTX_set_verify(WOLFSSL_CTX*, int,
290 VerifyCallback verify_callback);
291 WOLFSSL_API void wolfSSL_set_verify(WOLFSSL*, int, VerifyCallback verify_callback);
292 WOLFSSL_API void wolfSSL_SetCertCbCtx(WOLFSSL*, void*);
294 WOLFSSL_API int wolfSSL_pending(WOLFSSL*);
296 WOLFSSL_API void wolfSSL_load_error_strings(void);
297 WOLFSSL_API int wolfSSL_library_init(void);
298 WOLFSSL_API long wolfSSL_CTX_set_session_cache_mode(WOLFSSL_CTX*, long);
300 #ifdef HAVE_SECRET_CALLBACK
301 typedef int (*SessionSecretCb)(WOLFSSL* ssl,
302 void* secret, int* secretSz, void* ctx);
303 WOLFSSL_API int wolfSSL_set_session_secret_cb(WOLFSSL*, SessionSecretCb, void*);
304 #endif /* HAVE_SECRET_CALLBACK */
306 /* session cache persistence */
307 WOLFSSL_API int wolfSSL_save_session_cache(const char*);
308 WOLFSSL_API int wolfSSL_restore_session_cache(const char*);
309 WOLFSSL_API int wolfSSL_memsave_session_cache(void*, int);
310 WOLFSSL_API int wolfSSL_memrestore_session_cache(const void*, int);
311 WOLFSSL_API int wolfSSL_get_session_cache_memsize(void);
313 /* certificate cache persistence, uses ctx since certs are per ctx */
314 WOLFSSL_API int wolfSSL_CTX_save_cert_cache(WOLFSSL_CTX*, const char*);
315 WOLFSSL_API int wolfSSL_CTX_restore_cert_cache(WOLFSSL_CTX*, const char*);
316 WOLFSSL_API int wolfSSL_CTX_memsave_cert_cache(WOLFSSL_CTX*, void*, int, int*);
317 WOLFSSL_API int wolfSSL_CTX_memrestore_cert_cache(WOLFSSL_CTX*, const void*, int);
318 WOLFSSL_API int wolfSSL_CTX_get_cert_cache_memsize(WOLFSSL_CTX*);
320 /* only supports full name from cipher_name[] delimited by : */
321 WOLFSSL_API int wolfSSL_CTX_set_cipher_list(WOLFSSL_CTX*, const char*);
322 WOLFSSL_API int wolfSSL_set_cipher_list(WOLFSSL*, const char*);
324 /* Nonblocking DTLS helper functions */
325 WOLFSSL_API int wolfSSL_dtls_get_current_timeout(WOLFSSL* ssl);
326 WOLFSSL_API int wolfSSL_dtls_set_timeout_init(WOLFSSL* ssl, int);
327 WOLFSSL_API int wolfSSL_dtls_set_timeout_max(WOLFSSL* ssl, int);
328 WOLFSSL_API int wolfSSL_dtls_got_timeout(WOLFSSL* ssl);
329 WOLFSSL_API int wolfSSL_dtls(WOLFSSL* ssl);
331 WOLFSSL_API int wolfSSL_dtls_set_peer(WOLFSSL*, void*, unsigned int);
332 WOLFSSL_API int wolfSSL_dtls_get_peer(WOLFSSL*, void*, unsigned int*);
334 WOLFSSL_API int wolfSSL_ERR_GET_REASON(int err);
335 WOLFSSL_API char* wolfSSL_ERR_error_string(unsigned long,char*);
336 WOLFSSL_API void wolfSSL_ERR_error_string_n(unsigned long e, char* buf,
338 WOLFSSL_API const char* wolfSSL_ERR_reason_error_string(unsigned long);
342 #define STACK_OF(x) x
344 WOLFSSL_API int wolfSSL_set_ex_data(WOLFSSL*, int, void*);
345 WOLFSSL_API int wolfSSL_get_shutdown(const WOLFSSL*);
346 WOLFSSL_API int wolfSSL_set_rfd(WOLFSSL*, int);
347 WOLFSSL_API int wolfSSL_set_wfd(WOLFSSL*, int);
348 WOLFSSL_API void wolfSSL_set_shutdown(WOLFSSL*, int);
349 WOLFSSL_API int wolfSSL_set_session_id_context(WOLFSSL*, const unsigned char*,
351 WOLFSSL_API void wolfSSL_set_connect_state(WOLFSSL*);
352 WOLFSSL_API void wolfSSL_set_accept_state(WOLFSSL*);
353 WOLFSSL_API int wolfSSL_session_reused(WOLFSSL*);
354 WOLFSSL_API void wolfSSL_SESSION_free(WOLFSSL_SESSION* session);
355 WOLFSSL_API int wolfSSL_is_init_finished(WOLFSSL*);
357 WOLFSSL_API const char* wolfSSL_get_version(WOLFSSL*);
358 WOLFSSL_API int wolfSSL_get_current_cipher_suite(WOLFSSL* ssl);
359 WOLFSSL_API WOLFSSL_CIPHER* wolfSSL_get_current_cipher(WOLFSSL*);
360 WOLFSSL_API char* wolfSSL_CIPHER_description(WOLFSSL_CIPHER*, char*, int);
361 WOLFSSL_API const char* wolfSSL_CIPHER_get_name(const WOLFSSL_CIPHER* cipher);
362 WOLFSSL_API const char* wolfSSL_get_cipher(WOLFSSL*);
363 WOLFSSL_API WOLFSSL_SESSION* wolfSSL_get1_session(WOLFSSL* ssl);
364 /* what's ref count */
366 WOLFSSL_API void wolfSSL_X509_free(WOLFSSL_X509*);
367 WOLFSSL_API void wolfSSL_OPENSSL_free(void*);
369 WOLFSSL_API int wolfSSL_OCSP_parse_url(char* url, char** host, char** port,
370 char** path, int* ssl);
372 WOLFSSL_API WOLFSSL_METHOD* wolfSSLv23_client_method(void);
373 WOLFSSL_API WOLFSSL_METHOD* wolfSSLv2_client_method(void);
374 WOLFSSL_API WOLFSSL_METHOD* wolfSSLv2_server_method(void);
376 WOLFSSL_API void wolfSSL_MD4_Init(WOLFSSL_MD4_CTX*);
377 WOLFSSL_API void wolfSSL_MD4_Update(WOLFSSL_MD4_CTX*, const void*, unsigned long);
378 WOLFSSL_API void wolfSSL_MD4_Final(unsigned char*, WOLFSSL_MD4_CTX*);
381 WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new(WOLFSSL_BIO_METHOD*);
382 WOLFSSL_API int wolfSSL_BIO_free(WOLFSSL_BIO*);
383 WOLFSSL_API int wolfSSL_BIO_free_all(WOLFSSL_BIO*);
384 WOLFSSL_API int wolfSSL_BIO_read(WOLFSSL_BIO*, void*, int);
385 WOLFSSL_API int wolfSSL_BIO_write(WOLFSSL_BIO*, const void*, int);
386 WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_push(WOLFSSL_BIO*, WOLFSSL_BIO* append);
387 WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_pop(WOLFSSL_BIO*);
388 WOLFSSL_API int wolfSSL_BIO_flush(WOLFSSL_BIO*);
389 WOLFSSL_API int wolfSSL_BIO_pending(WOLFSSL_BIO*);
391 WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_buffer(void);
392 WOLFSSL_API long wolfSSL_BIO_set_write_buffer_size(WOLFSSL_BIO*, long size);
393 WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_ssl(void);
394 WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new_socket(int sfd, int flag);
395 WOLFSSL_API int wolfSSL_BIO_eof(WOLFSSL_BIO*);
397 WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_s_mem(void);
398 WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_base64(void);
399 WOLFSSL_API void wolfSSL_BIO_set_flags(WOLFSSL_BIO*, int);
401 WOLFSSL_API int wolfSSL_BIO_get_mem_data(WOLFSSL_BIO* bio,const unsigned char** p);
402 WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new_mem_buf(void* buf, int len);
405 WOLFSSL_API long wolfSSL_BIO_set_ssl(WOLFSSL_BIO*, WOLFSSL*, int flag);
406 WOLFSSL_API void wolfSSL_set_bio(WOLFSSL*, WOLFSSL_BIO* rd, WOLFSSL_BIO* wr);
408 WOLFSSL_API int wolfSSL_add_all_algorithms(void);
410 WOLFSSL_API void wolfSSL_RAND_screen(void);
411 WOLFSSL_API const char* wolfSSL_RAND_file_name(char*, unsigned long);
412 WOLFSSL_API int wolfSSL_RAND_write_file(const char*);
413 WOLFSSL_API int wolfSSL_RAND_load_file(const char*, long);
414 WOLFSSL_API int wolfSSL_RAND_egd(const char*);
415 WOLFSSL_API int wolfSSL_RAND_seed(const void*, int);
416 WOLFSSL_API void wolfSSL_RAND_add(const void*, int, double);
418 WOLFSSL_API WOLFSSL_COMP_METHOD* wolfSSL_COMP_zlib(void);
419 WOLFSSL_API WOLFSSL_COMP_METHOD* wolfSSL_COMP_rle(void);
420 WOLFSSL_API int wolfSSL_COMP_add_compression_method(int, void*);
422 WOLFSSL_API int wolfSSL_get_ex_new_index(long, void*, void*, void*, void*);
424 WOLFSSL_API void wolfSSL_set_id_callback(unsigned long (*f)(void));
425 WOLFSSL_API void wolfSSL_set_locking_callback(void (*f)(int, int, const char*,
427 WOLFSSL_API void wolfSSL_set_dynlock_create_callback(WOLFSSL_dynlock_value* (*f)
429 WOLFSSL_API void wolfSSL_set_dynlock_lock_callback(void (*f)(int,
430 WOLFSSL_dynlock_value*, const char*, int));
431 WOLFSSL_API void wolfSSL_set_dynlock_destroy_callback(void (*f)
432 (WOLFSSL_dynlock_value*, const char*, int));
433 WOLFSSL_API int wolfSSL_num_locks(void);
435 WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_STORE_CTX_get_current_cert(
436 WOLFSSL_X509_STORE_CTX*);
437 WOLFSSL_API int wolfSSL_X509_STORE_CTX_get_error(WOLFSSL_X509_STORE_CTX*);
438 WOLFSSL_API int wolfSSL_X509_STORE_CTX_get_error_depth(WOLFSSL_X509_STORE_CTX*);
440 WOLFSSL_API char* wolfSSL_X509_NAME_oneline(WOLFSSL_X509_NAME*, char*, int);
441 WOLFSSL_API WOLFSSL_X509_NAME* wolfSSL_X509_get_issuer_name(WOLFSSL_X509*);
442 WOLFSSL_API WOLFSSL_X509_NAME* wolfSSL_X509_get_subject_name(WOLFSSL_X509*);
443 WOLFSSL_API int wolfSSL_X509_ext_isSet_by_NID(WOLFSSL_X509*, int);
444 WOLFSSL_API int wolfSSL_X509_ext_get_critical_by_NID(WOLFSSL_X509*, int);
445 WOLFSSL_API int wolfSSL_X509_get_isCA(WOLFSSL_X509*);
446 WOLFSSL_API int wolfSSL_X509_get_isSet_pathLength(WOLFSSL_X509*);
447 WOLFSSL_API unsigned int wolfSSL_X509_get_pathLength(WOLFSSL_X509*);
448 WOLFSSL_API unsigned int wolfSSL_X509_get_keyUsage(WOLFSSL_X509*);
449 WOLFSSL_API unsigned char* wolfSSL_X509_get_authorityKeyID(
450 WOLFSSL_X509*, unsigned char*, int*);
451 WOLFSSL_API unsigned char* wolfSSL_X509_get_subjectKeyID(
452 WOLFSSL_X509*, unsigned char*, int*);
453 WOLFSSL_API int wolfSSL_X509_NAME_entry_count(WOLFSSL_X509_NAME*);
454 WOLFSSL_API int wolfSSL_X509_NAME_get_text_by_NID(
455 WOLFSSL_X509_NAME*, int, char*, int);
456 WOLFSSL_API int wolfSSL_X509_verify_cert(WOLFSSL_X509_STORE_CTX*);
457 WOLFSSL_API const char* wolfSSL_X509_verify_cert_error_string(long);
458 WOLFSSL_API int wolfSSL_X509_get_signature_type(WOLFSSL_X509*);
459 WOLFSSL_API int wolfSSL_X509_get_signature(WOLFSSL_X509*, unsigned char*, int*);
461 WOLFSSL_API int wolfSSL_X509_LOOKUP_add_dir(WOLFSSL_X509_LOOKUP*,const char*,long);
462 WOLFSSL_API int wolfSSL_X509_LOOKUP_load_file(WOLFSSL_X509_LOOKUP*, const char*,
464 WOLFSSL_API WOLFSSL_X509_LOOKUP_METHOD* wolfSSL_X509_LOOKUP_hash_dir(void);
465 WOLFSSL_API WOLFSSL_X509_LOOKUP_METHOD* wolfSSL_X509_LOOKUP_file(void);
467 WOLFSSL_API WOLFSSL_X509_LOOKUP* wolfSSL_X509_STORE_add_lookup(WOLFSSL_X509_STORE*,
468 WOLFSSL_X509_LOOKUP_METHOD*);
469 WOLFSSL_API WOLFSSL_X509_STORE* wolfSSL_X509_STORE_new(void);
470 WOLFSSL_API void wolfSSL_X509_STORE_free(WOLFSSL_X509_STORE*);
471 WOLFSSL_API int wolfSSL_X509_STORE_add_cert(
472 WOLFSSL_X509_STORE*, WOLFSSL_X509*);
473 WOLFSSL_API int wolfSSL_X509_STORE_set_default_paths(WOLFSSL_X509_STORE*);
474 WOLFSSL_API int wolfSSL_X509_STORE_get_by_subject(WOLFSSL_X509_STORE_CTX*,
475 int, WOLFSSL_X509_NAME*, WOLFSSL_X509_OBJECT*);
476 WOLFSSL_API WOLFSSL_X509_STORE_CTX* wolfSSL_X509_STORE_CTX_new(void);
477 WOLFSSL_API int wolfSSL_X509_STORE_CTX_init(WOLFSSL_X509_STORE_CTX*,
478 WOLFSSL_X509_STORE*, WOLFSSL_X509*, STACK_OF(WOLFSSL_X509)*);
479 WOLFSSL_API void wolfSSL_X509_STORE_CTX_free(WOLFSSL_X509_STORE_CTX*);
480 WOLFSSL_API void wolfSSL_X509_STORE_CTX_cleanup(WOLFSSL_X509_STORE_CTX*);
482 WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_X509_CRL_get_lastUpdate(WOLFSSL_X509_CRL*);
483 WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_X509_CRL_get_nextUpdate(WOLFSSL_X509_CRL*);
485 WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_X509_get_pubkey(WOLFSSL_X509*);
486 WOLFSSL_API int wolfSSL_X509_CRL_verify(WOLFSSL_X509_CRL*, WOLFSSL_EVP_PKEY*);
487 WOLFSSL_API void wolfSSL_X509_STORE_CTX_set_error(WOLFSSL_X509_STORE_CTX*,
489 WOLFSSL_API void wolfSSL_X509_OBJECT_free_contents(WOLFSSL_X509_OBJECT*);
490 WOLFSSL_API void wolfSSL_EVP_PKEY_free(WOLFSSL_EVP_PKEY*);
491 WOLFSSL_API int wolfSSL_X509_cmp_current_time(const WOLFSSL_ASN1_TIME*);
492 WOLFSSL_API int wolfSSL_sk_X509_REVOKED_num(WOLFSSL_X509_REVOKED*);
494 WOLFSSL_API WOLFSSL_X509_REVOKED* wolfSSL_X509_CRL_get_REVOKED(WOLFSSL_X509_CRL*);
495 WOLFSSL_API WOLFSSL_X509_REVOKED* wolfSSL_sk_X509_REVOKED_value(
496 WOLFSSL_X509_REVOKED*,int);
497 WOLFSSL_API WOLFSSL_ASN1_INTEGER* wolfSSL_X509_get_serialNumber(WOLFSSL_X509*);
499 WOLFSSL_API int wolfSSL_ASN1_TIME_print(WOLFSSL_BIO*, const WOLFSSL_ASN1_TIME*);
501 WOLFSSL_API int wolfSSL_ASN1_INTEGER_cmp(const WOLFSSL_ASN1_INTEGER*,
502 const WOLFSSL_ASN1_INTEGER*);
503 WOLFSSL_API long wolfSSL_ASN1_INTEGER_get(const WOLFSSL_ASN1_INTEGER*);
505 WOLFSSL_API STACK_OF(WOLFSSL_X509_NAME)* wolfSSL_load_client_CA_file(const char*);
507 WOLFSSL_API void wolfSSL_CTX_set_client_CA_list(WOLFSSL_CTX*,
508 STACK_OF(WOLFSSL_X509_NAME)*);
509 WOLFSSL_API void* wolfSSL_X509_STORE_CTX_get_ex_data(WOLFSSL_X509_STORE_CTX*, int);
510 WOLFSSL_API int wolfSSL_get_ex_data_X509_STORE_CTX_idx(void);
511 WOLFSSL_API void* wolfSSL_get_ex_data(const WOLFSSL*, int);
513 WOLFSSL_API void wolfSSL_CTX_set_default_passwd_cb_userdata(WOLFSSL_CTX*,
515 WOLFSSL_API void wolfSSL_CTX_set_default_passwd_cb(WOLFSSL_CTX*, pem_password_cb);
518 WOLFSSL_API void wolfSSL_CTX_set_info_callback(WOLFSSL_CTX*, void (*)(void));
520 WOLFSSL_API unsigned long wolfSSL_ERR_peek_error(void);
521 WOLFSSL_API int wolfSSL_GET_REASON(int);
523 WOLFSSL_API char* wolfSSL_alert_type_string_long(int);
524 WOLFSSL_API char* wolfSSL_alert_desc_string_long(int);
525 WOLFSSL_API char* wolfSSL_state_string_long(WOLFSSL*);
527 WOLFSSL_API WOLFSSL_RSA* wolfSSL_RSA_generate_key(int, unsigned long,
528 void(*)(int, int, void*), void*);
529 WOLFSSL_API void wolfSSL_CTX_set_tmp_rsa_callback(WOLFSSL_CTX*,
530 WOLFSSL_RSA*(*)(WOLFSSL*, int, int));
532 WOLFSSL_API int wolfSSL_PEM_def_callback(char*, int num, int w, void* key);
534 WOLFSSL_API long wolfSSL_CTX_sess_accept(WOLFSSL_CTX*);
535 WOLFSSL_API long wolfSSL_CTX_sess_connect(WOLFSSL_CTX*);
536 WOLFSSL_API long wolfSSL_CTX_sess_accept_good(WOLFSSL_CTX*);
537 WOLFSSL_API long wolfSSL_CTX_sess_connect_good(WOLFSSL_CTX*);
538 WOLFSSL_API long wolfSSL_CTX_sess_accept_renegotiate(WOLFSSL_CTX*);
539 WOLFSSL_API long wolfSSL_CTX_sess_connect_renegotiate(WOLFSSL_CTX*);
540 WOLFSSL_API long wolfSSL_CTX_sess_hits(WOLFSSL_CTX*);
541 WOLFSSL_API long wolfSSL_CTX_sess_cb_hits(WOLFSSL_CTX*);
542 WOLFSSL_API long wolfSSL_CTX_sess_cache_full(WOLFSSL_CTX*);
543 WOLFSSL_API long wolfSSL_CTX_sess_misses(WOLFSSL_CTX*);
544 WOLFSSL_API long wolfSSL_CTX_sess_timeouts(WOLFSSL_CTX*);
545 WOLFSSL_API long wolfSSL_CTX_sess_number(WOLFSSL_CTX*);
546 WOLFSSL_API long wolfSSL_CTX_sess_get_cache_size(WOLFSSL_CTX*);
548 #define WOLFSSL_DEFAULT_CIPHER_LIST "" /* default all */
549 #define WOLFSSL_RSA_F4 0x10001L
557 OCSP_NOEXPLICIT = 32,
559 OCSP_NODELEGATED = 128,
561 OCSP_TRUSTOTHER = 512,
562 OCSP_RESPID_KEY = 1024,
570 WOLFSSL_OCSP_URL_OVERRIDE = 1,
571 WOLFSSL_OCSP_NO_NONCE = 2,
572 WOLFSSL_OCSP_CHECKALL = 4,
574 WOLFSSL_CRL_CHECKALL = 1,
576 ASN1_GENERALIZEDTIME = 4,
578 SSL_OP_MICROSOFT_SESS_ID_BUG = 1,
579 SSL_OP_NETSCAPE_CHALLENGE_BUG = 2,
580 SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG = 3,
581 SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG = 4,
582 SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER = 5,
583 SSL_OP_MSIE_SSLV2_RSA_PADDING = 6,
584 SSL_OP_SSLEAY_080_CLIENT_DH_BUG = 7,
585 SSL_OP_TLS_D5_BUG = 8,
586 SSL_OP_TLS_BLOCK_PADDING_BUG = 9,
587 SSL_OP_TLS_ROLLBACK_BUG = 10,
589 SSL_OP_EPHEMERAL_RSA = 12,
590 SSL_OP_NO_SSLv3 = 13,
591 SSL_OP_NO_TLSv1 = 14,
592 SSL_OP_PKCS1_CHECK_1 = 15,
593 SSL_OP_PKCS1_CHECK_2 = 16,
594 SSL_OP_NETSCAPE_CA_DN_BUG = 17,
595 SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG = 18,
596 SSL_OP_SINGLE_DH_USE = 19,
597 SSL_OP_NO_TICKET = 20,
598 SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS = 21,
599 SSL_OP_NO_QUERY_MTU = 22,
600 SSL_OP_COOKIE_EXCHANGE = 23,
601 SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION = 24,
602 SSL_OP_SINGLE_ECDH_USE = 25,
603 SSL_OP_CIPHER_SERVER_PREFERENCE = 26,
605 SSL_MAX_SSL_SESSION_ID_LENGTH = 32,
607 EVP_R_BAD_DECRYPT = 2,
614 SSL_CB_HANDSHAKE_DONE = 9,
616 SSL_MODE_ENABLE_PARTIAL_WRITE = 2,
618 BIO_FLAGS_BASE64_NO_NL = 1,
624 X509_FILETYPE_PEM = 8,
628 X509_V_ERR_CRL_SIGNATURE_FAILURE = 13,
629 X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD = 14,
630 X509_V_ERR_CRL_HAS_EXPIRED = 15,
631 X509_V_ERR_CERT_REVOKED = 16,
632 X509_V_ERR_CERT_CHAIN_TOO_LONG = 17,
633 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT = 18,
634 X509_V_ERR_CERT_NOT_YET_VALID = 19,
635 X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD = 20,
636 X509_V_ERR_CERT_HAS_EXPIRED = 21,
637 X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD = 22,
642 CRYPTO_NUM_LOCKS = 10
647 #if !defined(NO_FILESYSTEM) && !defined(NO_STDIO_FILESYSTEM)
648 /* wolfSSL extension, provide last error from SSL_get_error
649 since not using thread storage error queue */
650 WOLFSSL_API void wolfSSL_ERR_print_errors_fp(FILE*, int err);
653 enum { /* ssl Constants */
654 SSL_ERROR_NONE = 0, /* for most functions */
655 SSL_FAILURE = 0, /* for some functions */
657 SSL_SHUTDOWN_NOT_DONE = 2, /* call wolfSSL_shutdown again to complete */
659 SSL_BAD_CERTTYPE = -8,
662 SSL_BAD_FILETYPE = -5,
664 SSL_NOT_IMPLEMENTED = -3,
666 SSL_FATAL_ERROR = -1,
668 SSL_FILETYPE_ASN1 = 2,
669 SSL_FILETYPE_PEM = 1,
670 SSL_FILETYPE_DEFAULT = 2, /* ASN1 */
671 SSL_FILETYPE_RAW = 3, /* NTRU raw key blob */
675 SSL_VERIFY_FAIL_IF_NO_PEER_CERT = 2,
676 SSL_VERIFY_CLIENT_ONCE = 4,
678 SSL_SESS_CACHE_OFF = 30,
679 SSL_SESS_CACHE_CLIENT = 31,
680 SSL_SESS_CACHE_SERVER = 32,
681 SSL_SESS_CACHE_BOTH = 33,
682 SSL_SESS_CACHE_NO_AUTO_CLEAR = 34,
683 SSL_SESS_CACHE_NO_INTERNAL_LOOKUP = 35,
685 SSL_ERROR_WANT_READ = 2,
686 SSL_ERROR_WANT_WRITE = 3,
687 SSL_ERROR_WANT_CONNECT = 7,
688 SSL_ERROR_WANT_ACCEPT = 8,
689 SSL_ERROR_SYSCALL = 5,
690 SSL_ERROR_WANT_X509_LOOKUP = 83,
691 SSL_ERROR_ZERO_RETURN = 6,
694 SSL_SENT_SHUTDOWN = 1,
695 SSL_RECEIVED_SHUTDOWN = 2,
696 SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER = 4,
699 SSL_R_SSL_HANDSHAKE_FAILURE = 101,
700 SSL_R_TLSV1_ALERT_UNKNOWN_CA = 102,
701 SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN = 103,
702 SSL_R_SSLV3_ALERT_BAD_CERTIFICATE = 104,
709 typedef unsigned int (*psk_client_callback)(WOLFSSL*, const char*, char*,
710 unsigned int, unsigned char*, unsigned int);
711 WOLFSSL_API void wolfSSL_CTX_set_psk_client_callback(WOLFSSL_CTX*,
712 psk_client_callback);
713 WOLFSSL_API void wolfSSL_set_psk_client_callback(WOLFSSL*,psk_client_callback);
715 WOLFSSL_API const char* wolfSSL_get_psk_identity_hint(const WOLFSSL*);
716 WOLFSSL_API const char* wolfSSL_get_psk_identity(const WOLFSSL*);
718 WOLFSSL_API int wolfSSL_CTX_use_psk_identity_hint(WOLFSSL_CTX*, const char*);
719 WOLFSSL_API int wolfSSL_use_psk_identity_hint(WOLFSSL*, const char*);
721 typedef unsigned int (*psk_server_callback)(WOLFSSL*, const char*,
722 unsigned char*, unsigned int);
723 WOLFSSL_API void wolfSSL_CTX_set_psk_server_callback(WOLFSSL_CTX*,
724 psk_server_callback);
725 WOLFSSL_API void wolfSSL_set_psk_server_callback(WOLFSSL*,psk_server_callback);
727 #define PSK_TYPES_DEFINED
732 WOLFSSL_API int wolfSSL_CTX_allow_anon_cipher(WOLFSSL_CTX*);
733 #endif /* HAVE_ANON */
738 enum { /* ERR Constants */
742 WOLFSSL_API unsigned long wolfSSL_ERR_get_error_line_data(const char**, int*,
743 const char**, int *);
745 WOLFSSL_API unsigned long wolfSSL_ERR_get_error(void);
746 WOLFSSL_API void wolfSSL_ERR_clear_error(void);
749 WOLFSSL_API int wolfSSL_RAND_status(void);
750 WOLFSSL_API int wolfSSL_RAND_bytes(unsigned char* buf, int num);
751 WOLFSSL_API WOLFSSL_METHOD *wolfSSLv23_server_method(void);
752 WOLFSSL_API long wolfSSL_CTX_set_options(WOLFSSL_CTX*, long);
754 WOLFSSL_API int wolfSSL_CTX_check_private_key(WOLFSSL_CTX*);
755 #endif /* !NO_CERTS */
757 WOLFSSL_API void wolfSSL_ERR_free_strings(void);
758 WOLFSSL_API void wolfSSL_ERR_remove_state(unsigned long);
759 WOLFSSL_API void wolfSSL_EVP_cleanup(void);
760 WOLFSSL_API int wolfSSL_clear(WOLFSSL* ssl);
762 WOLFSSL_API void wolfSSL_cleanup_all_ex_data(void);
763 WOLFSSL_API long wolfSSL_CTX_set_mode(WOLFSSL_CTX* ctx, long mode);
764 WOLFSSL_API long wolfSSL_CTX_get_mode(WOLFSSL_CTX* ctx);
765 WOLFSSL_API void wolfSSL_CTX_set_default_read_ahead(WOLFSSL_CTX* ctx, int m);
766 WOLFSSL_API long wolfSSL_SSL_get_mode(WOLFSSL* ssl);
768 WOLFSSL_API long wolfSSL_CTX_sess_set_cache_size(WOLFSSL_CTX*, long);
770 WOLFSSL_API int wolfSSL_CTX_set_default_verify_paths(WOLFSSL_CTX*);
771 WOLFSSL_API int wolfSSL_CTX_set_session_id_context(WOLFSSL_CTX*,
772 const unsigned char*, unsigned int);
773 WOLFSSL_API WOLFSSL_X509* wolfSSL_get_peer_certificate(WOLFSSL* ssl);
775 WOLFSSL_API int wolfSSL_want_read(WOLFSSL*);
776 WOLFSSL_API int wolfSSL_want_write(WOLFSSL*);
778 WOLFSSL_API int wolfSSL_BIO_printf(WOLFSSL_BIO*, const char*, ...);
779 WOLFSSL_API int wolfSSL_ASN1_UTCTIME_print(WOLFSSL_BIO*,
780 const WOLFSSL_ASN1_UTCTIME*);
781 WOLFSSL_API int wolfSSL_sk_num(WOLFSSL_X509_REVOKED*);
782 WOLFSSL_API void* wolfSSL_sk_value(WOLFSSL_X509_REVOKED*, int);
784 /* stunnel 4.28 needs */
785 WOLFSSL_API void* wolfSSL_CTX_get_ex_data(const WOLFSSL_CTX*, int);
786 WOLFSSL_API int wolfSSL_CTX_set_ex_data(WOLFSSL_CTX*, int, void*);
787 WOLFSSL_API void wolfSSL_CTX_sess_set_get_cb(WOLFSSL_CTX*,
788 WOLFSSL_SESSION*(*f)(WOLFSSL*, unsigned char*, int, int*));
789 WOLFSSL_API void wolfSSL_CTX_sess_set_new_cb(WOLFSSL_CTX*,
790 int (*f)(WOLFSSL*, WOLFSSL_SESSION*));
791 WOLFSSL_API void wolfSSL_CTX_sess_set_remove_cb(WOLFSSL_CTX*,
792 void (*f)(WOLFSSL_CTX*, WOLFSSL_SESSION*));
794 WOLFSSL_API int wolfSSL_i2d_SSL_SESSION(WOLFSSL_SESSION*,unsigned char**);
795 WOLFSSL_API WOLFSSL_SESSION* wolfSSL_d2i_SSL_SESSION(WOLFSSL_SESSION**,
796 const unsigned char**, long);
798 WOLFSSL_API long wolfSSL_SESSION_get_timeout(const WOLFSSL_SESSION*);
799 WOLFSSL_API long wolfSSL_SESSION_get_time(const WOLFSSL_SESSION*);
800 WOLFSSL_API int wolfSSL_CTX_get_ex_new_index(long, void*, void*, void*, void*);
805 /* wolfSSL extensions */
807 /* call before SSL_connect, if verifying will add name check to
808 date check and signature check */
809 WOLFSSL_API int wolfSSL_check_domain_name(WOLFSSL* ssl, const char* dn);
811 /* need to call once to load library (session cache) */
812 WOLFSSL_API int wolfSSL_Init(void);
813 /* call when done to cleanup/free session cache mutex / resources */
814 WOLFSSL_API int wolfSSL_Cleanup(void);
816 /* which library version do we have */
817 WOLFSSL_API const char* wolfSSL_lib_version(void);
818 /* which library version do we have in hex */
819 WOLFSSL_API unsigned int wolfSSL_lib_version_hex(void);
821 /* turn logging on, only if compiled in */
822 WOLFSSL_API int wolfSSL_Debugging_ON(void);
823 /* turn logging off */
824 WOLFSSL_API void wolfSSL_Debugging_OFF(void);
826 /* do accept or connect depedning on side */
827 WOLFSSL_API int wolfSSL_negotiate(WOLFSSL* ssl);
828 /* turn on wolfSSL data compression */
829 WOLFSSL_API int wolfSSL_set_compression(WOLFSSL* ssl);
831 WOLFSSL_API int wolfSSL_set_timeout(WOLFSSL*, unsigned int);
832 WOLFSSL_API int wolfSSL_CTX_set_timeout(WOLFSSL_CTX*, unsigned int);
834 /* get wolfSSL peer X509_CHAIN */
835 WOLFSSL_API WOLFSSL_X509_CHAIN* wolfSSL_get_peer_chain(WOLFSSL* ssl);
836 /* peer chain count */
837 WOLFSSL_API int wolfSSL_get_chain_count(WOLFSSL_X509_CHAIN* chain);
838 /* index cert length */
839 WOLFSSL_API int wolfSSL_get_chain_length(WOLFSSL_X509_CHAIN*, int idx);
841 WOLFSSL_API unsigned char* wolfSSL_get_chain_cert(WOLFSSL_X509_CHAIN*, int idx);
842 /* index cert in X509 */
843 WOLFSSL_API WOLFSSL_X509* wolfSSL_get_chain_X509(WOLFSSL_X509_CHAIN*, int idx);
845 WOLFSSL_API void wolfSSL_FreeX509(WOLFSSL_X509*);
846 /* get index cert in PEM */
847 WOLFSSL_API int wolfSSL_get_chain_cert_pem(WOLFSSL_X509_CHAIN*, int idx,
848 unsigned char* buffer, int inLen, int* outLen);
849 WOLFSSL_API const unsigned char* wolfSSL_get_sessionID(const WOLFSSL_SESSION* s);
850 WOLFSSL_API int wolfSSL_X509_get_serial_number(WOLFSSL_X509*,unsigned char*,int*);
851 WOLFSSL_API char* wolfSSL_X509_get_subjectCN(WOLFSSL_X509*);
852 WOLFSSL_API const unsigned char* wolfSSL_X509_get_der(WOLFSSL_X509*, int*);
853 WOLFSSL_API const unsigned char* wolfSSL_X509_notBefore(WOLFSSL_X509*);
854 WOLFSSL_API const unsigned char* wolfSSL_X509_notAfter(WOLFSSL_X509*);
855 WOLFSSL_API int wolfSSL_X509_version(WOLFSSL_X509*);
857 WOLFSSL_API int wolfSSL_cmp_peer_cert_to_file(WOLFSSL*, const char*);
859 WOLFSSL_API char* wolfSSL_X509_get_next_altname(WOLFSSL_X509*);
861 WOLFSSL_API WOLFSSL_X509*
862 wolfSSL_X509_d2i(WOLFSSL_X509** x509, const unsigned char* in, int len);
863 #ifndef NO_FILESYSTEM
864 #ifndef NO_STDIO_FILESYSTEM
865 WOLFSSL_API WOLFSSL_X509*
866 wolfSSL_X509_d2i_fp(WOLFSSL_X509** x509, FILE* file);
868 WOLFSSL_API WOLFSSL_X509*
869 wolfSSL_X509_load_certificate_file(const char* fname, int format);
873 WOLFSSL_API unsigned char*
874 wolfSSL_X509_get_device_type(WOLFSSL_X509*, unsigned char*, int*);
875 WOLFSSL_API unsigned char*
876 wolfSSL_X509_get_hw_type(WOLFSSL_X509*, unsigned char*, int*);
877 WOLFSSL_API unsigned char*
878 wolfSSL_X509_get_hw_serial_number(WOLFSSL_X509*, unsigned char*, int*);
881 /* connect enough to get peer cert */
882 WOLFSSL_API int wolfSSL_connect_cert(WOLFSSL* ssl);
885 /* server Diffie-Hellman parameters */
886 WOLFSSL_API int wolfSSL_SetTmpDH(WOLFSSL*, const unsigned char* p, int pSz,
887 const unsigned char* g, int gSz);
888 WOLFSSL_API int wolfSSL_SetTmpDH_buffer(WOLFSSL*, const unsigned char* b, long sz,
890 #ifndef NO_FILESYSTEM
891 WOLFSSL_API int wolfSSL_SetTmpDH_file(WOLFSSL*, const char* f, int format);
894 /* server ctx Diffie-Hellman parameters */
895 WOLFSSL_API int wolfSSL_CTX_SetTmpDH(WOLFSSL_CTX*, const unsigned char* p,
896 int pSz, const unsigned char* g, int gSz);
897 WOLFSSL_API int wolfSSL_CTX_SetTmpDH_buffer(WOLFSSL_CTX*, const unsigned char* b,
898 long sz, int format);
900 #ifndef NO_FILESYSTEM
901 WOLFSSL_API int wolfSSL_CTX_SetTmpDH_file(WOLFSSL_CTX*, const char* f,
905 WOLFSSL_API int wolfSSL_CTX_SetMinDhKey_Sz(WOLFSSL_CTX*, unsigned short);
906 WOLFSSL_API int wolfSSL_SetMinDhKey_Sz(WOLFSSL*, unsigned short);
907 WOLFSSL_API int wolfSSL_GetDhKey_Sz(WOLFSSL*);
910 WOLFSSL_API int wolfSSL_SetTmpEC_DHE_Sz(WOLFSSL*, unsigned short);
911 WOLFSSL_API int wolfSSL_CTX_SetTmpEC_DHE_Sz(WOLFSSL_CTX*, unsigned short);
913 /* keyblock size in bytes or -1 */
914 /* need to call wolfSSL_KeepArrays before handshake to save keys */
915 WOLFSSL_API int wolfSSL_get_keyblock_size(WOLFSSL*);
916 WOLFSSL_API int wolfSSL_get_keys(WOLFSSL*,unsigned char** ms, unsigned int* msLen,
917 unsigned char** sr, unsigned int* srLen,
918 unsigned char** cr, unsigned int* crLen);
920 /* Computes EAP-TLS and EAP-TTLS keying material from the master_secret. */
921 WOLFSSL_API int wolfSSL_make_eap_keys(WOLFSSL*, void* key, unsigned int len,
928 #include <sys/types.h>
929 #include <sys/socket.h>
930 #elif !defined(WOLFSSL_MDK_ARM) && !defined(WOLFSSL_IAR_ARM) && !defined(WOLFSSL_PICOTCP)
933 /* allow writev style writing */
934 WOLFSSL_API int wolfSSL_writev(WOLFSSL* ssl, const struct iovec* iov,
941 /* SSL_CTX versions */
942 WOLFSSL_API int wolfSSL_CTX_UnloadCAs(WOLFSSL_CTX*);
943 WOLFSSL_API int wolfSSL_CTX_load_verify_buffer(WOLFSSL_CTX*,
944 const unsigned char*, long, int);
945 WOLFSSL_API int wolfSSL_CTX_use_certificate_buffer(WOLFSSL_CTX*,
946 const unsigned char*, long, int);
947 WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_buffer(WOLFSSL_CTX*,
948 const unsigned char*, long, int);
949 WOLFSSL_API int wolfSSL_CTX_use_certificate_chain_buffer(WOLFSSL_CTX*,
950 const unsigned char*, long);
953 WOLFSSL_API int wolfSSL_use_certificate_buffer(WOLFSSL*, const unsigned char*,
955 WOLFSSL_API int wolfSSL_use_PrivateKey_buffer(WOLFSSL*, const unsigned char*,
957 WOLFSSL_API int wolfSSL_use_certificate_chain_buffer(WOLFSSL*,
958 const unsigned char*, long);
959 WOLFSSL_API int wolfSSL_UnloadCertsKeys(WOLFSSL*);
962 WOLFSSL_API int wolfSSL_CTX_set_group_messages(WOLFSSL_CTX*);
963 WOLFSSL_API int wolfSSL_set_group_messages(WOLFSSL*);
966 typedef int (*CallbackIORecv)(WOLFSSL *ssl, char *buf, int sz, void *ctx);
967 typedef int (*CallbackIOSend)(WOLFSSL *ssl, char *buf, int sz, void *ctx);
978 typedef int (*CallbackFuzzer)(WOLFSSL* ssl, const unsigned char* buf, int sz,
979 int type, void* fuzzCtx);
981 WOLFSSL_API void wolfSSL_SetFuzzerCb(WOLFSSL* ssl, CallbackFuzzer cbf, void* fCtx);
984 WOLFSSL_API void wolfSSL_SetIORecv(WOLFSSL_CTX*, CallbackIORecv);
985 WOLFSSL_API void wolfSSL_SetIOSend(WOLFSSL_CTX*, CallbackIOSend);
987 WOLFSSL_API void wolfSSL_SetIOReadCtx( WOLFSSL* ssl, void *ctx);
988 WOLFSSL_API void wolfSSL_SetIOWriteCtx(WOLFSSL* ssl, void *ctx);
990 WOLFSSL_API void* wolfSSL_GetIOReadCtx( WOLFSSL* ssl);
991 WOLFSSL_API void* wolfSSL_GetIOWriteCtx(WOLFSSL* ssl);
993 WOLFSSL_API void wolfSSL_SetIOReadFlags( WOLFSSL* ssl, int flags);
994 WOLFSSL_API void wolfSSL_SetIOWriteFlags(WOLFSSL* ssl, int flags);
997 #ifndef WOLFSSL_USER_IO
998 /* default IO callbacks */
999 WOLFSSL_API int EmbedReceive(WOLFSSL* ssl, char* buf, int sz, void* ctx);
1000 WOLFSSL_API int EmbedSend(WOLFSSL* ssl, char* buf, int sz, void* ctx);
1003 WOLFSSL_API int EmbedOcspLookup(void*, const char*, int, unsigned char*,
1004 int, unsigned char**);
1005 WOLFSSL_API void EmbedOcspRespFree(void*, unsigned char*);
1009 WOLFSSL_API int EmbedReceiveFrom(WOLFSSL* ssl, char* buf, int sz, void*);
1010 WOLFSSL_API int EmbedSendTo(WOLFSSL* ssl, char* buf, int sz, void* ctx);
1011 WOLFSSL_API int EmbedGenerateCookie(WOLFSSL* ssl, unsigned char* buf,
1013 #endif /* WOLFSSL_DTLS */
1014 #endif /* WOLFSSL_USER_IO */
1018 WOLFSSL_API void wolfSSL_SetIO_NetX(WOLFSSL* ssl, NX_TCP_SOCKET* nxsocket,
1022 typedef int (*CallbackGenCookie)(WOLFSSL* ssl, unsigned char* buf, int sz,
1024 WOLFSSL_API void wolfSSL_CTX_SetGenCookie(WOLFSSL_CTX*, CallbackGenCookie);
1025 WOLFSSL_API void wolfSSL_SetCookieCtx(WOLFSSL* ssl, void *ctx);
1026 WOLFSSL_API void* wolfSSL_GetCookieCtx(WOLFSSL* ssl);
1029 /* I/O Callback default errors */
1031 WOLFSSL_CBIO_ERR_GENERAL = -1, /* general unexpected err */
1032 WOLFSSL_CBIO_ERR_WANT_READ = -2, /* need to call read again */
1033 WOLFSSL_CBIO_ERR_WANT_WRITE = -2, /* need to call write again */
1034 WOLFSSL_CBIO_ERR_CONN_RST = -3, /* connection reset */
1035 WOLFSSL_CBIO_ERR_ISR = -4, /* interrupt */
1036 WOLFSSL_CBIO_ERR_CONN_CLOSE = -5, /* connection closed or epipe */
1037 WOLFSSL_CBIO_ERR_TIMEOUT = -6 /* socket timeout */
1041 /* CA cache callbacks */
1045 WOLFSSL_TLSV1_1 = 2,
1046 WOLFSSL_TLSV1_2 = 3,
1047 WOLFSSL_USER_CA = 1, /* user added as trusted */
1048 WOLFSSL_CHAIN_CA = 2 /* added to cache from trusted chain */
1051 WOLFSSL_API int wolfSSL_CTX_SetMinVersion(WOLFSSL_CTX* ctx, int version);
1052 WOLFSSL_API int wolfSSL_SetMinVersion(WOLFSSL* ssl, int version);
1053 WOLFSSL_API int wolfSSL_GetObjectSize(void); /* object size based on build */
1054 WOLFSSL_API int wolfSSL_SetVersion(WOLFSSL* ssl, int version);
1055 WOLFSSL_API int wolfSSL_KeyPemToDer(const unsigned char*, int sz, unsigned char*,
1057 WOLFSSL_API int wolfSSL_CertPemToDer(const unsigned char*, int sz, unsigned char*,
1060 typedef void (*CallbackCACache)(unsigned char* der, int sz, int type);
1061 typedef void (*CbMissingCRL)(const char* url);
1062 typedef int (*CbOCSPIO)(void*, const char*, int,
1063 unsigned char*, int, unsigned char**);
1064 typedef void (*CbOCSPRespFree)(void*,unsigned char*);
1066 /* User Atomic Record Layer CallBacks */
1067 typedef int (*CallbackMacEncrypt)(WOLFSSL* ssl, unsigned char* macOut,
1068 const unsigned char* macIn, unsigned int macInSz, int macContent,
1069 int macVerify, unsigned char* encOut, const unsigned char* encIn,
1070 unsigned int encSz, void* ctx);
1071 WOLFSSL_API void wolfSSL_CTX_SetMacEncryptCb(WOLFSSL_CTX*, CallbackMacEncrypt);
1072 WOLFSSL_API void wolfSSL_SetMacEncryptCtx(WOLFSSL* ssl, void *ctx);
1073 WOLFSSL_API void* wolfSSL_GetMacEncryptCtx(WOLFSSL* ssl);
1075 typedef int (*CallbackDecryptVerify)(WOLFSSL* ssl,
1076 unsigned char* decOut, const unsigned char* decIn,
1077 unsigned int decSz, int content, int verify, unsigned int* padSz,
1079 WOLFSSL_API void wolfSSL_CTX_SetDecryptVerifyCb(WOLFSSL_CTX*,
1080 CallbackDecryptVerify);
1081 WOLFSSL_API void wolfSSL_SetDecryptVerifyCtx(WOLFSSL* ssl, void *ctx);
1082 WOLFSSL_API void* wolfSSL_GetDecryptVerifyCtx(WOLFSSL* ssl);
1084 WOLFSSL_API const unsigned char* wolfSSL_GetMacSecret(WOLFSSL*, int);
1085 WOLFSSL_API const unsigned char* wolfSSL_GetClientWriteKey(WOLFSSL*);
1086 WOLFSSL_API const unsigned char* wolfSSL_GetClientWriteIV(WOLFSSL*);
1087 WOLFSSL_API const unsigned char* wolfSSL_GetServerWriteKey(WOLFSSL*);
1088 WOLFSSL_API const unsigned char* wolfSSL_GetServerWriteIV(WOLFSSL*);
1089 WOLFSSL_API int wolfSSL_GetKeySize(WOLFSSL*);
1090 WOLFSSL_API int wolfSSL_GetIVSize(WOLFSSL*);
1091 WOLFSSL_API int wolfSSL_GetSide(WOLFSSL*);
1092 WOLFSSL_API int wolfSSL_IsTLSv1_1(WOLFSSL*);
1093 WOLFSSL_API int wolfSSL_GetBulkCipher(WOLFSSL*);
1094 WOLFSSL_API int wolfSSL_GetCipherBlockSize(WOLFSSL*);
1095 WOLFSSL_API int wolfSSL_GetAeadMacSize(WOLFSSL*);
1096 WOLFSSL_API int wolfSSL_GetHmacSize(WOLFSSL*);
1097 WOLFSSL_API int wolfSSL_GetHmacType(WOLFSSL*);
1098 WOLFSSL_API int wolfSSL_GetCipherType(WOLFSSL*);
1099 WOLFSSL_API int wolfSSL_SetTlsHmacInner(WOLFSSL*, unsigned char*,
1100 unsigned int, int, int);
1102 /* Atomic User Needs */
1104 WOLFSSL_SERVER_END = 0,
1105 WOLFSSL_CLIENT_END = 1,
1106 WOLFSSL_BLOCK_TYPE = 2,
1107 WOLFSSL_STREAM_TYPE = 3,
1108 WOLFSSL_AEAD_TYPE = 4,
1109 WOLFSSL_TLS_HMAC_INNER_SZ = 13 /* SEQ_SZ + ENUM + VERSION_SZ + LEN_SZ */
1112 /* for GetBulkCipher and internal use */
1113 enum BulkCipherAlgorithm {
1114 wolfssl_cipher_null,
1118 wolfssl_triple_des, /* leading 3 (3des) not valid identifier */
1126 wolfssl_hc128, /* wolfSSL extensions */
1131 /* for KDF TLS 1.2 mac types */
1132 enum KDF_MacAlgorithm {
1133 wolfssl_sha256 = 4, /* needs to match internal MACAlgorithm */
1139 /* Public Key Callback support */
1140 typedef int (*CallbackEccSign)(WOLFSSL* ssl,
1141 const unsigned char* in, unsigned int inSz,
1142 unsigned char* out, unsigned int* outSz,
1143 const unsigned char* keyDer, unsigned int keySz,
1145 WOLFSSL_API void wolfSSL_CTX_SetEccSignCb(WOLFSSL_CTX*, CallbackEccSign);
1146 WOLFSSL_API void wolfSSL_SetEccSignCtx(WOLFSSL* ssl, void *ctx);
1147 WOLFSSL_API void* wolfSSL_GetEccSignCtx(WOLFSSL* ssl);
1149 typedef int (*CallbackEccVerify)(WOLFSSL* ssl,
1150 const unsigned char* sig, unsigned int sigSz,
1151 const unsigned char* hash, unsigned int hashSz,
1152 const unsigned char* keyDer, unsigned int keySz,
1153 int* result, void* ctx);
1154 WOLFSSL_API void wolfSSL_CTX_SetEccVerifyCb(WOLFSSL_CTX*, CallbackEccVerify);
1155 WOLFSSL_API void wolfSSL_SetEccVerifyCtx(WOLFSSL* ssl, void *ctx);
1156 WOLFSSL_API void* wolfSSL_GetEccVerifyCtx(WOLFSSL* ssl);
1158 typedef int (*CallbackRsaSign)(WOLFSSL* ssl,
1159 const unsigned char* in, unsigned int inSz,
1160 unsigned char* out, unsigned int* outSz,
1161 const unsigned char* keyDer, unsigned int keySz,
1163 WOLFSSL_API void wolfSSL_CTX_SetRsaSignCb(WOLFSSL_CTX*, CallbackRsaSign);
1164 WOLFSSL_API void wolfSSL_SetRsaSignCtx(WOLFSSL* ssl, void *ctx);
1165 WOLFSSL_API void* wolfSSL_GetRsaSignCtx(WOLFSSL* ssl);
1167 typedef int (*CallbackRsaVerify)(WOLFSSL* ssl,
1168 unsigned char* sig, unsigned int sigSz,
1169 unsigned char** out,
1170 const unsigned char* keyDer, unsigned int keySz,
1172 WOLFSSL_API void wolfSSL_CTX_SetRsaVerifyCb(WOLFSSL_CTX*, CallbackRsaVerify);
1173 WOLFSSL_API void wolfSSL_SetRsaVerifyCtx(WOLFSSL* ssl, void *ctx);
1174 WOLFSSL_API void* wolfSSL_GetRsaVerifyCtx(WOLFSSL* ssl);
1176 /* RSA Public Encrypt cb */
1177 typedef int (*CallbackRsaEnc)(WOLFSSL* ssl,
1178 const unsigned char* in, unsigned int inSz,
1179 unsigned char* out, unsigned int* outSz,
1180 const unsigned char* keyDer, unsigned int keySz,
1182 WOLFSSL_API void wolfSSL_CTX_SetRsaEncCb(WOLFSSL_CTX*, CallbackRsaEnc);
1183 WOLFSSL_API void wolfSSL_SetRsaEncCtx(WOLFSSL* ssl, void *ctx);
1184 WOLFSSL_API void* wolfSSL_GetRsaEncCtx(WOLFSSL* ssl);
1186 /* RSA Private Decrypt cb */
1187 typedef int (*CallbackRsaDec)(WOLFSSL* ssl,
1188 unsigned char* in, unsigned int inSz,
1189 unsigned char** out,
1190 const unsigned char* keyDer, unsigned int keySz,
1192 WOLFSSL_API void wolfSSL_CTX_SetRsaDecCb(WOLFSSL_CTX*, CallbackRsaDec);
1193 WOLFSSL_API void wolfSSL_SetRsaDecCtx(WOLFSSL* ssl, void *ctx);
1194 WOLFSSL_API void* wolfSSL_GetRsaDecCtx(WOLFSSL* ssl);
1198 WOLFSSL_API void wolfSSL_CTX_SetCACb(WOLFSSL_CTX*, CallbackCACache);
1200 WOLFSSL_API WOLFSSL_CERT_MANAGER* wolfSSL_CertManagerNew(void);
1201 WOLFSSL_API void wolfSSL_CertManagerFree(WOLFSSL_CERT_MANAGER*);
1203 WOLFSSL_API int wolfSSL_CertManagerLoadCA(WOLFSSL_CERT_MANAGER*, const char* f,
1205 WOLFSSL_API int wolfSSL_CertManagerUnloadCAs(WOLFSSL_CERT_MANAGER* cm);
1206 WOLFSSL_API int wolfSSL_CertManagerVerify(WOLFSSL_CERT_MANAGER*, const char* f,
1208 WOLFSSL_API int wolfSSL_CertManagerVerifyBuffer(WOLFSSL_CERT_MANAGER* cm,
1209 const unsigned char* buff, long sz, int format);
1210 WOLFSSL_API int wolfSSL_CertManagerCheckCRL(WOLFSSL_CERT_MANAGER*,
1211 unsigned char*, int sz);
1212 WOLFSSL_API int wolfSSL_CertManagerEnableCRL(WOLFSSL_CERT_MANAGER*,
1214 WOLFSSL_API int wolfSSL_CertManagerDisableCRL(WOLFSSL_CERT_MANAGER*);
1215 WOLFSSL_API int wolfSSL_CertManagerLoadCRL(WOLFSSL_CERT_MANAGER*, const char*,
1217 WOLFSSL_API int wolfSSL_CertManagerSetCRL_Cb(WOLFSSL_CERT_MANAGER*,
1219 WOLFSSL_API int wolfSSL_CertManagerCheckOCSP(WOLFSSL_CERT_MANAGER*,
1220 unsigned char*, int sz);
1221 WOLFSSL_API int wolfSSL_CertManagerEnableOCSP(WOLFSSL_CERT_MANAGER*,
1223 WOLFSSL_API int wolfSSL_CertManagerDisableOCSP(WOLFSSL_CERT_MANAGER*);
1224 WOLFSSL_API int wolfSSL_CertManagerSetOCSPOverrideURL(WOLFSSL_CERT_MANAGER*,
1226 WOLFSSL_API int wolfSSL_CertManagerSetOCSP_Cb(WOLFSSL_CERT_MANAGER*,
1227 CbOCSPIO, CbOCSPRespFree, void*);
1229 WOLFSSL_API int wolfSSL_EnableCRL(WOLFSSL* ssl, int options);
1230 WOLFSSL_API int wolfSSL_DisableCRL(WOLFSSL* ssl);
1231 WOLFSSL_API int wolfSSL_LoadCRL(WOLFSSL*, const char*, int, int);
1232 WOLFSSL_API int wolfSSL_SetCRL_Cb(WOLFSSL*, CbMissingCRL);
1233 WOLFSSL_API int wolfSSL_EnableOCSP(WOLFSSL*, int options);
1234 WOLFSSL_API int wolfSSL_DisableOCSP(WOLFSSL*);
1235 WOLFSSL_API int wolfSSL_SetOCSP_OverrideURL(WOLFSSL*, const char*);
1236 WOLFSSL_API int wolfSSL_SetOCSP_Cb(WOLFSSL*, CbOCSPIO, CbOCSPRespFree, void*);
1238 WOLFSSL_API int wolfSSL_CTX_EnableCRL(WOLFSSL_CTX* ctx, int options);
1239 WOLFSSL_API int wolfSSL_CTX_DisableCRL(WOLFSSL_CTX* ctx);
1240 WOLFSSL_API int wolfSSL_CTX_LoadCRL(WOLFSSL_CTX*, const char*, int, int);
1241 WOLFSSL_API int wolfSSL_CTX_SetCRL_Cb(WOLFSSL_CTX*, CbMissingCRL);
1242 WOLFSSL_API int wolfSSL_CTX_EnableOCSP(WOLFSSL_CTX*, int options);
1243 WOLFSSL_API int wolfSSL_CTX_DisableOCSP(WOLFSSL_CTX*);
1244 WOLFSSL_API int wolfSSL_CTX_SetOCSP_OverrideURL(WOLFSSL_CTX*, const char*);
1245 WOLFSSL_API int wolfSSL_CTX_SetOCSP_Cb(WOLFSSL_CTX*,
1246 CbOCSPIO, CbOCSPRespFree, void*);
1247 #endif /* !NO_CERTS */
1249 /* end of handshake frees temporary arrays, if user needs for get_keys or
1250 psk hints, call KeepArrays before handshake and then FreeArrays when done
1251 if don't want to wait for object free */
1252 WOLFSSL_API void wolfSSL_KeepArrays(WOLFSSL*);
1253 WOLFSSL_API void wolfSSL_FreeArrays(WOLFSSL*);
1256 /* cavium additions */
1257 WOLFSSL_API int wolfSSL_UseCavium(WOLFSSL*, int devId);
1258 WOLFSSL_API int wolfSSL_CTX_UseCavium(WOLFSSL_CTX*, int devId);
1260 /* TLS Extensions */
1262 /* Server Name Indication */
1267 WOLFSSL_SNI_HOST_NAME = 0
1270 WOLFSSL_API int wolfSSL_UseSNI(WOLFSSL* ssl, unsigned char type, const void* data,
1271 unsigned short size);
1272 WOLFSSL_API int wolfSSL_CTX_UseSNI(WOLFSSL_CTX* ctx, unsigned char type,
1273 const void* data, unsigned short size);
1275 #ifndef NO_WOLFSSL_SERVER
1279 WOLFSSL_SNI_CONTINUE_ON_MISMATCH = 0x01, /* do not abort on mismatch flag */
1280 WOLFSSL_SNI_ANSWER_ON_MISMATCH = 0x02 /* fake match on mismatch flag */
1283 WOLFSSL_API void wolfSSL_SNI_SetOptions(WOLFSSL* ssl, unsigned char type,
1284 unsigned char options);
1285 WOLFSSL_API void wolfSSL_CTX_SNI_SetOptions(WOLFSSL_CTX* ctx, unsigned char type,
1286 unsigned char options);
1290 WOLFSSL_SNI_NO_MATCH = 0,
1291 WOLFSSL_SNI_FAKE_MATCH = 1, /* if WOLFSSL_SNI_ANSWER_ON_MISMATCH is enabled */
1292 WOLFSSL_SNI_REAL_MATCH = 2
1295 WOLFSSL_API unsigned char wolfSSL_SNI_Status(WOLFSSL* ssl, unsigned char type);
1297 WOLFSSL_API unsigned short wolfSSL_SNI_GetRequest(WOLFSSL *ssl, unsigned char type,
1299 WOLFSSL_API int wolfSSL_SNI_GetFromBuffer(
1300 const unsigned char* clientHello, unsigned int helloSz,
1301 unsigned char type, unsigned char* sni, unsigned int* inOutSz);
1306 /* Maximum Fragment Length */
1307 #ifdef HAVE_MAX_FRAGMENT
1309 /* Fragment lengths */
1311 WOLFSSL_MFL_2_9 = 1, /* 512 bytes */
1312 WOLFSSL_MFL_2_10 = 2, /* 1024 bytes */
1313 WOLFSSL_MFL_2_11 = 3, /* 2048 bytes */
1314 WOLFSSL_MFL_2_12 = 4, /* 4096 bytes */
1315 WOLFSSL_MFL_2_13 = 5 /* 8192 bytes *//* wolfSSL ONLY!!! */
1318 #ifndef NO_WOLFSSL_CLIENT
1320 WOLFSSL_API int wolfSSL_UseMaxFragment(WOLFSSL* ssl, unsigned char mfl);
1321 WOLFSSL_API int wolfSSL_CTX_UseMaxFragment(WOLFSSL_CTX* ctx, unsigned char mfl);
1326 /* Truncated HMAC */
1327 #ifdef HAVE_TRUNCATED_HMAC
1328 #ifndef NO_WOLFSSL_CLIENT
1330 WOLFSSL_API int wolfSSL_UseTruncatedHMAC(WOLFSSL* ssl);
1331 WOLFSSL_API int wolfSSL_CTX_UseTruncatedHMAC(WOLFSSL_CTX* ctx);
1336 /* Elliptic Curves */
1338 WOLFSSL_ECC_SECP160R1 = 0x10,
1339 WOLFSSL_ECC_SECP192R1 = 0x13,
1340 WOLFSSL_ECC_SECP224R1 = 0x15,
1341 WOLFSSL_ECC_SECP256R1 = 0x17,
1342 WOLFSSL_ECC_SECP384R1 = 0x18,
1343 WOLFSSL_ECC_SECP521R1 = 0x19
1346 #ifdef HAVE_SUPPORTED_CURVES
1347 #ifndef NO_WOLFSSL_CLIENT
1349 WOLFSSL_API int wolfSSL_UseSupportedCurve(WOLFSSL* ssl, unsigned short name);
1350 WOLFSSL_API int wolfSSL_CTX_UseSupportedCurve(WOLFSSL_CTX* ctx,
1351 unsigned short name);
1356 /* Secure Renegotiation */
1357 #ifdef HAVE_SECURE_RENEGOTIATION
1359 WOLFSSL_API int wolfSSL_UseSecureRenegotiation(WOLFSSL* ssl);
1360 WOLFSSL_API int wolfSSL_Rehandshake(WOLFSSL* ssl);
1364 /* Session Ticket */
1365 #ifdef HAVE_SESSION_TICKET
1367 #ifndef NO_WOLFSSL_CLIENT
1368 WOLFSSL_API int wolfSSL_UseSessionTicket(WOLFSSL* ssl);
1369 WOLFSSL_API int wolfSSL_CTX_UseSessionTicket(WOLFSSL_CTX* ctx);
1370 WOLFSSL_API int wolfSSL_get_SessionTicket(WOLFSSL*, unsigned char*, unsigned int*);
1371 WOLFSSL_API int wolfSSL_set_SessionTicket(WOLFSSL*, unsigned char*, unsigned int);
1372 typedef int (*CallbackSessionTicket)(WOLFSSL*, const unsigned char*, int, void*);
1373 WOLFSSL_API int wolfSSL_set_SessionTicket_cb(WOLFSSL*,
1374 CallbackSessionTicket, void*);
1375 #endif /* NO_WOLFSSL_CLIENT */
1377 #ifndef NO_WOLFSSL_SERVER
1379 #define WOLFSSL_TICKET_NAME_SZ 16
1380 #define WOLFSSL_TICKET_IV_SZ 16
1381 #define WOLFSSL_TICKET_MAC_SZ 32
1384 WOLFSSL_TICKET_RET_FATAL = -1, /* fatal error, don't use ticket */
1385 WOLFSSL_TICKET_RET_OK = 0, /* ok, use ticket */
1386 WOLFSSL_TICKET_RET_REJECT, /* don't use ticket, but not fatal */
1387 WOLFSSL_TICKET_RET_CREATE /* existing ticket ok and create new one */
1390 typedef int (*SessionTicketEncCb)(WOLFSSL*,
1391 unsigned char key_name[WOLFSSL_TICKET_NAME_SZ],
1392 unsigned char iv[WOLFSSL_TICKET_IV_SZ],
1393 unsigned char mac[WOLFSSL_TICKET_MAC_SZ],
1394 int enc, unsigned char*, int, int*, void*);
1395 WOLFSSL_API int wolfSSL_CTX_set_TicketEncCb(WOLFSSL_CTX* ctx,
1396 SessionTicketEncCb);
1397 WOLFSSL_API int wolfSSL_CTX_set_TicketHint(WOLFSSL_CTX* ctx, int);
1398 WOLFSSL_API int wolfSSL_CTX_set_TicketEncCtx(WOLFSSL_CTX* ctx, void*);
1400 #endif /* NO_WOLFSSL_SERVER */
1402 #endif /* HAVE_SESSION_TICKET */
1404 #define WOLFSSL_CRL_MONITOR 0x01 /* monitor this dir flag */
1405 #define WOLFSSL_CRL_START_MON 0x02 /* start monitoring flag */
1408 /* notify user the hanshake is done */
1409 typedef int (*HandShakeDoneCb)(WOLFSSL*, void*);
1410 WOLFSSL_API int wolfSSL_SetHsDoneCb(WOLFSSL*, HandShakeDoneCb, void*);
1413 WOLFSSL_API int wolfSSL_PrintSessionStats(void);
1414 WOLFSSL_API int wolfSSL_get_session_stats(unsigned int* active,
1415 unsigned int* total,
1417 unsigned int* maxSessions);
1418 /* External facing KDF */
1420 int wolfSSL_MakeTlsMasterSecret(unsigned char* ms, unsigned int msLen,
1421 const unsigned char* pms, unsigned int pmsLen,
1422 const unsigned char* cr, const unsigned char* sr,
1423 int tls1_2, int hash_type);
1426 int wolfSSL_DeriveTlsKeys(unsigned char* key_data, unsigned int keyLen,
1427 const unsigned char* ms, unsigned int msLen,
1428 const unsigned char* sr, const unsigned char* cr,
1429 int tls1_2, int hash_type);
1431 #ifdef WOLFSSL_CALLBACKS
1433 /* used internally by wolfSSL while OpenSSL types aren't */
1434 #include <wolfssl/callbacks.h>
1436 typedef int (*HandShakeCallBack)(HandShakeInfo*);
1437 typedef int (*TimeoutCallBack)(TimeoutInfo*);
1439 /* wolfSSL connect extension allowing HandShakeCallBack and/or TimeoutCallBack
1441 WOLFSSL_API int wolfSSL_connect_ex(WOLFSSL*, HandShakeCallBack, TimeoutCallBack,
1443 WOLFSSL_API int wolfSSL_accept_ex(WOLFSSL*, HandShakeCallBack, TimeoutCallBack,
1446 #endif /* WOLFSSL_CALLBACKS */
1449 #ifdef WOLFSSL_HAVE_WOLFSCEP
1450 WOLFSSL_API void wolfSSL_wolfSCEP(void);
1451 #endif /* WOLFSSL_HAVE_WOLFSCEP */
1453 #ifdef WOLFSSL_HAVE_CERT_SERVICE
1454 WOLFSSL_API void wolfSSL_cert_service(void);
1463 #endif /* WOLFSSL_SSL_H */