source: asp3_tinet_ecnl_rx/trunk/wolfssl-3.12.2/wolfssl/ssl.h@ 337

Last change on this file since 337 was 337, checked in by coas-nagasima, 6 years ago

ASP3版ECNLを追加

  • Property svn:eol-style set to native
  • Property svn:mime-type set to text/x-chdr;charset=UTF-8
File size: 108.4 KB
Line 
1/* ssl.h
2 *
3 * Copyright (C) 2006-2017 wolfSSL Inc.
4 *
5 * This file is part of wolfSSL.
6 *
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.
11 *
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.
16 *
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-1335, USA
20 */
21
22
23
24/* wolfSSL API */
25
26#ifndef WOLFSSL_SSL_H
27#define WOLFSSL_SSL_H
28
29
30/* for users not using preprocessor flags*/
31#include <wolfssl/wolfcrypt/settings.h>
32#include <wolfssl/version.h>
33
34#ifdef HAVE_WOLF_EVENT
35 #include <wolfssl/wolfcrypt/wolfevent.h>
36#endif
37
38#ifndef NO_FILESYSTEM
39 #if defined(FREESCALE_MQX) || defined(FREESCALE_KSDK_MQX)
40 #if MQX_USE_IO_OLD
41 #include <fio.h>
42 #else
43 #include <nio.h>
44 #endif
45 #endif
46#endif
47
48#ifdef WOLFSSL_PREFIX
49 #include "prefix_ssl.h"
50#endif
51
52#ifdef LIBWOLFSSL_VERSION_STRING
53 #define WOLFSSL_VERSION LIBWOLFSSL_VERSION_STRING
54#endif
55
56#ifdef _WIN32
57 /* wincrypt.h clashes */
58 #undef OCSP_REQUEST
59 #undef OCSP_RESPONSE
60#endif
61
62#ifdef OPENSSL_COEXIST
63 /* mode to allow wolfSSL and OpenSSL to exist together */
64 #ifdef TEST_OPENSSL_COEXIST
65 /*
66 ./configure --enable-opensslcoexist \
67 CFLAGS="-I/usr/local/opt/openssl/include -DTEST_OPENSSL_COEXIST" \
68 LDFLAGS="-L/usr/local/opt/openssl/lib -lcrypto"
69 */
70 #include <openssl/ssl.h>
71 #include <openssl/rand.h>
72 #include <openssl/err.h>
73 #include <openssl/ec.h>
74 #include <openssl/hmac.h>
75 #include <openssl/bn.h>
76 #endif
77
78 /* make sure old names are disabled */
79 #ifndef NO_OLD_SSL_NAMES
80 #define NO_OLD_SSL_NAMES
81 #endif
82 #ifndef NO_OLD_WC_NAMES
83 #define NO_OLD_WC_NAMES
84 #endif
85
86#elif defined(OPENSSL_EXTRA)
87 #include <wolfssl/openssl/bn.h>
88 #include <wolfssl/openssl/hmac.h>
89
90 /* We need the old SSL names */
91 #ifdef NO_OLD_SSL_NAMES
92 #undef NO_OLD_SSL_NAMES
93 #endif
94 #ifdef NO_OLD_WC_NAMES
95 #undef NO_OLD_WC_NAMES
96 #endif
97#endif
98
99
100#ifdef __cplusplus
101 extern "C" {
102#endif
103
104#ifndef WOLFSSL_WOLFSSL_TYPE_DEFINED
105#define WOLFSSL_WOLFSSL_TYPE_DEFINED
106typedef struct WOLFSSL WOLFSSL;
107#endif
108typedef struct WOLFSSL_SESSION WOLFSSL_SESSION;
109typedef struct WOLFSSL_METHOD WOLFSSL_METHOD;
110#ifndef WOLFSSL_WOLFSSL_CTX_TYPE_DEFINED
111#define WOLFSSL_WOLFSSL_CTX_TYPE_DEFINED
112typedef struct WOLFSSL_CTX WOLFSSL_CTX;
113#endif
114
115typedef struct WOLFSSL_STACK WOLFSSL_STACK;
116typedef struct WOLFSSL_X509 WOLFSSL_X509;
117typedef struct WOLFSSL_X509_NAME WOLFSSL_X509_NAME;
118typedef struct WOLFSSL_X509_NAME_ENTRY WOLFSSL_X509_NAME_ENTRY;
119typedef struct WOLFSSL_X509_CHAIN WOLFSSL_X509_CHAIN;
120
121typedef struct WOLFSSL_CERT_MANAGER WOLFSSL_CERT_MANAGER;
122typedef struct WOLFSSL_SOCKADDR WOLFSSL_SOCKADDR;
123typedef struct WOLFSSL_CRL WOLFSSL_CRL;
124
125/* redeclare guard */
126#define WOLFSSL_TYPES_DEFINED
127
128#include <wolfssl/wolfio.h>
129
130
131#ifndef WOLFSSL_RSA_TYPE_DEFINED /* guard on redeclaration */
132typedef struct WOLFSSL_RSA WOLFSSL_RSA;
133#define WOLFSSL_RSA_TYPE_DEFINED
134#endif
135
136#ifndef WC_RNG_TYPE_DEFINED /* guard on redeclaration */
137 typedef struct WC_RNG WC_RNG;
138 #define WC_RNG_TYPE_DEFINED
139#endif
140
141#ifndef WOLFSSL_DSA_TYPE_DEFINED /* guard on redeclaration */
142typedef struct WOLFSSL_DSA WOLFSSL_DSA;
143#define WOLFSSL_DSA_TYPE_DEFINED
144#endif
145
146#ifndef WOLFSSL_EC_TYPE_DEFINED /* guard on redeclaration */
147typedef struct WOLFSSL_EC_KEY WOLFSSL_EC_KEY;
148typedef struct WOLFSSL_EC_POINT WOLFSSL_EC_POINT;
149typedef struct WOLFSSL_EC_GROUP WOLFSSL_EC_GROUP;
150#define WOLFSSL_EC_TYPE_DEFINED
151#endif
152
153#ifndef WOLFSSL_ECDSA_TYPE_DEFINED /* guard on redeclaration */
154typedef struct WOLFSSL_ECDSA_SIG WOLFSSL_ECDSA_SIG;
155#define WOLFSSL_ECDSA_TYPE_DEFINED
156#endif
157
158typedef struct WOLFSSL_CIPHER WOLFSSL_CIPHER;
159typedef struct WOLFSSL_X509_LOOKUP WOLFSSL_X509_LOOKUP;
160typedef struct WOLFSSL_X509_LOOKUP_METHOD WOLFSSL_X509_LOOKUP_METHOD;
161typedef struct WOLFSSL_X509_CRL WOLFSSL_X509_CRL;
162typedef struct WOLFSSL_X509_STORE WOLFSSL_X509_STORE;
163typedef struct WOLFSSL_BIO WOLFSSL_BIO;
164typedef struct WOLFSSL_BIO_METHOD WOLFSSL_BIO_METHOD;
165typedef struct WOLFSSL_X509_EXTENSION WOLFSSL_X509_EXTENSION;
166typedef struct WOLFSSL_ASN1_TIME WOLFSSL_ASN1_TIME;
167typedef struct WOLFSSL_ASN1_INTEGER WOLFSSL_ASN1_INTEGER;
168typedef struct WOLFSSL_ASN1_OBJECT WOLFSSL_ASN1_OBJECT;
169
170typedef struct WOLFSSL_ASN1_STRING WOLFSSL_ASN1_STRING;
171typedef struct WOLFSSL_dynlock_value WOLFSSL_dynlock_value;
172typedef struct WOLFSSL_DH WOLFSSL_DH;
173typedef struct WOLFSSL_ASN1_BIT_STRING WOLFSSL_ASN1_BIT_STRING;
174typedef unsigned char* WOLFSSL_BUF_MEM;
175
176#define WOLFSSL_ASN1_UTCTIME WOLFSSL_ASN1_TIME
177#define WOLFSSL_ASN1_GENERALIZEDTIME WOLFSSL_ASN1_TIME
178
179struct WOLFSSL_ASN1_INTEGER {
180 /* size can be increased set at 20 for tag, length then to hold at least 16
181 * byte type */
182 unsigned char data[20];
183 /* ASN_INTEGER | LENGTH | hex of number */
184};
185
186struct WOLFSSL_ASN1_TIME {
187 /* MAX_DATA_SIZE is 32 */
188 unsigned char data[32 + 2];
189 /* ASN_TIME | LENGTH | date bytes */
190};
191
192#ifndef WOLFSSL_EVP_PKEY_TYPE_DEFINED /* guard on redeclaration */
193typedef struct WOLFSSL_EVP_PKEY WOLFSSL_EVP_PKEY;
194#define WOLFSSL_EVP_PKEY_TYPE_DEFINED
195#endif
196
197typedef struct WOLFSSL_MD4_CTX {
198 int buffer[32]; /* big enough to hold, check size in Init */
199} WOLFSSL_MD4_CTX;
200
201
202typedef struct WOLFSSL_COMP_METHOD {
203 int type; /* stunnel dereference */
204} WOLFSSL_COMP_METHOD;
205
206struct WOLFSSL_X509_LOOKUP_METHOD {
207 int type;
208};
209
210struct WOLFSSL_X509_LOOKUP {
211 WOLFSSL_X509_STORE *store;
212};
213
214struct WOLFSSL_X509_STORE {
215 int cache; /* stunnel dereference */
216 WOLFSSL_CERT_MANAGER* cm;
217 WOLFSSL_X509_LOOKUP lookup;
218#ifdef OPENSSL_EXTRA
219 int isDynamic;
220#endif
221};
222
223typedef struct WOLFSSL_ALERT {
224 int code;
225 int level;
226} WOLFSSL_ALERT;
227
228typedef struct WOLFSSL_ALERT_HISTORY {
229 WOLFSSL_ALERT last_rx;
230 WOLFSSL_ALERT last_tx;
231} WOLFSSL_ALERT_HISTORY;
232
233typedef struct WOLFSSL_X509_REVOKED {
234 WOLFSSL_ASN1_INTEGER* serialNumber; /* stunnel dereference */
235} WOLFSSL_X509_REVOKED;
236
237
238typedef struct WOLFSSL_X509_OBJECT {
239 union {
240 char* ptr;
241 WOLFSSL_X509 *x509;
242 WOLFSSL_X509_CRL* crl; /* stunnel dereference */
243 } data;
244} WOLFSSL_X509_OBJECT;
245
246typedef struct WOLFSSL_BUFFER_INFO {
247 unsigned char* buffer;
248 unsigned int length;
249} WOLFSSL_BUFFER_INFO;
250
251typedef struct WOLFSSL_X509_STORE_CTX {
252 WOLFSSL_X509_STORE* store; /* Store full of a CA cert chain */
253 WOLFSSL_X509* current_cert; /* stunnel dereference */
254 WOLFSSL_STACK* chain;
255 char* domain; /* subject CN domain name */
256 void* ex_data; /* external data, for fortress build */
257 void* userCtx; /* user ctx */
258 int error; /* current error */
259 int error_depth; /* cert depth for this error */
260 int discardSessionCerts; /* so verify callback can flag for discard */
261 int totalCerts; /* number of peer cert buffers */
262 WOLFSSL_BUFFER_INFO* certs; /* peer certs */
263} WOLFSSL_X509_STORE_CTX;
264
265typedef char* WOLFSSL_STRING;
266
267/* Valid Alert types from page 16/17 */
268enum AlertDescription {
269 close_notify = 0,
270 unexpected_message = 10,
271 bad_record_mac = 20,
272 record_overflow = 22,
273 decompression_failure = 30,
274 handshake_failure = 40,
275 no_certificate = 41,
276 bad_certificate = 42,
277 unsupported_certificate = 43,
278 certificate_revoked = 44,
279 certificate_expired = 45,
280 certificate_unknown = 46,
281 illegal_parameter = 47,
282 decode_error = 50,
283 decrypt_error = 51,
284 #ifdef WOLFSSL_MYSQL_COMPATIBLE
285 /* catch name conflict for enum protocol with MYSQL build */
286 wc_protocol_version = 70,
287 #else
288 protocol_version = 70,
289 #endif
290 no_renegotiation = 100,
291 unrecognized_name = 112, /**< RFC 6066, section 3 */
292 bad_certificate_status_response = 113, /**< RFC 6066, section 8 */
293 no_application_protocol = 120
294};
295
296
297enum AlertLevel {
298 alert_warning = 1,
299 alert_fatal = 2
300};
301
302/* Maximum master key length (SECRET_LEN) */
303#define WOLFSSL_MAX_MASTER_KEY_LENGTH 48
304
305typedef WOLFSSL_METHOD* (*wolfSSL_method_func)(void* heap);
306WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_server_method_ex(void* heap);
307WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_client_method_ex(void* heap);
308WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_server_method_ex(void* heap);
309WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_client_method_ex(void* heap);
310WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_server_method_ex(void* heap);
311WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_client_method_ex(void* heap);
312WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_server_method_ex(void* heap);
313WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_client_method_ex(void* heap);
314#ifdef WOLFSSL_TLS13
315 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_3_server_method_ex(void* heap);
316 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_3_client_method_ex(void* heap);
317#endif
318WOLFSSL_API WOLFSSL_METHOD *wolfSSLv23_server_method_ex(void* heap);
319WOLFSSL_API WOLFSSL_METHOD *wolfSSLv23_client_method_ex(void* heap);
320
321#ifdef WOLFSSL_DTLS
322 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_client_method_ex(void* heap);
323 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_server_method_ex(void* heap);
324 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_client_method_ex(void* heap);
325 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_server_method_ex(void* heap);
326#endif
327WOLFSSL_API WOLFSSL_METHOD *wolfSSLv23_method(void);
328WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_server_method(void);
329WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_client_method(void);
330WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_server_method(void);
331WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_client_method(void);
332WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_server_method(void);
333WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_client_method(void);
334WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_server_method(void);
335WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_client_method(void);
336#ifdef WOLFSSL_TLS13
337 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_3_server_method(void);
338 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_3_client_method(void);
339#endif
340
341#ifdef WOLFSSL_DTLS
342 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_client_method(void);
343 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_server_method(void);
344 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_client_method(void);
345 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_server_method(void);
346#endif
347
348#ifdef HAVE_POLY1305
349 WOLFSSL_API int wolfSSL_use_old_poly(WOLFSSL*, int);
350#endif
351
352#ifdef WOLFSSL_SESSION_EXPORT
353#ifdef WOLFSSL_DTLS
354typedef int (*wc_dtls_export)(WOLFSSL* ssl,
355 unsigned char* exportBuffer, unsigned int sz, void* userCtx);
356WOLFSSL_API int wolfSSL_dtls_import(WOLFSSL* ssl, unsigned char* buf,
357 unsigned int sz);
358WOLFSSL_API int wolfSSL_CTX_dtls_set_export(WOLFSSL_CTX* ctx,
359 wc_dtls_export func);
360WOLFSSL_API int wolfSSL_dtls_set_export(WOLFSSL* ssl, wc_dtls_export func);
361WOLFSSL_API int wolfSSL_dtls_export(WOLFSSL* ssl, unsigned char* buf,
362 unsigned int* sz);
363#endif /* WOLFSSL_DTLS */
364#endif /* WOLFSSL_SESSION_EXPORT */
365
366#ifdef WOLFSSL_STATIC_MEMORY
367#ifndef WOLFSSL_MEM_GUARD
368#define WOLFSSL_MEM_GUARD
369 typedef struct WOLFSSL_MEM_STATS WOLFSSL_MEM_STATS;
370 typedef struct WOLFSSL_MEM_CONN_STATS WOLFSSL_MEM_CONN_STATS;
371#endif
372WOLFSSL_API int wolfSSL_CTX_load_static_memory(WOLFSSL_CTX** ctx,
373 wolfSSL_method_func method,
374 unsigned char* buf, unsigned int sz,
375 int flag, int max);
376WOLFSSL_API int wolfSSL_CTX_is_static_memory(WOLFSSL_CTX* ctx,
377 WOLFSSL_MEM_STATS* mem_stats);
378WOLFSSL_API int wolfSSL_is_static_memory(WOLFSSL* ssl,
379 WOLFSSL_MEM_CONN_STATS* mem_stats);
380#endif
381
382#if !defined(NO_FILESYSTEM) && !defined(NO_CERTS)
383
384WOLFSSL_API int wolfSSL_CTX_use_certificate_file(WOLFSSL_CTX*, const char*, int);
385WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_file(WOLFSSL_CTX*, const char*, int);
386WOLFSSL_API int wolfSSL_CTX_load_verify_locations(WOLFSSL_CTX*, const char*,
387 const char*);
388#ifdef WOLFSSL_TRUST_PEER_CERT
389WOLFSSL_API int wolfSSL_CTX_trust_peer_cert(WOLFSSL_CTX*, const char*, int);
390#endif
391WOLFSSL_API int wolfSSL_CTX_use_certificate_chain_file(WOLFSSL_CTX *,
392 const char *file);
393WOLFSSL_API int wolfSSL_CTX_use_RSAPrivateKey_file(WOLFSSL_CTX*, const char*, int);
394
395WOLFSSL_API long wolfSSL_get_verify_depth(WOLFSSL* ssl);
396WOLFSSL_API long wolfSSL_CTX_get_verify_depth(WOLFSSL_CTX* ctx);
397WOLFSSL_API int wolfSSL_use_certificate_file(WOLFSSL*, const char*, int);
398WOLFSSL_API int wolfSSL_use_PrivateKey_file(WOLFSSL*, const char*, int);
399WOLFSSL_API int wolfSSL_use_certificate_chain_file(WOLFSSL*, const char *file);
400WOLFSSL_API int wolfSSL_use_RSAPrivateKey_file(WOLFSSL*, const char*, int);
401
402#ifdef WOLFSSL_DER_LOAD
403 WOLFSSL_API int wolfSSL_CTX_der_load_verify_locations(WOLFSSL_CTX*,
404 const char*, int);
405#endif
406
407#ifdef HAVE_NTRU
408 WOLFSSL_API int wolfSSL_CTX_use_NTRUPrivateKey_file(WOLFSSL_CTX*, const char*);
409 /* load NTRU private key blob */
410#endif
411
412#ifndef WOLFSSL_PEMCERT_TODER_DEFINED
413 WOLFSSL_API int wolfSSL_PemCertToDer(const char*, unsigned char*, int);
414 #define WOLFSSL_PEMCERT_TODER_DEFINED
415#endif
416
417#endif /* !NO_FILESYSTEM && !NO_CERTS */
418
419WOLFSSL_API WOLFSSL_CTX* wolfSSL_CTX_new(WOLFSSL_METHOD*);
420WOLFSSL_API WOLFSSL* wolfSSL_new(WOLFSSL_CTX*);
421WOLFSSL_API int wolfSSL_is_server(WOLFSSL*);
422WOLFSSL_API WOLFSSL* wolfSSL_write_dup(WOLFSSL*);
423WOLFSSL_API int wolfSSL_set_fd (WOLFSSL*, int);
424WOLFSSL_API int wolfSSL_set_write_fd (WOLFSSL*, int);
425WOLFSSL_API int wolfSSL_set_read_fd (WOLFSSL*, int);
426WOLFSSL_API char* wolfSSL_get_cipher_list(int priority);
427WOLFSSL_API char* wolfSSL_get_cipher_list_ex(WOLFSSL* ssl, int priority);
428WOLFSSL_API int wolfSSL_get_ciphers(char*, int);
429WOLFSSL_API const char* wolfSSL_get_cipher_name(WOLFSSL* ssl);
430WOLFSSL_API const char* wolfSSL_get_shared_ciphers(WOLFSSL* ssl, char* buf,
431 int len);
432WOLFSSL_API const char* wolfSSL_get_curve_name(WOLFSSL* ssl);
433WOLFSSL_API int wolfSSL_get_fd(const WOLFSSL*);
434WOLFSSL_API void wolfSSL_set_using_nonblock(WOLFSSL*, int);
435WOLFSSL_API int wolfSSL_get_using_nonblock(WOLFSSL*);
436/* please see note at top of README if you get an error from connect */
437WOLFSSL_API int wolfSSL_connect(WOLFSSL*);
438WOLFSSL_API int wolfSSL_write(WOLFSSL*, const void*, int);
439WOLFSSL_API int wolfSSL_read(WOLFSSL*, void*, int);
440WOLFSSL_API int wolfSSL_peek(WOLFSSL*, void*, int);
441WOLFSSL_API int wolfSSL_accept(WOLFSSL*);
442#ifdef WOLFSSL_TLS13
443WOLFSSL_API int wolfSSL_send_hrr_cookie(WOLFSSL* ssl,
444 const unsigned char* secret, unsigned int secretSz);
445WOLFSSL_API int wolfSSL_CTX_no_ticket_TLSv13(WOLFSSL_CTX* ctx);
446WOLFSSL_API int wolfSSL_no_ticket_TLSv13(WOLFSSL* ssl);
447WOLFSSL_API int wolfSSL_CTX_no_dhe_psk(WOLFSSL_CTX* ctx);
448WOLFSSL_API int wolfSSL_no_dhe_psk(WOLFSSL* ssl);
449WOLFSSL_API int wolfSSL_update_keys(WOLFSSL* ssl);
450WOLFSSL_API int wolfSSL_CTX_allow_post_handshake_auth(WOLFSSL_CTX* ctx);
451WOLFSSL_API int wolfSSL_allow_post_handshake_auth(WOLFSSL* ssl);
452WOLFSSL_API int wolfSSL_request_certificate(WOLFSSL* ssl);
453
454WOLFSSL_API int wolfSSL_connect_TLSv13(WOLFSSL*);
455WOLFSSL_API int wolfSSL_accept_TLSv13(WOLFSSL*);
456
457#ifdef WOLFSSL_EARLY_DATA
458WOLFSSL_API int wolfSSL_CTX_set_max_early_data(WOLFSSL_CTX* ctx,
459 unsigned int sz);
460WOLFSSL_API int wolfSSL_set_max_early_data(WOLFSSL* ssl, unsigned int sz);
461WOLFSSL_API int wolfSSL_write_early_data(WOLFSSL*, const void*, int, int*);
462WOLFSSL_API int wolfSSL_read_early_data(WOLFSSL*, void*, int, int*);
463#endif
464#endif
465WOLFSSL_API void wolfSSL_CTX_free(WOLFSSL_CTX*);
466WOLFSSL_API void wolfSSL_free(WOLFSSL*);
467WOLFSSL_API int wolfSSL_shutdown(WOLFSSL*);
468WOLFSSL_API int wolfSSL_send(WOLFSSL*, const void*, int sz, int flags);
469WOLFSSL_API int wolfSSL_recv(WOLFSSL*, void*, int sz, int flags);
470
471WOLFSSL_API void wolfSSL_CTX_set_quiet_shutdown(WOLFSSL_CTX*, int);
472WOLFSSL_API void wolfSSL_set_quiet_shutdown(WOLFSSL*, int);
473
474WOLFSSL_API int wolfSSL_get_error(WOLFSSL*, int);
475WOLFSSL_API int wolfSSL_get_alert_history(WOLFSSL*, WOLFSSL_ALERT_HISTORY *);
476
477WOLFSSL_API int wolfSSL_set_session(WOLFSSL* ssl,WOLFSSL_SESSION* session);
478WOLFSSL_API long wolfSSL_SSL_SESSION_set_timeout(WOLFSSL_SESSION* session, long t);
479WOLFSSL_API WOLFSSL_SESSION* wolfSSL_get_session(WOLFSSL* ssl);
480WOLFSSL_API void wolfSSL_flush_sessions(WOLFSSL_CTX *ctx, long tm);
481WOLFSSL_API int wolfSSL_SetServerID(WOLFSSL* ssl, const unsigned char*,
482 int, int);
483
484#ifdef SESSION_INDEX
485WOLFSSL_API int wolfSSL_GetSessionIndex(WOLFSSL* ssl);
486WOLFSSL_API int wolfSSL_GetSessionAtIndex(int index, WOLFSSL_SESSION* session);
487#endif /* SESSION_INDEX */
488
489#if defined(SESSION_INDEX) && defined(SESSION_CERTS)
490WOLFSSL_API
491 WOLFSSL_X509_CHAIN* wolfSSL_SESSION_get_peer_chain(WOLFSSL_SESSION* session);
492#endif /* SESSION_INDEX && SESSION_CERTS */
493
494typedef int (*VerifyCallback)(int, WOLFSSL_X509_STORE_CTX*);
495typedef int (pem_password_cb)(char*, int, int, void*);
496
497WOLFSSL_API void wolfSSL_CTX_set_verify(WOLFSSL_CTX*, int,
498 VerifyCallback verify_callback);
499WOLFSSL_API void wolfSSL_set_verify(WOLFSSL*, int, VerifyCallback verify_callback);
500WOLFSSL_API void wolfSSL_SetCertCbCtx(WOLFSSL*, void*);
501
502WOLFSSL_API int wolfSSL_pending(WOLFSSL*);
503
504WOLFSSL_API void wolfSSL_load_error_strings(void);
505WOLFSSL_API int wolfSSL_library_init(void);
506WOLFSSL_API long wolfSSL_CTX_set_session_cache_mode(WOLFSSL_CTX*, long);
507
508#ifdef HAVE_SECRET_CALLBACK
509typedef int (*SessionSecretCb)(WOLFSSL* ssl,
510 void* secret, int* secretSz, void* ctx);
511WOLFSSL_API int wolfSSL_set_session_secret_cb(WOLFSSL*, SessionSecretCb, void*);
512#endif /* HAVE_SECRET_CALLBACK */
513
514/* session cache persistence */
515WOLFSSL_API int wolfSSL_save_session_cache(const char*);
516WOLFSSL_API int wolfSSL_restore_session_cache(const char*);
517WOLFSSL_API int wolfSSL_memsave_session_cache(void*, int);
518WOLFSSL_API int wolfSSL_memrestore_session_cache(const void*, int);
519WOLFSSL_API int wolfSSL_get_session_cache_memsize(void);
520
521/* certificate cache persistence, uses ctx since certs are per ctx */
522WOLFSSL_API int wolfSSL_CTX_save_cert_cache(WOLFSSL_CTX*, const char*);
523WOLFSSL_API int wolfSSL_CTX_restore_cert_cache(WOLFSSL_CTX*, const char*);
524WOLFSSL_API int wolfSSL_CTX_memsave_cert_cache(WOLFSSL_CTX*, void*, int, int*);
525WOLFSSL_API int wolfSSL_CTX_memrestore_cert_cache(WOLFSSL_CTX*, const void*, int);
526WOLFSSL_API int wolfSSL_CTX_get_cert_cache_memsize(WOLFSSL_CTX*);
527
528/* only supports full name from cipher_name[] delimited by : */
529WOLFSSL_API int wolfSSL_CTX_set_cipher_list(WOLFSSL_CTX*, const char*);
530WOLFSSL_API int wolfSSL_set_cipher_list(WOLFSSL*, const char*);
531
532/* Nonblocking DTLS helper functions */
533WOLFSSL_API int wolfSSL_dtls_get_current_timeout(WOLFSSL* ssl);
534WOLFSSL_API int wolfSSL_dtls_set_timeout_init(WOLFSSL* ssl, int);
535WOLFSSL_API int wolfSSL_dtls_set_timeout_max(WOLFSSL* ssl, int);
536WOLFSSL_API int wolfSSL_dtls_got_timeout(WOLFSSL* ssl);
537WOLFSSL_API int wolfSSL_dtls(WOLFSSL* ssl);
538
539WOLFSSL_API int wolfSSL_dtls_set_peer(WOLFSSL*, void*, unsigned int);
540WOLFSSL_API int wolfSSL_dtls_get_peer(WOLFSSL*, void*, unsigned int*);
541
542WOLFSSL_API int wolfSSL_CTX_dtls_set_sctp(WOLFSSL_CTX*);
543WOLFSSL_API int wolfSSL_dtls_set_sctp(WOLFSSL*);
544WOLFSSL_API int wolfSSL_CTX_dtls_set_mtu(WOLFSSL_CTX*, unsigned short);
545WOLFSSL_API int wolfSSL_dtls_set_mtu(WOLFSSL*, unsigned short);
546
547WOLFSSL_API int wolfSSL_dtls_get_drop_stats(WOLFSSL*,
548 unsigned int*, unsigned int*);
549WOLFSSL_API int wolfSSL_CTX_mcast_set_member_id(WOLFSSL_CTX*, unsigned short);
550WOLFSSL_API int wolfSSL_set_secret(WOLFSSL*, unsigned short,
551 const unsigned char*, unsigned int,
552 const unsigned char*, const unsigned char*,
553 const unsigned char*);
554WOLFSSL_API int wolfSSL_mcast_read(WOLFSSL*, unsigned short*, void*, int);
555WOLFSSL_API int wolfSSL_mcast_peer_add(WOLFSSL*, unsigned short, int);
556WOLFSSL_API int wolfSSL_mcast_peer_known(WOLFSSL*, unsigned short);
557WOLFSSL_API int wolfSSL_mcast_get_max_peers(void);
558typedef int (*CallbackMcastHighwater)(unsigned short peerId,
559 unsigned int maxSeq,
560 unsigned int curSeq, void* ctx);
561WOLFSSL_API int wolfSSL_CTX_mcast_set_highwater_cb(WOLFSSL_CTX*,
562 unsigned int,
563 unsigned int,
564 unsigned int,
565 CallbackMcastHighwater);
566WOLFSSL_API int wolfSSL_mcast_set_highwater_ctx(WOLFSSL*, void*);
567
568WOLFSSL_API int wolfSSL_ERR_GET_REASON(unsigned long err);
569WOLFSSL_API char* wolfSSL_ERR_error_string(unsigned long,char*);
570WOLFSSL_API void wolfSSL_ERR_error_string_n(unsigned long e, char* buf,
571 unsigned long sz);
572WOLFSSL_API const char* wolfSSL_ERR_reason_error_string(unsigned long);
573
574/* extras */
575
576#ifndef WOLF_STACK_OF
577 #define WOLF_STACK_OF(x) WOLFSSL_STACK
578#endif
579#ifndef DECLARE_STACK_OF
580 #define DECLARE_STACK_OF(x) WOLF_STACK_OF(x);
581#endif
582
583WOLFSSL_API int wolfSSL_sk_X509_push(WOLF_STACK_OF(WOLFSSL_X509_NAME)* sk,
584 WOLFSSL_X509* x509);
585WOLFSSL_API WOLFSSL_X509* wolfSSL_sk_X509_pop(WOLF_STACK_OF(WOLFSSL_X509_NAME)* sk);
586WOLFSSL_API void wolfSSL_sk_X509_free(WOLF_STACK_OF(WOLFSSL_X509_NAME)* sk);
587WOLFSSL_API WOLFSSL_ASN1_OBJECT* wolfSSL_ASN1_OBJECT_new(void);
588WOLFSSL_API void wolfSSL_ASN1_OBJECT_free(WOLFSSL_ASN1_OBJECT* obj);
589WOLFSSL_API int wolfSSL_sk_ASN1_OBJECT_push(WOLF_STACK_OF(WOLFSSL_ASN1_OBJEXT)* sk,
590 WOLFSSL_ASN1_OBJECT* obj);
591WOLFSSL_API WOLFSSL_ASN1_OBJECT* wolfSSL_sk_ASN1_OBJCET_pop(
592 WOLF_STACK_OF(WOLFSSL_ASN1_OBJECT)* sk);
593WOLFSSL_API void wolfSSL_sk_ASN1_OBJECT_free(WOLF_STACK_OF(WOLFSSL_ASN1_OBJECT)* sk);
594WOLFSSL_API int wolfSSL_ASN1_STRING_to_UTF8(unsigned char **out, WOLFSSL_ASN1_STRING *in);
595
596WOLFSSL_API int wolfSSL_set_ex_data(WOLFSSL*, int, void*);
597WOLFSSL_API int wolfSSL_get_shutdown(const WOLFSSL*);
598WOLFSSL_API int wolfSSL_set_rfd(WOLFSSL*, int);
599WOLFSSL_API int wolfSSL_set_wfd(WOLFSSL*, int);
600WOLFSSL_API void wolfSSL_set_shutdown(WOLFSSL*, int);
601WOLFSSL_API int wolfSSL_set_session_id_context(WOLFSSL*, const unsigned char*,
602 unsigned int);
603WOLFSSL_API void wolfSSL_set_connect_state(WOLFSSL*);
604WOLFSSL_API void wolfSSL_set_accept_state(WOLFSSL*);
605WOLFSSL_API int wolfSSL_session_reused(WOLFSSL*);
606WOLFSSL_API void wolfSSL_SESSION_free(WOLFSSL_SESSION* session);
607WOLFSSL_API int wolfSSL_is_init_finished(WOLFSSL*);
608
609WOLFSSL_API const char* wolfSSL_get_version(WOLFSSL*);
610WOLFSSL_API int wolfSSL_get_current_cipher_suite(WOLFSSL* ssl);
611WOLFSSL_API WOLFSSL_CIPHER* wolfSSL_get_current_cipher(WOLFSSL*);
612WOLFSSL_API char* wolfSSL_CIPHER_description(const WOLFSSL_CIPHER*, char*, int);
613WOLFSSL_API const char* wolfSSL_CIPHER_get_name(const WOLFSSL_CIPHER* cipher);
614WOLFSSL_API const char* wolfSSL_SESSION_CIPHER_get_name(WOLFSSL_SESSION* session);
615WOLFSSL_API const char* wolfSSL_get_cipher(WOLFSSL*);
616WOLFSSL_API WOLFSSL_SESSION* wolfSSL_get1_session(WOLFSSL* ssl);
617 /* what's ref count */
618
619WOLFSSL_API void wolfSSL_X509_free(WOLFSSL_X509*);
620WOLFSSL_API void wolfSSL_OPENSSL_free(void*);
621
622WOLFSSL_API int wolfSSL_OCSP_parse_url(char* url, char** host, char** port,
623 char** path, int* ssl);
624
625WOLFSSL_API WOLFSSL_METHOD* wolfSSLv23_client_method(void);
626WOLFSSL_API WOLFSSL_METHOD* wolfSSLv2_client_method(void);
627WOLFSSL_API WOLFSSL_METHOD* wolfSSLv2_server_method(void);
628
629WOLFSSL_API void wolfSSL_MD4_Init(WOLFSSL_MD4_CTX*);
630WOLFSSL_API void wolfSSL_MD4_Update(WOLFSSL_MD4_CTX*, const void*, unsigned long);
631WOLFSSL_API void wolfSSL_MD4_Final(unsigned char*, WOLFSSL_MD4_CTX*);
632
633
634WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new(WOLFSSL_BIO_METHOD*);
635WOLFSSL_API int wolfSSL_BIO_free(WOLFSSL_BIO*);
636WOLFSSL_API int wolfSSL_BIO_free_all(WOLFSSL_BIO*);
637WOLFSSL_API int wolfSSL_BIO_read(WOLFSSL_BIO*, void*, int);
638WOLFSSL_API int wolfSSL_BIO_write(WOLFSSL_BIO*, const void*, int);
639WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_push(WOLFSSL_BIO*, WOLFSSL_BIO* append);
640WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_pop(WOLFSSL_BIO*);
641WOLFSSL_API int wolfSSL_BIO_flush(WOLFSSL_BIO*);
642WOLFSSL_API int wolfSSL_BIO_pending(WOLFSSL_BIO*);
643
644WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_buffer(void);
645WOLFSSL_API long wolfSSL_BIO_set_write_buffer_size(WOLFSSL_BIO*, long size);
646WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_ssl(void);
647WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new_socket(int sfd, int flag);
648WOLFSSL_API int wolfSSL_BIO_eof(WOLFSSL_BIO*);
649
650WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_s_mem(void);
651WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_base64(void);
652WOLFSSL_API void wolfSSL_BIO_set_flags(WOLFSSL_BIO*, int);
653
654WOLFSSL_API int wolfSSL_BIO_get_mem_data(WOLFSSL_BIO* bio,void* p);
655WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new_mem_buf(void* buf, int len);
656
657
658WOLFSSL_API long wolfSSL_BIO_set_ssl(WOLFSSL_BIO*, WOLFSSL*, int flag);
659WOLFSSL_API long wolfSSL_BIO_set_fd(WOLFSSL_BIO* b, int fd, int flag);
660WOLFSSL_API void wolfSSL_set_bio(WOLFSSL*, WOLFSSL_BIO* rd, WOLFSSL_BIO* wr);
661WOLFSSL_API int wolfSSL_add_all_algorithms(void);
662
663#ifndef NO_FILESYSTEM
664WOLFSSL_API WOLFSSL_BIO_METHOD *wolfSSL_BIO_s_file(void);
665#endif
666
667WOLFSSL_API WOLFSSL_BIO_METHOD *wolfSSL_BIO_s_bio(void);
668WOLFSSL_API WOLFSSL_BIO_METHOD *wolfSSL_BIO_s_socket(void);
669
670WOLFSSL_API long wolfSSL_BIO_ctrl(WOLFSSL_BIO *bp, int cmd, long larg, void *parg);
671WOLFSSL_API long wolfSSL_BIO_int_ctrl(WOLFSSL_BIO *bp, int cmd, long larg, int iarg);
672
673WOLFSSL_API int wolfSSL_BIO_set_write_buf_size(WOLFSSL_BIO *b, long size);
674WOLFSSL_API int wolfSSL_BIO_make_bio_pair(WOLFSSL_BIO *b1, WOLFSSL_BIO *b2);
675WOLFSSL_API int wolfSSL_BIO_ctrl_reset_read_request(WOLFSSL_BIO *b);
676WOLFSSL_API int wolfSSL_BIO_nread0(WOLFSSL_BIO *bio, char **buf);
677WOLFSSL_API int wolfSSL_BIO_nread(WOLFSSL_BIO *bio, char **buf, int num);
678WOLFSSL_API int wolfSSL_BIO_nwrite(WOLFSSL_BIO *bio, char **buf, int num);
679WOLFSSL_API int wolfSSL_BIO_reset(WOLFSSL_BIO *bio);
680
681WOLFSSL_API int wolfSSL_BIO_seek(WOLFSSL_BIO *bio, int ofs);
682WOLFSSL_API int wolfSSL_BIO_write_filename(WOLFSSL_BIO *bio, char *name);
683WOLFSSL_API long wolfSSL_BIO_set_mem_eof_return(WOLFSSL_BIO *bio, int v);
684WOLFSSL_API long wolfSSL_BIO_get_mem_ptr(WOLFSSL_BIO *bio, WOLFSSL_BUF_MEM **m);
685
686WOLFSSL_API void wolfSSL_RAND_screen(void);
687WOLFSSL_API const char* wolfSSL_RAND_file_name(char*, unsigned long);
688WOLFSSL_API int wolfSSL_RAND_write_file(const char*);
689WOLFSSL_API int wolfSSL_RAND_load_file(const char*, long);
690WOLFSSL_API int wolfSSL_RAND_egd(const char*);
691WOLFSSL_API int wolfSSL_RAND_seed(const void*, int);
692WOLFSSL_API void wolfSSL_RAND_add(const void*, int, double);
693
694WOLFSSL_API WOLFSSL_COMP_METHOD* wolfSSL_COMP_zlib(void);
695WOLFSSL_API WOLFSSL_COMP_METHOD* wolfSSL_COMP_rle(void);
696WOLFSSL_API int wolfSSL_COMP_add_compression_method(int, void*);
697
698WOLFSSL_API int wolfSSL_get_ex_new_index(long, void*, void*, void*, void*);
699
700WOLFSSL_API void wolfSSL_set_id_callback(unsigned long (*f)(void));
701WOLFSSL_API void wolfSSL_set_locking_callback(void (*f)(int, int, const char*,
702 int));
703WOLFSSL_API void wolfSSL_set_dynlock_create_callback(WOLFSSL_dynlock_value* (*f)
704 (const char*, int));
705WOLFSSL_API void wolfSSL_set_dynlock_lock_callback(void (*f)(int,
706 WOLFSSL_dynlock_value*, const char*, int));
707WOLFSSL_API void wolfSSL_set_dynlock_destroy_callback(void (*f)
708 (WOLFSSL_dynlock_value*, const char*, int));
709WOLFSSL_API int wolfSSL_num_locks(void);
710
711WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_STORE_CTX_get_current_cert(
712 WOLFSSL_X509_STORE_CTX*);
713WOLFSSL_API int wolfSSL_X509_STORE_CTX_get_error(WOLFSSL_X509_STORE_CTX*);
714WOLFSSL_API int wolfSSL_X509_STORE_CTX_get_error_depth(WOLFSSL_X509_STORE_CTX*);
715
716WOLFSSL_API char* wolfSSL_X509_NAME_oneline(WOLFSSL_X509_NAME*, char*, int);
717WOLFSSL_API WOLFSSL_X509_NAME* wolfSSL_X509_get_issuer_name(WOLFSSL_X509*);
718WOLFSSL_API WOLFSSL_X509_NAME* wolfSSL_X509_get_subject_name(WOLFSSL_X509*);
719WOLFSSL_API int wolfSSL_X509_ext_isSet_by_NID(WOLFSSL_X509*, int);
720WOLFSSL_API int wolfSSL_X509_ext_get_critical_by_NID(WOLFSSL_X509*, int);
721WOLFSSL_API int wolfSSL_X509_get_isCA(WOLFSSL_X509*);
722WOLFSSL_API int wolfSSL_X509_get_isSet_pathLength(WOLFSSL_X509*);
723WOLFSSL_API unsigned int wolfSSL_X509_get_pathLength(WOLFSSL_X509*);
724WOLFSSL_API unsigned int wolfSSL_X509_get_keyUsage(WOLFSSL_X509*);
725WOLFSSL_API unsigned char* wolfSSL_X509_get_authorityKeyID(
726 WOLFSSL_X509*, unsigned char*, int*);
727WOLFSSL_API unsigned char* wolfSSL_X509_get_subjectKeyID(
728 WOLFSSL_X509*, unsigned char*, int*);
729WOLFSSL_API int wolfSSL_X509_NAME_entry_count(WOLFSSL_X509_NAME*);
730WOLFSSL_API int wolfSSL_X509_NAME_get_text_by_NID(
731 WOLFSSL_X509_NAME*, int, char*, int);
732WOLFSSL_API int wolfSSL_X509_NAME_get_index_by_NID(
733 WOLFSSL_X509_NAME*, int, int);
734WOLFSSL_API WOLFSSL_ASN1_STRING* wolfSSL_X509_NAME_ENTRY_get_data(WOLFSSL_X509_NAME_ENTRY*);
735WOLFSSL_API char* wolfSSL_ASN1_STRING_data(WOLFSSL_ASN1_STRING*);
736WOLFSSL_API int wolfSSL_ASN1_STRING_length(WOLFSSL_ASN1_STRING*);
737WOLFSSL_API int wolfSSL_X509_verify_cert(WOLFSSL_X509_STORE_CTX*);
738WOLFSSL_API const char* wolfSSL_X509_verify_cert_error_string(long);
739WOLFSSL_API int wolfSSL_X509_get_signature_type(WOLFSSL_X509*);
740WOLFSSL_API int wolfSSL_X509_get_signature(WOLFSSL_X509*, unsigned char*, int*);
741
742WOLFSSL_API int wolfSSL_X509_LOOKUP_add_dir(WOLFSSL_X509_LOOKUP*,const char*,long);
743WOLFSSL_API int wolfSSL_X509_LOOKUP_load_file(WOLFSSL_X509_LOOKUP*, const char*,
744 long);
745WOLFSSL_API WOLFSSL_X509_LOOKUP_METHOD* wolfSSL_X509_LOOKUP_hash_dir(void);
746WOLFSSL_API WOLFSSL_X509_LOOKUP_METHOD* wolfSSL_X509_LOOKUP_file(void);
747
748WOLFSSL_API WOLFSSL_X509_LOOKUP* wolfSSL_X509_STORE_add_lookup(WOLFSSL_X509_STORE*,
749 WOLFSSL_X509_LOOKUP_METHOD*);
750WOLFSSL_API WOLFSSL_X509_STORE* wolfSSL_X509_STORE_new(void);
751WOLFSSL_API void wolfSSL_X509_STORE_free(WOLFSSL_X509_STORE*);
752WOLFSSL_API int wolfSSL_X509_STORE_add_cert(
753 WOLFSSL_X509_STORE*, WOLFSSL_X509*);
754WOLFSSL_API WOLFSSL_STACK* wolfSSL_X509_STORE_CTX_get_chain(
755 WOLFSSL_X509_STORE_CTX* ctx);
756WOLFSSL_API int wolfSSL_X509_STORE_set_flags(WOLFSSL_X509_STORE* store,
757 unsigned long flag);
758WOLFSSL_API int wolfSSL_X509_STORE_set_default_paths(WOLFSSL_X509_STORE*);
759WOLFSSL_API int wolfSSL_X509_STORE_get_by_subject(WOLFSSL_X509_STORE_CTX*,
760 int, WOLFSSL_X509_NAME*, WOLFSSL_X509_OBJECT*);
761WOLFSSL_API WOLFSSL_X509_STORE_CTX* wolfSSL_X509_STORE_CTX_new(void);
762WOLFSSL_API int wolfSSL_X509_STORE_CTX_init(WOLFSSL_X509_STORE_CTX*,
763 WOLFSSL_X509_STORE*, WOLFSSL_X509*, WOLF_STACK_OF(WOLFSSL_X509)*);
764WOLFSSL_API void wolfSSL_X509_STORE_CTX_free(WOLFSSL_X509_STORE_CTX*);
765WOLFSSL_API void wolfSSL_X509_STORE_CTX_cleanup(WOLFSSL_X509_STORE_CTX*);
766
767WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_X509_CRL_get_lastUpdate(WOLFSSL_X509_CRL*);
768WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_X509_CRL_get_nextUpdate(WOLFSSL_X509_CRL*);
769
770WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_X509_get_pubkey(WOLFSSL_X509*);
771WOLFSSL_API int wolfSSL_X509_CRL_verify(WOLFSSL_X509_CRL*, WOLFSSL_EVP_PKEY*);
772WOLFSSL_API void wolfSSL_X509_STORE_CTX_set_error(WOLFSSL_X509_STORE_CTX*,
773 int);
774WOLFSSL_API void wolfSSL_X509_OBJECT_free_contents(WOLFSSL_X509_OBJECT*);
775WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_d2i_PrivateKey(int type,
776 WOLFSSL_EVP_PKEY** out, const unsigned char **in, long inSz);
777WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_PKEY_new(void);
778WOLFSSL_API void wolfSSL_EVP_PKEY_free(WOLFSSL_EVP_PKEY*);
779WOLFSSL_API int wolfSSL_X509_cmp_current_time(const WOLFSSL_ASN1_TIME*);
780WOLFSSL_API int wolfSSL_sk_X509_REVOKED_num(WOLFSSL_X509_REVOKED*);
781
782WOLFSSL_API WOLFSSL_X509_REVOKED* wolfSSL_X509_CRL_get_REVOKED(WOLFSSL_X509_CRL*);
783WOLFSSL_API WOLFSSL_X509_REVOKED* wolfSSL_sk_X509_REVOKED_value(
784 WOLFSSL_X509_REVOKED*,int);
785WOLFSSL_API WOLFSSL_ASN1_INTEGER* wolfSSL_X509_get_serialNumber(WOLFSSL_X509*);
786
787WOLFSSL_API int wolfSSL_ASN1_TIME_print(WOLFSSL_BIO*, const WOLFSSL_ASN1_TIME*);
788
789WOLFSSL_API int wolfSSL_ASN1_INTEGER_cmp(const WOLFSSL_ASN1_INTEGER*,
790 const WOLFSSL_ASN1_INTEGER*);
791WOLFSSL_API long wolfSSL_ASN1_INTEGER_get(const WOLFSSL_ASN1_INTEGER*);
792
793#ifdef OPENSSL_EXTRA
794WOLFSSL_API WOLFSSL_BIGNUM *wolfSSL_ASN1_INTEGER_to_BN(const WOLFSSL_ASN1_INTEGER *ai,
795 WOLFSSL_BIGNUM *bn);
796WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509_NAME)* wolfSSL_load_client_CA_file(const char*);
797#endif
798
799WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509_NAME)* wolfSSL_SSL_CTX_get_client_CA_list(
800 const WOLFSSL_CTX *s);
801WOLFSSL_API void wolfSSL_CTX_set_client_CA_list(WOLFSSL_CTX*,
802 WOLF_STACK_OF(WOLFSSL_X509_NAME)*);
803WOLFSSL_API void* wolfSSL_X509_STORE_CTX_get_ex_data(WOLFSSL_X509_STORE_CTX*, int);
804WOLFSSL_API int wolfSSL_get_ex_data_X509_STORE_CTX_idx(void);
805WOLFSSL_API void* wolfSSL_get_ex_data(const WOLFSSL*, int);
806
807WOLFSSL_API void wolfSSL_CTX_set_default_passwd_cb_userdata(WOLFSSL_CTX*,
808 void* userdata);
809WOLFSSL_API void wolfSSL_CTX_set_default_passwd_cb(WOLFSSL_CTX*,
810 pem_password_cb*);
811
812
813WOLFSSL_API void wolfSSL_CTX_set_info_callback(WOLFSSL_CTX*,
814 void (*)(const WOLFSSL* ssl, int type, int val));
815
816WOLFSSL_API unsigned long wolfSSL_ERR_peek_error(void);
817WOLFSSL_API int wolfSSL_GET_REASON(int);
818
819WOLFSSL_API char* wolfSSL_alert_type_string_long(int);
820WOLFSSL_API char* wolfSSL_alert_desc_string_long(int);
821WOLFSSL_API char* wolfSSL_state_string_long(const WOLFSSL*);
822
823WOLFSSL_API WOLFSSL_RSA* wolfSSL_RSA_generate_key(int, unsigned long,
824 void(*)(int, int, void*), void*);
825WOLFSSL_API void wolfSSL_CTX_set_tmp_rsa_callback(WOLFSSL_CTX*,
826 WOLFSSL_RSA*(*)(WOLFSSL*, int, int));
827
828WOLFSSL_API int wolfSSL_PEM_def_callback(char*, int num, int w, void* key);
829
830WOLFSSL_API long wolfSSL_CTX_sess_accept(WOLFSSL_CTX*);
831WOLFSSL_API long wolfSSL_CTX_sess_connect(WOLFSSL_CTX*);
832WOLFSSL_API long wolfSSL_CTX_sess_accept_good(WOLFSSL_CTX*);
833WOLFSSL_API long wolfSSL_CTX_sess_connect_good(WOLFSSL_CTX*);
834WOLFSSL_API long wolfSSL_CTX_sess_accept_renegotiate(WOLFSSL_CTX*);
835WOLFSSL_API long wolfSSL_CTX_sess_connect_renegotiate(WOLFSSL_CTX*);
836WOLFSSL_API long wolfSSL_CTX_sess_hits(WOLFSSL_CTX*);
837WOLFSSL_API long wolfSSL_CTX_sess_cb_hits(WOLFSSL_CTX*);
838WOLFSSL_API long wolfSSL_CTX_sess_cache_full(WOLFSSL_CTX*);
839WOLFSSL_API long wolfSSL_CTX_sess_misses(WOLFSSL_CTX*);
840WOLFSSL_API long wolfSSL_CTX_sess_timeouts(WOLFSSL_CTX*);
841WOLFSSL_API long wolfSSL_CTX_sess_number(WOLFSSL_CTX*);
842
843WOLFSSL_API long wolfSSL_CTX_add_extra_chain_cert(WOLFSSL_CTX*, WOLFSSL_X509*);
844WOLFSSL_API long wolfSSL_CTX_sess_set_cache_size(WOLFSSL_CTX*, long);
845WOLFSSL_API long wolfSSL_CTX_sess_get_cache_size(WOLFSSL_CTX*);
846
847WOLFSSL_API long wolfSSL_CTX_get_session_cache_mode(WOLFSSL_CTX*);
848WOLFSSL_API int wolfSSL_CTX_get_read_ahead(WOLFSSL_CTX*);
849WOLFSSL_API int wolfSSL_CTX_set_read_ahead(WOLFSSL_CTX*, int v);
850WOLFSSL_API long wolfSSL_CTX_set_tlsext_status_arg(WOLFSSL_CTX*, void* arg);
851WOLFSSL_API long wolfSSL_CTX_set_tlsext_opaque_prf_input_callback_arg(
852 WOLFSSL_CTX*, void* arg);
853
854WOLFSSL_API unsigned long wolfSSL_set_options(WOLFSSL *s, unsigned long op);
855WOLFSSL_API unsigned long wolfSSL_get_options(const WOLFSSL *s);
856WOLFSSL_API long wolfSSL_clear_num_renegotiations(WOLFSSL *s);
857WOLFSSL_API long wolfSSL_total_renegotiations(WOLFSSL *s);
858WOLFSSL_API long wolfSSL_set_tmp_dh(WOLFSSL *s, WOLFSSL_DH *dh);
859WOLFSSL_API long wolfSSL_set_tlsext_debug_arg(WOLFSSL *s, void *arg);
860WOLFSSL_API long wolfSSL_set_tlsext_status_type(WOLFSSL *s, int type);
861WOLFSSL_API long wolfSSL_set_tlsext_status_exts(WOLFSSL *s, void *arg);
862WOLFSSL_API long wolfSSL_get_tlsext_status_ids(WOLFSSL *s, void *arg);
863WOLFSSL_API long wolfSSL_set_tlsext_status_ids(WOLFSSL *s, void *arg);
864WOLFSSL_API long wolfSSL_get_tlsext_status_ocsp_resp(WOLFSSL *s, unsigned char **resp);
865WOLFSSL_API long wolfSSL_set_tlsext_status_ocsp_resp(WOLFSSL *s, unsigned char *resp, int len);
866
867WOLFSSL_API void wolfSSL_CONF_modules_unload(int all);
868WOLFSSL_API long wolfSSL_get_tlsext_status_exts(WOLFSSL *s, void *arg);
869WOLFSSL_API long wolfSSL_get_verify_result(const WOLFSSL *ssl);
870
871#define WOLFSSL_DEFAULT_CIPHER_LIST "" /* default all */
872#define WOLFSSL_RSA_F4 0x10001L
873
874enum {
875 WOLFSSL_OCSP_URL_OVERRIDE = 1,
876 WOLFSSL_OCSP_NO_NONCE = 2,
877 WOLFSSL_OCSP_CHECKALL = 4,
878
879 WOLFSSL_CRL_CHECKALL = 1,
880 WOLFSSL_CRL_CHECK = 27,
881};
882
883#ifdef OPENSSL_EXTRA
884/* seperated out from other enums because of size */
885enum {
886 SSL_OP_MICROSOFT_SESS_ID_BUG = 0x00000001,
887 SSL_OP_NETSCAPE_CHALLENGE_BUG = 0x00000002,
888 SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG = 0x00000004,
889 SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG = 0x00000008,
890 SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER = 0x00000010,
891 SSL_OP_MSIE_SSLV2_RSA_PADDING = 0x00000020,
892 SSL_OP_SSLEAY_080_CLIENT_DH_BUG = 0x00000040,
893 SSL_OP_TLS_D5_BUG = 0x00000080,
894 SSL_OP_TLS_BLOCK_PADDING_BUG = 0x00000100,
895 SSL_OP_TLS_ROLLBACK_BUG = 0x00000200,
896 SSL_OP_ALL = 0x00000400,
897 SSL_OP_EPHEMERAL_RSA = 0x00000800,
898 SSL_OP_NO_SSLv3 = 0x00001000,
899 SSL_OP_NO_TLSv1 = 0x00002000,
900 SSL_OP_PKCS1_CHECK_1 = 0x00004000,
901 SSL_OP_PKCS1_CHECK_2 = 0x00008000,
902 SSL_OP_NETSCAPE_CA_DN_BUG = 0x00010000,
903 SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG = 0x00020000,
904 SSL_OP_SINGLE_DH_USE = 0x00040000,
905 SSL_OP_NO_TICKET = 0x00080000,
906 SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS = 0x00100000,
907 SSL_OP_NO_QUERY_MTU = 0x00200000,
908 SSL_OP_COOKIE_EXCHANGE = 0x00400000,
909 SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION = 0x00800000,
910 SSL_OP_SINGLE_ECDH_USE = 0x01000000,
911 SSL_OP_CIPHER_SERVER_PREFERENCE = 0x02000000,
912 SSL_OP_NO_TLSv1_1 = 0x04000000,
913 SSL_OP_NO_TLSv1_2 = 0x08000000,
914 SSL_OP_NO_COMPRESSION = 0x10000000,
915 SSL_OP_NO_TLSv1_3 = 0x20000000,
916};
917
918enum {
919#ifdef HAVE_OCSP
920 /* OCSP Flags */
921 OCSP_NOCERTS = 1,
922 OCSP_NOINTERN = 2,
923 OCSP_NOSIGS = 4,
924 OCSP_NOCHAIN = 8,
925 OCSP_NOVERIFY = 16,
926 OCSP_NOEXPLICIT = 32,
927 OCSP_NOCASIGN = 64,
928 OCSP_NODELEGATED = 128,
929 OCSP_NOCHECKS = 256,
930 OCSP_TRUSTOTHER = 512,
931 OCSP_RESPID_KEY = 1024,
932 OCSP_NOTIME = 2048,
933
934 /* OCSP Types */
935 OCSP_CERTID = 2,
936 OCSP_REQUEST = 4,
937 OCSP_RESPONSE = 8,
938 OCSP_BASICRESP = 16,
939#endif
940
941 ASN1_GENERALIZEDTIME = 4,
942 SSL_MAX_SSL_SESSION_ID_LENGTH = 32,
943
944 EVP_R_BAD_DECRYPT = 2,
945
946 SSL_ST_CONNECT = 0x1000,
947 SSL_ST_ACCEPT = 0x2000,
948
949 SSL_CB_LOOP = 0x01,
950 SSL_CB_EXIT = 0x02,
951 SSL_CB_READ = 0x04,
952 SSL_CB_WRITE = 0x08,
953 SSL_CB_HANDSHAKE_START = 0x10,
954 SSL_CB_HANDSHAKE_DONE = 0x20,
955 SSL_CB_ALERT = 0x4000,
956 SSL_CB_READ_ALERT = (SSL_CB_ALERT | SSL_CB_READ),
957 SSL_CB_WRITE_ALERT = (SSL_CB_ALERT | SSL_CB_WRITE),
958 SSL_CB_ACCEPT_LOOP = (SSL_ST_ACCEPT | SSL_CB_LOOP),
959 SSL_CB_ACCEPT_EXIT = (SSL_ST_ACCEPT | SSL_CB_EXIT),
960 SSL_CB_CONNECT_LOOP = (SSL_ST_CONNECT | SSL_CB_LOOP),
961 SSL_CB_CONNECT_EXIT = (SSL_ST_CONNECT | SSL_CB_EXIT),
962
963 SSL_MODE_ENABLE_PARTIAL_WRITE = 2,
964
965 BIO_FLAGS_BASE64_NO_NL = 1,
966 BIO_CLOSE = 1,
967 BIO_NOCLOSE = 0,
968
969 NID_undef = 0,
970
971 X509_FILETYPE_PEM = 8,
972 X509_LU_X509 = 9,
973 X509_LU_CRL = 12,
974
975 X509_V_OK = 0,
976 X509_V_ERR_CRL_SIGNATURE_FAILURE = 13,
977 X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD = 14,
978 X509_V_ERR_CRL_HAS_EXPIRED = 15,
979 X509_V_ERR_CERT_REVOKED = 16,
980 X509_V_ERR_CERT_CHAIN_TOO_LONG = 17,
981 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT = 18,
982 X509_V_ERR_CERT_NOT_YET_VALID = 19,
983 X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD = 20,
984 X509_V_ERR_CERT_HAS_EXPIRED = 21,
985 X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD = 22,
986 X509_V_ERR_CERT_REJECTED = 23,
987 /* Required for Nginx */
988 X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT = 24,
989 X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN = 25,
990 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY = 26,
991 X509_V_ERR_CERT_UNTRUSTED = 27,
992 X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE = 28,
993 X509_V_ERR_SUBJECT_ISSUER_MISMATCH = 29,
994 /* additional X509_V_ERR_* enums not used in wolfSSL */
995 X509_V_ERR_UNABLE_TO_GET_CRL,
996 X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE,
997 X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE,
998 X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY,
999 X509_V_ERR_CERT_SIGNATURE_FAILURE,
1000 X509_V_ERR_CRL_NOT_YET_VALID,
1001 X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD,
1002 X509_V_ERR_OUT_OF_MEM,
1003 X509_V_ERR_INVALID_CA,
1004 X509_V_ERR_PATH_LENGTH_EXCEEDED,
1005 X509_V_ERR_INVALID_PURPOSE,
1006 X509_V_ERR_AKID_SKID_MISMATCH,
1007 X509_V_ERR_AKID_ISSUER_SERIAL_MISMATCH,
1008 X509_V_ERR_KEYUSAGE_NO_CERTSIGN,
1009 X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER,
1010 X509_V_ERR_UNHANDLED_CRITICAL_EXTENSION,
1011 X509_V_ERR_KEYUSAGE_NO_CRL_SIGN,
1012 X509_V_ERR_UNHANDLED_CRITICAL_CRL_EXTENSION,
1013 X509_V_ERR_INVALID_NON_CA,
1014 X509_V_ERR_PROXY_PATH_LENGTH_EXCEEDED,
1015 X509_V_ERR_KEYUSAGE_NO_DIGITAL_SIGNATURE,
1016 X509_V_ERR_PROXY_CERTIFICATES_NOT_ALLOWED,
1017 X509_V_ERR_INVALID_EXTENSION,
1018 X509_V_ERR_INVALID_POLICY_EXTENSION,
1019 X509_V_ERR_NO_EXPLICIT_POLICY,
1020 X509_V_ERR_UNNESTED_RESOURCE,
1021
1022 XN_FLAG_SPC_EQ = (1 << 23),
1023 XN_FLAG_ONELINE = 0,
1024 XN_FLAG_RFC2253 = 1,
1025
1026 CRYPTO_LOCK = 1,
1027 CRYPTO_NUM_LOCKS = 10,
1028
1029 ASN1_STRFLGS_ESC_MSB = 4
1030};
1031#endif
1032
1033/* extras end */
1034
1035#if !defined(NO_FILESYSTEM) && !defined(NO_STDIO_FILESYSTEM)
1036/* wolfSSL extension, provide last error from SSL_get_error
1037 since not using thread storage error queue */
1038#include <stdio.h>
1039WOLFSSL_API void wolfSSL_ERR_print_errors_fp(FILE*, int err);
1040#if defined(OPENSSL_EXTRA) || defined(DEBUG_WOLFSSL_VERBOSE)
1041WOLFSSL_API void wolfSSL_ERR_dump_errors_fp(FILE* fp);
1042#endif
1043#endif
1044
1045
1046#ifndef NO_OLD_SSL_NAMES
1047 #define SSL_ERROR_NONE WOLFSSL_ERROR_NONE
1048 #define SSL_FAILURE WOLFSSL_FAILURE
1049 #define SSL_SUCCESS WOLFSSL_SUCCESS
1050 #define SSL_SHUTDOWN_NOT_DONE WOLFSSL_SHUTDOWN_NOT_DONE
1051
1052 #define SSL_ALPN_NOT_FOUND WOLFSSL_ALPN_NOT_FOUND
1053 #define SSL_BAD_CERTTYPE WOLFSSL_BAD_CERTTYPE
1054 #define SSL_BAD_STAT WOLFSSL_BAD_STAT
1055 #define SSL_BAD_PATH WOLFSSL_BAD_PATH
1056 #define SSL_BAD_FILETYPE WOLFSSL_BAD_FILETYPE
1057 #define SSL_BAD_FILE WOLFSSL_BAD_FILE
1058 #define SSL_NOT_IMPLEMENTED WOLFSSL_NOT_IMPLEMENTED
1059 #define SSL_UNKNOWN WOLFSSL_UNKNOWN
1060 #define SSL_FATAL_ERROR WOLFSSL_FATAL_ERROR
1061
1062 #define SSL_FILETYPE_ASN1 WOLFSSL_FILETYPE_ASN1
1063 #define SSL_FILETYPE_PEM WOLFSSL_FILETYPE_PEM
1064 #define SSL_FILETYPE_DEFAULT WOLFSSL_FILETYPE_DEFAULT
1065 #define SSL_FILETYPE_RAW WOLFSSL_FILETYPE_RAW
1066
1067 #define SSL_VERIFY_NONE WOLFSSL_VERIFY_NONE
1068 #define SSL_VERIFY_PEER WOLFSSL_VERIFY_PEER
1069 #define SSL_VERIFY_FAIL_IF_NO_PEER_CERT WOLFSSL_VERIFY_FAIL_IF_NO_PEER_CERT
1070 #define SSL_VERIFY_CLIENT_ONCE WOLFSSL_VERIFY_CLIENT_ONCE
1071 #define SSL_VERIFY_FAIL_EXCEPT_PSK WOLFSSL_VERIFY_FAIL_EXCEPT_PSK
1072
1073 #define SSL_SESS_CACHE_OFF WOLFSSL_SESS_CACHE_OFF
1074 #define SSL_SESS_CACHE_CLIENT WOLFSSL_SESS_CACHE_CLIENT
1075 #define SSL_SESS_CACHE_SERVER WOLFSSL_SESS_CACHE_SERVER
1076 #define SSL_SESS_CACHE_BOTH WOLFSSL_SESS_CACHE_BOTH
1077 #define SSL_SESS_CACHE_NO_AUTO_CLEAR WOLFSSL_SESS_CACHE_NO_AUTO_CLEAR
1078 #define SSL_SESS_CACHE_NO_INTERNAL_LOOKUP WOLFSSL_SESS_CACHE_NO_INTERNAL_LOOKUP
1079 #define SSL_SESS_CACHE_NO_INTERNAL_STORE WOLFSSL_SESS_CACHE_NO_INTERNAL_STORE
1080 #define SSL_SESS_CACHE_NO_INTERNAL WOLFSSL_SESS_CACHE_NO_INTERNAL
1081
1082 #define SSL_ERROR_WANT_READ WOLFSSL_ERROR_WANT_READ
1083 #define SSL_ERROR_WANT_WRITE WOLFSSL_ERROR_WANT_WRITE
1084 #define SSL_ERROR_WANT_CONNECT WOLFSSL_ERROR_WANT_CONNECT
1085 #define SSL_ERROR_WANT_ACCEPT WOLFSSL_ERROR_WANT_ACCEPT
1086 #define SSL_ERROR_SYSCALL WOLFSSL_ERROR_SYSCALL
1087 #define SSL_ERROR_WANT_X509_LOOKUP WOLFSSL_ERROR_WANT_X509_LOOKUP
1088 #define SSL_ERROR_ZERO_RETURN WOLFSSL_ERROR_ZERO_RETURN
1089 #define SSL_ERROR_SSL WOLFSSL_ERROR_SSL
1090
1091 #define SSL_SENT_SHUTDOWN WOLFSSL_SENT_SHUTDOWN
1092 #define SSL_RECEIVED_SHUTDOWN WOLFSSL_RECEIVED_SHUTDOWN
1093 #define SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER WOLFSSL_MODE_ACCEPT_MOVING_WRITE_BUFFER
1094 #define SSL_OP_NO_SSLv2 WOLFSSL_OP_NO_SSLv2
1095
1096 #define SSL_R_SSL_HANDSHAKE_FAILURE WOLFSSL_R_SSL_HANDSHAKE_FAILURE
1097 #define SSL_R_TLSV1_ALERT_UNKNOWN_CA WOLFSSL_R_TLSV1_ALERT_UNKNOWN_CA
1098 #define SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN WOLFSSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN
1099 #define SSL_R_SSLV3_ALERT_BAD_CERTIFICATE WOLFSSL_R_SSLV3_ALERT_BAD_CERTIFICATE
1100
1101 #define PEM_BUFSIZE WOLF_PEM_BUFSIZE
1102#endif
1103
1104enum { /* ssl Constants */
1105 WOLFSSL_ERROR_NONE = 0, /* for most functions */
1106 WOLFSSL_FAILURE = 0, /* for some functions */
1107 WOLFSSL_SUCCESS = 1,
1108 WOLFSSL_SHUTDOWN_NOT_DONE = 2, /* call wolfSSL_shutdown again to complete */
1109
1110 WOLFSSL_ALPN_NOT_FOUND = -9,
1111 WOLFSSL_BAD_CERTTYPE = -8,
1112 WOLFSSL_BAD_STAT = -7,
1113 WOLFSSL_BAD_PATH = -6,
1114 WOLFSSL_BAD_FILETYPE = -5,
1115 WOLFSSL_BAD_FILE = -4,
1116 WOLFSSL_NOT_IMPLEMENTED = -3,
1117 WOLFSSL_UNKNOWN = -2,
1118 WOLFSSL_FATAL_ERROR = -1,
1119
1120 WOLFSSL_FILETYPE_ASN1 = 2,
1121 WOLFSSL_FILETYPE_PEM = 1,
1122 WOLFSSL_FILETYPE_DEFAULT = 2, /* ASN1 */
1123 WOLFSSL_FILETYPE_RAW = 3, /* NTRU raw key blob */
1124
1125 WOLFSSL_VERIFY_NONE = 0,
1126 WOLFSSL_VERIFY_PEER = 1,
1127 WOLFSSL_VERIFY_FAIL_IF_NO_PEER_CERT = 2,
1128 WOLFSSL_VERIFY_CLIENT_ONCE = 4,
1129 WOLFSSL_VERIFY_FAIL_EXCEPT_PSK = 8,
1130
1131 WOLFSSL_SESS_CACHE_OFF = 0x0000,
1132 WOLFSSL_SESS_CACHE_CLIENT = 0x0001,
1133 WOLFSSL_SESS_CACHE_SERVER = 0x0002,
1134 WOLFSSL_SESS_CACHE_BOTH = 0x0003,
1135 WOLFSSL_SESS_CACHE_NO_AUTO_CLEAR = 0x0008,
1136 WOLFSSL_SESS_CACHE_NO_INTERNAL_LOOKUP = 0x0100,
1137 WOLFSSL_SESS_CACHE_NO_INTERNAL_STORE = 0x0200,
1138 WOLFSSL_SESS_CACHE_NO_INTERNAL = 0x0300,
1139
1140 WOLFSSL_ERROR_WANT_READ = 2,
1141 WOLFSSL_ERROR_WANT_WRITE = 3,
1142 WOLFSSL_ERROR_WANT_CONNECT = 7,
1143 WOLFSSL_ERROR_WANT_ACCEPT = 8,
1144 WOLFSSL_ERROR_SYSCALL = 5,
1145 WOLFSSL_ERROR_WANT_X509_LOOKUP = 83,
1146 WOLFSSL_ERROR_ZERO_RETURN = 6,
1147 WOLFSSL_ERROR_SSL = 85,
1148
1149 WOLFSSL_SENT_SHUTDOWN = 1,
1150 WOLFSSL_RECEIVED_SHUTDOWN = 2,
1151 WOLFSSL_MODE_ACCEPT_MOVING_WRITE_BUFFER = 4,
1152 WOLFSSL_OP_NO_SSLv2 = 8,
1153
1154 WOLFSSL_R_SSL_HANDSHAKE_FAILURE = 101,
1155 WOLFSSL_R_TLSV1_ALERT_UNKNOWN_CA = 102,
1156 WOLFSSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN = 103,
1157 WOLFSSL_R_SSLV3_ALERT_BAD_CERTIFICATE = 104,
1158
1159 WOLF_PEM_BUFSIZE = 1024
1160};
1161
1162#ifndef NO_PSK
1163 typedef unsigned int (*wc_psk_client_callback)(WOLFSSL*, const char*, char*,
1164 unsigned int, unsigned char*, unsigned int);
1165 WOLFSSL_API void wolfSSL_CTX_set_psk_client_callback(WOLFSSL_CTX*,
1166 wc_psk_client_callback);
1167 WOLFSSL_API void wolfSSL_set_psk_client_callback(WOLFSSL*,
1168 wc_psk_client_callback);
1169
1170 WOLFSSL_API const char* wolfSSL_get_psk_identity_hint(const WOLFSSL*);
1171 WOLFSSL_API const char* wolfSSL_get_psk_identity(const WOLFSSL*);
1172
1173 WOLFSSL_API int wolfSSL_CTX_use_psk_identity_hint(WOLFSSL_CTX*, const char*);
1174 WOLFSSL_API int wolfSSL_use_psk_identity_hint(WOLFSSL*, const char*);
1175
1176 typedef unsigned int (*wc_psk_server_callback)(WOLFSSL*, const char*,
1177 unsigned char*, unsigned int);
1178 WOLFSSL_API void wolfSSL_CTX_set_psk_server_callback(WOLFSSL_CTX*,
1179 wc_psk_server_callback);
1180 WOLFSSL_API void wolfSSL_set_psk_server_callback(WOLFSSL*,
1181 wc_psk_server_callback);
1182
1183 #define PSK_TYPES_DEFINED
1184#endif /* NO_PSK */
1185
1186
1187#ifdef HAVE_ANON
1188 WOLFSSL_API int wolfSSL_CTX_allow_anon_cipher(WOLFSSL_CTX*);
1189#endif /* HAVE_ANON */
1190
1191
1192/* extra begins */
1193#ifdef OPENSSL_EXTRA
1194enum { /* ERR Constants */
1195 ERR_TXT_STRING = 1
1196};
1197
1198/* bio misc */
1199enum {
1200 WOLFSSL_BIO_ERROR = -1,
1201 WOLFSSL_BIO_UNSET = -2,
1202 WOLFSSL_BIO_SIZE = 17000 /* default BIO write size if not set */
1203};
1204
1205#endif
1206
1207WOLFSSL_API unsigned long wolfSSL_ERR_get_error_line_data(const char**, int*,
1208 const char**, int *);
1209
1210WOLFSSL_API unsigned long wolfSSL_ERR_get_error(void);
1211WOLFSSL_API void wolfSSL_ERR_clear_error(void);
1212
1213
1214WOLFSSL_API int wolfSSL_RAND_status(void);
1215WOLFSSL_API int wolfSSL_RAND_bytes(unsigned char* buf, int num);
1216WOLFSSL_API WOLFSSL_METHOD *wolfSSLv23_server_method(void);
1217WOLFSSL_API long wolfSSL_CTX_set_options(WOLFSSL_CTX*, long);
1218#ifndef NO_CERTS
1219 WOLFSSL_API int wolfSSL_CTX_check_private_key(WOLFSSL_CTX*);
1220#endif /* !NO_CERTS */
1221
1222WOLFSSL_API void wolfSSL_ERR_free_strings(void);
1223WOLFSSL_API void wolfSSL_ERR_remove_state(unsigned long);
1224WOLFSSL_API void wolfSSL_EVP_cleanup(void);
1225WOLFSSL_API int wolfSSL_clear(WOLFSSL* ssl);
1226WOLFSSL_API int wolfSSL_state(WOLFSSL* ssl);
1227
1228WOLFSSL_API void wolfSSL_cleanup_all_ex_data(void);
1229WOLFSSL_API long wolfSSL_CTX_set_mode(WOLFSSL_CTX* ctx, long mode);
1230WOLFSSL_API long wolfSSL_CTX_get_mode(WOLFSSL_CTX* ctx);
1231WOLFSSL_API void wolfSSL_CTX_set_default_read_ahead(WOLFSSL_CTX* ctx, int m);
1232WOLFSSL_API long wolfSSL_SSL_get_mode(WOLFSSL* ssl);
1233
1234
1235WOLFSSL_API int wolfSSL_CTX_set_default_verify_paths(WOLFSSL_CTX*);
1236WOLFSSL_API int wolfSSL_CTX_set_session_id_context(WOLFSSL_CTX*,
1237 const unsigned char*, unsigned int);
1238WOLFSSL_API WOLFSSL_X509* wolfSSL_get_peer_certificate(WOLFSSL* ssl);
1239
1240WOLFSSL_API int wolfSSL_want_read(WOLFSSL*);
1241WOLFSSL_API int wolfSSL_want_write(WOLFSSL*);
1242
1243WOLFSSL_API int wolfSSL_BIO_printf(WOLFSSL_BIO*, const char*, ...);
1244WOLFSSL_API int wolfSSL_ASN1_UTCTIME_print(WOLFSSL_BIO*,
1245 const WOLFSSL_ASN1_UTCTIME*);
1246WOLFSSL_API int wolfSSL_ASN1_GENERALIZEDTIME_print(WOLFSSL_BIO*,
1247 const WOLFSSL_ASN1_GENERALIZEDTIME*);
1248WOLFSSL_API int wolfSSL_sk_num(WOLFSSL_X509_REVOKED*);
1249WOLFSSL_API void* wolfSSL_sk_value(WOLFSSL_X509_REVOKED*, int);
1250
1251/* stunnel 4.28 needs */
1252WOLFSSL_API void* wolfSSL_CTX_get_ex_data(const WOLFSSL_CTX*, int);
1253WOLFSSL_API int wolfSSL_CTX_set_ex_data(WOLFSSL_CTX*, int, void*);
1254WOLFSSL_API void wolfSSL_CTX_sess_set_get_cb(WOLFSSL_CTX*,
1255 WOLFSSL_SESSION*(*f)(WOLFSSL*, unsigned char*, int, int*));
1256WOLFSSL_API void wolfSSL_CTX_sess_set_new_cb(WOLFSSL_CTX*,
1257 int (*f)(WOLFSSL*, WOLFSSL_SESSION*));
1258WOLFSSL_API void wolfSSL_CTX_sess_set_remove_cb(WOLFSSL_CTX*,
1259 void (*f)(WOLFSSL_CTX*, WOLFSSL_SESSION*));
1260
1261WOLFSSL_API int wolfSSL_i2d_SSL_SESSION(WOLFSSL_SESSION*,unsigned char**);
1262WOLFSSL_API WOLFSSL_SESSION* wolfSSL_d2i_SSL_SESSION(WOLFSSL_SESSION**,
1263 const unsigned char**, long);
1264
1265WOLFSSL_API long wolfSSL_SESSION_get_timeout(const WOLFSSL_SESSION*);
1266WOLFSSL_API long wolfSSL_SESSION_get_time(const WOLFSSL_SESSION*);
1267WOLFSSL_API int wolfSSL_CTX_get_ex_new_index(long, void*, void*, void*, void*);
1268
1269/* extra ends */
1270
1271
1272/* wolfSSL extensions */
1273
1274/* call before SSL_connect, if verifying will add name check to
1275 date check and signature check */
1276WOLFSSL_API int wolfSSL_check_domain_name(WOLFSSL* ssl, const char* dn);
1277
1278/* need to call once to load library (session cache) */
1279WOLFSSL_API int wolfSSL_Init(void);
1280/* call when done to cleanup/free session cache mutex / resources */
1281WOLFSSL_API int wolfSSL_Cleanup(void);
1282
1283/* which library version do we have */
1284WOLFSSL_API const char* wolfSSL_lib_version(void);
1285/* which library version do we have in hex */
1286WOLFSSL_API unsigned int wolfSSL_lib_version_hex(void);
1287
1288/* turn logging on, only if compiled in */
1289WOLFSSL_API int wolfSSL_Debugging_ON(void);
1290/* turn logging off */
1291WOLFSSL_API void wolfSSL_Debugging_OFF(void);
1292
1293/* do accept or connect depedning on side */
1294WOLFSSL_API int wolfSSL_negotiate(WOLFSSL* ssl);
1295/* turn on wolfSSL data compression */
1296WOLFSSL_API int wolfSSL_set_compression(WOLFSSL* ssl);
1297
1298WOLFSSL_API int wolfSSL_set_timeout(WOLFSSL*, unsigned int);
1299WOLFSSL_API int wolfSSL_CTX_set_timeout(WOLFSSL_CTX*, unsigned int);
1300
1301/* get wolfSSL peer X509_CHAIN */
1302WOLFSSL_API WOLFSSL_X509_CHAIN* wolfSSL_get_peer_chain(WOLFSSL* ssl);
1303#ifdef WOLFSSL_ALT_CERT_CHAINS
1304WOLFSSL_API int wolfSSL_is_peer_alt_cert_chain(const WOLFSSL* ssl);
1305/* get wolfSSL alternate peer X509_CHAIN */
1306WOLFSSL_API WOLFSSL_X509_CHAIN* wolfSSL_get_peer_alt_chain(WOLFSSL* ssl);
1307#endif
1308/* peer chain count */
1309WOLFSSL_API int wolfSSL_get_chain_count(WOLFSSL_X509_CHAIN* chain);
1310/* index cert length */
1311WOLFSSL_API int wolfSSL_get_chain_length(WOLFSSL_X509_CHAIN*, int idx);
1312/* index cert */
1313WOLFSSL_API unsigned char* wolfSSL_get_chain_cert(WOLFSSL_X509_CHAIN*, int idx);
1314/* index cert in X509 */
1315WOLFSSL_API WOLFSSL_X509* wolfSSL_get_chain_X509(WOLFSSL_X509_CHAIN*, int idx);
1316/* free X509 */
1317WOLFSSL_API void wolfSSL_FreeX509(WOLFSSL_X509*);
1318/* get index cert in PEM */
1319WOLFSSL_API int wolfSSL_get_chain_cert_pem(WOLFSSL_X509_CHAIN*, int idx,
1320 unsigned char* buf, int inLen, int* outLen);
1321WOLFSSL_API const unsigned char* wolfSSL_get_sessionID(const WOLFSSL_SESSION* s);
1322WOLFSSL_API int wolfSSL_X509_get_serial_number(WOLFSSL_X509*,unsigned char*,int*);
1323WOLFSSL_API char* wolfSSL_X509_get_subjectCN(WOLFSSL_X509*);
1324WOLFSSL_API const unsigned char* wolfSSL_X509_get_der(WOLFSSL_X509*, int*);
1325WOLFSSL_API const unsigned char* wolfSSL_X509_notBefore(WOLFSSL_X509*);
1326WOLFSSL_API const unsigned char* wolfSSL_X509_notAfter(WOLFSSL_X509*);
1327WOLFSSL_API int wolfSSL_X509_version(WOLFSSL_X509*);
1328
1329WOLFSSL_API int wolfSSL_cmp_peer_cert_to_file(WOLFSSL*, const char*);
1330
1331WOLFSSL_API char* wolfSSL_X509_get_next_altname(WOLFSSL_X509*);
1332
1333WOLFSSL_API WOLFSSL_X509*
1334 wolfSSL_X509_d2i(WOLFSSL_X509** x509, const unsigned char* in, int len);
1335#ifndef NO_FILESYSTEM
1336 #ifndef NO_STDIO_FILESYSTEM
1337 WOLFSSL_API WOLFSSL_X509*
1338 wolfSSL_X509_d2i_fp(WOLFSSL_X509** x509, FILE* file);
1339 #endif
1340WOLFSSL_API WOLFSSL_X509*
1341 wolfSSL_X509_load_certificate_file(const char* fname, int format);
1342#endif
1343WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_load_certificate_buffer(
1344 const unsigned char* buf, int sz, int format);
1345
1346#ifdef WOLFSSL_SEP
1347 WOLFSSL_API unsigned char*
1348 wolfSSL_X509_get_device_type(WOLFSSL_X509*, unsigned char*, int*);
1349 WOLFSSL_API unsigned char*
1350 wolfSSL_X509_get_hw_type(WOLFSSL_X509*, unsigned char*, int*);
1351 WOLFSSL_API unsigned char*
1352 wolfSSL_X509_get_hw_serial_number(WOLFSSL_X509*, unsigned char*, int*);
1353#endif
1354
1355/* connect enough to get peer cert */
1356WOLFSSL_API int wolfSSL_connect_cert(WOLFSSL* ssl);
1357
1358
1359
1360/* PKCS12 compatibility */
1361typedef struct WC_PKCS12 WC_PKCS12;
1362WOLFSSL_API WC_PKCS12* wolfSSL_d2i_PKCS12_bio(WOLFSSL_BIO* bio,
1363 WC_PKCS12** pkcs12);
1364WOLFSSL_API int wolfSSL_PKCS12_parse(WC_PKCS12* pkcs12, const char* psw,
1365 WOLFSSL_EVP_PKEY** pkey, WOLFSSL_X509** cert, WOLF_STACK_OF(WOLFSSL_X509)** ca);
1366WOLFSSL_API void wolfSSL_PKCS12_PBE_add(void);
1367
1368
1369
1370#ifndef NO_DH
1371/* server Diffie-Hellman parameters */
1372WOLFSSL_API int wolfSSL_SetTmpDH(WOLFSSL*, const unsigned char* p, int pSz,
1373 const unsigned char* g, int gSz);
1374WOLFSSL_API int wolfSSL_SetTmpDH_buffer(WOLFSSL*, const unsigned char* b, long sz,
1375 int format);
1376#ifndef NO_FILESYSTEM
1377 WOLFSSL_API int wolfSSL_SetTmpDH_file(WOLFSSL*, const char* f, int format);
1378#endif
1379
1380/* server ctx Diffie-Hellman parameters */
1381WOLFSSL_API int wolfSSL_CTX_SetTmpDH(WOLFSSL_CTX*, const unsigned char* p,
1382 int pSz, const unsigned char* g, int gSz);
1383WOLFSSL_API int wolfSSL_CTX_SetTmpDH_buffer(WOLFSSL_CTX*, const unsigned char* b,
1384 long sz, int format);
1385
1386#ifndef NO_FILESYSTEM
1387 WOLFSSL_API int wolfSSL_CTX_SetTmpDH_file(WOLFSSL_CTX*, const char* f,
1388 int format);
1389#endif
1390
1391WOLFSSL_API int wolfSSL_CTX_SetMinDhKey_Sz(WOLFSSL_CTX*, unsigned short);
1392WOLFSSL_API int wolfSSL_SetMinDhKey_Sz(WOLFSSL*, unsigned short);
1393WOLFSSL_API int wolfSSL_GetDhKey_Sz(WOLFSSL*);
1394#endif /* NO_DH */
1395
1396#ifndef NO_RSA
1397WOLFSSL_API int wolfSSL_CTX_SetMinRsaKey_Sz(WOLFSSL_CTX*, short);
1398WOLFSSL_API int wolfSSL_SetMinRsaKey_Sz(WOLFSSL*, short);
1399#endif /* NO_RSA */
1400
1401#ifdef HAVE_ECC
1402WOLFSSL_API int wolfSSL_CTX_SetMinEccKey_Sz(WOLFSSL_CTX*, short);
1403WOLFSSL_API int wolfSSL_SetMinEccKey_Sz(WOLFSSL*, short);
1404#endif /* NO_RSA */
1405
1406WOLFSSL_API int wolfSSL_SetTmpEC_DHE_Sz(WOLFSSL*, unsigned short);
1407WOLFSSL_API int wolfSSL_CTX_SetTmpEC_DHE_Sz(WOLFSSL_CTX*, unsigned short);
1408
1409/* keyblock size in bytes or -1 */
1410/* need to call wolfSSL_KeepArrays before handshake to save keys */
1411WOLFSSL_API int wolfSSL_get_keyblock_size(WOLFSSL*);
1412WOLFSSL_API int wolfSSL_get_keys(WOLFSSL*,unsigned char** ms, unsigned int* msLen,
1413 unsigned char** sr, unsigned int* srLen,
1414 unsigned char** cr, unsigned int* crLen);
1415
1416/* Computes EAP-TLS and EAP-TTLS keying material from the master_secret. */
1417WOLFSSL_API int wolfSSL_make_eap_keys(WOLFSSL*, void* key, unsigned int len,
1418 const char* label);
1419
1420
1421#ifndef _WIN32
1422 #ifndef NO_WRITEV
1423 #ifdef __PPU
1424 #include <sys/types.h>
1425 #include <sys/socket.h>
1426 #elif !defined(WOLFSSL_MDK_ARM) && !defined(WOLFSSL_IAR_ARM) && \
1427 !defined(WOLFSSL_PICOTCP) && !defined(WOLFSSL_ROWLEY_ARM) && \
1428 !defined(WOLFSSL_EMBOS) && !defined(WOLFSSL_FROSTED)
1429 #include <sys/uio.h>
1430 #endif
1431 /* allow writev style writing */
1432 WOLFSSL_API int wolfSSL_writev(WOLFSSL* ssl, const struct iovec* iov,
1433 int iovcnt);
1434 #endif
1435#endif
1436
1437
1438#ifndef NO_CERTS
1439 /* SSL_CTX versions */
1440 WOLFSSL_API int wolfSSL_CTX_UnloadCAs(WOLFSSL_CTX*);
1441#ifdef WOLFSSL_TRUST_PEER_CERT
1442 WOLFSSL_API int wolfSSL_CTX_Unload_trust_peers(WOLFSSL_CTX*);
1443 WOLFSSL_API int wolfSSL_CTX_trust_peer_buffer(WOLFSSL_CTX*,
1444 const unsigned char*, long, int);
1445#endif
1446 WOLFSSL_API int wolfSSL_CTX_load_verify_buffer(WOLFSSL_CTX*,
1447 const unsigned char*, long, int);
1448 WOLFSSL_API int wolfSSL_CTX_use_certificate_buffer(WOLFSSL_CTX*,
1449 const unsigned char*, long, int);
1450 WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_buffer(WOLFSSL_CTX*,
1451 const unsigned char*, long, int);
1452 WOLFSSL_API int wolfSSL_CTX_use_certificate_chain_buffer_format(WOLFSSL_CTX*,
1453 const unsigned char*, long, int);
1454 WOLFSSL_API int wolfSSL_CTX_use_certificate_chain_buffer(WOLFSSL_CTX*,
1455 const unsigned char*, long);
1456
1457 /* SSL versions */
1458 WOLFSSL_API int wolfSSL_use_certificate_buffer(WOLFSSL*, const unsigned char*,
1459 long, int);
1460 WOLFSSL_API int wolfSSL_use_PrivateKey_buffer(WOLFSSL*, const unsigned char*,
1461 long, int);
1462 WOLFSSL_API int wolfSSL_use_certificate_chain_buffer_format(WOLFSSL*,
1463 const unsigned char*, long, int);
1464 WOLFSSL_API int wolfSSL_use_certificate_chain_buffer(WOLFSSL*,
1465 const unsigned char*, long);
1466 WOLFSSL_API int wolfSSL_UnloadCertsKeys(WOLFSSL*);
1467
1468 #if defined(OPENSSL_EXTRA) && defined(KEEP_OUR_CERT)
1469 WOLFSSL_API WOLFSSL_X509* wolfSSL_get_certificate(WOLFSSL* ssl);
1470 #endif
1471#endif
1472
1473WOLFSSL_API int wolfSSL_CTX_set_group_messages(WOLFSSL_CTX*);
1474WOLFSSL_API int wolfSSL_set_group_messages(WOLFSSL*);
1475
1476
1477#ifdef HAVE_FUZZER
1478enum fuzzer_type {
1479 FUZZ_HMAC = 0,
1480 FUZZ_ENCRYPT = 1,
1481 FUZZ_SIGNATURE = 2,
1482 FUZZ_HASH = 3,
1483 FUZZ_HEAD = 4
1484};
1485
1486typedef int (*CallbackFuzzer)(WOLFSSL* ssl, const unsigned char* buf, int sz,
1487 int type, void* fuzzCtx);
1488
1489WOLFSSL_API void wolfSSL_SetFuzzerCb(WOLFSSL* ssl, CallbackFuzzer cbf, void* fCtx);
1490#endif
1491
1492
1493WOLFSSL_API int wolfSSL_DTLS_SetCookieSecret(WOLFSSL*,
1494 const unsigned char*,
1495 unsigned int);
1496
1497
1498/* I/O Callback default errors */
1499enum IOerrors {
1500 WOLFSSL_CBIO_ERR_GENERAL = -1, /* general unexpected err */
1501 WOLFSSL_CBIO_ERR_WANT_READ = -2, /* need to call read again */
1502 WOLFSSL_CBIO_ERR_WANT_WRITE = -2, /* need to call write again */
1503 WOLFSSL_CBIO_ERR_CONN_RST = -3, /* connection reset */
1504 WOLFSSL_CBIO_ERR_ISR = -4, /* interrupt */
1505 WOLFSSL_CBIO_ERR_CONN_CLOSE = -5, /* connection closed or epipe */
1506 WOLFSSL_CBIO_ERR_TIMEOUT = -6 /* socket timeout */
1507};
1508
1509
1510/* CA cache callbacks */
1511enum {
1512 WOLFSSL_SSLV3 = 0,
1513 WOLFSSL_TLSV1 = 1,
1514 WOLFSSL_TLSV1_1 = 2,
1515 WOLFSSL_TLSV1_2 = 3,
1516 WOLFSSL_USER_CA = 1, /* user added as trusted */
1517 WOLFSSL_CHAIN_CA = 2 /* added to cache from trusted chain */
1518};
1519
1520WOLFSSL_API WC_RNG* wolfSSL_GetRNG(WOLFSSL*);
1521
1522WOLFSSL_API int wolfSSL_CTX_SetMinVersion(WOLFSSL_CTX* ctx, int version);
1523WOLFSSL_API int wolfSSL_SetMinVersion(WOLFSSL* ssl, int version);
1524WOLFSSL_API int wolfSSL_GetObjectSize(void); /* object size based on build */
1525WOLFSSL_API int wolfSSL_CTX_GetObjectSize(void);
1526WOLFSSL_API int wolfSSL_METHOD_GetObjectSize(void);
1527WOLFSSL_API int wolfSSL_GetOutputSize(WOLFSSL*, int);
1528WOLFSSL_API int wolfSSL_GetMaxOutputSize(WOLFSSL*);
1529WOLFSSL_API int wolfSSL_SetVersion(WOLFSSL* ssl, int version);
1530WOLFSSL_API int wolfSSL_KeyPemToDer(const unsigned char*, int,
1531 unsigned char*, int, const char*);
1532WOLFSSL_API int wolfSSL_CertPemToDer(const unsigned char*, int,
1533 unsigned char*, int, int);
1534#if defined(WOLFSSL_CERT_EXT) || defined(WOLFSSL_PUB_PEM_TO_DER)
1535 #ifndef WOLFSSL_PEMPUBKEY_TODER_DEFINED
1536 #ifndef NO_FILESYSTEM
1537 WOLFSSL_API int wolfSSL_PemPubKeyToDer(const char* fileName,
1538 unsigned char* derBuf, int derSz);
1539 #endif
1540 WOLFSSL_API int wolfSSL_PubKeyPemToDer(const unsigned char*, int,
1541 unsigned char*, int);
1542 #define WOLFSSL_PEMPUBKEY_TODER_DEFINED
1543 #endif /* WOLFSSL_PEMPUBKEY_TODER_DEFINED */
1544#endif /* WOLFSSL_CERT_EXT || WOLFSSL_PUB_PEM_TO_DER*/
1545
1546typedef void (*CallbackCACache)(unsigned char* der, int sz, int type);
1547typedef void (*CbMissingCRL)(const char* url);
1548typedef int (*CbOCSPIO)(void*, const char*, int,
1549 unsigned char*, int, unsigned char**);
1550typedef void (*CbOCSPRespFree)(void*,unsigned char*);
1551
1552#ifdef HAVE_CRL_IO
1553typedef int (*CbCrlIO)(WOLFSSL_CRL* crl, const char* url, int urlSz);
1554#endif
1555
1556/* User Atomic Record Layer CallBacks */
1557typedef int (*CallbackMacEncrypt)(WOLFSSL* ssl, unsigned char* macOut,
1558 const unsigned char* macIn, unsigned int macInSz, int macContent,
1559 int macVerify, unsigned char* encOut, const unsigned char* encIn,
1560 unsigned int encSz, void* ctx);
1561WOLFSSL_API void wolfSSL_CTX_SetMacEncryptCb(WOLFSSL_CTX*, CallbackMacEncrypt);
1562WOLFSSL_API void wolfSSL_SetMacEncryptCtx(WOLFSSL* ssl, void *ctx);
1563WOLFSSL_API void* wolfSSL_GetMacEncryptCtx(WOLFSSL* ssl);
1564
1565typedef int (*CallbackDecryptVerify)(WOLFSSL* ssl,
1566 unsigned char* decOut, const unsigned char* decIn,
1567 unsigned int decSz, int content, int verify, unsigned int* padSz,
1568 void* ctx);
1569WOLFSSL_API void wolfSSL_CTX_SetDecryptVerifyCb(WOLFSSL_CTX*,
1570 CallbackDecryptVerify);
1571WOLFSSL_API void wolfSSL_SetDecryptVerifyCtx(WOLFSSL* ssl, void *ctx);
1572WOLFSSL_API void* wolfSSL_GetDecryptVerifyCtx(WOLFSSL* ssl);
1573
1574WOLFSSL_API const unsigned char* wolfSSL_GetMacSecret(WOLFSSL*, int);
1575WOLFSSL_API const unsigned char* wolfSSL_GetClientWriteKey(WOLFSSL*);
1576WOLFSSL_API const unsigned char* wolfSSL_GetClientWriteIV(WOLFSSL*);
1577WOLFSSL_API const unsigned char* wolfSSL_GetServerWriteKey(WOLFSSL*);
1578WOLFSSL_API const unsigned char* wolfSSL_GetServerWriteIV(WOLFSSL*);
1579WOLFSSL_API int wolfSSL_GetKeySize(WOLFSSL*);
1580WOLFSSL_API int wolfSSL_GetIVSize(WOLFSSL*);
1581WOLFSSL_API int wolfSSL_GetSide(WOLFSSL*);
1582WOLFSSL_API int wolfSSL_IsTLSv1_1(WOLFSSL*);
1583WOLFSSL_API int wolfSSL_GetBulkCipher(WOLFSSL*);
1584WOLFSSL_API int wolfSSL_GetCipherBlockSize(WOLFSSL*);
1585WOLFSSL_API int wolfSSL_GetAeadMacSize(WOLFSSL*);
1586WOLFSSL_API int wolfSSL_GetHmacSize(WOLFSSL*);
1587WOLFSSL_API int wolfSSL_GetHmacType(WOLFSSL*);
1588WOLFSSL_API int wolfSSL_GetCipherType(WOLFSSL*);
1589WOLFSSL_API int wolfSSL_SetTlsHmacInner(WOLFSSL*, unsigned char*,
1590 unsigned int, int, int);
1591
1592/* Atomic User Needs */
1593enum {
1594 WOLFSSL_SERVER_END = 0,
1595 WOLFSSL_CLIENT_END = 1,
1596 WOLFSSL_NEITHER_END = 3,
1597 WOLFSSL_BLOCK_TYPE = 2,
1598 WOLFSSL_STREAM_TYPE = 3,
1599 WOLFSSL_AEAD_TYPE = 4,
1600 WOLFSSL_TLS_HMAC_INNER_SZ = 13 /* SEQ_SZ + ENUM + VERSION_SZ + LEN_SZ */
1601};
1602
1603/* for GetBulkCipher and internal use */
1604enum BulkCipherAlgorithm {
1605 wolfssl_cipher_null,
1606 wolfssl_rc4,
1607 wolfssl_rc2,
1608 wolfssl_des,
1609 wolfssl_triple_des, /* leading 3 (3des) not valid identifier */
1610 wolfssl_des40,
1611 wolfssl_idea,
1612 wolfssl_aes,
1613 wolfssl_aes_gcm,
1614 wolfssl_aes_ccm,
1615 wolfssl_chacha,
1616 wolfssl_camellia,
1617 wolfssl_hc128, /* wolfSSL extensions */
1618 wolfssl_rabbit
1619};
1620
1621
1622/* for KDF TLS 1.2 mac types */
1623enum KDF_MacAlgorithm {
1624 wolfssl_sha256 = 4, /* needs to match internal MACAlgorithm */
1625 wolfssl_sha384,
1626 wolfssl_sha512
1627};
1628
1629
1630/* Public Key Callback support */
1631typedef int (*CallbackEccSign)(WOLFSSL* ssl,
1632 const unsigned char* in, unsigned int inSz,
1633 unsigned char* out, unsigned int* outSz,
1634 const unsigned char* keyDer, unsigned int keySz,
1635 void* ctx);
1636WOLFSSL_API void wolfSSL_CTX_SetEccSignCb(WOLFSSL_CTX*, CallbackEccSign);
1637WOLFSSL_API void wolfSSL_SetEccSignCtx(WOLFSSL* ssl, void *ctx);
1638WOLFSSL_API void* wolfSSL_GetEccSignCtx(WOLFSSL* ssl);
1639
1640typedef int (*CallbackEccVerify)(WOLFSSL* ssl,
1641 const unsigned char* sig, unsigned int sigSz,
1642 const unsigned char* hash, unsigned int hashSz,
1643 const unsigned char* keyDer, unsigned int keySz,
1644 int* result, void* ctx);
1645WOLFSSL_API void wolfSSL_CTX_SetEccVerifyCb(WOLFSSL_CTX*, CallbackEccVerify);
1646WOLFSSL_API void wolfSSL_SetEccVerifyCtx(WOLFSSL* ssl, void *ctx);
1647WOLFSSL_API void* wolfSSL_GetEccVerifyCtx(WOLFSSL* ssl);
1648
1649struct ecc_key;
1650typedef int (*CallbackEccSharedSecret)(WOLFSSL* ssl, struct ecc_key* otherKey,
1651 unsigned char* pubKeyDer, unsigned int* pubKeySz,
1652 unsigned char* out, unsigned int* outlen,
1653 int side, void* ctx); /* side is WOLFSSL_CLIENT_END or WOLFSSL_SERVER_END */
1654WOLFSSL_API void wolfSSL_CTX_SetEccSharedSecretCb(WOLFSSL_CTX*, CallbackEccSharedSecret);
1655WOLFSSL_API void wolfSSL_SetEccSharedSecretCtx(WOLFSSL* ssl, void *ctx);
1656WOLFSSL_API void* wolfSSL_GetEccSharedSecretCtx(WOLFSSL* ssl);
1657
1658struct ed25519_key;
1659typedef int (*CallbackEd25519Sign)(WOLFSSL* ssl,
1660 const unsigned char* in, unsigned int inSz,
1661 unsigned char* out, unsigned int* outSz,
1662 const unsigned char* keyDer, unsigned int keySz,
1663 void* ctx);
1664WOLFSSL_API void wolfSSL_CTX_SetEd25519SignCb(WOLFSSL_CTX*,
1665 CallbackEd25519Sign);
1666WOLFSSL_API void wolfSSL_SetEd25519SignCtx(WOLFSSL* ssl, void *ctx);
1667WOLFSSL_API void* wolfSSL_GetEd25519SignCtx(WOLFSSL* ssl);
1668
1669typedef int (*CallbackEd25519Verify)(WOLFSSL* ssl,
1670 const unsigned char* sig, unsigned int sigSz,
1671 const unsigned char* msg, unsigned int msgSz,
1672 const unsigned char* keyDer, unsigned int keySz,
1673 int* result, void* ctx);
1674WOLFSSL_API void wolfSSL_CTX_SetEd25519VerifyCb(WOLFSSL_CTX*,
1675 CallbackEd25519Verify);
1676WOLFSSL_API void wolfSSL_SetEd25519VerifyCtx(WOLFSSL* ssl, void *ctx);
1677WOLFSSL_API void* wolfSSL_GetEd25519VerifyCtx(WOLFSSL* ssl);
1678
1679struct curve25519_key;
1680typedef int (*CallbackX25519SharedSecret)(WOLFSSL* ssl,
1681 struct curve25519_key* otherKey,
1682 unsigned char* pubKeyDer, unsigned int* pubKeySz,
1683 unsigned char* out, unsigned int* outlen,
1684 int side, void* ctx);
1685 /* side is WOLFSSL_CLIENT_END or WOLFSSL_SERVER_END */
1686WOLFSSL_API void wolfSSL_CTX_SetX25519SharedSecretCb(WOLFSSL_CTX*,
1687 CallbackX25519SharedSecret);
1688WOLFSSL_API void wolfSSL_SetX25519SharedSecretCtx(WOLFSSL* ssl, void *ctx);
1689WOLFSSL_API void* wolfSSL_GetX25519SharedSecretCtx(WOLFSSL* ssl);
1690
1691typedef int (*CallbackRsaSign)(WOLFSSL* ssl,
1692 const unsigned char* in, unsigned int inSz,
1693 unsigned char* out, unsigned int* outSz,
1694 const unsigned char* keyDer, unsigned int keySz,
1695 void* ctx);
1696WOLFSSL_API void wolfSSL_CTX_SetRsaSignCb(WOLFSSL_CTX*, CallbackRsaSign);
1697WOLFSSL_API void wolfSSL_SetRsaSignCtx(WOLFSSL* ssl, void *ctx);
1698WOLFSSL_API void* wolfSSL_GetRsaSignCtx(WOLFSSL* ssl);
1699
1700typedef int (*CallbackRsaVerify)(WOLFSSL* ssl,
1701 unsigned char* sig, unsigned int sigSz,
1702 unsigned char** out,
1703 const unsigned char* keyDer, unsigned int keySz,
1704 void* ctx);
1705WOLFSSL_API void wolfSSL_CTX_SetRsaVerifyCb(WOLFSSL_CTX*, CallbackRsaVerify);
1706WOLFSSL_API void wolfSSL_SetRsaVerifyCtx(WOLFSSL* ssl, void *ctx);
1707WOLFSSL_API void* wolfSSL_GetRsaVerifyCtx(WOLFSSL* ssl);
1708
1709#ifdef WC_RSA_PSS
1710typedef int (*CallbackRsaPssSign)(WOLFSSL* ssl,
1711 const unsigned char* in, unsigned int inSz,
1712 unsigned char* out, unsigned int* outSz,
1713 int hash, int mgf,
1714 const unsigned char* keyDer, unsigned int keySz,
1715 void* ctx);
1716WOLFSSL_API void wolfSSL_CTX_SetRsaPssSignCb(WOLFSSL_CTX*, CallbackRsaPssSign);
1717WOLFSSL_API void wolfSSL_SetRsaPssSignCtx(WOLFSSL* ssl, void *ctx);
1718WOLFSSL_API void* wolfSSL_GetRsaPssSignCtx(WOLFSSL* ssl);
1719
1720typedef int (*CallbackRsaPssVerify)(WOLFSSL* ssl,
1721 unsigned char* sig, unsigned int sigSz,
1722 unsigned char** out,
1723 int hash, int mgf,
1724 const unsigned char* keyDer, unsigned int keySz,
1725 void* ctx);
1726WOLFSSL_API void wolfSSL_CTX_SetRsaPssVerifyCb(WOLFSSL_CTX*,
1727 CallbackRsaPssVerify);
1728WOLFSSL_API void wolfSSL_SetRsaPssVerifyCtx(WOLFSSL* ssl, void *ctx);
1729WOLFSSL_API void* wolfSSL_GetRsaPssVerifyCtx(WOLFSSL* ssl);
1730#endif
1731
1732/* RSA Public Encrypt cb */
1733typedef int (*CallbackRsaEnc)(WOLFSSL* ssl,
1734 const unsigned char* in, unsigned int inSz,
1735 unsigned char* out, unsigned int* outSz,
1736 const unsigned char* keyDer, unsigned int keySz,
1737 void* ctx);
1738WOLFSSL_API void wolfSSL_CTX_SetRsaEncCb(WOLFSSL_CTX*, CallbackRsaEnc);
1739WOLFSSL_API void wolfSSL_SetRsaEncCtx(WOLFSSL* ssl, void *ctx);
1740WOLFSSL_API void* wolfSSL_GetRsaEncCtx(WOLFSSL* ssl);
1741
1742/* RSA Private Decrypt cb */
1743typedef int (*CallbackRsaDec)(WOLFSSL* ssl,
1744 unsigned char* in, unsigned int inSz,
1745 unsigned char** out,
1746 const unsigned char* keyDer, unsigned int keySz,
1747 void* ctx);
1748WOLFSSL_API void wolfSSL_CTX_SetRsaDecCb(WOLFSSL_CTX*, CallbackRsaDec);
1749WOLFSSL_API void wolfSSL_SetRsaDecCtx(WOLFSSL* ssl, void *ctx);
1750WOLFSSL_API void* wolfSSL_GetRsaDecCtx(WOLFSSL* ssl);
1751
1752
1753#ifndef NO_CERTS
1754 WOLFSSL_API void wolfSSL_CTX_SetCACb(WOLFSSL_CTX*, CallbackCACache);
1755
1756 WOLFSSL_API WOLFSSL_CERT_MANAGER* wolfSSL_CTX_GetCertManager(WOLFSSL_CTX*);
1757
1758 WOLFSSL_API WOLFSSL_CERT_MANAGER* wolfSSL_CertManagerNew_ex(void* heap);
1759 WOLFSSL_API WOLFSSL_CERT_MANAGER* wolfSSL_CertManagerNew(void);
1760 WOLFSSL_API void wolfSSL_CertManagerFree(WOLFSSL_CERT_MANAGER*);
1761
1762 WOLFSSL_API int wolfSSL_CertManagerLoadCA(WOLFSSL_CERT_MANAGER*, const char* f,
1763 const char* d);
1764 WOLFSSL_API int wolfSSL_CertManagerLoadCABuffer(WOLFSSL_CERT_MANAGER*,
1765 const unsigned char* in, long sz, int format);
1766 WOLFSSL_API int wolfSSL_CertManagerUnloadCAs(WOLFSSL_CERT_MANAGER* cm);
1767#ifdef WOLFSSL_TRUST_PEER_CERT
1768 WOLFSSL_API int wolfSSL_CertManagerUnload_trust_peers(WOLFSSL_CERT_MANAGER* cm);
1769#endif
1770 WOLFSSL_API int wolfSSL_CertManagerVerify(WOLFSSL_CERT_MANAGER*, const char* f,
1771 int format);
1772 WOLFSSL_API int wolfSSL_CertManagerVerifyBuffer(WOLFSSL_CERT_MANAGER* cm,
1773 const unsigned char* buff, long sz, int format);
1774 WOLFSSL_API int wolfSSL_CertManagerCheckCRL(WOLFSSL_CERT_MANAGER*,
1775 unsigned char*, int sz);
1776 WOLFSSL_API int wolfSSL_CertManagerEnableCRL(WOLFSSL_CERT_MANAGER*,
1777 int options);
1778 WOLFSSL_API int wolfSSL_CertManagerDisableCRL(WOLFSSL_CERT_MANAGER*);
1779 WOLFSSL_API int wolfSSL_CertManagerLoadCRL(WOLFSSL_CERT_MANAGER*,
1780 const char*, int, int);
1781 WOLFSSL_API int wolfSSL_CertManagerLoadCRLBuffer(WOLFSSL_CERT_MANAGER*,
1782 const unsigned char*, long sz, int);
1783 WOLFSSL_API int wolfSSL_CertManagerSetCRL_Cb(WOLFSSL_CERT_MANAGER*,
1784 CbMissingCRL);
1785#ifdef HAVE_CRL_IO
1786 WOLFSSL_API int wolfSSL_CertManagerSetCRL_IOCb(WOLFSSL_CERT_MANAGER*,
1787 CbCrlIO);
1788#endif
1789 WOLFSSL_API int wolfSSL_CertManagerCheckOCSP(WOLFSSL_CERT_MANAGER*,
1790 unsigned char*, int sz);
1791 WOLFSSL_API int wolfSSL_CertManagerEnableOCSP(WOLFSSL_CERT_MANAGER*,
1792 int options);
1793 WOLFSSL_API int wolfSSL_CertManagerDisableOCSP(WOLFSSL_CERT_MANAGER*);
1794 WOLFSSL_API int wolfSSL_CertManagerSetOCSPOverrideURL(WOLFSSL_CERT_MANAGER*,
1795 const char*);
1796 WOLFSSL_API int wolfSSL_CertManagerSetOCSP_Cb(WOLFSSL_CERT_MANAGER*,
1797 CbOCSPIO, CbOCSPRespFree, void*);
1798
1799 WOLFSSL_API int wolfSSL_CertManagerEnableOCSPStapling(
1800 WOLFSSL_CERT_MANAGER* cm);
1801 WOLFSSL_API int wolfSSL_CertManagerDisableOCSPStapling(
1802 WOLFSSL_CERT_MANAGER* cm);
1803
1804 WOLFSSL_API int wolfSSL_EnableCRL(WOLFSSL* ssl, int options);
1805 WOLFSSL_API int wolfSSL_DisableCRL(WOLFSSL* ssl);
1806 WOLFSSL_API int wolfSSL_LoadCRL(WOLFSSL*, const char*, int, int);
1807 WOLFSSL_API int wolfSSL_LoadCRLBuffer(WOLFSSL*,
1808 const unsigned char*, long sz, int);
1809 WOLFSSL_API int wolfSSL_SetCRL_Cb(WOLFSSL*, CbMissingCRL);
1810#ifdef HAVE_CRL_IO
1811 WOLFSSL_API int wolfSSL_SetCRL_IOCb(WOLFSSL* ssl, CbCrlIO cb);
1812#endif
1813 WOLFSSL_API int wolfSSL_EnableOCSP(WOLFSSL*, int options);
1814 WOLFSSL_API int wolfSSL_DisableOCSP(WOLFSSL*);
1815 WOLFSSL_API int wolfSSL_SetOCSP_OverrideURL(WOLFSSL*, const char*);
1816 WOLFSSL_API int wolfSSL_SetOCSP_Cb(WOLFSSL*, CbOCSPIO, CbOCSPRespFree, void*);
1817 WOLFSSL_API int wolfSSL_EnableOCSPStapling(WOLFSSL*);
1818 WOLFSSL_API int wolfSSL_DisableOCSPStapling(WOLFSSL*);
1819
1820 WOLFSSL_API int wolfSSL_CTX_EnableCRL(WOLFSSL_CTX* ctx, int options);
1821 WOLFSSL_API int wolfSSL_CTX_DisableCRL(WOLFSSL_CTX* ctx);
1822 WOLFSSL_API int wolfSSL_CTX_LoadCRL(WOLFSSL_CTX*, const char*, int, int);
1823 WOLFSSL_API int wolfSSL_CTX_LoadCRLBuffer(WOLFSSL_CTX*,
1824 const unsigned char*, long sz, int);
1825 WOLFSSL_API int wolfSSL_CTX_SetCRL_Cb(WOLFSSL_CTX*, CbMissingCRL);
1826#ifdef HAVE_CRL_IO
1827 WOLFSSL_API int wolfSSL_CTX_SetCRL_IOCb(WOLFSSL_CTX*, CbCrlIO);
1828#endif
1829
1830 WOLFSSL_API int wolfSSL_CTX_EnableOCSP(WOLFSSL_CTX*, int options);
1831 WOLFSSL_API int wolfSSL_CTX_DisableOCSP(WOLFSSL_CTX*);
1832 WOLFSSL_API int wolfSSL_CTX_SetOCSP_OverrideURL(WOLFSSL_CTX*, const char*);
1833 WOLFSSL_API int wolfSSL_CTX_SetOCSP_Cb(WOLFSSL_CTX*,
1834 CbOCSPIO, CbOCSPRespFree, void*);
1835 WOLFSSL_API int wolfSSL_CTX_EnableOCSPStapling(WOLFSSL_CTX*);
1836 WOLFSSL_API int wolfSSL_CTX_DisableOCSPStapling(WOLFSSL_CTX*);
1837#endif /* !NO_CERTS */
1838
1839
1840#ifdef SINGLE_THREADED
1841 WOLFSSL_API int wolfSSL_CTX_new_rng(WOLFSSL_CTX*);
1842#endif
1843
1844/* end of handshake frees temporary arrays, if user needs for get_keys or
1845 psk hints, call KeepArrays before handshake and then FreeArrays when done
1846 if don't want to wait for object free */
1847WOLFSSL_API void wolfSSL_KeepArrays(WOLFSSL*);
1848WOLFSSL_API void wolfSSL_FreeArrays(WOLFSSL*);
1849
1850WOLFSSL_API int wolfSSL_KeepHandshakeResources(WOLFSSL* ssl);
1851WOLFSSL_API int wolfSSL_FreeHandshakeResources(WOLFSSL* ssl);
1852
1853WOLFSSL_API int wolfSSL_CTX_UseClientSuites(WOLFSSL_CTX* ctx);
1854WOLFSSL_API int wolfSSL_UseClientSuites(WOLFSSL* ssl);
1855
1856/* async additions */
1857WOLFSSL_API int wolfSSL_UseAsync(WOLFSSL*, int devId);
1858WOLFSSL_API int wolfSSL_CTX_UseAsync(WOLFSSL_CTX*, int devId);
1859
1860/* helpers to get device id and heap */
1861WOLFSSL_API int wolfSSL_CTX_GetDevId(WOLFSSL_CTX* ctx, WOLFSSL* ssl);
1862WOLFSSL_API void* wolfSSL_CTX_GetHeap(WOLFSSL_CTX* ctx, WOLFSSL* ssl);
1863
1864/* TLS Extensions */
1865
1866/* Server Name Indication */
1867#ifdef HAVE_SNI
1868
1869/* SNI types */
1870enum {
1871 WOLFSSL_SNI_HOST_NAME = 0
1872};
1873
1874WOLFSSL_API int wolfSSL_UseSNI(WOLFSSL* ssl, unsigned char type,
1875 const void* data, unsigned short size);
1876WOLFSSL_API int wolfSSL_CTX_UseSNI(WOLFSSL_CTX* ctx, unsigned char type,
1877 const void* data, unsigned short size);
1878
1879#ifndef NO_WOLFSSL_SERVER
1880
1881/* SNI options */
1882enum {
1883 /* Do not abort the handshake if the requested SNI didn't match. */
1884 WOLFSSL_SNI_CONTINUE_ON_MISMATCH = 0x01,
1885
1886 /* Behave as if the requested SNI matched in a case of mismatch. */
1887 /* In this case, the status will be set to WOLFSSL_SNI_FAKE_MATCH. */
1888 WOLFSSL_SNI_ANSWER_ON_MISMATCH = 0x02,
1889
1890 /* Abort the handshake if the client didn't send a SNI request. */
1891 WOLFSSL_SNI_ABORT_ON_ABSENCE = 0x04,
1892};
1893
1894WOLFSSL_API void wolfSSL_SNI_SetOptions(WOLFSSL* ssl, unsigned char type,
1895 unsigned char options);
1896WOLFSSL_API void wolfSSL_CTX_SNI_SetOptions(WOLFSSL_CTX* ctx,
1897 unsigned char type, unsigned char options);
1898
1899/* SNI status */
1900enum {
1901 WOLFSSL_SNI_NO_MATCH = 0,
1902 WOLFSSL_SNI_FAKE_MATCH = 1, /**< @see WOLFSSL_SNI_ANSWER_ON_MISMATCH */
1903 WOLFSSL_SNI_REAL_MATCH = 2,
1904 WOLFSSL_SNI_FORCE_KEEP = 3 /** Used with -DWOLFSSL_ALWAYS_KEEP_SNI */
1905};
1906
1907WOLFSSL_API unsigned char wolfSSL_SNI_Status(WOLFSSL* ssl, unsigned char type);
1908
1909WOLFSSL_API unsigned short wolfSSL_SNI_GetRequest(WOLFSSL *ssl,
1910 unsigned char type, void** data);
1911WOLFSSL_API int wolfSSL_SNI_GetFromBuffer(
1912 const unsigned char* clientHello, unsigned int helloSz,
1913 unsigned char type, unsigned char* sni, unsigned int* inOutSz);
1914
1915#endif
1916#endif
1917
1918/* Application-Layer Protocol Negotiation */
1919#ifdef HAVE_ALPN
1920
1921/* ALPN status code */
1922enum {
1923 WOLFSSL_ALPN_NO_MATCH = 0,
1924 WOLFSSL_ALPN_MATCH = 1,
1925 WOLFSSL_ALPN_CONTINUE_ON_MISMATCH = 2,
1926 WOLFSSL_ALPN_FAILED_ON_MISMATCH = 4,
1927};
1928
1929enum {
1930 WOLFSSL_MAX_ALPN_PROTO_NAME_LEN = 255,
1931 WOLFSSL_MAX_ALPN_NUMBER = 257
1932};
1933
1934#if defined(WOLFSSL_NGINX) || defined(WOLFSSL_HAPROXY)
1935typedef int (*CallbackALPNSelect)(WOLFSSL* ssl, const unsigned char** out,
1936 unsigned char* outLen, const unsigned char* in, unsigned int inLen,
1937 void *arg);
1938#endif
1939
1940WOLFSSL_API int wolfSSL_UseALPN(WOLFSSL* ssl, char *protocol_name_list,
1941 unsigned int protocol_name_listSz,
1942 unsigned char options);
1943
1944WOLFSSL_API int wolfSSL_ALPN_GetProtocol(WOLFSSL* ssl, char **protocol_name,
1945 unsigned short *size);
1946
1947WOLFSSL_API int wolfSSL_ALPN_GetPeerProtocol(WOLFSSL* ssl, char **list,
1948 unsigned short *listSz);
1949WOLFSSL_API int wolfSSL_ALPN_FreePeerProtocol(WOLFSSL* ssl, char **list);
1950#endif /* HAVE_ALPN */
1951
1952/* Maximum Fragment Length */
1953#ifdef HAVE_MAX_FRAGMENT
1954
1955/* Fragment lengths */
1956enum {
1957 WOLFSSL_MFL_2_9 = 1, /* 512 bytes */
1958 WOLFSSL_MFL_2_10 = 2, /* 1024 bytes */
1959 WOLFSSL_MFL_2_11 = 3, /* 2048 bytes */
1960 WOLFSSL_MFL_2_12 = 4, /* 4096 bytes */
1961 WOLFSSL_MFL_2_13 = 5 /* 8192 bytes *//* wolfSSL ONLY!!! */
1962};
1963
1964#ifndef NO_WOLFSSL_CLIENT
1965
1966WOLFSSL_API int wolfSSL_UseMaxFragment(WOLFSSL* ssl, unsigned char mfl);
1967WOLFSSL_API int wolfSSL_CTX_UseMaxFragment(WOLFSSL_CTX* ctx, unsigned char mfl);
1968
1969#endif
1970#endif
1971
1972/* Truncated HMAC */
1973#ifdef HAVE_TRUNCATED_HMAC
1974#ifndef NO_WOLFSSL_CLIENT
1975
1976WOLFSSL_API int wolfSSL_UseTruncatedHMAC(WOLFSSL* ssl);
1977WOLFSSL_API int wolfSSL_CTX_UseTruncatedHMAC(WOLFSSL_CTX* ctx);
1978
1979#endif
1980#endif
1981
1982/* Certificate Status Request */
1983/* Certificate Status Type */
1984enum {
1985 WOLFSSL_CSR_OCSP = 1
1986};
1987
1988/* Certificate Status Options (flags) */
1989enum {
1990 WOLFSSL_CSR_OCSP_USE_NONCE = 0x01
1991};
1992
1993#ifdef HAVE_CERTIFICATE_STATUS_REQUEST
1994#ifndef NO_WOLFSSL_CLIENT
1995
1996WOLFSSL_API int wolfSSL_UseOCSPStapling(WOLFSSL* ssl,
1997 unsigned char status_type, unsigned char options);
1998
1999WOLFSSL_API int wolfSSL_CTX_UseOCSPStapling(WOLFSSL_CTX* ctx,
2000 unsigned char status_type, unsigned char options);
2001
2002#endif
2003#endif
2004
2005/* Certificate Status Request v2 */
2006/* Certificate Status Type */
2007enum {
2008 WOLFSSL_CSR2_OCSP = 1,
2009 WOLFSSL_CSR2_OCSP_MULTI = 2
2010};
2011
2012/* Certificate Status v2 Options (flags) */
2013enum {
2014 WOLFSSL_CSR2_OCSP_USE_NONCE = 0x01
2015};
2016
2017#ifdef HAVE_CERTIFICATE_STATUS_REQUEST_V2
2018#ifndef NO_WOLFSSL_CLIENT
2019
2020WOLFSSL_API int wolfSSL_UseOCSPStaplingV2(WOLFSSL* ssl,
2021 unsigned char status_type, unsigned char options);
2022
2023WOLFSSL_API int wolfSSL_CTX_UseOCSPStaplingV2(WOLFSSL_CTX* ctx,
2024 unsigned char status_type, unsigned char options);
2025
2026#endif
2027#endif
2028
2029/* Named Groups */
2030enum {
2031#if 0 /* Not Supported */
2032 WOLFSSL_ECC_SECT163K1 = 1,
2033 WOLFSSL_ECC_SECT163R1 = 2,
2034 WOLFSSL_ECC_SECT163R2 = 3,
2035 WOLFSSL_ECC_SECT193R1 = 4,
2036 WOLFSSL_ECC_SECT193R2 = 5,
2037 WOLFSSL_ECC_SECT233K1 = 6,
2038 WOLFSSL_ECC_SECT233R1 = 7,
2039 WOLFSSL_ECC_SECT239K1 = 8,
2040 WOLFSSL_ECC_SECT283K1 = 9,
2041 WOLFSSL_ECC_SECT283R1 = 10,
2042 WOLFSSL_ECC_SECT409K1 = 11,
2043 WOLFSSL_ECC_SECT409R1 = 12,
2044 WOLFSSL_ECC_SECT571K1 = 13,
2045 WOLFSSL_ECC_SECT571R1 = 14,
2046#endif
2047 WOLFSSL_ECC_SECP160K1 = 15,
2048 WOLFSSL_ECC_SECP160R1 = 16,
2049 WOLFSSL_ECC_SECP160R2 = 17,
2050 WOLFSSL_ECC_SECP192K1 = 18,
2051 WOLFSSL_ECC_SECP192R1 = 19,
2052 WOLFSSL_ECC_SECP224K1 = 20,
2053 WOLFSSL_ECC_SECP224R1 = 21,
2054 WOLFSSL_ECC_SECP256K1 = 22,
2055 WOLFSSL_ECC_SECP256R1 = 23,
2056 WOLFSSL_ECC_SECP384R1 = 24,
2057 WOLFSSL_ECC_SECP521R1 = 25,
2058 WOLFSSL_ECC_BRAINPOOLP256R1 = 26,
2059 WOLFSSL_ECC_BRAINPOOLP384R1 = 27,
2060 WOLFSSL_ECC_BRAINPOOLP512R1 = 28,
2061 WOLFSSL_ECC_X25519 = 29,
2062#ifdef WOLFSSL_TLS13
2063 /* Not implemented. */
2064 WOLFSSL_ECC_X448 = 30,
2065
2066 WOLFSSL_FFDHE_2048 = 256,
2067 WOLFSSL_FFDHE_3072 = 257,
2068 WOLFSSL_FFDHE_4096 = 258,
2069 WOLFSSL_FFDHE_6144 = 259,
2070 WOLFSSL_FFDHE_8192 = 260,
2071#endif
2072};
2073
2074enum {
2075 WOLFSSL_EC_PF_UNCOMPRESSED = 0,
2076#if 0 /* Not Supported */
2077 WOLFSSL_EC_PF_X962_COMP_PRIME = 1,
2078 WOLFSSL_EC_PF_X962_COMP_CHAR2 = 2,
2079#endif
2080};
2081
2082#ifdef HAVE_SUPPORTED_CURVES
2083#ifndef NO_WOLFSSL_CLIENT
2084
2085WOLFSSL_API int wolfSSL_UseSupportedCurve(WOLFSSL* ssl, unsigned short name);
2086WOLFSSL_API int wolfSSL_CTX_UseSupportedCurve(WOLFSSL_CTX* ctx,
2087 unsigned short name);
2088
2089#endif
2090#endif
2091
2092#ifdef WOLFSSL_TLS13
2093WOLFSSL_API int wolfSSL_UseKeyShare(WOLFSSL* ssl, unsigned short group);
2094WOLFSSL_API int wolfSSL_NoKeyShares(WOLFSSL* ssl);
2095#endif
2096
2097
2098/* Secure Renegotiation */
2099#ifdef HAVE_SECURE_RENEGOTIATION
2100
2101WOLFSSL_API int wolfSSL_UseSecureRenegotiation(WOLFSSL* ssl);
2102WOLFSSL_API int wolfSSL_Rehandshake(WOLFSSL* ssl);
2103
2104#endif
2105
2106/* Session Ticket */
2107#ifdef HAVE_SESSION_TICKET
2108
2109#ifndef NO_WOLFSSL_CLIENT
2110WOLFSSL_API int wolfSSL_UseSessionTicket(WOLFSSL* ssl);
2111WOLFSSL_API int wolfSSL_CTX_UseSessionTicket(WOLFSSL_CTX* ctx);
2112WOLFSSL_API int wolfSSL_get_SessionTicket(WOLFSSL*, unsigned char*, unsigned int*);
2113WOLFSSL_API int wolfSSL_set_SessionTicket(WOLFSSL*, const unsigned char*, unsigned int);
2114typedef int (*CallbackSessionTicket)(WOLFSSL*, const unsigned char*, int, void*);
2115WOLFSSL_API int wolfSSL_set_SessionTicket_cb(WOLFSSL*,
2116 CallbackSessionTicket, void*);
2117#endif /* NO_WOLFSSL_CLIENT */
2118
2119#ifndef NO_WOLFSSL_SERVER
2120
2121#define WOLFSSL_TICKET_NAME_SZ 16
2122#define WOLFSSL_TICKET_IV_SZ 16
2123#define WOLFSSL_TICKET_MAC_SZ 32
2124
2125enum TicketEncRet {
2126 WOLFSSL_TICKET_RET_FATAL = -1, /* fatal error, don't use ticket */
2127 WOLFSSL_TICKET_RET_OK = 0, /* ok, use ticket */
2128 WOLFSSL_TICKET_RET_REJECT, /* don't use ticket, but not fatal */
2129 WOLFSSL_TICKET_RET_CREATE /* existing ticket ok and create new one */
2130};
2131
2132typedef int (*SessionTicketEncCb)(WOLFSSL*,
2133 unsigned char key_name[WOLFSSL_TICKET_NAME_SZ],
2134 unsigned char iv[WOLFSSL_TICKET_IV_SZ],
2135 unsigned char mac[WOLFSSL_TICKET_MAC_SZ],
2136 int enc, unsigned char*, int, int*, void*);
2137WOLFSSL_API int wolfSSL_CTX_set_TicketEncCb(WOLFSSL_CTX* ctx,
2138 SessionTicketEncCb);
2139WOLFSSL_API int wolfSSL_CTX_set_TicketHint(WOLFSSL_CTX* ctx, int);
2140WOLFSSL_API int wolfSSL_CTX_set_TicketEncCtx(WOLFSSL_CTX* ctx, void*);
2141
2142#endif /* NO_WOLFSSL_SERVER */
2143
2144#endif /* HAVE_SESSION_TICKET */
2145
2146#ifdef HAVE_QSH
2147/* Quantum-safe Crypto Schemes */
2148enum {
2149 WOLFSSL_NTRU_EESS439 = 0x0101, /* max plaintext length of 65 */
2150 WOLFSSL_NTRU_EESS593 = 0x0102, /* max plaintext length of 86 */
2151 WOLFSSL_NTRU_EESS743 = 0x0103, /* max plaintext length of 106 */
2152 WOLFSSL_LWE_XXX = 0x0201, /* Learning With Error encryption scheme */
2153 WOLFSSL_HFE_XXX = 0x0301, /* Hidden Field Equation scheme */
2154 WOLFSSL_NULL_QSH = 0xFFFF /* QSHScheme is not used */
2155};
2156
2157
2158/* test if the connection is using a QSH secure connection return 1 if so */
2159WOLFSSL_API int wolfSSL_isQSH(WOLFSSL* ssl);
2160WOLFSSL_API int wolfSSL_UseSupportedQSH(WOLFSSL* ssl, unsigned short name);
2161#ifndef NO_WOLFSSL_CLIENT
2162 /* user control over sending client public key in hello
2163 when flag = 1 will send keys if flag is 0 or function is not called
2164 then will not send keys in the hello extension */
2165 WOLFSSL_API int wolfSSL_UseClientQSHKeys(WOLFSSL* ssl, unsigned char flag);
2166#endif
2167
2168#endif /* QSH */
2169
2170/* TLS Extended Master Secret Extension */
2171WOLFSSL_API int wolfSSL_DisableExtendedMasterSecret(WOLFSSL* ssl);
2172WOLFSSL_API int wolfSSL_CTX_DisableExtendedMasterSecret(WOLFSSL_CTX* ctx);
2173
2174
2175#define WOLFSSL_CRL_MONITOR 0x01 /* monitor this dir flag */
2176#define WOLFSSL_CRL_START_MON 0x02 /* start monitoring flag */
2177
2178
2179/* notify user the handshake is done */
2180typedef int (*HandShakeDoneCb)(WOLFSSL*, void*);
2181WOLFSSL_API int wolfSSL_SetHsDoneCb(WOLFSSL*, HandShakeDoneCb, void*);
2182
2183
2184WOLFSSL_API int wolfSSL_PrintSessionStats(void);
2185WOLFSSL_API int wolfSSL_get_session_stats(unsigned int* active,
2186 unsigned int* total,
2187 unsigned int* peak,
2188 unsigned int* maxSessions);
2189/* External facing KDF */
2190WOLFSSL_API
2191int wolfSSL_MakeTlsMasterSecret(unsigned char* ms, unsigned int msLen,
2192 const unsigned char* pms, unsigned int pmsLen,
2193 const unsigned char* cr, const unsigned char* sr,
2194 int tls1_2, int hash_type);
2195
2196WOLFSSL_API
2197int wolfSSL_MakeTlsExtendedMasterSecret(unsigned char* ms, unsigned int msLen,
2198 const unsigned char* pms, unsigned int pmsLen,
2199 const unsigned char* sHash, unsigned int sHashLen,
2200 int tls1_2, int hash_type);
2201
2202WOLFSSL_API
2203int wolfSSL_DeriveTlsKeys(unsigned char* key_data, unsigned int keyLen,
2204 const unsigned char* ms, unsigned int msLen,
2205 const unsigned char* sr, const unsigned char* cr,
2206 int tls1_2, int hash_type);
2207
2208#ifdef WOLFSSL_CALLBACKS
2209
2210/* used internally by wolfSSL while OpenSSL types aren't */
2211#include <wolfssl/callbacks.h>
2212
2213typedef int (*HandShakeCallBack)(HandShakeInfo*);
2214typedef int (*TimeoutCallBack)(TimeoutInfo*);
2215
2216/* wolfSSL connect extension allowing HandShakeCallBack and/or TimeoutCallBack
2217 for diagnostics */
2218WOLFSSL_API int wolfSSL_connect_ex(WOLFSSL*, HandShakeCallBack, TimeoutCallBack,
2219 Timeval);
2220WOLFSSL_API int wolfSSL_accept_ex(WOLFSSL*, HandShakeCallBack, TimeoutCallBack,
2221 Timeval);
2222
2223#endif /* WOLFSSL_CALLBACKS */
2224
2225
2226#ifdef WOLFSSL_HAVE_WOLFSCEP
2227 WOLFSSL_API void wolfSSL_wolfSCEP(void);
2228#endif /* WOLFSSL_HAVE_WOLFSCEP */
2229
2230#ifdef WOLFSSL_HAVE_CERT_SERVICE
2231 WOLFSSL_API void wolfSSL_cert_service(void);
2232#endif
2233
2234#if defined(WOLFSSL_MYSQL_COMPATIBLE) || defined(WOLFSSL_NGINX) || defined(WOLFSSL_HAPROXY)
2235WOLFSSL_API char* wolfSSL_ASN1_TIME_to_string(WOLFSSL_ASN1_TIME* time,
2236 char* buf, int len);
2237#endif /* WOLFSSL_MYSQL_COMPATIBLE */
2238
2239#ifdef OPENSSL_EXTRA
2240
2241#ifndef NO_FILESYSTEM
2242WOLFSSL_API long wolfSSL_BIO_set_fp(WOLFSSL_BIO *bio, XFILE fp, int c);
2243WOLFSSL_API long wolfSSL_BIO_get_fp(WOLFSSL_BIO *bio, XFILE* fp);
2244#endif
2245
2246WOLFSSL_API unsigned long wolfSSL_ERR_peek_last_error_line(const char **file, int *line);
2247WOLFSSL_API long wolfSSL_ctrl(WOLFSSL* ssl, int cmd, long opt, void* pt);
2248WOLFSSL_API long wolfSSL_CTX_ctrl(WOLFSSL_CTX* ctx, int cmd, long opt,void* pt);
2249
2250#ifndef NO_CERTS
2251WOLFSSL_API int wolfSSL_check_private_key(const WOLFSSL* ssl);
2252WOLFSSL_API void* wolfSSL_X509_get_ext_d2i(const WOLFSSL_X509* x509,
2253 int nid, int* c, int* idx);
2254WOLFSSL_API int wolfSSL_X509_digest(const WOLFSSL_X509* x509,
2255 const WOLFSSL_EVP_MD* digest, unsigned char* buf, unsigned int* len);
2256WOLFSSL_API int wolfSSL_use_certificate(WOLFSSL* ssl, WOLFSSL_X509* x509);
2257WOLFSSL_API int wolfSSL_use_certificate_ASN1(WOLFSSL* ssl, unsigned char* der,
2258 int derSz);
2259WOLFSSL_API int wolfSSL_use_PrivateKey(WOLFSSL* ssl, WOLFSSL_EVP_PKEY* pkey);
2260WOLFSSL_API int wolfSSL_use_PrivateKey_ASN1(int pri, WOLFSSL* ssl,
2261 unsigned char* der, long derSz);
2262WOLFSSL_API WOLFSSL_EVP_PKEY *wolfSSL_get_privatekey(const WOLFSSL *ssl);
2263#ifndef NO_RSA
2264WOLFSSL_API int wolfSSL_use_RSAPrivateKey_ASN1(WOLFSSL* ssl, unsigned char* der,
2265 long derSz);
2266#endif
2267#endif /* NO_CERTS */
2268
2269WOLFSSL_API WOLFSSL_DH *wolfSSL_DSA_dup_DH(const WOLFSSL_DSA *r);
2270
2271WOLFSSL_API int wolfSSL_SESSION_get_master_key(const WOLFSSL_SESSION* ses,
2272 unsigned char* out, int outSz);
2273WOLFSSL_API int wolfSSL_SESSION_get_master_key_length(const WOLFSSL_SESSION* ses);
2274
2275WOLFSSL_API void wolfSSL_CTX_set_cert_store(WOLFSSL_CTX* ctx,
2276 WOLFSSL_X509_STORE* str);
2277WOLFSSL_X509* wolfSSL_d2i_X509_bio(WOLFSSL_BIO* bio, WOLFSSL_X509** x509);
2278WOLFSSL_API WOLFSSL_X509_STORE* wolfSSL_CTX_get_cert_store(WOLFSSL_CTX* ctx);
2279
2280WOLFSSL_API size_t wolfSSL_BIO_ctrl_pending(WOLFSSL_BIO *b);
2281WOLFSSL_API size_t wolfSSL_get_server_random(const WOLFSSL *ssl,
2282 unsigned char *out, size_t outlen);
2283WOLFSSL_API size_t wolfSSL_get_client_random(const WOLFSSL* ssl,
2284 unsigned char* out, size_t outSz);
2285WOLFSSL_API pem_password_cb* wolfSSL_CTX_get_default_passwd_cb(WOLFSSL_CTX *ctx);
2286WOLFSSL_API void *wolfSSL_CTX_get_default_passwd_cb_userdata(WOLFSSL_CTX *ctx);
2287WOLFSSL_API int wolfSSL_CTX_use_PrivateKey(WOLFSSL_CTX *ctx, WOLFSSL_EVP_PKEY *pkey);
2288WOLFSSL_API WOLFSSL_X509 *wolfSSL_PEM_read_bio_X509(WOLFSSL_BIO *bp, WOLFSSL_X509 **x, pem_password_cb *cb, void *u);
2289WOLFSSL_API WOLFSSL_X509 *wolfSSL_PEM_read_bio_X509_AUX
2290 (WOLFSSL_BIO *bp, WOLFSSL_X509 **x, pem_password_cb *cb, void *u);
2291
2292/*lighttp compatibility */
2293
2294#include <wolfssl/openssl/asn1.h>
2295struct WOLFSSL_X509_NAME_ENTRY {
2296 WOLFSSL_ASN1_OBJECT* object; /* not defined yet */
2297 WOLFSSL_ASN1_STRING data;
2298 WOLFSSL_ASN1_STRING* value; /* points to data, for lighttpd port */
2299 int set;
2300 int size;
2301};
2302
2303#if defined(HAVE_LIGHTY) || defined(WOLFSSL_MYSQL_COMPATIBLE) \
2304 || defined(HAVE_STUNNEL) \
2305 || defined(WOLFSSL_NGINX) \
2306 || defined(WOLFSSL_HAPROXY) \
2307 || defined(OPENSSL_EXTRA)
2308WOLFSSL_API void wolfSSL_X509_NAME_free(WOLFSSL_X509_NAME *name);
2309WOLFSSL_API char wolfSSL_CTX_use_certificate(WOLFSSL_CTX *ctx, WOLFSSL_X509 *x);
2310WOLFSSL_API int wolfSSL_BIO_read_filename(WOLFSSL_BIO *b, const char *name);
2311/* These are to be merged shortly */
2312WOLFSSL_API const char * wolfSSL_OBJ_nid2sn(int n);
2313WOLFSSL_API int wolfSSL_OBJ_obj2nid(const WOLFSSL_ASN1_OBJECT *o);
2314WOLFSSL_API int wolfSSL_OBJ_sn2nid(const char *sn);
2315WOLFSSL_API void wolfSSL_CTX_set_verify_depth(WOLFSSL_CTX *ctx,int depth);
2316WOLFSSL_API void wolfSSL_set_verify_depth(WOLFSSL *ssl,int depth);
2317WOLFSSL_API void* wolfSSL_get_app_data( const WOLFSSL *ssl);
2318WOLFSSL_API int wolfSSL_set_app_data(WOLFSSL *ssl, void *arg);
2319WOLFSSL_API WOLFSSL_ASN1_OBJECT * wolfSSL_X509_NAME_ENTRY_get_object(WOLFSSL_X509_NAME_ENTRY *ne);
2320WOLFSSL_API WOLFSSL_X509_NAME_ENTRY *wolfSSL_X509_NAME_get_entry(WOLFSSL_X509_NAME *name, int loc);
2321WOLFSSL_API void wolfSSL_sk_X509_NAME_pop_free(WOLF_STACK_OF(WOLFSSL_X509_NAME)* sk, void f (WOLFSSL_X509_NAME*));
2322WOLFSSL_API unsigned char *wolfSSL_SHA1(const unsigned char *d, size_t n, unsigned char *md);
2323WOLFSSL_API int wolfSSL_X509_check_private_key(WOLFSSL_X509*, WOLFSSL_EVP_PKEY*);
2324WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509_NAME) *wolfSSL_dup_CA_list( WOLF_STACK_OF(WOLFSSL_X509_NAME) *sk );
2325
2326/* end lighttpd*/
2327#endif
2328#endif
2329
2330#if defined(HAVE_STUNNEL) || defined(HAVE_LIGHTY) \
2331 || defined(WOLFSSL_MYSQL_COMPATIBLE) \
2332 || defined(WOLFSSL_HAPROXY) \
2333 || defined(OPENSSL_EXTRA)
2334
2335WOLFSSL_API char* wolfSSL_OBJ_nid2ln(int n);
2336WOLFSSL_API int wolfSSL_OBJ_txt2nid(const char *sn);
2337WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new_file(const char *filename, const char *mode);
2338WOLFSSL_API long wolfSSL_CTX_set_tmp_dh(WOLFSSL_CTX*, WOLFSSL_DH*);
2339WOLFSSL_API WOLFSSL_DH *wolfSSL_PEM_read_bio_DHparams(WOLFSSL_BIO *bp,
2340 WOLFSSL_DH **x, pem_password_cb *cb, void *u);
2341WOLFSSL_API WOLFSSL_DSA *wolfSSL_PEM_read_bio_DSAparams(WOLFSSL_BIO *bp,
2342 WOLFSSL_DSA **x, pem_password_cb *cb, void *u);
2343WOLFSSL_API int wolfSSL_PEM_write_bio_X509(WOLFSSL_BIO *bp, WOLFSSL_X509 *x);
2344WOLFSSL_API long wolfSSL_CTX_get_options(WOLFSSL_CTX* ctx);
2345
2346
2347
2348#endif /* HAVE_STUNNEL || HAVE_LIGHTY */
2349
2350
2351#if defined(HAVE_STUNNEL) || defined(WOLFSSL_NGINX) || defined(WOLFSSL_HAPROXY)
2352
2353#include <wolfssl/openssl/crypto.h>
2354
2355/* SNI received callback type */
2356typedef int (*CallbackSniRecv)(WOLFSSL *ssl, int *ret, void* exArg);
2357
2358WOLFSSL_API int wolfSSL_CRYPTO_set_mem_ex_functions(void *(*m) (size_t, const char *, int),
2359 void *(*r) (void *, size_t, const char *, int), void (*f) (void *));
2360
2361WOLFSSL_API WOLFSSL_DH *wolfSSL_DH_generate_parameters(int prime_len, int generator,
2362 void (*callback) (int, int, void *), void *cb_arg);
2363
2364WOLFSSL_API int wolfSSL_DH_generate_parameters_ex(WOLFSSL_DH*, int, int,
2365 void (*callback) (int, int, void *));
2366
2367WOLFSSL_API void wolfSSL_ERR_load_crypto_strings(void);
2368
2369WOLFSSL_API unsigned long wolfSSL_ERR_peek_last_error(void);
2370
2371WOLFSSL_API int wolfSSL_FIPS_mode(void);
2372
2373WOLFSSL_API int wolfSSL_FIPS_mode_set(int r);
2374
2375WOLFSSL_API int wolfSSL_RAND_set_rand_method(const void *meth);
2376
2377WOLFSSL_API int wolfSSL_CIPHER_get_bits(const WOLFSSL_CIPHER *c, int *alg_bits);
2378
2379WOLFSSL_API int wolfSSL_sk_X509_NAME_num(const WOLF_STACK_OF(WOLFSSL_X509_NAME) *s);
2380
2381WOLFSSL_API int wolfSSL_sk_X509_num(const WOLF_STACK_OF(WOLFSSL_X509) *s);
2382
2383WOLFSSL_API int wolfSSL_X509_NAME_print_ex(WOLFSSL_BIO*,WOLFSSL_X509_NAME*,int,
2384 unsigned long);
2385
2386WOLFSSL_API WOLFSSL_ASN1_BIT_STRING* wolfSSL_X509_get0_pubkey_bitstr(
2387 const WOLFSSL_X509*);
2388
2389WOLFSSL_API int wolfSSL_CTX_add_session(WOLFSSL_CTX*, WOLFSSL_SESSION*);
2390
2391WOLFSSL_API WOLFSSL_CTX* wolfSSL_get_SSL_CTX(WOLFSSL* ssl);
2392
2393WOLFSSL_API int wolfSSL_version(WOLFSSL*);
2394
2395WOLFSSL_API int wolfSSL_get_state(const WOLFSSL*);
2396
2397WOLFSSL_API void* wolfSSL_sk_X509_NAME_value(const WOLF_STACK_OF(WOLFSSL_X509_NAME)*, int);
2398
2399WOLFSSL_API void* wolfSSL_sk_X509_value(WOLF_STACK_OF(WOLFSSL_X509)*, int);
2400
2401WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509)* wolfSSL_get_peer_cert_chain(const WOLFSSL*);
2402
2403WOLFSSL_API void* wolfSSL_SESSION_get_ex_data(const WOLFSSL_SESSION*, int);
2404
2405WOLFSSL_API int wolfSSL_SESSION_set_ex_data(WOLFSSL_SESSION*, int, void*);
2406
2407WOLFSSL_API int wolfSSL_SESSION_get_ex_new_index(long,void*,void*,void*,
2408 CRYPTO_free_func*);
2409
2410WOLFSSL_API int wolfSSL_X509_NAME_get_sz(WOLFSSL_X509_NAME*);
2411
2412
2413WOLFSSL_API const unsigned char* wolfSSL_SESSION_get_id(WOLFSSL_SESSION*,
2414 unsigned int*);
2415
2416WOLFSSL_API int wolfSSL_set_tlsext_host_name(WOLFSSL *, const char *);
2417
2418WOLFSSL_API const char* wolfSSL_get_servername(WOLFSSL *, unsigned char);
2419
2420WOLFSSL_API WOLFSSL_CTX* wolfSSL_set_SSL_CTX(WOLFSSL*,WOLFSSL_CTX*);
2421
2422WOLFSSL_API VerifyCallback wolfSSL_CTX_get_verify_callback(WOLFSSL_CTX*);
2423
2424WOLFSSL_API void wolfSSL_CTX_set_servername_callback(WOLFSSL_CTX *,
2425 CallbackSniRecv);
2426WOLFSSL_API int wolfSSL_CTX_set_tlsext_servername_callback(WOLFSSL_CTX *,
2427 CallbackSniRecv);
2428
2429WOLFSSL_API void wolfSSL_CTX_set_servername_arg(WOLFSSL_CTX *, void*);
2430
2431WOLFSSL_API void WOLFSSL_ERR_remove_thread_state(void*);
2432
2433#ifndef NO_FILESYSTEM
2434WOLFSSL_API void wolfSSL_print_all_errors_fp(XFILE *fp);
2435#endif
2436
2437WOLFSSL_API long wolfSSL_CTX_clear_options(WOLFSSL_CTX*, long);
2438
2439WOLFSSL_API void wolfSSL_THREADID_set_callback(void (*threadid_func)(void*));
2440
2441WOLFSSL_API void wolfSSL_THREADID_set_numeric(void* id, unsigned long val);
2442
2443WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509)* wolfSSL_X509_STORE_get1_certs(
2444 WOLFSSL_X509_STORE_CTX*, WOLFSSL_X509_NAME*);
2445
2446WOLFSSL_API void wolfSSL_sk_X509_pop_free(WOLF_STACK_OF(WOLFSSL_X509)* sk, void f (WOLFSSL_X509*));
2447#endif /* HAVE_STUNNEL || WOLFSSL_NGINX || WOLFSSL_HAPROXY */
2448
2449#if defined(HAVE_STUNNEL) || defined(WOLFSSL_MYSQL_COMPATIBLE) \
2450 || defined(WOLFSSL_NGINX) || defined(WOLFSSL_HAPROXY)
2451
2452WOLFSSL_API int wolfSSL_CTX_get_verify_mode(WOLFSSL_CTX* ctx);
2453
2454#endif
2455
2456#ifdef WOLFSSL_JNI
2457WOLFSSL_API int wolfSSL_set_jobject(WOLFSSL* ssl, void* objPtr);
2458WOLFSSL_API void* wolfSSL_get_jobject(WOLFSSL* ssl);
2459#endif /* WOLFSSL_JNI */
2460
2461
2462#ifdef WOLFSSL_ASYNC_CRYPT
2463WOLFSSL_API int wolfSSL_AsyncPoll(WOLFSSL* ssl, WOLF_EVENT_FLAG flags);
2464WOLFSSL_API int wolfSSL_CTX_AsyncPoll(WOLFSSL_CTX* ctx, WOLF_EVENT** events, int maxEvents,
2465 WOLF_EVENT_FLAG flags, int* eventCount);
2466#endif /* WOLFSSL_ASYNC_CRYPT */
2467
2468#ifdef OPENSSL_EXTRA
2469WOLFSSL_API int wolfSSL_CTX_set1_curves_list(WOLFSSL_CTX* ctx, char* names);
2470
2471typedef void (*SSL_Msg_Cb)(int write_p, int version, int content_type,
2472 const void *buf, size_t len, WOLFSSL *ssl, void *arg);
2473
2474WOLFSSL_API int wolfSSL_CTX_set_msg_callback(WOLFSSL_CTX *ctx, SSL_Msg_Cb cb);
2475WOLFSSL_API int wolfSSL_set_msg_callback(WOLFSSL *ssl, SSL_Msg_Cb cb);
2476WOLFSSL_API int wolfSSL_CTX_set_msg_callback_arg(WOLFSSL_CTX *ctx, void* arg);
2477WOLFSSL_API int wolfSSL_set_msg_callback_arg(WOLFSSL *ssl, void* arg);
2478#endif
2479
2480#ifdef OPENSSL_EXTRA
2481WOLFSSL_API unsigned long wolfSSL_ERR_peek_error_line_data(const char **file,
2482 int *line, const char **data, int *flags);
2483#endif
2484
2485#if defined WOLFSSL_NGINX || defined WOLFSSL_HAPROXY
2486/* Not an OpenSSL API. */
2487WOLFSSL_LOCAL int wolfSSL_get_ocsp_response(WOLFSSL* ssl, byte** response);
2488/* Not an OpenSSL API. */
2489WOLFSSL_LOCAL char* wolfSSL_get_ocsp_url(WOLFSSL* ssl);
2490/* Not an OpenSSL API. */
2491WOLFSSL_API int wolfSSL_set_ocsp_url(WOLFSSL* ssl, char* url);
2492
2493WOLFSSL_API WOLF_STACK_OF(WOLFSSL_CIPHER) *wolfSSL_get_ciphers_compat(const WOLFSSL *ssl);
2494WOLFSSL_API void wolfSSL_OPENSSL_config(char *config_name);
2495WOLFSSL_API int wolfSSL_X509_get_ex_new_index(int idx, void *arg, void *a,
2496 void *b, void *c);
2497WOLFSSL_API void *wolfSSL_X509_get_ex_data(WOLFSSL_X509 *x509, int idx);
2498WOLFSSL_API int wolfSSL_X509_set_ex_data(WOLFSSL_X509 *x509, int idx,
2499 void *data);
2500
2501WOLFSSL_API int wolfSSL_X509_NAME_digest(const WOLFSSL_X509_NAME *data,
2502 const WOLFSSL_EVP_MD *type, unsigned char *md, unsigned int *len);
2503
2504WOLFSSL_API long wolfSSL_SSL_CTX_get_timeout(const WOLFSSL_CTX *ctx);
2505WOLFSSL_API int wolfSSL_SSL_CTX_set_tmp_ecdh(WOLFSSL_CTX *ctx,
2506 WOLFSSL_EC_KEY *ecdh);
2507WOLFSSL_API int wolfSSL_SSL_CTX_remove_session(WOLFSSL_CTX *,
2508 WOLFSSL_SESSION *c);
2509
2510WOLFSSL_API WOLFSSL_BIO *wolfSSL_SSL_get_rbio(const WOLFSSL *s);
2511WOLFSSL_API WOLFSSL_BIO *wolfSSL_SSL_get_wbio(const WOLFSSL *s);
2512WOLFSSL_API int wolfSSL_SSL_do_handshake(WOLFSSL *s);
2513WOLFSSL_API int wolfSSL_SSL_in_init(WOLFSSL *a); /* #define in OpenSSL */
2514#ifndef NO_SESSION_CACHE
2515 WOLFSSL_API WOLFSSL_SESSION *wolfSSL_SSL_get0_session(const WOLFSSL *s);
2516#endif
2517WOLFSSL_API int wolfSSL_X509_check_host(WOLFSSL_X509 *x, const char *chk,
2518 size_t chklen, unsigned int flags, char **peername);
2519
2520WOLFSSL_API int wolfSSL_i2a_ASN1_INTEGER(WOLFSSL_BIO *bp,
2521 const WOLFSSL_ASN1_INTEGER *a);
2522
2523#ifdef HAVE_SESSION_TICKET
2524WOLFSSL_API int wolfSSL_CTX_set_tlsext_ticket_key_cb(WOLFSSL_CTX *, int (*)(
2525 WOLFSSL *ssl, unsigned char *name, unsigned char *iv,
2526 WOLFSSL_EVP_CIPHER_CTX *ectx, WOLFSSL_HMAC_CTX *hctx, int enc));
2527#endif
2528
2529#ifdef HAVE_OCSP
2530WOLFSSL_API int wolfSSL_CTX_get_extra_chain_certs(WOLFSSL_CTX* ctx,
2531 WOLF_STACK_OF(X509)** chain);
2532WOLFSSL_API int wolfSSL_CTX_set_tlsext_status_cb(WOLFSSL_CTX* ctx,
2533 int(*)(WOLFSSL*, void*));
2534
2535WOLFSSL_API int wolfSSL_X509_STORE_CTX_get1_issuer(WOLFSSL_X509 **issuer,
2536 WOLFSSL_X509_STORE_CTX *ctx, WOLFSSL_X509 *x);
2537
2538WOLFSSL_API void wolfSSL_X509_email_free(WOLF_STACK_OF(WOLFSSL_STRING) *sk);
2539WOLFSSL_API WOLF_STACK_OF(WOLFSSL_STRING) *wolfSSL_X509_get1_ocsp(WOLFSSL_X509 *x);
2540
2541WOLFSSL_API int wolfSSL_X509_check_issued(WOLFSSL_X509 *issuer,
2542 WOLFSSL_X509 *subject);
2543
2544WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_dup(WOLFSSL_X509 *x);
2545
2546WOLFSSL_API char* wolfSSL_sk_WOLFSSL_STRING_value(
2547 WOLF_STACK_OF(WOLFSSL_STRING)* strings, int idx);
2548#endif /* HAVE_OCSP */
2549
2550WOLFSSL_API int PEM_write_bio_WOLFSSL_X509(WOLFSSL_BIO *bio,
2551 WOLFSSL_X509 *cert);
2552
2553#endif /* WOLFSSL_NGINX */
2554
2555WOLFSSL_API void wolfSSL_get0_alpn_selected(const WOLFSSL *ssl,
2556 const unsigned char **data, unsigned int *len);
2557WOLFSSL_API int wolfSSL_select_next_proto(unsigned char **out,
2558 unsigned char *outlen,
2559 const unsigned char *in, unsigned int inlen,
2560 const unsigned char *client,
2561 unsigned int client_len);
2562WOLFSSL_API void wolfSSL_CTX_set_alpn_select_cb(WOLFSSL_CTX *ctx,
2563 int (*cb) (WOLFSSL *ssl,
2564 const unsigned char **out,
2565 unsigned char *outlen,
2566 const unsigned char *in,
2567 unsigned int inlen,
2568 void *arg), void *arg);
2569WOLFSSL_API void wolfSSL_CTX_set_next_protos_advertised_cb(WOLFSSL_CTX *s,
2570 int (*cb) (WOLFSSL *ssl,
2571 const unsigned char **out,
2572 unsigned int *outlen,
2573 void *arg), void *arg);
2574WOLFSSL_API void wolfSSL_CTX_set_next_proto_select_cb(WOLFSSL_CTX *s,
2575 int (*cb) (WOLFSSL *ssl,
2576 unsigned char **out,
2577 unsigned char *outlen,
2578 const unsigned char *in,
2579 unsigned int inlen,
2580 void *arg), void *arg);
2581WOLFSSL_API void wolfSSL_get0_next_proto_negotiated(const WOLFSSL *s, const unsigned char **data,
2582 unsigned *len);
2583
2584
2585#ifdef OPENSSL_EXTRA
2586#if defined(WOLFSSL_NGINX) || defined(WOLFSSL_HAPROXY)
2587WOLFSSL_API const unsigned char *SSL_SESSION_get0_id_context(
2588 const WOLFSSL_SESSION *sess, unsigned int *sid_ctx_length);
2589WOLFSSL_API size_t SSL_get_finished(const WOLFSSL *s, void *buf, size_t count);
2590WOLFSSL_API size_t SSL_get_peer_finished(const WOLFSSL *s, void *buf, size_t count);
2591#endif
2592
2593WOLFSSL_API int SSL_SESSION_set1_id(WOLFSSL_SESSION *s, const unsigned char *sid, unsigned int sid_len);
2594WOLFSSL_API int SSL_SESSION_set1_id_context(WOLFSSL_SESSION *s, const unsigned char *sid_ctx, unsigned int sid_ctx_len);
2595WOLFSSL_API void *X509_get0_tbs_sigalg(const WOLFSSL_X509 *x);
2596WOLFSSL_API void X509_ALGOR_get0(WOLFSSL_ASN1_OBJECT **paobj, int *pptype, const void **ppval, const void *algor);
2597WOLFSSL_API void *X509_get_X509_PUBKEY(void * x);
2598WOLFSSL_API int X509_PUBKEY_get0_param(WOLFSSL_ASN1_OBJECT **ppkalg, const unsigned char **pk, int *ppklen, void **pa, WOLFSSL_EVP_PKEY *pub);
2599WOLFSSL_API int EVP_PKEY_bits(WOLFSSL_EVP_PKEY *pkey);
2600WOLFSSL_API int i2d_X509(WOLFSSL_X509 *x, unsigned char **out);
2601WOLFSSL_API int i2t_ASN1_OBJECT(char *buf, int buf_len, WOLFSSL_ASN1_OBJECT *a);
2602WOLFSSL_API void SSL_CTX_set_tmp_dh_callback(WOLFSSL_CTX *ctx, WOLFSSL_DH *(*dh) (WOLFSSL *ssl, int is_export, int keylength));
2603WOLFSSL_API WOLF_STACK_OF(SSL_COMP) *SSL_COMP_get_compression_methods(void);
2604WOLFSSL_API int X509_STORE_load_locations(WOLFSSL_X509_STORE *ctx, const char *file, const char *dir);
2605WOLFSSL_API int wolfSSL_sk_SSL_CIPHER_num(const void * p);
2606WOLFSSL_API int wolfSSL_sk_SSL_COMP_zero(WOLFSSL_STACK* st);
2607WOLFSSL_API WOLFSSL_CIPHER* wolfSSL_sk_SSL_CIPHER_value(void *ciphers, int idx);
2608WOLFSSL_API void ERR_load_SSL_strings(void);
2609#endif /* OPENSSL_EXTRA */
2610
2611#ifdef __cplusplus
2612 } /* extern "C" */
2613#endif
2614
2615
2616#endif /* WOLFSSL_SSL_H */
Note: See TracBrowser for help on using the repository browser.