blob: 2d7faf5909f67e5748e1327caf4f632a8c7c9c24 [file] [log] [blame]
lh9ed821d2023-04-07 01:36:19 -07001/* ssl.h
2 *
3 * Copyright (C) 2006-2021 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 \file ../wolfssl/ssl.h
23 \brief Header file containing key wolfSSL API
24*/
25
26/* wolfSSL API */
27
28#ifndef WOLFSSL_SSL_H
29#define WOLFSSL_SSL_H
30
31
32/* for users not using preprocessor flags*/
33#include <wolfssl/wolfcrypt/settings.h>
34#include <wolfssl/version.h>
35#include <wolfssl/wolfcrypt/logging.h>
36#include <wolfssl/wolfcrypt/asn_public.h>
37#include <wolfssl/wolfcrypt/types.h>
38
39#ifdef HAVE_WOLF_EVENT
40 #include <wolfssl/wolfcrypt/wolfevent.h>
41#endif
42
43 #ifdef WOLF_CRYPTO_CB
44 #include <wolfssl/wolfcrypt/cryptocb.h>
45#endif
46
47/* used internally by wolfSSL while OpenSSL types aren't */
48#include <wolfssl/callbacks.h>
49
50#ifdef WOLFSSL_PREFIX
51 #include "prefix_ssl.h"
52#endif
53
54#ifdef LIBWOLFSSL_VERSION_STRING
55 #define WOLFSSL_VERSION LIBWOLFSSL_VERSION_STRING
56#endif
57
58#ifdef _WIN32
59 /* wincrypt.h clashes */
60 #undef OCSP_REQUEST
61 #undef OCSP_RESPONSE
62#endif
63
64#ifdef OPENSSL_COEXIST
65 /* mode to allow wolfSSL and OpenSSL to exist together */
66 #ifdef TEST_OPENSSL_COEXIST
67 /*
68 ./configure --enable-opensslcoexist \
69 CFLAGS="-I/usr/local/opt/openssl/include -DTEST_OPENSSL_COEXIST" \
70 LDFLAGS="-L/usr/local/opt/openssl/lib -lcrypto"
71 */
72 #include <openssl/ssl.h>
73 #include <openssl/rand.h>
74 #include <openssl/err.h>
75 #include <openssl/ec.h>
76 #include <openssl/hmac.h>
77 #include <openssl/bn.h>
78 #endif
79
80 /* make sure old names are disabled */
81 #ifndef NO_OLD_SSL_NAMES
82 #define NO_OLD_SSL_NAMES
83 #endif
84 #ifndef NO_OLD_WC_NAMES
85 #define NO_OLD_WC_NAMES
86 #endif
87
88#elif (defined(OPENSSL_EXTRA) || defined(OPENSSL_EXTRA_X509_SMALL))
89 #include <wolfssl/openssl/bn.h>
90 #include <wolfssl/openssl/hmac.h>
91
92 /* We need the old SSL names */
93 #ifdef NO_OLD_SSL_NAMES
94 #undef NO_OLD_SSL_NAMES
95 #endif
96 #ifdef NO_OLD_WC_NAMES
97 #undef NO_OLD_WC_NAMES
98 #endif
99#endif
100
101#ifdef __cplusplus
102 extern "C" {
103#endif
104
105/* LHASH is implemented as a stack */
106typedef struct WOLFSSL_STACK WOLFSSL_LHASH;
107#ifndef WOLF_LHASH_OF
108 #define WOLF_LHASH_OF(x) WOLFSSL_LHASH
109#endif
110
111#ifndef WOLF_STACK_OF
112 #define WOLF_STACK_OF(x) WOLFSSL_STACK
113#endif
114#ifndef DECLARE_STACK_OF
115 #define DECLARE_STACK_OF(x) WOLF_STACK_OF(x);
116#endif
117
118#ifndef WOLFSSL_WOLFSSL_TYPE_DEFINED
119#define WOLFSSL_WOLFSSL_TYPE_DEFINED
120typedef struct WOLFSSL WOLFSSL;
121#endif
122typedef struct WOLFSSL_SESSION WOLFSSL_SESSION;
123typedef struct WOLFSSL_METHOD WOLFSSL_METHOD;
124#ifndef WOLFSSL_WOLFSSL_CTX_TYPE_DEFINED
125#define WOLFSSL_WOLFSSL_CTX_TYPE_DEFINED
126typedef struct WOLFSSL_CTX WOLFSSL_CTX;
127#endif
128
129typedef struct WOLFSSL_STACK WOLFSSL_STACK;
130typedef struct WOLFSSL_X509 WOLFSSL_X509;
131typedef struct WOLFSSL_X509_NAME WOLFSSL_X509_NAME;
132typedef struct WOLFSSL_X509_NAME_ENTRY WOLFSSL_X509_NAME_ENTRY;
133typedef struct WOLFSSL_X509_PUBKEY WOLFSSL_X509_PUBKEY;
134typedef struct WOLFSSL_X509_ALGOR WOLFSSL_X509_ALGOR;
135typedef struct WOLFSSL_X509_CHAIN WOLFSSL_X509_CHAIN;
136typedef struct WC_PKCS12 WOLFSSL_X509_PKCS12;
137typedef struct WOLFSSL_X509_INFO WOLFSSL_X509_INFO;
138
139typedef struct WOLFSSL_CERT_MANAGER WOLFSSL_CERT_MANAGER;
140typedef struct WOLFSSL_SOCKADDR WOLFSSL_SOCKADDR;
141typedef struct WOLFSSL_CRL WOLFSSL_CRL;
142typedef struct WOLFSSL_X509_STORE_CTX WOLFSSL_X509_STORE_CTX;
143
144typedef int (*WOLFSSL_X509_STORE_CTX_verify_cb)(int, WOLFSSL_X509_STORE_CTX *);
145
146typedef struct WOLFSSL_BY_DIR_HASH WOLFSSL_BY_DIR_HASH;
147typedef struct WOLFSSL_BY_DIR_entry WOLFSSL_BY_DIR_entry;
148typedef struct WOLFSSL_BY_DIR WOLFSSL_BY_DIR;
149
150/* redeclare guard */
151#define WOLFSSL_TYPES_DEFINED
152
153#include <wolfssl/wolfio.h>
154
155
156#ifndef WOLFSSL_RSA_TYPE_DEFINED /* guard on redeclaration */
157typedef struct WOLFSSL_RSA WOLFSSL_RSA;
158#define WOLFSSL_RSA_TYPE_DEFINED
159#endif
160
161#ifndef WC_RNG_TYPE_DEFINED /* guard on redeclaration */
162 typedef struct WC_RNG WC_RNG;
163 #define WC_RNG_TYPE_DEFINED
164#endif
165
166#ifndef WOLFSSL_DSA_TYPE_DEFINED /* guard on redeclaration */
167typedef struct WOLFSSL_DSA WOLFSSL_DSA;
168#define WOLFSSL_DSA_TYPE_DEFINED
169#endif
170
171#ifndef WOLFSSL_EC_TYPE_DEFINED /* guard on redeclaration */
172typedef struct WOLFSSL_EC_KEY WOLFSSL_EC_KEY;
173typedef struct WOLFSSL_EC_POINT WOLFSSL_EC_POINT;
174typedef struct WOLFSSL_EC_GROUP WOLFSSL_EC_GROUP;
175typedef struct WOLFSSL_EC_BUILTIN_CURVE WOLFSSL_EC_BUILTIN_CURVE;
176/* WOLFSSL_EC_METHOD is just an alias of WOLFSSL_EC_GROUP for now */
177typedef struct WOLFSSL_EC_GROUP WOLFSSL_EC_METHOD;
178#define WOLFSSL_EC_TYPE_DEFINED
179#endif
180
181#ifndef WOLFSSL_ECDSA_TYPE_DEFINED /* guard on redeclaration */
182typedef struct WOLFSSL_ECDSA_SIG WOLFSSL_ECDSA_SIG;
183#define WOLFSSL_ECDSA_TYPE_DEFINED
184#endif
185
186typedef struct WOLFSSL_CIPHER WOLFSSL_CIPHER;
187typedef struct WOLFSSL_X509_LOOKUP WOLFSSL_X509_LOOKUP;
188typedef struct WOLFSSL_X509_LOOKUP_METHOD WOLFSSL_X509_LOOKUP_METHOD;
189typedef struct WOLFSSL_CRL WOLFSSL_X509_CRL;
190typedef struct WOLFSSL_X509_STORE WOLFSSL_X509_STORE;
191typedef struct WOLFSSL_X509_VERIFY_PARAM WOLFSSL_X509_VERIFY_PARAM;
192typedef struct WOLFSSL_BIO WOLFSSL_BIO;
193typedef struct WOLFSSL_BIO_METHOD WOLFSSL_BIO_METHOD;
194typedef struct WOLFSSL_X509_EXTENSION WOLFSSL_X509_EXTENSION;
195typedef struct WOLFSSL_ASN1_OBJECT WOLFSSL_ASN1_OBJECT;
196typedef struct WOLFSSL_ASN1_OTHERNAME WOLFSSL_ASN1_OTHERNAME;
197typedef struct WOLFSSL_X509V3_CTX WOLFSSL_X509V3_CTX;
198typedef struct WOLFSSL_v3_ext_method WOLFSSL_v3_ext_method;
199
200typedef struct WOLFSSL_ASN1_STRING WOLFSSL_ASN1_STRING;
201typedef struct WOLFSSL_dynlock_value WOLFSSL_dynlock_value;
202#ifndef WOLFSSL_DH_TYPE_DEFINED /* guard on redeclaration */
203typedef struct WOLFSSL_DH WOLFSSL_DH;
204#define WOLFSSL_DH_TYPE_DEFINED /* guard on redeclaration */
205#endif
206typedef struct WOLFSSL_ASN1_BIT_STRING WOLFSSL_ASN1_BIT_STRING;
207typedef struct WOLFSSL_ASN1_TYPE WOLFSSL_ASN1_TYPE;
208typedef struct WOLFSSL_X509_ATTRIBUTE WOLFSSL_X509_ATTRIBUTE;
209
210typedef struct WOLFSSL_GENERAL_NAME WOLFSSL_GENERAL_NAME;
211typedef struct WOLFSSL_AUTHORITY_KEYID WOLFSSL_AUTHORITY_KEYID;
212typedef struct WOLFSSL_BASIC_CONSTRAINTS WOLFSSL_BASIC_CONSTRAINTS;
213typedef struct WOLFSSL_ACCESS_DESCRIPTION WOLFSSL_ACCESS_DESCRIPTION;
214
215typedef struct WOLFSSL_CONF_CTX WOLFSSL_CONF_CTX;
216
217#if defined(OPENSSL_ALL) || defined(OPENSSL_EXTRA) || defined(WOLFSSL_WPAS_SMALL)
218
219struct WOLFSSL_AUTHORITY_KEYID {
220 WOLFSSL_ASN1_STRING *keyid;
221 WOLFSSL_ASN1_OBJECT *issuer;
222 WOLFSSL_ASN1_INTEGER *serial;
223};
224
225struct WOLFSSL_BASIC_CONSTRAINTS {
226 int ca;
227 WOLFSSL_ASN1_INTEGER *pathlen;
228};
229
230#endif /* OPENSSL_ALL || OPENSSL_EXTRA*/
231
232#define WOLFSSL_ASN1_UTCTIME WOLFSSL_ASN1_TIME
233#define WOLFSSL_ASN1_GENERALIZEDTIME WOLFSSL_ASN1_TIME
234
235struct WOLFSSL_ASN1_STRING {
236 char strData[CTC_NAME_SIZE];
237 int length;
238 int type; /* type of string i.e. CTC_UTF8 */
239 char* data;
240 long flags;
241 unsigned int isDynamic:1; /* flag for if data pointer dynamic (1 is yes 0 is no) */
242};
243
244#define WOLFSSL_MAX_SNAME 40
245
246
247#define WOLFSSL_ASN1_DYNAMIC 0x1
248#define WOLFSSL_ASN1_DYNAMIC_DATA 0x2
249
250struct WOLFSSL_ASN1_OTHERNAME {
251 WOLFSSL_ASN1_OBJECT* type_id;
252 WOLFSSL_ASN1_TYPE* value;
253};
254
255struct WOLFSSL_GENERAL_NAME {
256 int type;
257 union {
258 char* ptr;
259 WOLFSSL_ASN1_OTHERNAME* otherName;
260 WOLFSSL_ASN1_STRING* rfc822Name;
261 WOLFSSL_ASN1_STRING* dNSName;
262 WOLFSSL_ASN1_TYPE* x400Address;
263 WOLFSSL_X509_NAME* directoryName;
264 WOLFSSL_ASN1_STRING* uniformResourceIdentifier;
265 WOLFSSL_ASN1_STRING* iPAddress;
266 WOLFSSL_ASN1_OBJECT* registeredID;
267
268 WOLFSSL_ASN1_STRING* ip;
269 WOLFSSL_X509_NAME* dirn;
270 WOLFSSL_ASN1_STRING* ia5;
271 WOLFSSL_ASN1_OBJECT* rid;
272 WOLFSSL_ASN1_TYPE* other;
273 } d; /* dereference */
274};
275
276struct WOLFSSL_ACCESS_DESCRIPTION {
277 WOLFSSL_ASN1_OBJECT* method;
278 WOLFSSL_GENERAL_NAME* location;
279};
280
281struct WOLFSSL_X509V3_CTX {
282 WOLFSSL_X509* x509;
283};
284
285struct WOLFSSL_ASN1_OBJECT {
286 void* heap;
287 const unsigned char* obj;
288 /* sName is short name i.e sha256 rather than oid (null terminated) */
289 char sName[WOLFSSL_MAX_SNAME];
290 int type; /* oid */
291 int grp; /* type of OID, i.e. oidCertPolicyType */
292 int nid;
293 unsigned int objSz;
294#if defined(OPENSSL_ALL) || defined(WOLFSSL_QT) || defined(WOLFSSL_APACHE_HTTPD)
295 int ca;
296 WOLFSSL_ASN1_INTEGER *pathlen;
297#endif
298 unsigned char dynamic; /* Use WOLFSSL_ASN1_DYNAMIC and WOLFSSL_ASN1_DYNAMIC_DATA
299 * to determine what needs to be freed. */
300
301#if defined(WOLFSSL_APACHE_HTTPD)
302 WOLFSSL_GENERAL_NAME* gn;
303#endif
304
305 struct d { /* derefrenced */
306 WOLFSSL_ASN1_STRING* dNSName;
307 WOLFSSL_ASN1_STRING ia5_internal;
308 WOLFSSL_ASN1_STRING* ia5; /* points to ia5_internal */
309#if defined(WOLFSSL_QT) || defined(OPENSSL_ALL)
310 WOLFSSL_ASN1_STRING* uniformResourceIdentifier;
311 WOLFSSL_ASN1_STRING iPAddress_internal;
312 WOLFSSL_ASN1_OTHERNAME* otherName; /* added for Apache httpd */
313#endif
314 WOLFSSL_ASN1_STRING* iPAddress; /* points to iPAddress_internal */
315 } d;
316};
317
318/* wrap ASN1 types */
319struct WOLFSSL_ASN1_TYPE {
320 int type;
321 union {
322 char *ptr;
323 WOLFSSL_ASN1_STRING* asn1_string;
324 WOLFSSL_ASN1_OBJECT* object;
325 WOLFSSL_ASN1_INTEGER* integer;
326 WOLFSSL_ASN1_BIT_STRING* bit_string;
327 WOLFSSL_ASN1_STRING* octet_string;
328 WOLFSSL_ASN1_STRING* printablestring;
329 WOLFSSL_ASN1_STRING* ia5string;
330 WOLFSSL_ASN1_UTCTIME* utctime;
331 WOLFSSL_ASN1_GENERALIZEDTIME* generalizedtime;
332 WOLFSSL_ASN1_STRING* utf8string;
333 WOLFSSL_ASN1_STRING* set;
334 WOLFSSL_ASN1_STRING* sequence;
335 } value;
336};
337
338struct WOLFSSL_X509_ATTRIBUTE {
339 WOLFSSL_ASN1_OBJECT *object;
340 WOLFSSL_ASN1_TYPE *value;
341 WOLF_STACK_OF(WOLFSSL_ASN1_TYPE) *set;
342};
343
344struct WOLFSSL_EVP_PKEY {
345 void* heap;
346 int type; /* openssh dereference */
347 int save_type; /* openssh dereference */
348 int pkey_sz;
349 int references; /*number of times free should be called for complete free*/
350 wolfSSL_Mutex refMutex; /* ref count mutex */
351
352 union {
353 char* ptr; /* der format of key / or raw for NTRU */
354 } pkey;
355 #if (defined(OPENSSL_EXTRA) || defined(OPENSSL_EXTRA_X509_SMALL))
356 #ifndef NO_RSA
357 WOLFSSL_RSA* rsa;
358 byte ownRsa; /* if struct owns RSA and should free it */
359 #endif
360 #ifndef NO_DSA
361 WOLFSSL_DSA* dsa;
362 byte ownDsa; /* if struct owns DSA and should free it */
363 #endif
364 #ifdef HAVE_ECC
365 WOLFSSL_EC_KEY* ecc;
366 byte ownEcc; /* if struct owns ECC and should free it */
367 #endif
368 #ifndef NO_DH
369 WOLFSSL_DH* dh;
370 byte ownDh; /* if struct owns DH and should free it */
371 #endif
372 WC_RNG rng;
373 #endif /* OPENSSL_EXTRA || OPENSSL_EXTRA_X509_SMALL */
374 #ifdef HAVE_ECC
375 int pkey_curve;
376 #endif
377};
378typedef struct WOLFSSL_EVP_PKEY WOLFSSL_PKCS8_PRIV_KEY_INFO;
379#ifndef WOLFSSL_EVP_TYPE_DEFINED /* guard on redeclaration */
380typedef struct WOLFSSL_EVP_PKEY WOLFSSL_EVP_PKEY;
381typedef struct WOLFSSL_EVP_MD_CTX WOLFSSL_EVP_MD_CTX;
382typedef char WOLFSSL_EVP_MD;
383#define WOLFSSL_EVP_TYPE_DEFINED
384#endif
385
386struct WOLFSSL_X509_PKEY {
387 WOLFSSL_EVP_PKEY* dec_pkey; /* dereferenced by Apache */
388 void* heap;
389};
390typedef struct WOLFSSL_X509_PKEY WOLFSSL_X509_PKEY;
391
392struct WOLFSSL_X509_INFO {
393 WOLFSSL_X509 *x509;
394 WOLFSSL_X509_CRL *crl;
395 WOLFSSL_X509_PKEY *x_pkey; /* dereferenced by Apache */
396 EncryptedInfo enc_cipher;
397 int enc_len;
398 char *enc_data;
399 int num;
400};
401
402#define WOLFSSL_EVP_PKEY_DEFAULT EVP_PKEY_RSA /* default key type */
403
404#if defined(OPENSSL_ALL) || defined(WOLFSSL_QT)
405 #define wolfSSL_SSL_MODE_RELEASE_BUFFERS 0x00000010U
406 #define wolfSSL_SSL_CTRL_SET_TMP_ECDH 4
407#endif
408
409struct WOLFSSL_X509_ALGOR {
410 WOLFSSL_ASN1_OBJECT* algorithm;
411 WOLFSSL_ASN1_TYPE* parameter;
412};
413
414struct WOLFSSL_X509_PUBKEY {
415 WOLFSSL_X509_ALGOR* algor;
416 WOLFSSL_EVP_PKEY* pkey;
417 int pubKeyOID;
418};
419
420
421enum BIO_TYPE {
422 WOLFSSL_BIO_BUFFER = 1,
423 WOLFSSL_BIO_SOCKET = 2,
424 WOLFSSL_BIO_SSL = 3,
425 WOLFSSL_BIO_MEMORY = 4,
426 WOLFSSL_BIO_BIO = 5,
427 WOLFSSL_BIO_FILE = 6,
428 WOLFSSL_BIO_BASE64 = 7,
429 WOLFSSL_BIO_MD = 8
430};
431
432enum BIO_FLAGS {
433 WOLFSSL_BIO_FLAG_BASE64_NO_NL = 0x01,
434 WOLFSSL_BIO_FLAG_READ = 0x02,
435 WOLFSSL_BIO_FLAG_WRITE = 0x04,
436 WOLFSSL_BIO_FLAG_IO_SPECIAL = 0x08,
437 WOLFSSL_BIO_FLAG_RETRY = 0x10
438};
439
440enum BIO_CB_OPS {
441 WOLFSSL_BIO_CB_FREE = 0x01,
442 WOLFSSL_BIO_CB_READ = 0x02,
443 WOLFSSL_BIO_CB_WRITE = 0x03,
444 WOLFSSL_BIO_CB_PUTS = 0x04,
445 WOLFSSL_BIO_CB_GETS = 0x05,
446 WOLFSSL_BIO_CB_CTRL = 0x06,
447 WOLFSSL_BIO_CB_RETURN = 0x80
448};
449
450typedef struct WOLFSSL_BUF_MEM {
451 char* data; /* dereferenced */
452 size_t length; /* current length */
453 size_t max; /* maximum length */
454} WOLFSSL_BUF_MEM;
455
456/* custom method with user set callbacks */
457typedef int (*wolfSSL_BIO_meth_write_cb)(WOLFSSL_BIO*, const char*, int);
458typedef int (*wolfSSL_BIO_meth_read_cb)(WOLFSSL_BIO *, char *, int);
459typedef int (*wolfSSL_BIO_meth_puts_cb)(WOLFSSL_BIO*, const char*);
460typedef int (*wolfSSL_BIO_meth_gets_cb)(WOLFSSL_BIO*, char*, int);
461typedef long (*wolfSSL_BIO_meth_ctrl_get_cb)(WOLFSSL_BIO*, int, long, void*);
462typedef int (*wolfSSL_BIO_meth_create_cb)(WOLFSSL_BIO*);
463typedef int (*wolfSSL_BIO_meth_destroy_cb)(WOLFSSL_BIO*);
464
465typedef int wolfSSL_BIO_info_cb(WOLFSSL_BIO *, int, int);
466typedef long (*wolfssl_BIO_meth_ctrl_info_cb)(WOLFSSL_BIO*, int, wolfSSL_BIO_info_cb*);
467
468/* wolfSSL BIO_METHOD type */
469#ifndef MAX_BIO_METHOD_NAME
470#define MAX_BIO_METHOD_NAME 256
471#endif
472struct WOLFSSL_BIO_METHOD {
473 byte type; /* method type */
474 char name[MAX_BIO_METHOD_NAME];
475 wolfSSL_BIO_meth_write_cb writeCb;
476 wolfSSL_BIO_meth_read_cb readCb;
477 wolfSSL_BIO_meth_puts_cb putsCb;
478 wolfSSL_BIO_meth_gets_cb getsCb;
479 wolfSSL_BIO_meth_ctrl_get_cb ctrlCb;
480 wolfSSL_BIO_meth_create_cb createCb;
481 wolfSSL_BIO_meth_destroy_cb freeCb;
482 wolfssl_BIO_meth_ctrl_info_cb ctrlInfoCb;
483};
484
485/* wolfSSL BIO type */
486typedef long (*wolf_bio_info_cb)(WOLFSSL_BIO *bio, int event, const char *parg,
487 int iarg, long larg, long return_value);
488
489struct WOLFSSL_BIO {
490 WOLFSSL_BUF_MEM* mem_buf;
491 WOLFSSL_BIO_METHOD* method;
492 WOLFSSL_BIO* prev; /* previous in chain */
493 WOLFSSL_BIO* next; /* next in chain */
494 WOLFSSL_BIO* pair; /* BIO paired with */
495 void* heap; /* user heap hint */
496 void* ptr; /* WOLFSSL, file descriptor, MD, or mem buf */
497 void* usrCtx; /* user set pointer */
498 const char* ip; /* IP address for wolfIO_TcpConnect */
499 word16 port; /* Port for wolfIO_TcpConnect */
500 char* infoArg; /* BIO callback argument */
501 wolf_bio_info_cb infoCb; /* BIO callback */
502 int wrSz; /* write buffer size (mem) */
503 int wrIdx; /* current index for write buffer */
504 int rdIdx; /* current read index */
505 int readRq; /* read request */
506 int num; /* socket num or length */
507 int eof; /* eof flag */
508 int flags;
509 byte type; /* method type */
510 byte init:1; /* bio has been initialized */
511 byte shutdown:1; /* close flag */
512#ifdef HAVE_EX_DATA
513 WOLFSSL_CRYPTO_EX_DATA ex_data;
514#endif
515};
516
517typedef struct WOLFSSL_COMP_METHOD {
518 int type; /* stunnel dereference */
519} WOLFSSL_COMP_METHOD;
520
521typedef struct WOLFSSL_COMP {
522 int id;
523 const char *name;
524 WOLFSSL_COMP_METHOD *method;
525} WOLFSSL_COMP;
526
527#define WOLFSSL_X509_L_FILE_LOAD 0x1
528#define WOLFSSL_X509_L_ADD_DIR 0x2
529#define WOLFSSL_X509_L_ADD_STORE 0x3
530#define WOLFSSL_X509_L_LOAD_STORE 0x4
531
532struct WOLFSSL_X509_LOOKUP_METHOD {
533 int type;
534};
535
536struct WOLFSSL_X509_LOOKUP {
537 WOLFSSL_X509_STORE *store;
538 int type;
539 WOLFSSL_BY_DIR* dirs;
540};
541
542struct WOLFSSL_X509_STORE {
543 int cache; /* stunnel dereference */
544 WOLFSSL_CERT_MANAGER* cm;
545 WOLFSSL_X509_LOOKUP lookup;
546#if defined(OPENSSL_EXTRA) || defined(WOLFSSL_WPAS_SMALL)
547 int isDynamic;
548 WOLFSSL_X509_VERIFY_PARAM* param; /* certificate validation parameter */
549#endif
550#if defined(OPENSSL_ALL) || defined(WOLFSSL_QT)
551 WOLFSSL_X509_STORE_CTX_verify_cb verify_cb;
552#endif
553#ifdef HAVE_EX_DATA
554 WOLFSSL_CRYPTO_EX_DATA ex_data;
555#endif
556#if (defined(OPENSSL_EXTRA) || defined(WOLFSSL_WPAS_SMALL)) && defined(HAVE_CRL)
557 WOLFSSL_X509_CRL *crl; /* points to cm->crl */
558#endif
559};
560
561#define WOLFSSL_NO_WILDCARDS 0x4
562
563#if defined(OPENSSL_ALL) || defined(OPENSSL_EXTRA) || \
564 defined(WOLFSSL_WPAS_SMALL) || defined(WOLFSSL_IP_ALT_NAME)
565 #define WOLFSSL_MAX_IPSTR 46 /* max ip size IPv4 mapped IPv6 */
566#endif /* OPENSSL_ALL || WOLFSSL_IP_ALT_NAME */
567
568#if defined(OPENSSL_EXTRA) || defined(WOLFSSL_WPAS_SMALL)
569#define WOLFSSL_USE_CHECK_TIME 0x2
570#define WOLFSSL_NO_CHECK_TIME 0x200000
571#define WOLFSSL_HOST_NAME_MAX 256
572
573#define WOLFSSL_VPARAM_DEFAULT 0x1
574#define WOLFSSL_VPARAM_OVERWRITE 0x2
575#define WOLFSSL_VPARAM_RESET_FLAGS 0x4
576#define WOLFSSL_VPARAM_LOCKED 0x8
577#define WOLFSSL_VPARAM_ONCE 0x10
578
579struct WOLFSSL_X509_VERIFY_PARAM {
580 time_t check_time;
581 unsigned int inherit_flags;
582 unsigned long flags;
583 char hostName[WOLFSSL_HOST_NAME_MAX];
584 unsigned int hostFlags;
585 char ipasc[WOLFSSL_MAX_IPSTR];
586};
587#endif /* OPENSSL_EXTRA || WOLFSSL_WPAS_SMALL */
588
589typedef struct WOLFSSL_ALERT {
590 int code;
591 int level;
592} WOLFSSL_ALERT;
593
594typedef struct WOLFSSL_ALERT_HISTORY {
595 WOLFSSL_ALERT last_rx;
596 WOLFSSL_ALERT last_tx;
597} WOLFSSL_ALERT_HISTORY;
598
599typedef struct WOLFSSL_X509_REVOKED {
600 WOLFSSL_ASN1_INTEGER* serialNumber; /* stunnel dereference */
601} WOLFSSL_X509_REVOKED;
602
603
604typedef struct WOLFSSL_X509_OBJECT {
605 union {
606 char* ptr;
607 WOLFSSL_X509 *x509;
608 WOLFSSL_X509_CRL* crl; /* stunnel dereference */
609 } data;
610} WOLFSSL_X509_OBJECT;
611
612#define WOLFSSL_ASN1_BOOLEAN int
613
614typedef struct WOLFSSL_BUFFER_INFO {
615 unsigned char* buffer;
616 unsigned int length;
617} WOLFSSL_BUFFER_INFO;
618
619struct WOLFSSL_X509_STORE_CTX {
620 WOLFSSL_X509_STORE* store; /* Store full of a CA cert chain */
621 WOLFSSL_X509* current_cert; /* current X509 (OPENSSL_EXTRA) */
622#ifdef WOLFSSL_ASIO
623 WOLFSSL_X509* current_issuer; /* asio dereference */
624#endif
625 WOLFSSL_X509_CHAIN* sesChain; /* pointer to WOLFSSL_SESSION peer chain */
626 WOLFSSL_STACK* chain;
627#ifdef OPENSSL_EXTRA
628 WOLFSSL_X509_VERIFY_PARAM* param; /* certificate validation parameter */
629#endif
630 char* domain; /* subject CN domain name */
631#if defined(HAVE_EX_DATA) || defined(FORTRESS)
632 WOLFSSL_CRYPTO_EX_DATA ex_data; /* external data */
633#endif
634#if defined(WOLFSSL_APACHE_HTTPD) || defined(OPENSSL_EXTRA)
635 int depth; /* used in X509_STORE_CTX_*_depth */
636#endif
637 void* userCtx; /* user ctx */
638 int error; /* current error */
639 int error_depth; /* index of cert depth for this error */
640 int discardSessionCerts; /* so verify callback can flag for discard */
641 int totalCerts; /* number of peer cert buffers */
642 WOLFSSL_BUFFER_INFO* certs; /* peer certs */
643 WOLFSSL_X509_STORE_CTX_verify_cb verify_cb; /* verify callback */
644};
645
646typedef char* WOLFSSL_STRING;
647
648typedef struct WOLFSSL_RAND_METHOD {
649 /* seed = Data to mix into the random generator.
650 * len = Number of bytes to mix from seed. */
651 int (*seed)(const void* seed, int len);
652 /* buf = Buffer to store random bytes in.
653 * len = Number of bytes to store in buf. */
654 int (*bytes)(unsigned char* buf, int len);
655 void (*cleanup)(void);
656 /* add = Data to mix into the random generator.
657 * len = Number of bytes to mix from add.
658 * entropy = Estimate of randomness contained in seed.
659 * Should be between 0 and len. */
660 int (*add)(const void* add, int len, double entropy);
661 /* buf = Buffer to store pseudorandom bytes in.
662 * len = Number of bytes to store in buf. */
663 int (*pseudorand)(unsigned char *buf, int len);
664 int (*status)(void);
665} WOLFSSL_RAND_METHOD;
666
667/* Valid Alert types from page 16/17
668 * Add alert string to the function wolfSSL_alert_type_string_long in src/ssl.c
669 */
670enum AlertDescription {
671 close_notify = 0,
672 unexpected_message = 10,
673 bad_record_mac = 20,
674 record_overflow = 22,
675 decompression_failure = 30,
676 handshake_failure = 40,
677 no_certificate = 41,
678 bad_certificate = 42,
679 unsupported_certificate = 43,
680 certificate_revoked = 44,
681 certificate_expired = 45,
682 certificate_unknown = 46,
683 illegal_parameter = 47,
684 unknown_ca = 48,
685 decode_error = 50,
686 decrypt_error = 51,
687 #ifdef WOLFSSL_MYSQL_COMPATIBLE
688 /* catch name conflict for enum protocol with MYSQL build */
689 wc_protocol_version = 70,
690 #else
691 protocol_version = 70,
692 #endif
693 inappropriate_fallback = 86,
694 no_renegotiation = 100,
695 missing_extension = 109,
696 unsupported_extension = 110, /**< RFC 5246, section 7.2.2 */
697 unrecognized_name = 112, /**< RFC 6066, section 3 */
698 bad_certificate_status_response = 113, /**< RFC 6066, section 8 */
699 unknown_psk_identity = 115, /**< RFC 4279, section 2 */
700 certificate_required = 116, /**< RFC 8446, section 8.2 */
701 no_application_protocol = 120
702};
703
704
705enum AlertLevel {
706 alert_warning = 1,
707 alert_fatal = 2
708};
709
710/* WS_RETURN_CODE macro
711 * Some OpenSSL APIs specify "0" as the return value when an error occurs.
712 * However, some corresponding wolfSSL APIs return negative values. Such
713 * functions should use this macro to fill this gap. Users who want them
714 * to return the same return value as OpenSSL can define
715 * WOLFSSL_ERR_CODE_OPENSSL.
716 * Give item1 a variable that contains the potentially negative
717 * wolfSSL-defined return value or the return value itself, and
718 * give item2 the openSSL-defined return value.
719 * Note that this macro replaces only negative return values with the
720 * specified value.
721 * Since wolfSSL 4.7.0, the following functions use this macro:
722 * - wolfSSL_CTX_load_verify_locations
723 * - wolfSSL_X509_LOOKUP_load_file
724 * - wolfSSL_EVP_PKEY_cmp
725 */
726#if defined(WOLFSSL_ERROR_CODE_OPENSSL)
727 #define WS_RETURN_CODE(item1,item2) \
728 ((item1 < 0) ? item2 : item1)
729#else
730 #define WS_RETURN_CODE(item1,item2) (item1)
731#endif
732
733/* Maximum master key length (SECRET_LEN) */
734#define WOLFSSL_MAX_MASTER_KEY_LENGTH 48
735/* Maximum number of groups that can be set */
736#define WOLFSSL_MAX_GROUP_COUNT 10
737
738#if defined(HAVE_SECRET_CALLBACK) && defined(WOLFSSL_TLS13)
739enum Tls13Secret {
740 CLIENT_EARLY_TRAFFIC_SECRET,
741 CLIENT_HANDSHAKE_TRAFFIC_SECRET,
742 SERVER_HANDSHAKE_TRAFFIC_SECRET,
743 CLIENT_TRAFFIC_SECRET,
744 SERVER_TRAFFIC_SECRET,
745 EARLY_EXPORTER_SECRET,
746 EXPORTER_SECRET
747};
748#endif
749
750
751typedef WOLFSSL_METHOD* (*wolfSSL_method_func)(void* heap);
752
753/* CTX Method EX Constructor Functions */
754WOLFSSL_API WOLFSSL_METHOD *wolfTLS_client_method_ex(void* heap);
755WOLFSSL_API WOLFSSL_METHOD *wolfTLS_server_method_ex(void* heap);
756WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_method_ex(void* heap);
757WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_server_method_ex(void* heap);
758WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_client_method_ex(void* heap);
759WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_method_ex(void* heap);
760WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_server_method_ex(void* heap);
761WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_client_method_ex(void* heap);
762WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_method_ex(void* heap);
763WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_server_method_ex(void* heap);
764WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_client_method_ex(void* heap);
765WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_method_ex(void* heap);
766WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_server_method_ex(void* heap);
767WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_client_method_ex(void* heap);
768#ifdef WOLFSSL_TLS13
769 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_3_method_ex(void* heap);
770 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_3_server_method_ex(void* heap);
771 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_3_client_method_ex(void* heap);
772#endif
773
774WOLFSSL_API WOLFSSL_METHOD *wolfSSLv23_method_ex(void* heap);
775WOLFSSL_API WOLFSSL_METHOD *wolfSSLv23_server_method_ex(void* heap);
776WOLFSSL_API WOLFSSL_METHOD *wolfSSLv23_client_method_ex(void* heap);
777
778#ifdef WOLFSSL_DTLS
779 WOLFSSL_API WOLFSSL_METHOD *wolfDTLS_method_ex(void* heap);
780 WOLFSSL_API WOLFSSL_METHOD *wolfDTLS_client_method_ex(void* heap);
781 WOLFSSL_API WOLFSSL_METHOD *wolfDTLS_server_method_ex(void* heap);
782 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_method_ex(void* heap);
783 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_client_method_ex(void* heap);
784 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_server_method_ex(void* heap);
785 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_method_ex(void* heap);
786 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_client_method_ex(void* heap);
787 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_server_method_ex(void* heap);
788#endif
789
790/* CTX Method Constructor Functions */
791WOLFSSL_API WOLFSSL_METHOD *wolfTLS_client_method(void);
792WOLFSSL_API WOLFSSL_METHOD *wolfTLS_server_method(void);
793WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_method(void);
794WOLFSSL_API WOLFSSL_METHOD *wolfSSLv23_method(void);
795WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_server_method(void);
796WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_client_method(void);
797WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_method(void);
798WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_server_method(void);
799WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_client_method(void);
800WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_method(void);
801WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_server_method(void);
802WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_client_method(void);
803WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_method(void);
804WOLFSSL_ABI WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_server_method(void);
805WOLFSSL_ABI WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_client_method(void);
806#ifdef WOLFSSL_TLS13
807 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_3_method(void);
808 WOLFSSL_ABI WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_3_server_method(void);
809 WOLFSSL_ABI WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_3_client_method(void);
810#endif
811
812#ifdef WOLFSSL_DTLS
813 WOLFSSL_API WOLFSSL_METHOD *wolfDTLS_method(void);
814 WOLFSSL_API WOLFSSL_METHOD *wolfDTLS_server_method(void);
815 WOLFSSL_API WOLFSSL_METHOD *wolfDTLS_client_method(void);
816 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_method(void);
817 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_client_method(void);
818 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_server_method(void);
819 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_method(void);
820 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_client_method(void);
821 WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_server_method(void);
822#endif
823
824#ifdef HAVE_POLY1305
825 WOLFSSL_API int wolfSSL_use_old_poly(WOLFSSL*, int);
826#endif
827
828#ifdef WOLFSSL_SESSION_EXPORT
829#ifdef WOLFSSL_DTLS
830
831#ifndef WOLFSSL_DTLS_EXPORT_TYPES
832typedef int (*wc_dtls_export)(WOLFSSL* ssl,
833 unsigned char* exportBuffer, unsigned int sz, void* userCtx);
834#define WOLFSSL_DTLS_EXPORT_TYPES
835#endif /* WOLFSSL_DTLS_EXPORT_TYPES */
836
837WOLFSSL_API int wolfSSL_dtls_import(WOLFSSL* ssl, const unsigned char* buf,
838 unsigned int sz);
839WOLFSSL_API int wolfSSL_CTX_dtls_set_export(WOLFSSL_CTX* ctx,
840 wc_dtls_export func);
841WOLFSSL_API int wolfSSL_dtls_set_export(WOLFSSL* ssl, wc_dtls_export func);
842WOLFSSL_API int wolfSSL_dtls_export(WOLFSSL* ssl, unsigned char* buf,
843 unsigned int* sz);
844WOLFSSL_API int wolfSSL_dtls_export_state_only(WOLFSSL* ssl, unsigned char* buf,
845 unsigned int* sz);
846#endif /* WOLFSSL_DTLS */
847#endif /* WOLFSSL_SESSION_EXPORT */
848
849#ifdef WOLFSSL_STATIC_MEMORY
850#ifndef WOLFSSL_MEM_GUARD
851#define WOLFSSL_MEM_GUARD
852 typedef struct WOLFSSL_MEM_STATS WOLFSSL_MEM_STATS;
853 typedef struct WOLFSSL_MEM_CONN_STATS WOLFSSL_MEM_CONN_STATS;
854#endif
855WOLFSSL_API int wolfSSL_CTX_load_static_memory(WOLFSSL_CTX** ctx,
856 wolfSSL_method_func method,
857 unsigned char* buf, unsigned int sz,
858 int flag, int max);
859WOLFSSL_API int wolfSSL_CTX_is_static_memory(WOLFSSL_CTX* ctx,
860 WOLFSSL_MEM_STATS* mem_stats);
861WOLFSSL_API int wolfSSL_is_static_memory(WOLFSSL* ssl,
862 WOLFSSL_MEM_CONN_STATS* mem_stats);
863#endif
864
865#if !defined(NO_FILESYSTEM) && !defined(NO_CERTS)
866
867WOLFSSL_ABI WOLFSSL_API int wolfSSL_CTX_use_certificate_file(WOLFSSL_CTX*,
868 const char*, int);
869WOLFSSL_ABI WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_file(WOLFSSL_CTX*,
870 const char*, int);
871
872#endif
873
874#ifndef NO_CERTS
875#define WOLFSSL_LOAD_FLAG_NONE 0x00000000
876#define WOLFSSL_LOAD_FLAG_IGNORE_ERR 0x00000001
877#define WOLFSSL_LOAD_FLAG_DATE_ERR_OKAY 0x00000002
878#define WOLFSSL_LOAD_FLAG_PEM_CA_ONLY 0x00000004
879#if defined(WOLFSSL_QT)
880#define WOLFSSL_LOAD_FLAG_IGNORE_BAD_PATH_ERR 0x00000008
881#define WOLFSSL_LOAD_FLAG_IGNORE_ZEROFILE 0x00000010
882#endif
883
884#ifndef WOLFSSL_LOAD_VERIFY_DEFAULT_FLAGS
885#define WOLFSSL_LOAD_VERIFY_DEFAULT_FLAGS WOLFSSL_LOAD_FLAG_NONE
886#endif
887
888WOLFSSL_API long wolfSSL_get_verify_depth(WOLFSSL* ssl);
889WOLFSSL_API long wolfSSL_CTX_get_verify_depth(WOLFSSL_CTX* ctx);
890WOLFSSL_API void wolfSSL_CTX_set_verify_depth(WOLFSSL_CTX *ctx,int depth);
891#endif /* !NO_CERTS */
892
893#define WOLFSSL_CIPHER_SUITE_FLAG_NONE 0x0
894#define WOLFSSL_CIPHER_SUITE_FLAG_NAMEALIAS 0x1
895
896#if !defined(NO_FILESYSTEM) && !defined(NO_CERTS)
897
898WOLFSSL_API int wolfSSL_CTX_load_verify_locations_ex(WOLFSSL_CTX*, const char*,
899 const char*, unsigned int);
900WOLFSSL_ABI WOLFSSL_API int wolfSSL_CTX_load_verify_locations(WOLFSSL_CTX*,
901 const char*, const char*);
902#ifdef WOLFSSL_TRUST_PEER_CERT
903WOLFSSL_API int wolfSSL_CTX_trust_peer_cert(WOLFSSL_CTX*, const char*, int);
904#endif
905WOLFSSL_ABI WOLFSSL_API int wolfSSL_CTX_use_certificate_chain_file(
906 WOLFSSL_CTX*, const char*);
907WOLFSSL_API int wolfSSL_CTX_use_certificate_chain_file_format(WOLFSSL_CTX *,
908 const char *file, int format);
909WOLFSSL_API int wolfSSL_CTX_use_RSAPrivateKey_file(WOLFSSL_CTX*, const char*, int);
910
911WOLFSSL_ABI WOLFSSL_API int wolfSSL_use_certificate_file(WOLFSSL*, const char*,
912 int);
913WOLFSSL_ABI WOLFSSL_API int wolfSSL_use_PrivateKey_file(WOLFSSL*, const char*,
914 int);
915WOLFSSL_ABI WOLFSSL_API int wolfSSL_use_certificate_chain_file(WOLFSSL*,
916 const char*);
917WOLFSSL_API int wolfSSL_use_certificate_chain_file_format(WOLFSSL*,
918 const char *file, int format);
919WOLFSSL_API int wolfSSL_use_RSAPrivateKey_file(WOLFSSL*, const char*, int);
920
921#ifdef WOLFSSL_DER_LOAD
922 WOLFSSL_API int wolfSSL_CTX_der_load_verify_locations(WOLFSSL_CTX*,
923 const char*, int);
924#endif
925
926#ifdef HAVE_NTRU
927 WOLFSSL_API int wolfSSL_CTX_use_NTRUPrivateKey_file(WOLFSSL_CTX*, const char*);
928 /* load NTRU private key blob */
929#endif
930
931#endif /* !NO_FILESYSTEM && !NO_CERTS */
932
933WOLFSSL_API WOLFSSL_CTX* wolfSSL_CTX_new_ex(WOLFSSL_METHOD* method, void* heap);
934WOLFSSL_ABI WOLFSSL_API WOLFSSL_CTX* wolfSSL_CTX_new(WOLFSSL_METHOD*);
935#ifdef OPENSSL_EXTRA
936WOLFSSL_API int wolfSSL_CTX_up_ref(WOLFSSL_CTX*);
937WOLFSSL_API int wolfSSL_CTX_set_ecdh_auto(WOLFSSL_CTX* ctx, int onoff);
938WOLFSSL_API int wolfSSL_get_signature_nid(WOLFSSL* ssl, int* nid);
939WOLFSSL_API int wolfSSL_CTX_set1_sigalgs_list(WOLFSSL_CTX* ctx,
940 const char* list);
941WOLFSSL_API int wolfSSL_set1_sigalgs_list(WOLFSSL* ssl, const char* list);
942#endif
943WOLFSSL_ABI WOLFSSL_API WOLFSSL* wolfSSL_new(WOLFSSL_CTX*);
944WOLFSSL_API WOLFSSL_CTX* wolfSSL_get_SSL_CTX(WOLFSSL* ssl);
945WOLFSSL_API WOLFSSL_X509_VERIFY_PARAM* wolfSSL_CTX_get0_param(WOLFSSL_CTX* ctx);
946WOLFSSL_API WOLFSSL_X509_VERIFY_PARAM* wolfSSL_get0_param(WOLFSSL* ssl);
947WOLFSSL_API int wolfSSL_CTX_set1_param(WOLFSSL_CTX* ctx, WOLFSSL_X509_VERIFY_PARAM *vpm);
948WOLFSSL_API int wolfSSL_is_server(WOLFSSL*);
949WOLFSSL_API WOLFSSL* wolfSSL_write_dup(WOLFSSL*);
950WOLFSSL_ABI WOLFSSL_API int wolfSSL_set_fd (WOLFSSL*, int);
951WOLFSSL_API int wolfSSL_set_write_fd (WOLFSSL*, int);
952WOLFSSL_API int wolfSSL_set_read_fd (WOLFSSL*, int);
953WOLFSSL_API char* wolfSSL_get_cipher_list(int priority);
954WOLFSSL_API char* wolfSSL_get_cipher_list_ex(WOLFSSL* ssl, int priority);
955WOLFSSL_API int wolfSSL_get_ciphers(char*, int);
956WOLFSSL_API int wolfSSL_get_ciphers_iana(char*, int);
957WOLFSSL_API const char* wolfSSL_get_cipher_name(WOLFSSL* ssl);
958WOLFSSL_API const char* wolfSSL_get_cipher_name_from_suite(const unsigned char,
959 const unsigned char);
960WOLFSSL_API const char* wolfSSL_get_cipher_name_iana_from_suite(
961 const unsigned char, const unsigned char);
962WOLFSSL_API int wolfSSL_get_cipher_suite_from_name(const char* name,
963 byte* cipherSuite0, byte* cipherSuite, int* flags);
964WOLFSSL_API const char* wolfSSL_get_shared_ciphers(WOLFSSL* ssl, char* buf,
965 int len);
966WOLFSSL_API const char* wolfSSL_get_curve_name(WOLFSSL* ssl);
967WOLFSSL_API int wolfSSL_get_fd(const WOLFSSL*);
968/* please see note at top of README if you get an error from connect */
969WOLFSSL_ABI WOLFSSL_API int wolfSSL_connect(WOLFSSL*);
970WOLFSSL_ABI WOLFSSL_API int wolfSSL_write(WOLFSSL*, const void*, int);
971WOLFSSL_ABI WOLFSSL_API int wolfSSL_read(WOLFSSL*, void*, int);
972WOLFSSL_API int wolfSSL_peek(WOLFSSL*, void*, int);
973WOLFSSL_ABI WOLFSSL_API int wolfSSL_accept(WOLFSSL*);
974WOLFSSL_API int wolfSSL_CTX_mutual_auth(WOLFSSL_CTX* ctx, int req);
975WOLFSSL_API int wolfSSL_mutual_auth(WOLFSSL* ssl, int req);
976#ifdef WOLFSSL_TLS13
977WOLFSSL_API int wolfSSL_send_hrr_cookie(WOLFSSL* ssl,
978 const unsigned char* secret, unsigned int secretSz);
979WOLFSSL_API int wolfSSL_CTX_no_ticket_TLSv13(WOLFSSL_CTX* ctx);
980WOLFSSL_API int wolfSSL_no_ticket_TLSv13(WOLFSSL* ssl);
981WOLFSSL_API int wolfSSL_CTX_no_dhe_psk(WOLFSSL_CTX* ctx);
982WOLFSSL_API int wolfSSL_no_dhe_psk(WOLFSSL* ssl);
983WOLFSSL_API int wolfSSL_update_keys(WOLFSSL* ssl);
984WOLFSSL_API int wolfSSL_key_update_response(WOLFSSL* ssl, int* required);
985WOLFSSL_API int wolfSSL_CTX_allow_post_handshake_auth(WOLFSSL_CTX* ctx);
986WOLFSSL_API int wolfSSL_allow_post_handshake_auth(WOLFSSL* ssl);
987WOLFSSL_API int wolfSSL_request_certificate(WOLFSSL* ssl);
988
989WOLFSSL_API int wolfSSL_CTX_set1_groups_list(WOLFSSL_CTX *ctx, char *list);
990WOLFSSL_API int wolfSSL_set1_groups_list(WOLFSSL *ssl, char *list);
991
992WOLFSSL_API int wolfSSL_preferred_group(WOLFSSL* ssl);
993WOLFSSL_API int wolfSSL_CTX_set_groups(WOLFSSL_CTX* ctx, int* groups,
994 int count);
995WOLFSSL_API int wolfSSL_set_groups(WOLFSSL* ssl, int* groups, int count);
996
997#ifdef OPENSSL_EXTRA
998WOLFSSL_API int wolfSSL_CTX_set1_groups(WOLFSSL_CTX* ctx, int* groups,
999 int count);
1000WOLFSSL_API int wolfSSL_set1_groups(WOLFSSL* ssl, int* groups, int count);
1001#endif
1002
1003WOLFSSL_API int wolfSSL_connect_TLSv13(WOLFSSL*);
1004WOLFSSL_API int wolfSSL_accept_TLSv13(WOLFSSL*);
1005
1006#ifdef WOLFSSL_EARLY_DATA
1007
1008#define WOLFSSL_EARLY_DATA_NOT_SENT 0
1009#define WOLFSSL_EARLY_DATA_REJECTED 1
1010#define WOLFSSL_EARLY_DATA_ACCEPTED 2
1011
1012WOLFSSL_API int wolfSSL_CTX_set_max_early_data(WOLFSSL_CTX* ctx,
1013 unsigned int sz);
1014WOLFSSL_API int wolfSSL_set_max_early_data(WOLFSSL* ssl, unsigned int sz);
1015WOLFSSL_API int wolfSSL_write_early_data(WOLFSSL* ssl, const void* data,
1016 int sz, int* outSz);
1017WOLFSSL_API int wolfSSL_read_early_data(WOLFSSL* ssl, void* data, int sz,
1018 int* outSz);
1019WOLFSSL_API int wolfSSL_get_early_data_status(const WOLFSSL* ssl);
1020#endif /* WOLFSSL_EARLY_DATA */
1021#endif /* WOLFSSL_TLS13 */
1022WOLFSSL_ABI WOLFSSL_API void wolfSSL_CTX_free(WOLFSSL_CTX*);
1023WOLFSSL_ABI WOLFSSL_API void wolfSSL_free(WOLFSSL*);
1024WOLFSSL_ABI WOLFSSL_API int wolfSSL_shutdown(WOLFSSL*);
1025WOLFSSL_API int wolfSSL_send(WOLFSSL*, const void*, int sz, int flags);
1026WOLFSSL_API int wolfSSL_recv(WOLFSSL*, void*, int sz, int flags);
1027
1028WOLFSSL_API void wolfSSL_CTX_set_quiet_shutdown(WOLFSSL_CTX*, int);
1029WOLFSSL_API void wolfSSL_set_quiet_shutdown(WOLFSSL*, int);
1030
1031WOLFSSL_ABI WOLFSSL_API int wolfSSL_get_error(WOLFSSL*, int);
1032WOLFSSL_API int wolfSSL_get_alert_history(WOLFSSL*, WOLFSSL_ALERT_HISTORY *);
1033
1034WOLFSSL_ABI WOLFSSL_API int wolfSSL_set_session(WOLFSSL*, WOLFSSL_SESSION*);
1035WOLFSSL_API long wolfSSL_SSL_SESSION_set_timeout(WOLFSSL_SESSION*, long);
1036WOLFSSL_ABI WOLFSSL_API WOLFSSL_SESSION* wolfSSL_get_session(WOLFSSL*);
1037WOLFSSL_ABI WOLFSSL_API void wolfSSL_flush_sessions(WOLFSSL_CTX*, long);
1038WOLFSSL_API int wolfSSL_SetServerID(WOLFSSL*, const unsigned char*, int, int);
1039
1040#if defined(OPENSSL_ALL) || defined(WOLFSSL_ASIO) || defined(WOLFSSL_HAPROXY) \
1041 || defined(WOLFSSL_NGINX)
1042WOLFSSL_API int wolfSSL_BIO_new_bio_pair(WOLFSSL_BIO**, size_t,
1043 WOLFSSL_BIO**, size_t);
1044
1045WOLFSSL_API int wolfSSL_RSA_padding_add_PKCS1_PSS(WOLFSSL_RSA *rsa,
1046 unsigned char *EM,
1047 const unsigned char *mHash,
1048 const WOLFSSL_EVP_MD *hashAlg,
1049 int saltLen);
1050WOLFSSL_API int wolfSSL_RSA_verify_PKCS1_PSS(WOLFSSL_RSA *rsa, const unsigned char *mHash,
1051 const WOLFSSL_EVP_MD *hashAlg,
1052 const unsigned char *EM, int saltLen);
1053WOLFSSL_API WOLFSSL_RSA* wolfSSL_d2i_RSAPrivateKey_bio(WOLFSSL_BIO*, WOLFSSL_RSA**);
1054WOLFSSL_API int wolfSSL_CTX_use_certificate_ASN1(WOLFSSL_CTX*,
1055 int, const unsigned char*);
1056WOLFSSL_API int wolfSSL_CTX_use_RSAPrivateKey(WOLFSSL_CTX*, WOLFSSL_RSA*);
1057WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_d2i_PrivateKey_bio(WOLFSSL_BIO*, WOLFSSL_EVP_PKEY**);
1058#endif /* OPENSSL_ALL || WOLFSSL_ASIO */
1059
1060#ifdef SESSION_INDEX
1061WOLFSSL_API int wolfSSL_GetSessionIndex(WOLFSSL* ssl);
1062WOLFSSL_API int wolfSSL_GetSessionAtIndex(int index, WOLFSSL_SESSION* session);
1063#endif /* SESSION_INDEX */
1064
1065#if defined(SESSION_CERTS)
1066WOLFSSL_API
1067 WOLFSSL_X509_CHAIN* wolfSSL_SESSION_get_peer_chain(WOLFSSL_SESSION* session);
1068WOLFSSL_API WOLFSSL_X509* wolfSSL_SESSION_get0_peer(WOLFSSL_SESSION* session);
1069#endif /* SESSION_INDEX && SESSION_CERTS */
1070
1071typedef int (*VerifyCallback)(int, WOLFSSL_X509_STORE_CTX*);
1072typedef void (CallbackInfoState)(const WOLFSSL*, int, int);
1073
1074/* class index for wolfSSL_CRYPTO_get_ex_new_index */
1075#define CRYPTO_EX_INDEX_SSL 0
1076#define CRYPTO_EX_INDEX_SSL_CTX 1
1077#define CRYPTO_EX_INDEX_SSL_SESSION 2
1078#define CRYPTO_EX_INDEX_X509 3
1079#define CRYPTO_EX_INDEX_X509_STORE 4
1080#define CRYPTO_EX_INDEX_X509_STORE_CTX 5
1081#define CRYPTO_EX_INDEX_DH 6
1082#define CRYPTO_EX_INDEX_DSA 7
1083#define CRYPTO_EX_INDEX_EC_KEY 8
1084#define CRYPTO_EX_INDEX_RSA 9
1085#define CRYPTO_EX_INDEX_ENGINE 10
1086#define CRYPTO_EX_INDEX_UI 11
1087#define CRYPTO_EX_INDEX_BIO 12
1088#define CRYPTO_EX_INDEX_APP 13
1089#define CRYPTO_EX_INDEX_UI_METHOD 14
1090#define CRYPTO_EX_INDEX_DRBG 15
1091#define CRYPTO_EX_INDEX__COUNT 16
1092
1093#if defined(HAVE_EX_DATA) || defined(FORTRESS)
1094typedef int (WOLFSSL_CRYPTO_EX_new)(void* p, void* ptr,
1095 WOLFSSL_CRYPTO_EX_DATA* a, int idx, long argValue, void* arg);
1096typedef int (WOLFSSL_CRYPTO_EX_dup)(WOLFSSL_CRYPTO_EX_DATA* out,
1097 WOLFSSL_CRYPTO_EX_DATA* in, void* inPtr, int idx, long argV, void* arg);
1098typedef void (WOLFSSL_CRYPTO_EX_free)(void* p, void* ptr,
1099 WOLFSSL_CRYPTO_EX_DATA* a, int idx, long argValue, void* arg);
1100
1101WOLFSSL_API int wolfSSL_get_ex_new_index(long argValue, void* arg,
1102 WOLFSSL_CRYPTO_EX_new* a, WOLFSSL_CRYPTO_EX_dup* b,
1103 WOLFSSL_CRYPTO_EX_free* c);
1104
1105#endif
1106
1107WOLFSSL_ABI WOLFSSL_API void wolfSSL_CTX_set_verify(WOLFSSL_CTX*, int,
1108 VerifyCallback verify_callback);
1109
1110#ifdef OPENSSL_ALL
1111typedef int (*CertVerifyCallback)(WOLFSSL_X509_STORE_CTX* store, void* arg);
1112WOLFSSL_API void wolfSSL_CTX_set_cert_verify_callback(WOLFSSL_CTX* ctx,
1113 CertVerifyCallback cb, void* arg);
1114#endif
1115
1116WOLFSSL_API void wolfSSL_set_verify(WOLFSSL*, int, VerifyCallback verify_callback);
1117WOLFSSL_API void wolfSSL_set_verify_result(WOLFSSL*, long);
1118
1119#if defined(OPENSSL_EXTRA) && !defined(NO_CERTS) && \
1120 defined(WOLFSSL_TLS13) && defined(WOLFSSL_POST_HANDSHAKE_AUTH)
1121WOLFSSL_API int wolfSSL_verify_client_post_handshake(WOLFSSL*);
1122WOLFSSL_API int wolfSSL_CTX_set_post_handshake_auth(WOLFSSL_CTX*, int);
1123WOLFSSL_API int wolfSSL_set_post_handshake_auth(WOLFSSL*, int);
1124#endif
1125
1126WOLFSSL_API void wolfSSL_SetCertCbCtx(WOLFSSL*, void*);
1127
1128WOLFSSL_ABI WOLFSSL_API int wolfSSL_pending(WOLFSSL*);
1129
1130WOLFSSL_API void wolfSSL_load_error_strings(void);
1131WOLFSSL_API int wolfSSL_library_init(void);
1132WOLFSSL_ABI WOLFSSL_API long wolfSSL_CTX_set_session_cache_mode(WOLFSSL_CTX*,
1133 long);
1134
1135#ifdef HAVE_SECRET_CALLBACK
1136typedef int (*SessionSecretCb)(WOLFSSL* ssl, void* secret, int* secretSz,
1137 void* ctx);
1138WOLFSSL_API int wolfSSL_set_session_secret_cb(WOLFSSL*, SessionSecretCb,
1139 void*);
1140#ifdef WOLFSSL_TLS13
1141typedef int (*Tls13SecretCb)(WOLFSSL* ssl, int id, const unsigned char* secret,
1142 int secretSz, void* ctx);
1143WOLFSSL_API int wolfSSL_set_tls13_secret_cb(WOLFSSL*, Tls13SecretCb, void*);
1144#endif
1145#endif /* HAVE_SECRET_CALLBACK */
1146
1147/* session cache persistence */
1148WOLFSSL_API int wolfSSL_save_session_cache(const char*);
1149WOLFSSL_API int wolfSSL_restore_session_cache(const char*);
1150WOLFSSL_API int wolfSSL_memsave_session_cache(void*, int);
1151WOLFSSL_API int wolfSSL_memrestore_session_cache(const void*, int);
1152WOLFSSL_API int wolfSSL_get_session_cache_memsize(void);
1153
1154/* certificate cache persistence, uses ctx since certs are per ctx */
1155WOLFSSL_API int wolfSSL_CTX_save_cert_cache(WOLFSSL_CTX*, const char*);
1156WOLFSSL_API int wolfSSL_CTX_restore_cert_cache(WOLFSSL_CTX*, const char*);
1157WOLFSSL_API int wolfSSL_CTX_memsave_cert_cache(WOLFSSL_CTX*, void*, int, int*);
1158WOLFSSL_API int wolfSSL_CTX_memrestore_cert_cache(WOLFSSL_CTX*, const void*, int);
1159WOLFSSL_API int wolfSSL_CTX_get_cert_cache_memsize(WOLFSSL_CTX*);
1160
1161/* only supports full name from cipher_name[] delimited by : */
1162WOLFSSL_API int wolfSSL_CTX_set_cipher_list(WOLFSSL_CTX*, const char*);
1163WOLFSSL_API int wolfSSL_set_cipher_list(WOLFSSL*, const char*);
1164
1165#ifdef HAVE_KEYING_MATERIAL
1166/* Keying Material Exporter for TLS */
1167WOLFSSL_API int wolfSSL_export_keying_material(WOLFSSL *ssl,
1168 unsigned char *out, size_t outLen,
1169 const char *label, size_t labelLen,
1170 const unsigned char *context, size_t contextLen,
1171 int use_context);
1172#endif /* HAVE_KEYING_MATERIAL */
1173
1174#ifdef WOLFSSL_WOLFSENTRY_HOOKS
1175
1176typedef enum {
1177 WOLFSSL_NETFILTER_PASS = 0,
1178 WOLFSSL_NETFILTER_ACCEPT = 1,
1179 WOLFSSL_NETFILTER_REJECT = 2
1180} wolfSSL_netfilter_decision_t;
1181
1182typedef int (*NetworkFilterCallback_t)(
1183 WOLFSSL *ssl,
1184 void *AcceptFilter_arg,
1185 wolfSSL_netfilter_decision_t *decision);
1186WOLFSSL_API int wolfSSL_CTX_set_AcceptFilter(
1187 WOLFSSL_CTX *ctx,
1188 NetworkFilterCallback_t AcceptFilter,
1189 void *AcceptFilter_arg);
1190WOLFSSL_API int wolfSSL_set_AcceptFilter(
1191 WOLFSSL *ssl,
1192 NetworkFilterCallback_t AcceptFilter,
1193 void *AcceptFilter_arg);
1194WOLFSSL_API int wolfSSL_CTX_set_ConnectFilter(
1195 WOLFSSL_CTX *ctx,
1196 NetworkFilterCallback_t ConnectFilter,
1197 void *ConnectFilter_arg);
1198WOLFSSL_API int wolfSSL_set_ConnectFilter(
1199 WOLFSSL *ssl,
1200 NetworkFilterCallback_t ConnectFilter,
1201 void *ConnectFilter_arg);
1202
1203#endif /* WOLFSSL_WOLFSENTRY_HOOKS */
1204
1205/* Nonblocking DTLS helper functions */
1206WOLFSSL_API void wolfSSL_dtls_set_using_nonblock(WOLFSSL*, int);
1207WOLFSSL_API int wolfSSL_dtls_get_using_nonblock(WOLFSSL*);
1208#define wolfSSL_set_using_nonblock wolfSSL_dtls_set_using_nonblock
1209#define wolfSSL_get_using_nonblock wolfSSL_dtls_get_using_nonblock
1210 /* The old names are deprecated. */
1211WOLFSSL_API int wolfSSL_dtls_get_current_timeout(WOLFSSL* ssl);
1212WOLFSSL_API int wolfSSL_DTLSv1_get_timeout(WOLFSSL* ssl,
1213 WOLFSSL_TIMEVAL* timeleft);
1214WOLFSSL_API void wolfSSL_DTLSv1_set_initial_timeout_duration(WOLFSSL* ssl,
1215 word32 duration_ms);
1216WOLFSSL_API int wolfSSL_DTLSv1_handle_timeout(WOLFSSL* ssl);
1217
1218WOLFSSL_API int wolfSSL_dtls_set_timeout_init(WOLFSSL* ssl, int);
1219WOLFSSL_API int wolfSSL_dtls_set_timeout_max(WOLFSSL* ssl, int);
1220WOLFSSL_API int wolfSSL_dtls_got_timeout(WOLFSSL* ssl);
1221WOLFSSL_API int wolfSSL_dtls_retransmit(WOLFSSL*);
1222WOLFSSL_API int wolfSSL_dtls(WOLFSSL* ssl);
1223
1224WOLFSSL_API int wolfSSL_dtls_set_peer(WOLFSSL*, void*, unsigned int);
1225WOLFSSL_API int wolfSSL_dtls_get_peer(WOLFSSL*, void*, unsigned int*);
1226
1227WOLFSSL_API int wolfSSL_CTX_dtls_set_sctp(WOLFSSL_CTX*);
1228WOLFSSL_API int wolfSSL_dtls_set_sctp(WOLFSSL*);
1229WOLFSSL_API int wolfSSL_CTX_dtls_set_mtu(WOLFSSL_CTX*, unsigned short);
1230WOLFSSL_API int wolfSSL_dtls_set_mtu(WOLFSSL*, unsigned short);
1231
1232WOLFSSL_API int wolfSSL_dtls_get_drop_stats(WOLFSSL*,
1233 unsigned int*, unsigned int*);
1234WOLFSSL_API int wolfSSL_CTX_mcast_set_member_id(WOLFSSL_CTX*, unsigned short);
1235WOLFSSL_API int wolfSSL_set_secret(WOLFSSL*, unsigned short,
1236 const unsigned char*, unsigned int,
1237 const unsigned char*, const unsigned char*,
1238 const unsigned char*);
1239WOLFSSL_API int wolfSSL_mcast_read(WOLFSSL*, unsigned short*, void*, int);
1240WOLFSSL_API int wolfSSL_mcast_peer_add(WOLFSSL*, unsigned short, int);
1241WOLFSSL_API int wolfSSL_mcast_peer_known(WOLFSSL*, unsigned short);
1242WOLFSSL_API int wolfSSL_mcast_get_max_peers(void);
1243typedef int (*CallbackMcastHighwater)(unsigned short peerId,
1244 unsigned int maxSeq,
1245 unsigned int curSeq, void* ctx);
1246WOLFSSL_API int wolfSSL_CTX_mcast_set_highwater_cb(WOLFSSL_CTX*,
1247 unsigned int,
1248 unsigned int,
1249 unsigned int,
1250 CallbackMcastHighwater);
1251WOLFSSL_API int wolfSSL_mcast_set_highwater_ctx(WOLFSSL*, void*);
1252
1253WOLFSSL_API int wolfSSL_ERR_GET_LIB(unsigned long err);
1254WOLFSSL_API int wolfSSL_ERR_GET_REASON(unsigned long err);
1255WOLFSSL_API char* wolfSSL_ERR_error_string(unsigned long,char*);
1256WOLFSSL_API void wolfSSL_ERR_error_string_n(unsigned long e, char* buf,
1257 unsigned long sz);
1258WOLFSSL_API const char* wolfSSL_ERR_reason_error_string(unsigned long);
1259
1260/* extras */
1261
1262WOLFSSL_API WOLFSSL_STACK* wolfSSL_sk_new_node(void* heap);
1263WOLFSSL_API void wolfSSL_sk_free(WOLFSSL_STACK* sk);
1264WOLFSSL_API void wolfSSL_sk_free_node(WOLFSSL_STACK* in);
1265WOLFSSL_API WOLFSSL_STACK* wolfSSL_sk_dup(WOLFSSL_STACK* sk);
1266WOLFSSL_API int wolfSSL_sk_push_node(WOLFSSL_STACK** stack, WOLFSSL_STACK* in);
1267WOLFSSL_API WOLFSSL_STACK* wolfSSL_sk_get_node(WOLFSSL_STACK* sk, int idx);
1268WOLFSSL_API int wolfSSL_sk_push(WOLFSSL_STACK *st, const void *data);
1269
1270#if defined(HAVE_OCSP)
1271#include "wolfssl/ocsp.h"
1272#include "wolfssl/wolfcrypt/asn.h"
1273#endif
1274
1275#if defined(OPENSSL_ALL) || defined(WOLFSSL_QT)
1276WOLFSSL_API int wolfSSL_sk_ACCESS_DESCRIPTION_push(
1277 WOLF_STACK_OF(ACCESS_DESCRIPTION)* sk,
1278 WOLFSSL_ACCESS_DESCRIPTION* access);
1279#endif /* defined(OPENSSL_ALL) || defined(WOLFSSL_QT) */
1280
1281typedef WOLF_STACK_OF(WOLFSSL_GENERAL_NAME) WOLFSSL_GENERAL_NAMES;
1282
1283WOLFSSL_API int wolfSSL_sk_X509_push(WOLF_STACK_OF(WOLFSSL_X509_NAME)* sk,
1284 WOLFSSL_X509* x509);
1285WOLFSSL_API WOLFSSL_X509* wolfSSL_sk_X509_pop(WOLF_STACK_OF(WOLFSSL_X509_NAME)* sk);
1286WOLFSSL_API void wolfSSL_sk_X509_free(WOLF_STACK_OF(WOLFSSL_X509_NAME)* sk);
1287WOLFSSL_API WOLFSSL_GENERAL_NAME* wolfSSL_GENERAL_NAME_new(void);
1288WOLFSSL_API void wolfSSL_GENERAL_NAME_free(WOLFSSL_GENERAL_NAME* gn);
1289WOLFSSL_API WOLFSSL_GENERAL_NAMES* wolfSSL_GENERAL_NAMES_dup(
1290 WOLFSSL_GENERAL_NAMES* gns);
1291WOLFSSL_API int wolfSSL_sk_GENERAL_NAME_push(WOLFSSL_GENERAL_NAMES* sk,
1292 WOLFSSL_GENERAL_NAME* gn);
1293WOLFSSL_API WOLFSSL_GENERAL_NAME* wolfSSL_sk_GENERAL_NAME_value(
1294 WOLFSSL_STACK* sk, int i);
1295WOLFSSL_API int wolfSSL_sk_GENERAL_NAME_num(WOLFSSL_STACK* sk);
1296WOLFSSL_API void wolfSSL_sk_GENERAL_NAME_pop_free(WOLFSSL_STACK* sk,
1297 void (*f) (WOLFSSL_GENERAL_NAME*));
1298WOLFSSL_API void wolfSSL_sk_GENERAL_NAME_free(WOLFSSL_STACK* sk);
1299WOLFSSL_API void wolfSSL_GENERAL_NAMES_free(WOLFSSL_GENERAL_NAMES* name);
1300WOLFSSL_API int wolfSSL_sk_ACCESS_DESCRIPTION_num(WOLFSSL_STACK* sk);
1301WOLFSSL_API void wolfSSL_AUTHORITY_INFO_ACCESS_free(
1302 WOLF_STACK_OF(WOLFSSL_ACCESS_DESCRIPTION)* sk);
1303WOLFSSL_API WOLFSSL_ACCESS_DESCRIPTION* wolfSSL_sk_ACCESS_DESCRIPTION_value(
1304 WOLFSSL_STACK* sk, int idx);
1305WOLFSSL_API void wolfSSL_sk_ACCESS_DESCRIPTION_free(WOLFSSL_STACK* sk);
1306WOLFSSL_API void wolfSSL_sk_ACCESS_DESCRIPTION_pop_free(WOLFSSL_STACK* sk,
1307 void (*f) (WOLFSSL_ACCESS_DESCRIPTION*));
1308WOLFSSL_API void wolfSSL_ACCESS_DESCRIPTION_free(WOLFSSL_ACCESS_DESCRIPTION* access);
1309WOLFSSL_API void wolfSSL_sk_X509_EXTENSION_pop_free(
1310 WOLF_STACK_OF(WOLFSSL_X509_EXTENSION)* sk,
1311 void (*f) (WOLFSSL_X509_EXTENSION*));
1312WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509_EXTENSION)* wolfSSL_sk_X509_EXTENSION_new_null(void);
1313WOLFSSL_API WOLFSSL_ASN1_OBJECT* wolfSSL_ASN1_OBJECT_new(void);
1314WOLFSSL_API WOLFSSL_ASN1_OBJECT* wolfSSL_ASN1_OBJECT_dup(WOLFSSL_ASN1_OBJECT* obj);
1315WOLFSSL_API void wolfSSL_ASN1_OBJECT_free(WOLFSSL_ASN1_OBJECT* obj);
1316WOLFSSL_API WOLFSSL_STACK* wolfSSL_sk_new_asn1_obj(void);
1317WOLFSSL_API int wolfSSL_sk_ASN1_OBJECT_push(WOLF_STACK_OF(WOLFSSL_ASN1_OBJEXT)* sk,
1318 WOLFSSL_ASN1_OBJECT* obj);
1319WOLFSSL_API WOLFSSL_ASN1_OBJECT* wolfSSL_sk_ASN1_OBJECT_pop(
1320 WOLF_STACK_OF(WOLFSSL_ASN1_OBJECT)* sk);
1321WOLFSSL_API void wolfSSL_sk_ASN1_OBJECT_free(WOLF_STACK_OF(WOLFSSL_ASN1_OBJECT)* sk);
1322WOLFSSL_API void wolfSSL_sk_ASN1_OBJECT_pop_free(
1323 WOLF_STACK_OF(WOLFSSL_ASN1_OBJECT)* sk,
1324 void (*f)(WOLFSSL_ASN1_OBJECT*));
1325WOLFSSL_API int wolfSSL_ASN1_STRING_to_UTF8(unsigned char **out, WOLFSSL_ASN1_STRING *in);
1326WOLFSSL_API int wolfSSL_ASN1_UNIVERSALSTRING_to_string(WOLFSSL_ASN1_STRING *s);
1327WOLFSSL_API int wolfSSL_sk_X509_EXTENSION_num(WOLF_STACK_OF(WOLFSSL_X509_EXTENSION)* sk);
1328WOLFSSL_API WOLFSSL_X509_EXTENSION* wolfSSL_sk_X509_EXTENSION_value(
1329 WOLF_STACK_OF(WOLFSSL_X509_EXTENSION)* sk, int idx);
1330WOLFSSL_API int wolfSSL_set_ex_data(WOLFSSL*, int, void*);
1331#ifdef HAVE_EX_DATA_CLEANUP_HOOKS
1332WOLFSSL_API int wolfSSL_set_ex_data_with_cleanup(
1333 WOLFSSL* ssl,
1334 int idx,
1335 void* data,
1336 wolfSSL_ex_data_cleanup_routine_t cleanup_routine);
1337#endif
1338WOLFSSL_API int wolfSSL_get_shutdown(const WOLFSSL*);
1339WOLFSSL_API int wolfSSL_set_rfd(WOLFSSL*, int);
1340WOLFSSL_API int wolfSSL_set_wfd(WOLFSSL*, int);
1341WOLFSSL_API void wolfSSL_set_shutdown(WOLFSSL*, int);
1342WOLFSSL_API int wolfSSL_set_session_id_context(WOLFSSL*, const unsigned char*,
1343 unsigned int);
1344WOLFSSL_API void wolfSSL_set_connect_state(WOLFSSL*);
1345WOLFSSL_API void wolfSSL_set_accept_state(WOLFSSL*);
1346WOLFSSL_API int wolfSSL_session_reused(WOLFSSL*);
1347WOLFSSL_API int wolfSSL_SESSION_up_ref(WOLFSSL_SESSION* session);
1348WOLFSSL_API WOLFSSL_SESSION* wolfSSL_SESSION_dup(WOLFSSL_SESSION* session);
1349WOLFSSL_API WOLFSSL_SESSION* wolfSSL_SESSION_new(void);
1350WOLFSSL_API void wolfSSL_SESSION_free(WOLFSSL_SESSION* session);
1351WOLFSSL_API int wolfSSL_SESSION_set_cipher(WOLFSSL_SESSION* session,
1352 const WOLFSSL_CIPHER* cipher);
1353WOLFSSL_API int wolfSSL_is_init_finished(WOLFSSL*);
1354
1355WOLFSSL_API const char* wolfSSL_get_version(const WOLFSSL*);
1356WOLFSSL_API int wolfSSL_get_current_cipher_suite(WOLFSSL* ssl);
1357WOLFSSL_API WOLFSSL_CIPHER* wolfSSL_get_current_cipher(WOLFSSL*);
1358WOLFSSL_API char* wolfSSL_CIPHER_description(const WOLFSSL_CIPHER*, char*, int);
1359WOLFSSL_API const char* wolfSSL_CIPHER_get_name(const WOLFSSL_CIPHER* cipher);
1360WOLFSSL_API const char* wolfSSL_CIPHER_get_version(const WOLFSSL_CIPHER* cipher);
1361WOLFSSL_API word32 wolfSSL_CIPHER_get_id(const WOLFSSL_CIPHER* cipher);
1362WOLFSSL_API const WOLFSSL_CIPHER* wolfSSL_get_cipher_by_value(word16 value);
1363WOLFSSL_API const char* wolfSSL_SESSION_CIPHER_get_name(WOLFSSL_SESSION* session);
1364WOLFSSL_API const char* wolfSSL_get_cipher(WOLFSSL*);
1365WOLFSSL_API void wolfSSL_sk_CIPHER_free(WOLF_STACK_OF(WOLFSSL_CIPHER)* sk);
1366WOLFSSL_API WOLFSSL_SESSION* wolfSSL_get1_session(WOLFSSL* ssl);
1367 /* what's ref count */
1368
1369WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_new(void);
1370#if defined(OPENSSL_EXTRA_X509_SMALL) || defined(OPENSSL_ALL)
1371WOLFSSL_API int wolfSSL_RSA_up_ref(WOLFSSL_RSA* rsa);
1372WOLFSSL_API int wolfSSL_X509_up_ref(WOLFSSL_X509* x509);
1373WOLFSSL_API int wolfSSL_EVP_PKEY_up_ref(WOLFSSL_EVP_PKEY* pkey);
1374#endif
1375
1376WOLFSSL_API int wolfSSL_OCSP_parse_url(char* url, char** host, char** port,
1377 char** path, int* ssl);
1378
1379WOLFSSL_API WOLFSSL_METHOD* wolfSSLv23_client_method(void);
1380WOLFSSL_API WOLFSSL_METHOD* wolfSSLv2_client_method(void);
1381WOLFSSL_API WOLFSSL_METHOD* wolfSSLv2_server_method(void);
1382
1383#if defined(OPENSSL_VERSION_NUMBER) && OPENSSL_VERSION_NUMBER >= 0x10100000L
1384WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new(const WOLFSSL_BIO_METHOD*);
1385#else
1386WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new(WOLFSSL_BIO_METHOD*);
1387#endif
1388WOLFSSL_API int wolfSSL_BIO_free(WOLFSSL_BIO*);
1389WOLFSSL_API void wolfSSL_BIO_vfree(WOLFSSL_BIO*);
1390WOLFSSL_API void wolfSSL_BIO_free_all(WOLFSSL_BIO*);
1391WOLFSSL_API int wolfSSL_BIO_gets(WOLFSSL_BIO* bio, char* buf, int sz);
1392WOLFSSL_API int wolfSSL_BIO_puts(WOLFSSL_BIO* bio, const char* buf);
1393WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_next(WOLFSSL_BIO* bio);
1394WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_find_type(WOLFSSL_BIO* bio, int type);
1395WOLFSSL_API int wolfSSL_BIO_read(WOLFSSL_BIO*, void*, int);
1396WOLFSSL_API int wolfSSL_BIO_write(WOLFSSL_BIO*, const void*, int);
1397WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_push(WOLFSSL_BIO*, WOLFSSL_BIO* append);
1398WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_pop(WOLFSSL_BIO*);
1399WOLFSSL_API int wolfSSL_BIO_flush(WOLFSSL_BIO*);
1400WOLFSSL_API int wolfSSL_BIO_pending(WOLFSSL_BIO*);
1401WOLFSSL_API void wolfSSL_BIO_set_callback(WOLFSSL_BIO *bio,
1402 wolf_bio_info_cb callback_func);
1403WOLFSSL_API wolf_bio_info_cb wolfSSL_BIO_get_callback(WOLFSSL_BIO *bio);
1404WOLFSSL_API void wolfSSL_BIO_set_callback_arg(WOLFSSL_BIO *bio, char *arg);
1405WOLFSSL_API char* wolfSSL_BIO_get_callback_arg(const WOLFSSL_BIO *bio);
1406
1407WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_md(void);
1408WOLFSSL_API int wolfSSL_BIO_get_md_ctx(WOLFSSL_BIO *bio,
1409 WOLFSSL_EVP_MD_CTX **mdcp);
1410
1411WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_buffer(void);
1412WOLFSSL_API long wolfSSL_BIO_set_write_buffer_size(WOLFSSL_BIO*, long size);
1413WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_ssl(void);
1414WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new_socket(int sfd, int flag);
1415WOLFSSL_API int wolfSSL_BIO_eof(WOLFSSL_BIO*);
1416
1417WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_s_mem(void);
1418WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_base64(void);
1419WOLFSSL_API void wolfSSL_BIO_set_flags(WOLFSSL_BIO*, int);
1420WOLFSSL_API void wolfSSL_BIO_clear_flags(WOLFSSL_BIO *bio, int flags);
1421WOLFSSL_API int wolfSSL_BIO_set_ex_data(WOLFSSL_BIO *bio, int idx, void *data);
1422#ifdef HAVE_EX_DATA_CLEANUP_HOOKS
1423WOLFSSL_API int wolfSSL_BIO_set_ex_data_with_cleanup(
1424 WOLFSSL_BIO *bio,
1425 int idx,
1426 void *data,
1427 wolfSSL_ex_data_cleanup_routine_t cleanup_routine);
1428#endif
1429WOLFSSL_API void *wolfSSL_BIO_get_ex_data(WOLFSSL_BIO *bio, int idx);
1430WOLFSSL_API long wolfSSL_BIO_set_nbio(WOLFSSL_BIO*, long);
1431
1432WOLFSSL_API int wolfSSL_BIO_get_mem_data(WOLFSSL_BIO* bio,void* p);
1433
1434WOLFSSL_API void wolfSSL_BIO_set_init(WOLFSSL_BIO*, int);
1435WOLFSSL_API void wolfSSL_BIO_set_data(WOLFSSL_BIO*, void*);
1436WOLFSSL_API void* wolfSSL_BIO_get_data(WOLFSSL_BIO*);
1437WOLFSSL_API void wolfSSL_BIO_set_shutdown(WOLFSSL_BIO*, int);
1438WOLFSSL_API int wolfSSL_BIO_get_shutdown(WOLFSSL_BIO*);
1439WOLFSSL_API void wolfSSL_BIO_clear_retry_flags(WOLFSSL_BIO*);
1440WOLFSSL_API int wolfSSL_BIO_should_retry(WOLFSSL_BIO *bio);
1441
1442WOLFSSL_API WOLFSSL_BIO_METHOD *wolfSSL_BIO_meth_new(int, const char*);
1443WOLFSSL_API void wolfSSL_BIO_meth_free(WOLFSSL_BIO_METHOD*);
1444WOLFSSL_API int wolfSSL_BIO_meth_set_write(WOLFSSL_BIO_METHOD*, wolfSSL_BIO_meth_write_cb);
1445WOLFSSL_API int wolfSSL_BIO_meth_set_read(WOLFSSL_BIO_METHOD*, wolfSSL_BIO_meth_read_cb);
1446WOLFSSL_API int wolfSSL_BIO_meth_set_puts(WOLFSSL_BIO_METHOD*, wolfSSL_BIO_meth_puts_cb);
1447WOLFSSL_API int wolfSSL_BIO_meth_set_gets(WOLFSSL_BIO_METHOD*, wolfSSL_BIO_meth_gets_cb);
1448WOLFSSL_API int wolfSSL_BIO_meth_set_ctrl(WOLFSSL_BIO_METHOD*, wolfSSL_BIO_meth_ctrl_get_cb);
1449WOLFSSL_API int wolfSSL_BIO_meth_set_create(WOLFSSL_BIO_METHOD*, wolfSSL_BIO_meth_create_cb);
1450WOLFSSL_API int wolfSSL_BIO_meth_set_destroy(WOLFSSL_BIO_METHOD*, wolfSSL_BIO_meth_destroy_cb);
1451WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new_mem_buf(const void* buf, int len);
1452
1453WOLFSSL_API long wolfSSL_BIO_set_ssl(WOLFSSL_BIO*, WOLFSSL*, int flag);
1454#ifndef NO_FILESYSTEM
1455WOLFSSL_API long wolfSSL_BIO_set_fd(WOLFSSL_BIO* b, int fd, int flag);
1456#endif
1457WOLFSSL_API int wolfSSL_BIO_set_close(WOLFSSL_BIO *b, long flag);
1458WOLFSSL_API void wolfSSL_set_bio(WOLFSSL*, WOLFSSL_BIO* rd, WOLFSSL_BIO* wr);
1459
1460#ifndef NO_FILESYSTEM
1461WOLFSSL_API WOLFSSL_BIO_METHOD *wolfSSL_BIO_s_file(void);
1462WOLFSSL_API WOLFSSL_BIO *wolfSSL_BIO_new_fd(int fd, int close_flag);
1463#endif
1464
1465WOLFSSL_API WOLFSSL_BIO_METHOD *wolfSSL_BIO_s_bio(void);
1466WOLFSSL_API WOLFSSL_BIO_METHOD *wolfSSL_BIO_s_socket(void);
1467
1468WOLFSSL_API WOLFSSL_BIO *wolfSSL_BIO_new_connect(const char *str);
1469WOLFSSL_API long wolfSSL_BIO_set_conn_port(WOLFSSL_BIO *b, char* port);
1470WOLFSSL_API long wolfSSL_BIO_do_connect(WOLFSSL_BIO *b);
1471
1472WOLFSSL_API long wolfSSL_BIO_do_handshake(WOLFSSL_BIO *b);
1473
1474WOLFSSL_API long wolfSSL_BIO_ctrl(WOLFSSL_BIO *bp, int cmd, long larg, void *parg);
1475WOLFSSL_API long wolfSSL_BIO_int_ctrl(WOLFSSL_BIO *bp, int cmd, long larg, int iarg);
1476
1477WOLFSSL_API int wolfSSL_BIO_set_write_buf_size(WOLFSSL_BIO *b, long size);
1478WOLFSSL_API int wolfSSL_BIO_make_bio_pair(WOLFSSL_BIO *b1, WOLFSSL_BIO *b2);
1479WOLFSSL_API int wolfSSL_BIO_ctrl_reset_read_request(WOLFSSL_BIO *b);
1480WOLFSSL_API int wolfSSL_BIO_nread0(WOLFSSL_BIO *bio, char **buf);
1481WOLFSSL_API int wolfSSL_BIO_nread(WOLFSSL_BIO *bio, char **buf, int num);
1482WOLFSSL_API int wolfSSL_BIO_nwrite(WOLFSSL_BIO *bio, char **buf, int num);
1483WOLFSSL_API int wolfSSL_BIO_reset(WOLFSSL_BIO *bio);
1484
1485WOLFSSL_API int wolfSSL_BIO_seek(WOLFSSL_BIO *bio, int ofs);
1486WOLFSSL_API int wolfSSL_BIO_tell(WOLFSSL_BIO* bio);
1487WOLFSSL_API int wolfSSL_BIO_write_filename(WOLFSSL_BIO *bio, char *name);
1488WOLFSSL_API long wolfSSL_BIO_set_mem_eof_return(WOLFSSL_BIO *bio, int v);
1489WOLFSSL_API long wolfSSL_BIO_get_mem_ptr(WOLFSSL_BIO *bio, WOLFSSL_BUF_MEM **m);
1490WOLFSSL_API int wolfSSL_BIO_get_len(WOLFSSL_BIO *bio);
1491
1492WOLFSSL_API void wolfSSL_RAND_screen(void);
1493WOLFSSL_API const char* wolfSSL_RAND_file_name(char*, unsigned long);
1494WOLFSSL_API int wolfSSL_RAND_write_file(const char*);
1495WOLFSSL_API int wolfSSL_RAND_load_file(const char*, long);
1496WOLFSSL_API int wolfSSL_RAND_egd(const char*);
1497WOLFSSL_API int wolfSSL_RAND_seed(const void*, int);
1498WOLFSSL_API void wolfSSL_RAND_Cleanup(void);
1499WOLFSSL_API void wolfSSL_RAND_add(const void*, int, double);
1500WOLFSSL_API int wolfSSL_RAND_poll(void);
1501
1502WOLFSSL_API WOLFSSL_COMP_METHOD* wolfSSL_COMP_zlib(void);
1503WOLFSSL_API WOLFSSL_COMP_METHOD* wolfSSL_COMP_rle(void);
1504WOLFSSL_API int wolfSSL_COMP_add_compression_method(int, void*);
1505
1506WOLFSSL_API unsigned long wolfSSL_thread_id(void);
1507WOLFSSL_API void wolfSSL_set_id_callback(unsigned long (*f)(void));
1508WOLFSSL_API void wolfSSL_set_locking_callback(void (*f)(int, int, const char*,
1509 int));
1510WOLFSSL_API void wolfSSL_set_dynlock_create_callback(WOLFSSL_dynlock_value* (*f)
1511 (const char*, int));
1512WOLFSSL_API void wolfSSL_set_dynlock_lock_callback(void (*f)(int,
1513 WOLFSSL_dynlock_value*, const char*, int));
1514WOLFSSL_API void wolfSSL_set_dynlock_destroy_callback(void (*f)
1515 (WOLFSSL_dynlock_value*, const char*, int));
1516WOLFSSL_API int wolfSSL_num_locks(void);
1517
1518WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_STORE_CTX_get_current_cert(
1519 WOLFSSL_X509_STORE_CTX*);
1520WOLFSSL_API int wolfSSL_X509_STORE_CTX_get_error(WOLFSSL_X509_STORE_CTX*);
1521WOLFSSL_API int wolfSSL_X509_STORE_CTX_get_error_depth(WOLFSSL_X509_STORE_CTX*);
1522
1523WOLFSSL_API void wolfSSL_X509_STORE_CTX_set_verify_cb(WOLFSSL_X509_STORE_CTX *ctx,
1524 WOLFSSL_X509_STORE_CTX_verify_cb verify_cb);
1525WOLFSSL_API void wolfSSL_X509_STORE_set_verify_cb(WOLFSSL_X509_STORE *st,
1526 WOLFSSL_X509_STORE_CTX_verify_cb verify_cb);
1527WOLFSSL_API int wolfSSL_i2d_X509_NAME(WOLFSSL_X509_NAME* n,
1528 unsigned char** out);
1529WOLFSSL_API int wolfSSL_i2d_X509_NAME_canon(WOLFSSL_X509_NAME* name,
1530 unsigned char** out);
1531WOLFSSL_API WOLFSSL_X509_NAME *wolfSSL_d2i_X509_NAME(WOLFSSL_X509_NAME **name,
1532 unsigned char **in, long length);
1533#ifndef NO_RSA
1534WOLFSSL_API int wolfSSL_RSA_print(WOLFSSL_BIO* bio, WOLFSSL_RSA* rsa, int offset);
1535#endif
1536WOLFSSL_API int wolfSSL_X509_print_ex(WOLFSSL_BIO* bio, WOLFSSL_X509* x509,
1537 unsigned long nmflags, unsigned long cflag);
1538#ifndef NO_FILESYSTEM
1539WOLFSSL_API int wolfSSL_X509_print_fp(XFILE fp, WOLFSSL_X509 *x509);
1540#endif
1541WOLFSSL_API int wolfSSL_X509_signature_print(WOLFSSL_BIO *bp,
1542 const WOLFSSL_X509_ALGOR *sigalg, const WOLFSSL_ASN1_STRING *sig);
1543WOLFSSL_API void wolfSSL_X509_get0_signature(const WOLFSSL_ASN1_BIT_STRING **psig,
1544 const WOLFSSL_X509_ALGOR **palg, const WOLFSSL_X509 *x509);
1545WOLFSSL_API int wolfSSL_X509_print(WOLFSSL_BIO* bio, WOLFSSL_X509* x509);
1546WOLFSSL_ABI WOLFSSL_API char* wolfSSL_X509_NAME_oneline(WOLFSSL_X509_NAME*,
1547 char*, int);
1548#if defined(OPENSSL_EXTRA) && defined(XSNPRINTF)
1549WOLFSSL_API char* wolfSSL_X509_get_name_oneline(WOLFSSL_X509_NAME*, char*, int);
1550#endif
1551WOLFSSL_ABI WOLFSSL_API WOLFSSL_X509_NAME* wolfSSL_X509_get_issuer_name(
1552 WOLFSSL_X509*);
1553WOLFSSL_API unsigned long wolfSSL_X509_issuer_name_hash(const WOLFSSL_X509* x509);
1554WOLFSSL_ABI WOLFSSL_API WOLFSSL_X509_NAME* wolfSSL_X509_get_subject_name(
1555 WOLFSSL_X509*);
1556WOLFSSL_API unsigned long wolfSSL_X509_subject_name_hash(const WOLFSSL_X509* x509);
1557WOLFSSL_API int wolfSSL_X509_ext_isSet_by_NID(WOLFSSL_X509*, int);
1558WOLFSSL_API int wolfSSL_X509_ext_get_critical_by_NID(WOLFSSL_X509*, int);
1559WOLFSSL_API int wolfSSL_X509_get_isCA(WOLFSSL_X509*);
1560WOLFSSL_API int wolfSSL_X509_get_isSet_pathLength(WOLFSSL_X509*);
1561WOLFSSL_API unsigned int wolfSSL_X509_get_pathLength(WOLFSSL_X509*);
1562WOLFSSL_API unsigned int wolfSSL_X509_get_keyUsage(WOLFSSL_X509*);
1563WOLFSSL_API unsigned char* wolfSSL_X509_get_authorityKeyID(
1564 WOLFSSL_X509*, unsigned char*, int*);
1565WOLFSSL_API unsigned char* wolfSSL_X509_get_subjectKeyID(
1566 WOLFSSL_X509*, unsigned char*, int*);
1567
1568WOLFSSL_API int wolfSSL_X509_verify(WOLFSSL_X509* x509, WOLFSSL_EVP_PKEY* pkey);
1569#ifdef WOLFSSL_CERT_REQ
1570WOLFSSL_API int wolfSSL_X509_REQ_verify(WOLFSSL_X509* x509, WOLFSSL_EVP_PKEY* pkey);
1571#endif
1572WOLFSSL_API int wolfSSL_X509_set_subject_name(WOLFSSL_X509*,
1573 WOLFSSL_X509_NAME*);
1574WOLFSSL_API int wolfSSL_X509_set_issuer_name(WOLFSSL_X509*,
1575 WOLFSSL_X509_NAME*);
1576WOLFSSL_API int wolfSSL_X509_set_pubkey(WOLFSSL_X509*, WOLFSSL_EVP_PKEY*);
1577WOLFSSL_API int wolfSSL_X509_set_notAfter(WOLFSSL_X509* x509,
1578 const WOLFSSL_ASN1_TIME* t);
1579WOLFSSL_API int wolfSSL_X509_set_notBefore(WOLFSSL_X509* x509,
1580 const WOLFSSL_ASN1_TIME* t);
1581WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_X509_get_notBefore(const WOLFSSL_X509* x509);
1582WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_X509_get_notAfter(const WOLFSSL_X509* x509);
1583WOLFSSL_API int wolfSSL_X509_set_serialNumber(WOLFSSL_X509* x509,
1584 WOLFSSL_ASN1_INTEGER* s);
1585WOLFSSL_API int wolfSSL_X509_set_version(WOLFSSL_X509* x509, long v);
1586WOLFSSL_API int wolfSSL_X509_sign(WOLFSSL_X509* x509, WOLFSSL_EVP_PKEY* pkey,
1587 const WOLFSSL_EVP_MD* md);
1588WOLFSSL_API int wolfSSL_X509_sign_ctx(WOLFSSL_X509 *x509, WOLFSSL_EVP_MD_CTX *ctx);
1589
1590
1591WOLFSSL_API int wolfSSL_X509_NAME_entry_count(WOLFSSL_X509_NAME*);
1592WOLFSSL_API int wolfSSL_X509_NAME_get_text_by_NID(
1593 WOLFSSL_X509_NAME*, int, char*, int);
1594WOLFSSL_API int wolfSSL_X509_NAME_get_index_by_NID(
1595 WOLFSSL_X509_NAME*, int, int);
1596WOLFSSL_API WOLFSSL_ASN1_STRING* wolfSSL_X509_NAME_ENTRY_get_data(WOLFSSL_X509_NAME_ENTRY*);
1597
1598WOLFSSL_API WOLFSSL_ASN1_STRING* wolfSSL_ASN1_STRING_new(void);
1599WOLFSSL_API WOLFSSL_ASN1_STRING* wolfSSL_ASN1_STRING_dup(WOLFSSL_ASN1_STRING* asn1);
1600WOLFSSL_API WOLFSSL_ASN1_STRING* wolfSSL_ASN1_STRING_type_new(int type);
1601WOLFSSL_API int wolfSSL_ASN1_STRING_type(const WOLFSSL_ASN1_STRING* asn1);
1602WOLFSSL_API WOLFSSL_ASN1_STRING* wolfSSL_d2i_DISPLAYTEXT(WOLFSSL_ASN1_STRING **asn, const unsigned char **in, long len);
1603WOLFSSL_API int wolfSSL_ASN1_STRING_cmp(const WOLFSSL_ASN1_STRING *a, const WOLFSSL_ASN1_STRING *b);
1604WOLFSSL_API void wolfSSL_ASN1_STRING_free(WOLFSSL_ASN1_STRING* asn1);
1605WOLFSSL_API int wolfSSL_ASN1_STRING_set(WOLFSSL_ASN1_STRING* asn1,
1606 const void* data, int dataSz);
1607WOLFSSL_API unsigned char* wolfSSL_ASN1_STRING_data(WOLFSSL_ASN1_STRING*);
1608WOLFSSL_API const unsigned char* wolfSSL_ASN1_STRING_get0_data(
1609 const WOLFSSL_ASN1_STRING*);
1610WOLFSSL_API int wolfSSL_ASN1_STRING_length(WOLFSSL_ASN1_STRING*);
1611WOLFSSL_API int wolfSSL_ASN1_STRING_copy(WOLFSSL_ASN1_STRING* dst,
1612 const WOLFSSL_ASN1_STRING* src);
1613WOLFSSL_API int wolfSSL_X509_verify_cert(WOLFSSL_X509_STORE_CTX*);
1614WOLFSSL_API const char* wolfSSL_X509_verify_cert_error_string(long);
1615WOLFSSL_API int wolfSSL_X509_get_signature_type(WOLFSSL_X509*);
1616WOLFSSL_API int wolfSSL_X509_get_signature(WOLFSSL_X509*, unsigned char*, int*);
1617WOLFSSL_API int wolfSSL_X509_get_pubkey_buffer(WOLFSSL_X509*, unsigned char*,
1618 int*);
1619WOLFSSL_API int wolfSSL_X509_get_pubkey_type(WOLFSSL_X509* x509);
1620
1621WOLFSSL_API int wolfSSL_X509_LOOKUP_add_dir(WOLFSSL_X509_LOOKUP*,const char*,long);
1622WOLFSSL_API int wolfSSL_X509_LOOKUP_load_file(WOLFSSL_X509_LOOKUP*, const char*,
1623 long);
1624WOLFSSL_API WOLFSSL_X509_LOOKUP_METHOD* wolfSSL_X509_LOOKUP_hash_dir(void);
1625WOLFSSL_API WOLFSSL_X509_LOOKUP_METHOD* wolfSSL_X509_LOOKUP_file(void);
1626WOLFSSL_API int wolfSSL_X509_LOOKUP_ctrl(WOLFSSL_X509_LOOKUP *ctx, int cmd,
1627 const char *argc, long argl, char **ret);
1628
1629WOLFSSL_API WOLFSSL_X509_LOOKUP* wolfSSL_X509_STORE_add_lookup(WOLFSSL_X509_STORE*,
1630 WOLFSSL_X509_LOOKUP_METHOD*);
1631WOLFSSL_API WOLFSSL_X509_STORE* wolfSSL_X509_STORE_new(void);
1632WOLFSSL_API void wolfSSL_X509_STORE_free(WOLFSSL_X509_STORE*);
1633WOLFSSL_API int wolfSSL_X509_STORE_add_cert(
1634 WOLFSSL_X509_STORE*, WOLFSSL_X509*);
1635WOLFSSL_API WOLFSSL_STACK* wolfSSL_X509_STORE_CTX_get_chain(
1636 WOLFSSL_X509_STORE_CTX* ctx);
1637WOLFSSL_API WOLFSSL_STACK* wolfSSL_X509_STORE_CTX_get1_chain(
1638 WOLFSSL_X509_STORE_CTX* ctx);
1639WOLFSSL_API WOLFSSL_X509_STORE_CTX *wolfSSL_X509_STORE_CTX_get0_parent_ctx(
1640 WOLFSSL_X509_STORE_CTX *ctx);
1641WOLFSSL_API int wolfSSL_X509_STORE_set_flags(WOLFSSL_X509_STORE* store,
1642 unsigned long flag);
1643WOLFSSL_API int wolfSSL_X509_STORE_set_default_paths(WOLFSSL_X509_STORE*);
1644WOLFSSL_API int wolfSSL_X509_STORE_get_by_subject(WOLFSSL_X509_STORE_CTX*,
1645 int, WOLFSSL_X509_NAME*, WOLFSSL_X509_OBJECT*);
1646WOLFSSL_API WOLFSSL_X509_STORE_CTX* wolfSSL_X509_STORE_CTX_new(void);
1647WOLFSSL_API int wolfSSL_X509_STORE_CTX_init(WOLFSSL_X509_STORE_CTX*,
1648 WOLFSSL_X509_STORE*, WOLFSSL_X509*, WOLF_STACK_OF(WOLFSSL_X509)*);
1649WOLFSSL_API void wolfSSL_X509_STORE_CTX_free(WOLFSSL_X509_STORE_CTX*);
1650WOLFSSL_API void wolfSSL_X509_STORE_CTX_cleanup(WOLFSSL_X509_STORE_CTX*);
1651WOLFSSL_API void wolfSSL_X509_STORE_CTX_trusted_stack(WOLFSSL_X509_STORE_CTX *ctx,
1652 WOLF_STACK_OF(WOLFSSL_X509) *sk);
1653
1654WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_X509_CRL_get_lastUpdate(WOLFSSL_X509_CRL*);
1655WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_X509_CRL_get_nextUpdate(WOLFSSL_X509_CRL*);
1656WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_X509_gmtime_adj(WOLFSSL_ASN1_TIME *s, long adj);
1657
1658WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_X509_get_pubkey(WOLFSSL_X509*);
1659WOLFSSL_API int wolfSSL_X509_CRL_verify(WOLFSSL_X509_CRL*, WOLFSSL_EVP_PKEY*);
1660WOLFSSL_API void wolfSSL_X509_OBJECT_free_contents(WOLFSSL_X509_OBJECT*);
1661WOLFSSL_API WOLFSSL_PKCS8_PRIV_KEY_INFO* wolfSSL_d2i_PKCS8_PKEY_bio(
1662 WOLFSSL_BIO* bio, WOLFSSL_PKCS8_PRIV_KEY_INFO** pkey);
1663WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_d2i_PUBKEY_bio(WOLFSSL_BIO* bio,
1664 WOLFSSL_EVP_PKEY** out);
1665WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_d2i_PUBKEY(WOLFSSL_EVP_PKEY** key,
1666 const unsigned char** in, long inSz);
1667WOLFSSL_API int wolfSSL_i2d_PUBKEY(const WOLFSSL_EVP_PKEY *key, unsigned char **der);
1668WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_d2i_PrivateKey(int type,
1669 WOLFSSL_EVP_PKEY** out, const unsigned char **in, long inSz);
1670WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_d2i_PrivateKey_EVP(WOLFSSL_EVP_PKEY** key,
1671 unsigned char** in, long inSz);
1672WOLFSSL_API int wolfSSL_i2d_PrivateKey(const WOLFSSL_EVP_PKEY* key,
1673 unsigned char** der);
1674#if defined(OPENSSL_EXTRA)
1675WOLFSSL_API int wolfSSL_EVP_PKEY_print_public(WOLFSSL_BIO* out,
1676 const WOLFSSL_EVP_PKEY* pkey,
1677 int indent, WOLFSSL_ASN1_PCTX* pctx);
1678#endif /* OPENSSL_EXTRA */
1679WOLFSSL_API int wolfSSL_X509_cmp_current_time(const WOLFSSL_ASN1_TIME*);
1680#ifdef OPENSSL_EXTRA
1681WOLFSSL_API int wolfSSL_X509_cmp_time(const WOLFSSL_ASN1_TIME* asnTime,
1682 time_t *cmpTime);
1683WOLFSSL_API WOLFSSL_ASN1_TIME *wolfSSL_X509_time_adj_ex(WOLFSSL_ASN1_TIME *asnTime,
1684 int offset_day, long offset_sec, time_t *in_tm);
1685WOLFSSL_API WOLFSSL_ASN1_TIME *wolfSSL_X509_time_adj(WOLFSSL_ASN1_TIME *asnTime,
1686 long offset_sec, time_t *in_tm);
1687WOLFSSL_API int wolfSSL_sk_X509_REVOKED_num(WOLFSSL_X509_REVOKED*);
1688WOLFSSL_API void wolfSSL_X509_STORE_CTX_set_time(WOLFSSL_X509_STORE_CTX*,
1689 unsigned long flags,
1690 time_t t);
1691WOLFSSL_API WOLFSSL_X509_VERIFY_PARAM* wolfSSL_X509_VERIFY_PARAM_new(void);
1692WOLFSSL_API void wolfSSL_X509_VERIFY_PARAM_free(WOLFSSL_X509_VERIFY_PARAM *param);
1693WOLFSSL_API int wolfSSL_X509_VERIFY_PARAM_set_flags(WOLFSSL_X509_VERIFY_PARAM *param,
1694 unsigned long flags);
1695WOLFSSL_API int wolfSSL_X509_VERIFY_PARAM_get_flags(WOLFSSL_X509_VERIFY_PARAM *param);
1696WOLFSSL_API int wolfSSL_X509_VERIFY_PARAM_clear_flags(WOLFSSL_X509_VERIFY_PARAM *param,
1697 unsigned long flags);
1698WOLFSSL_API void wolfSSL_X509_VERIFY_PARAM_set_hostflags(
1699 WOLFSSL_X509_VERIFY_PARAM* param, unsigned int flags);
1700WOLFSSL_API int wolfSSL_X509_VERIFY_PARAM_set1_host(WOLFSSL_X509_VERIFY_PARAM* pParam,
1701 const char* name,
1702 unsigned int nameSz);
1703WOLFSSL_API int wolfSSL_X509_VERIFY_PARAM_set1_ip_asc(
1704 WOLFSSL_X509_VERIFY_PARAM *param, const char *ipasc);
1705WOLFSSL_API int wolfSSL_X509_VERIFY_PARAM_set1(WOLFSSL_X509_VERIFY_PARAM* to,
1706 const WOLFSSL_X509_VERIFY_PARAM* from);
1707WOLFSSL_API int wolfSSL_X509_load_crl_file(WOLFSSL_X509_LOOKUP *ctx,
1708 const char *file, int type);
1709WOLFSSL_API int wolfSSL_X509_load_cert_crl_file(WOLFSSL_X509_LOOKUP *ctx,
1710 const char *file, int type);
1711#endif
1712WOLFSSL_API WOLFSSL_X509_REVOKED* wolfSSL_X509_CRL_get_REVOKED(WOLFSSL_X509_CRL*);
1713WOLFSSL_API WOLFSSL_X509_REVOKED* wolfSSL_sk_X509_REVOKED_value(
1714 WOLFSSL_X509_REVOKED*,int);
1715WOLFSSL_API WOLFSSL_ASN1_INTEGER* wolfSSL_X509_get_serialNumber(WOLFSSL_X509*);
1716WOLFSSL_API void wolfSSL_ASN1_INTEGER_free(WOLFSSL_ASN1_INTEGER*);
1717WOLFSSL_API WOLFSSL_ASN1_INTEGER* wolfSSL_ASN1_INTEGER_new(void);
1718WOLFSSL_API WOLFSSL_ASN1_INTEGER* wolfSSL_ASN1_INTEGER_dup(
1719 const WOLFSSL_ASN1_INTEGER* src);
1720WOLFSSL_API int wolfSSL_ASN1_INTEGER_set(WOLFSSL_ASN1_INTEGER *a, long v);
1721
1722WOLFSSL_API int wolfSSL_ASN1_TIME_print(WOLFSSL_BIO*, const WOLFSSL_ASN1_TIME*);
1723
1724WOLFSSL_API char* wolfSSL_ASN1_TIME_to_string(WOLFSSL_ASN1_TIME* t,
1725 char* buf, int len);
1726WOLFSSL_API int wolfSSL_ASN1_INTEGER_cmp(const WOLFSSL_ASN1_INTEGER*,
1727 const WOLFSSL_ASN1_INTEGER*);
1728WOLFSSL_API long wolfSSL_ASN1_INTEGER_get(const WOLFSSL_ASN1_INTEGER*);
1729
1730#ifdef OPENSSL_EXTRA
1731WOLFSSL_API WOLFSSL_BIGNUM *wolfSSL_ASN1_INTEGER_to_BN(const WOLFSSL_ASN1_INTEGER *ai,
1732 WOLFSSL_BIGNUM *bn);
1733WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_ASN1_TIME_adj(WOLFSSL_ASN1_TIME*, time_t,
1734 int, long);
1735WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_ASN1_TIME_new(void);
1736WOLFSSL_API void wolfSSL_ASN1_TIME_free(WOLFSSL_ASN1_TIME* t);
1737#endif
1738
1739WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509_NAME)* wolfSSL_load_client_CA_file(const char*);
1740WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509_NAME)* wolfSSL_CTX_get_client_CA_list(
1741 const WOLFSSL_CTX *s);
1742/* deprecated function name */
1743#define wolfSSL_SSL_CTX_get_client_CA_list wolfSSL_CTX_get_client_CA_list
1744
1745WOLFSSL_API void wolfSSL_CTX_set_client_CA_list(WOLFSSL_CTX*,
1746 WOLF_STACK_OF(WOLFSSL_X509_NAME)*);
1747WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509_NAME)* wolfSSL_get_client_CA_list(
1748 const WOLFSSL* ssl);
1749
1750typedef int (*client_cert_cb)(WOLFSSL *ssl, WOLFSSL_X509 **x509,
1751 WOLFSSL_EVP_PKEY **pkey);
1752WOLFSSL_API void wolfSSL_CTX_set_client_cert_cb(WOLFSSL_CTX *ctx, client_cert_cb);
1753
1754WOLFSSL_API void* wolfSSL_X509_STORE_CTX_get_ex_data(
1755 WOLFSSL_X509_STORE_CTX* ctx, int idx);
1756WOLFSSL_API int wolfSSL_X509_STORE_CTX_set_ex_data(WOLFSSL_X509_STORE_CTX* ctx,
1757 int idx, void *data);
1758#ifdef HAVE_EX_DATA_CLEANUP_HOOKS
1759WOLFSSL_API int wolfSSL_X509_STORE_CTX_set_ex_data_with_cleanup(
1760 WOLFSSL_X509_STORE_CTX* ctx,
1761 int idx,
1762 void *data,
1763 wolfSSL_ex_data_cleanup_routine_t cleanup_routine);
1764#endif
1765WOLFSSL_API void* wolfSSL_X509_STORE_get_ex_data(
1766 WOLFSSL_X509_STORE* store, int idx);
1767WOLFSSL_API int wolfSSL_X509_STORE_set_ex_data(WOLFSSL_X509_STORE* store,
1768 int idx, void *data);
1769#ifdef HAVE_EX_DATA_CLEANUP_HOOKS
1770WOLFSSL_API int wolfSSL_X509_STORE_set_ex_data_with_cleanup(
1771 WOLFSSL_X509_STORE* store,
1772 int idx,
1773 void *data,
1774 wolfSSL_ex_data_cleanup_routine_t cleanup_routine);
1775#endif
1776WOLFSSL_API void wolfSSL_X509_STORE_CTX_set_depth(WOLFSSL_X509_STORE_CTX* ctx,
1777 int depth);
1778WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_STORE_CTX_get0_current_issuer(
1779 WOLFSSL_X509_STORE_CTX* ctx);
1780WOLFSSL_API WOLFSSL_X509_STORE* wolfSSL_X509_STORE_CTX_get0_store(
1781 WOLFSSL_X509_STORE_CTX* ctx);
1782WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_STORE_CTX_get0_cert(
1783 WOLFSSL_X509_STORE_CTX*);
1784WOLFSSL_API int wolfSSL_get_ex_data_X509_STORE_CTX_idx(void);
1785WOLFSSL_API void wolfSSL_X509_STORE_CTX_set_error(
1786 WOLFSSL_X509_STORE_CTX* ctx, int er);
1787void wolfSSL_X509_STORE_CTX_set_error_depth(WOLFSSL_X509_STORE_CTX* ctx,
1788 int depth);
1789WOLFSSL_API void* wolfSSL_get_ex_data(const WOLFSSL*, int);
1790
1791WOLFSSL_API void wolfSSL_CTX_set_default_passwd_cb_userdata(WOLFSSL_CTX*,
1792 void* userdata);
1793WOLFSSL_API void wolfSSL_CTX_set_default_passwd_cb(WOLFSSL_CTX*,
1794 pem_password_cb*);
1795WOLFSSL_API pem_password_cb* wolfSSL_CTX_get_default_passwd_cb(WOLFSSL_CTX *ctx);
1796WOLFSSL_API void *wolfSSL_CTX_get_default_passwd_cb_userdata(WOLFSSL_CTX *ctx);
1797
1798WOLFSSL_API void wolfSSL_CTX_set_info_callback(WOLFSSL_CTX*,
1799 void (*)(const WOLFSSL* ssl, int type, int val));
1800
1801WOLFSSL_API unsigned long wolfSSL_ERR_peek_error(void);
1802WOLFSSL_API int wolfSSL_GET_REASON(int);
1803
1804WOLFSSL_API const char* wolfSSL_alert_type_string_long(int);
1805WOLFSSL_API const char* wolfSSL_alert_desc_string_long(int);
1806WOLFSSL_API const char* wolfSSL_state_string_long(const WOLFSSL*);
1807
1808WOLFSSL_API WOLFSSL_RSA* wolfSSL_RSA_generate_key(int, unsigned long,
1809 void(*)(int, int, void*), void*);
1810WOLFSSL_API WOLFSSL_RSA *wolfSSL_d2i_RSAPublicKey(WOLFSSL_RSA **r,
1811 const unsigned char **pp, long len);
1812WOLFSSL_API WOLFSSL_RSA *wolfSSL_d2i_RSAPrivateKey(WOLFSSL_RSA**,
1813 const unsigned char**, long);
1814WOLFSSL_API int wolfSSL_i2d_RSAPublicKey(WOLFSSL_RSA *r, const unsigned char **pp);
1815WOLFSSL_API int wolfSSL_i2d_RSAPrivateKey(WOLFSSL_RSA *r, unsigned char **pp);
1816WOLFSSL_API void wolfSSL_CTX_set_tmp_rsa_callback(WOLFSSL_CTX *,
1817 WOLFSSL_RSA *(*)(WOLFSSL *, int, int));
1818
1819WOLFSSL_API int wolfSSL_PEM_def_callback(char*, int num, int w, void* key);
1820
1821WOLFSSL_API long wolfSSL_CTX_sess_accept(WOLFSSL_CTX*);
1822WOLFSSL_API long wolfSSL_CTX_sess_connect(WOLFSSL_CTX*);
1823WOLFSSL_API long wolfSSL_CTX_sess_accept_good(WOLFSSL_CTX*);
1824WOLFSSL_API long wolfSSL_CTX_sess_connect_good(WOLFSSL_CTX*);
1825WOLFSSL_API long wolfSSL_CTX_sess_accept_renegotiate(WOLFSSL_CTX*);
1826WOLFSSL_API long wolfSSL_CTX_sess_connect_renegotiate(WOLFSSL_CTX*);
1827WOLFSSL_API long wolfSSL_CTX_sess_hits(WOLFSSL_CTX*);
1828WOLFSSL_API long wolfSSL_CTX_sess_cb_hits(WOLFSSL_CTX*);
1829WOLFSSL_API long wolfSSL_CTX_sess_cache_full(WOLFSSL_CTX*);
1830WOLFSSL_API long wolfSSL_CTX_sess_misses(WOLFSSL_CTX*);
1831WOLFSSL_API long wolfSSL_CTX_sess_timeouts(WOLFSSL_CTX*);
1832WOLFSSL_API long wolfSSL_CTX_sess_number(WOLFSSL_CTX*);
1833
1834WOLFSSL_API long wolfSSL_CTX_add_extra_chain_cert(WOLFSSL_CTX*, WOLFSSL_X509*);
1835WOLFSSL_API long wolfSSL_CTX_sess_set_cache_size(WOLFSSL_CTX*, long);
1836WOLFSSL_API long wolfSSL_CTX_sess_get_cache_size(WOLFSSL_CTX*);
1837
1838WOLFSSL_API long wolfSSL_CTX_get_session_cache_mode(WOLFSSL_CTX*);
1839WOLFSSL_API int wolfSSL_CTX_get_read_ahead(WOLFSSL_CTX*);
1840WOLFSSL_API int wolfSSL_CTX_set_read_ahead(WOLFSSL_CTX*, int v);
1841WOLFSSL_API long wolfSSL_CTX_set_tlsext_status_arg(WOLFSSL_CTX*, void* arg);
1842WOLFSSL_API long wolfSSL_CTX_set_tlsext_opaque_prf_input_callback_arg(
1843 WOLFSSL_CTX*, void* arg);
1844WOLFSSL_API int wolfSSL_CTX_add_client_CA(WOLFSSL_CTX*, WOLFSSL_X509*);
1845WOLFSSL_API int wolfSSL_CTX_set_srp_password(WOLFSSL_CTX*, char*);
1846WOLFSSL_API int wolfSSL_CTX_set_srp_username(WOLFSSL_CTX*, char*);
1847WOLFSSL_API int wolfSSL_CTX_set_srp_strength(WOLFSSL_CTX *ctx, int strength);
1848
1849WOLFSSL_API char* wolfSSL_get_srp_username(WOLFSSL *ssl);
1850
1851WOLFSSL_API long wolfSSL_set_options(WOLFSSL *s, long op);
1852WOLFSSL_API long wolfSSL_get_options(const WOLFSSL *s);
1853WOLFSSL_API long wolfSSL_clear_options(WOLFSSL *s, long op);
1854WOLFSSL_API long wolfSSL_clear_num_renegotiations(WOLFSSL *s);
1855WOLFSSL_API long wolfSSL_total_renegotiations(WOLFSSL *s);
1856WOLFSSL_API long wolfSSL_num_renegotiations(WOLFSSL* s);
1857WOLFSSL_API int wolfSSL_SSL_renegotiate_pending(WOLFSSL *s);
1858WOLFSSL_API long wolfSSL_set_tmp_dh(WOLFSSL *s, WOLFSSL_DH *dh);
1859WOLFSSL_API long wolfSSL_set_tlsext_debug_arg(WOLFSSL *s, void *arg);
1860WOLFSSL_API long wolfSSL_set_tlsext_status_type(WOLFSSL *s, int type);
1861WOLFSSL_API long wolfSSL_set_tlsext_status_exts(WOLFSSL *s, void *arg);
1862WOLFSSL_API long wolfSSL_get_tlsext_status_ids(WOLFSSL *s, void *arg);
1863WOLFSSL_API long wolfSSL_set_tlsext_status_ids(WOLFSSL *s, void *arg);
1864WOLFSSL_API long wolfSSL_get_tlsext_status_ocsp_resp(WOLFSSL *s, unsigned char **resp);
1865WOLFSSL_API long wolfSSL_set_tlsext_status_ocsp_resp(WOLFSSL *s, unsigned char *resp, int len);
1866
1867WOLFSSL_API void wolfSSL_CONF_modules_unload(int all);
1868WOLFSSL_API char* wolfSSL_CONF_get1_default_config_file(void);
1869WOLFSSL_API long wolfSSL_get_tlsext_status_exts(WOLFSSL *s, void *arg);
1870WOLFSSL_API long wolfSSL_get_verify_result(const WOLFSSL *ssl);
1871
1872#define WOLFSSL_DEFAULT_CIPHER_LIST "" /* default all */
1873
1874/* These are bit-masks */
1875enum {
1876 WOLFSSL_OCSP_URL_OVERRIDE = 1,
1877 WOLFSSL_OCSP_NO_NONCE = 2,
1878 WOLFSSL_OCSP_CHECKALL = 4,
1879
1880 WOLFSSL_CRL_CHECKALL = 1,
1881 WOLFSSL_CRL_CHECK = 2,
1882};
1883
1884/* Separated out from other enums because of size */
1885enum {
1886 SSL_OP_MICROSOFT_SESS_ID_BUG = 0x00000001,
1887 SSL_OP_NETSCAPE_CHALLENGE_BUG = 0x00000002,
1888 SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG = 0x00000004,
1889 SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG = 0x00000008,
1890 SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER = 0x00000010,
1891 SSL_OP_MSIE_SSLV2_RSA_PADDING = 0x00000020,
1892 SSL_OP_SSLEAY_080_CLIENT_DH_BUG = 0x00000040,
1893 SSL_OP_TLS_D5_BUG = 0x00000080,
1894 SSL_OP_TLS_BLOCK_PADDING_BUG = 0x00000100,
1895 SSL_OP_TLS_ROLLBACK_BUG = 0x00000200,
1896 SSL_OP_EPHEMERAL_RSA = 0x00000800,
1897 WOLFSSL_OP_NO_SSLv3 = 0x00001000,
1898 WOLFSSL_OP_NO_TLSv1 = 0x00002000,
1899 SSL_OP_PKCS1_CHECK_1 = 0x00004000,
1900 SSL_OP_PKCS1_CHECK_2 = 0x00008000,
1901 SSL_OP_NETSCAPE_CA_DN_BUG = 0x00010000,
1902 SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG = 0x00020000,
1903 SSL_OP_SINGLE_DH_USE = 0x00040000,
1904 SSL_OP_NO_TICKET = 0x00080000,
1905 SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS = 0x00100000,
1906 SSL_OP_NO_QUERY_MTU = 0x00200000,
1907 SSL_OP_COOKIE_EXCHANGE = 0x00400000,
1908 SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION = 0x00800000,
1909 SSL_OP_SINGLE_ECDH_USE = 0x01000000,
1910 SSL_OP_CIPHER_SERVER_PREFERENCE = 0x02000000,
1911 WOLFSSL_OP_NO_TLSv1_1 = 0x04000000,
1912 WOLFSSL_OP_NO_TLSv1_2 = 0x08000000,
1913 SSL_OP_NO_COMPRESSION = 0x10000000,
1914 WOLFSSL_OP_NO_TLSv1_3 = 0x20000000,
1915 WOLFSSL_OP_NO_SSLv2 = 0x40000000,
1916 SSL_OP_ALL =
1917 (SSL_OP_MICROSOFT_SESS_ID_BUG
1918 | SSL_OP_NETSCAPE_CHALLENGE_BUG
1919 | SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG
1920 | SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG
1921 | SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER
1922 | SSL_OP_MSIE_SSLV2_RSA_PADDING
1923 | SSL_OP_SSLEAY_080_CLIENT_DH_BUG
1924 | SSL_OP_TLS_D5_BUG
1925 | SSL_OP_TLS_BLOCK_PADDING_BUG
1926 | SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS
1927 | SSL_OP_TLS_ROLLBACK_BUG),
1928};
1929
1930#if defined(OPENSSL_EXTRA) || defined(OPENSSL_EXTRA_X509_SMALL) || \
1931 defined(HAVE_WEBSERVER)
1932/* for compatibility these must be macros */
1933#define SSL_OP_NO_SSLv2 WOLFSSL_OP_NO_SSLv2
1934#define SSL_OP_NO_SSLv3 WOLFSSL_OP_NO_SSLv3
1935#define SSL_OP_NO_TLSv1 WOLFSSL_OP_NO_TLSv1
1936#define SSL_OP_NO_TLSv1_1 WOLFSSL_OP_NO_TLSv1_1
1937#define SSL_OP_NO_TLSv1_2 WOLFSSL_OP_NO_TLSv1_2
1938#if !(!defined(WOLFSSL_TLS13) && defined(WOLFSSL_APACHE_HTTPD)) /* apache uses this to determine if TLS 1.3 is enabled */
1939#define SSL_OP_NO_TLSv1_3 WOLFSSL_OP_NO_TLSv1_3
1940#endif
1941
1942#define SSL_OP_NO_SSL_MASK (SSL_OP_NO_SSLv3 | SSL_OP_NO_TLSv1 | \
1943 SSL_OP_NO_TLSv1_1 | SSL_OP_NO_TLSv1_2 | SSL_OP_NO_TLSv1_3)
1944
1945#define SSL_NOTHING 1
1946#define SSL_WRITING 2
1947#define SSL_READING 3
1948
1949enum {
1950#ifdef HAVE_OCSP
1951 /* OCSP Flags */
1952 OCSP_NOCERTS = 1,
1953 OCSP_NOINTERN = 2,
1954 OCSP_NOSIGS = 4,
1955 OCSP_NOCHAIN = 8,
1956 OCSP_NOVERIFY = 16,
1957 OCSP_NOEXPLICIT = 32,
1958 OCSP_NOCASIGN = 64,
1959 OCSP_NODELEGATED = 128,
1960 OCSP_NOCHECKS = 256,
1961 OCSP_TRUSTOTHER = 512,
1962 OCSP_RESPID_KEY = 1024,
1963 OCSP_NOTIME = 2048,
1964
1965 /* OCSP Types */
1966 OCSP_CERTID = 2,
1967 OCSP_REQUEST = 4,
1968 OCSP_RESPONSE = 8,
1969 OCSP_BASICRESP = 16,
1970#endif
1971
1972 ASN1_GENERALIZEDTIME = 4,
1973 SSL_MAX_SSL_SESSION_ID_LENGTH = 32,
1974
1975 SSL_ST_CONNECT = 0x1000,
1976 SSL_ST_ACCEPT = 0x2000,
1977 SSL_ST_MASK = 0x0FFF,
1978
1979 SSL_CB_LOOP = 0x01,
1980 SSL_CB_EXIT = 0x02,
1981 SSL_CB_READ = 0x04,
1982 SSL_CB_WRITE = 0x08,
1983 SSL_CB_HANDSHAKE_START = 0x10,
1984 SSL_CB_HANDSHAKE_DONE = 0x20,
1985 SSL_CB_ALERT = 0x4000,
1986 SSL_CB_READ_ALERT = (SSL_CB_ALERT | SSL_CB_READ),
1987 SSL_CB_WRITE_ALERT = (SSL_CB_ALERT | SSL_CB_WRITE),
1988 SSL_CB_ACCEPT_LOOP = (SSL_ST_ACCEPT | SSL_CB_LOOP),
1989 SSL_CB_ACCEPT_EXIT = (SSL_ST_ACCEPT | SSL_CB_EXIT),
1990 SSL_CB_CONNECT_LOOP = (SSL_ST_CONNECT | SSL_CB_LOOP),
1991 SSL_CB_CONNECT_EXIT = (SSL_ST_CONNECT | SSL_CB_EXIT),
1992 SSL_CB_MODE_READ = 1,
1993 SSL_CB_MODE_WRITE = 2,
1994
1995 SSL_MODE_ENABLE_PARTIAL_WRITE = 2,
1996 SSL_MODE_AUTO_RETRY = 3, /* wolfSSL default is to block with blocking io
1997 * and auto retry */
1998 SSL_MODE_RELEASE_BUFFERS = -1, /* For libwebsockets build. No current use. */
1999
2000 BIO_CLOSE = 1,
2001 BIO_NOCLOSE = 0,
2002
2003 X509_FILETYPE_PEM = 8,
2004 X509_LU_X509 = 9,
2005 X509_LU_CRL = 12,
2006
2007 X509_V_OK = 0,
2008 X509_V_ERR_CRL_SIGNATURE_FAILURE = 13,
2009 X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD = 14,
2010 X509_V_ERR_CRL_HAS_EXPIRED = 15,
2011 X509_V_ERR_CERT_REVOKED = 16,
2012 X509_V_ERR_CERT_CHAIN_TOO_LONG = 17,
2013 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT = 18,
2014 X509_V_ERR_CERT_NOT_YET_VALID = 19,
2015 X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD = 20,
2016 X509_V_ERR_CERT_HAS_EXPIRED = 21,
2017 X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD = 22,
2018 X509_V_ERR_CERT_REJECTED = 23,
2019 /* Required for Nginx */
2020 X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT = 24,
2021 X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN = 25,
2022 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY = 26,
2023 X509_V_ERR_CERT_UNTRUSTED = 27,
2024 X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE = 28,
2025 X509_V_ERR_SUBJECT_ISSUER_MISMATCH = 29,
2026 /* additional X509_V_ERR_* enums not used in wolfSSL */
2027 X509_V_ERR_UNABLE_TO_GET_CRL,
2028 X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE,
2029 X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE,
2030 X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY,
2031 X509_V_ERR_CERT_SIGNATURE_FAILURE,
2032 X509_V_ERR_CRL_NOT_YET_VALID,
2033 X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD,
2034 X509_V_ERR_OUT_OF_MEM,
2035 X509_V_ERR_INVALID_CA,
2036 X509_V_ERR_PATH_LENGTH_EXCEEDED,
2037 X509_V_ERR_INVALID_PURPOSE,
2038 X509_V_ERR_AKID_SKID_MISMATCH,
2039 X509_V_ERR_AKID_ISSUER_SERIAL_MISMATCH,
2040 X509_V_ERR_KEYUSAGE_NO_CERTSIGN,
2041 X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER,
2042 X509_V_ERR_UNHANDLED_CRITICAL_EXTENSION,
2043 X509_V_ERR_KEYUSAGE_NO_CRL_SIGN,
2044 X509_V_ERR_UNHANDLED_CRITICAL_CRL_EXTENSION,
2045 X509_V_ERR_INVALID_NON_CA,
2046 X509_V_ERR_PROXY_PATH_LENGTH_EXCEEDED,
2047 X509_V_ERR_KEYUSAGE_NO_DIGITAL_SIGNATURE,
2048 X509_V_ERR_PROXY_CERTIFICATES_NOT_ALLOWED,
2049 X509_V_ERR_INVALID_EXTENSION,
2050 X509_V_ERR_INVALID_POLICY_EXTENSION,
2051 X509_V_ERR_NO_EXPLICIT_POLICY,
2052 X509_V_ERR_UNNESTED_RESOURCE,
2053 X509_V_ERR_APPLICATION_VERIFICATION,
2054
2055 X509_R_CERT_ALREADY_IN_HASH_TABLE,
2056
2057 CRYPTO_LOCK = 1,
2058 CRYPTO_NUM_LOCKS = 10,
2059
2060 ASN1_STRFLGS_ESC_MSB = 4
2061};
2062#endif
2063
2064/* extras end */
2065
2066#if !defined(NO_FILESYSTEM) && !defined(NO_STDIO_FILESYSTEM)
2067/* wolfSSL extension, provide last error from SSL_get_error
2068 since not using thread storage error queue */
2069#ifdef FUSION_RTOS
2070 #include <fclstdio.h>
2071#else
2072 #include <stdio.h>
2073#endif
2074WOLFSSL_API void wolfSSL_ERR_print_errors_fp(XFILE, int err);
2075#if defined(OPENSSL_EXTRA) || defined(DEBUG_WOLFSSL_VERBOSE)
2076WOLFSSL_API void wolfSSL_ERR_dump_errors_fp(XFILE fp);
2077WOLFSSL_API void wolfSSL_ERR_print_errors_cb(int (*cb)(const char *str,
2078 size_t len, void *u), void *u);
2079#endif
2080#endif
2081WOLFSSL_API void wolfSSL_ERR_print_errors(WOLFSSL_BIO *bio);
2082
2083
2084#ifndef NO_OLD_SSL_NAMES
2085 #define SSL_ERROR_NONE WOLFSSL_ERROR_NONE
2086 #define SSL_FAILURE WOLFSSL_FAILURE
2087 #define SSL_SUCCESS WOLFSSL_SUCCESS
2088 #define SSL_SHUTDOWN_NOT_DONE WOLFSSL_SHUTDOWN_NOT_DONE
2089
2090 #define SSL_ALPN_NOT_FOUND WOLFSSL_ALPN_NOT_FOUND
2091 #define SSL_BAD_CERTTYPE WOLFSSL_BAD_CERTTYPE
2092 #define SSL_BAD_STAT WOLFSSL_BAD_STAT
2093 #define SSL_BAD_PATH WOLFSSL_BAD_PATH
2094 #define SSL_BAD_FILETYPE WOLFSSL_BAD_FILETYPE
2095 #define SSL_BAD_FILE WOLFSSL_BAD_FILE
2096 #define SSL_NOT_IMPLEMENTED WOLFSSL_NOT_IMPLEMENTED
2097 #define SSL_UNKNOWN WOLFSSL_UNKNOWN
2098 #define SSL_FATAL_ERROR WOLFSSL_FATAL_ERROR
2099
2100 #define SSL_FILETYPE_ASN1 WOLFSSL_FILETYPE_ASN1
2101 #define SSL_FILETYPE_PEM WOLFSSL_FILETYPE_PEM
2102 #define SSL_FILETYPE_DEFAULT WOLFSSL_FILETYPE_DEFAULT
2103 #define SSL_FILETYPE_RAW WOLFSSL_FILETYPE_RAW
2104
2105 #define SSL_VERIFY_NONE WOLFSSL_VERIFY_NONE
2106 #define SSL_VERIFY_PEER WOLFSSL_VERIFY_PEER
2107 #define SSL_VERIFY_FAIL_IF_NO_PEER_CERT WOLFSSL_VERIFY_FAIL_IF_NO_PEER_CERT
2108 #define SSL_VERIFY_CLIENT_ONCE WOLFSSL_VERIFY_CLIENT_ONCE
2109 #define SSL_VERIFY_FAIL_EXCEPT_PSK WOLFSSL_VERIFY_FAIL_EXCEPT_PSK
2110
2111 #define SSL_SESS_CACHE_OFF WOLFSSL_SESS_CACHE_OFF
2112 #define SSL_SESS_CACHE_CLIENT WOLFSSL_SESS_CACHE_CLIENT
2113 #define SSL_SESS_CACHE_SERVER WOLFSSL_SESS_CACHE_SERVER
2114 #define SSL_SESS_CACHE_BOTH WOLFSSL_SESS_CACHE_BOTH
2115 #define SSL_SESS_CACHE_NO_AUTO_CLEAR WOLFSSL_SESS_CACHE_NO_AUTO_CLEAR
2116 #define SSL_SESS_CACHE_NO_INTERNAL_LOOKUP WOLFSSL_SESS_CACHE_NO_INTERNAL_LOOKUP
2117 #define SSL_SESS_CACHE_NO_INTERNAL_STORE WOLFSSL_SESS_CACHE_NO_INTERNAL_STORE
2118 #define SSL_SESS_CACHE_NO_INTERNAL WOLFSSL_SESS_CACHE_NO_INTERNAL
2119
2120 #define SSL_ERROR_WANT_READ WOLFSSL_ERROR_WANT_READ
2121 #define SSL_ERROR_WANT_WRITE WOLFSSL_ERROR_WANT_WRITE
2122 #define SSL_ERROR_WANT_CONNECT WOLFSSL_ERROR_WANT_CONNECT
2123 #define SSL_ERROR_WANT_ACCEPT WOLFSSL_ERROR_WANT_ACCEPT
2124 #define SSL_ERROR_SYSCALL WOLFSSL_ERROR_SYSCALL
2125 #define SSL_ERROR_WANT_X509_LOOKUP WOLFSSL_ERROR_WANT_X509_LOOKUP
2126 #define SSL_ERROR_ZERO_RETURN WOLFSSL_ERROR_ZERO_RETURN
2127 #define SSL_ERROR_SSL WOLFSSL_ERROR_SSL
2128
2129 #define SSL_SENT_SHUTDOWN WOLFSSL_SENT_SHUTDOWN
2130 #define SSL_RECEIVED_SHUTDOWN WOLFSSL_RECEIVED_SHUTDOWN
2131 #define SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER WOLFSSL_MODE_ACCEPT_MOVING_WRITE_BUFFER
2132
2133 #define SSL_R_SSL_HANDSHAKE_FAILURE WOLFSSL_R_SSL_HANDSHAKE_FAILURE
2134 #define SSL_R_TLSV1_ALERT_UNKNOWN_CA WOLFSSL_R_TLSV1_ALERT_UNKNOWN_CA
2135 #define SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN WOLFSSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN
2136 #define SSL_R_SSLV3_ALERT_BAD_CERTIFICATE WOLFSSL_R_SSLV3_ALERT_BAD_CERTIFICATE
2137
2138 #define PEM_BUFSIZE WOLF_PEM_BUFSIZE
2139#endif
2140
2141enum { /* ssl Constants */
2142 WOLFSSL_ERROR_NONE = 0, /* for most functions */
2143 WOLFSSL_FAILURE = 0, /* for some functions */
2144 WOLFSSL_SUCCESS = 1,
2145 WOLFSSL_SHUTDOWN_NOT_DONE = 2, /* call wolfSSL_shutdown again to complete */
2146
2147 WOLFSSL_ALPN_NOT_FOUND = -9,
2148 WOLFSSL_BAD_CERTTYPE = -8,
2149 WOLFSSL_BAD_STAT = -7,
2150 WOLFSSL_BAD_PATH = -6,
2151 WOLFSSL_BAD_FILETYPE = -5,
2152 WOLFSSL_BAD_FILE = -4,
2153 WOLFSSL_NOT_IMPLEMENTED = -3,
2154 WOLFSSL_UNKNOWN = -2,
2155 WOLFSSL_FATAL_ERROR = -1,
2156
2157 WOLFSSL_FILETYPE_ASN1 = 2,
2158 WOLFSSL_FILETYPE_PEM = 1,
2159 WOLFSSL_FILETYPE_DEFAULT = 2, /* ASN1 */
2160 WOLFSSL_FILETYPE_RAW = 3, /* NTRU raw key blob */
2161
2162 WOLFSSL_VERIFY_NONE = 0,
2163 WOLFSSL_VERIFY_PEER = 1,
2164 WOLFSSL_VERIFY_FAIL_IF_NO_PEER_CERT = 2,
2165 WOLFSSL_VERIFY_CLIENT_ONCE = 4,
2166 WOLFSSL_VERIFY_FAIL_EXCEPT_PSK = 8,
2167
2168 WOLFSSL_SESS_CACHE_OFF = 0x0000,
2169 WOLFSSL_SESS_CACHE_CLIENT = 0x0001,
2170 WOLFSSL_SESS_CACHE_SERVER = 0x0002,
2171 WOLFSSL_SESS_CACHE_BOTH = 0x0003,
2172 WOLFSSL_SESS_CACHE_NO_AUTO_CLEAR = 0x0008,
2173 WOLFSSL_SESS_CACHE_NO_INTERNAL_LOOKUP = 0x0100,
2174 WOLFSSL_SESS_CACHE_NO_INTERNAL_STORE = 0x0200,
2175 WOLFSSL_SESS_CACHE_NO_INTERNAL = 0x0300,
2176
2177 WOLFSSL_ERROR_WANT_READ = 2,
2178 WOLFSSL_ERROR_WANT_WRITE = 3,
2179 WOLFSSL_ERROR_WANT_CONNECT = 7,
2180 WOLFSSL_ERROR_WANT_ACCEPT = 8,
2181 WOLFSSL_ERROR_SYSCALL = 5,
2182 WOLFSSL_ERROR_WANT_X509_LOOKUP = 83,
2183 WOLFSSL_ERROR_ZERO_RETURN = 6,
2184 WOLFSSL_ERROR_SSL = 85,
2185
2186 WOLFSSL_SENT_SHUTDOWN = 1,
2187 WOLFSSL_RECEIVED_SHUTDOWN = 2,
2188 WOLFSSL_MODE_ACCEPT_MOVING_WRITE_BUFFER = 4,
2189
2190 WOLFSSL_R_SSL_HANDSHAKE_FAILURE = 101,
2191 WOLFSSL_R_TLSV1_ALERT_UNKNOWN_CA = 102,
2192 WOLFSSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN = 103,
2193 WOLFSSL_R_SSLV3_ALERT_BAD_CERTIFICATE = 104,
2194
2195 WOLF_PEM_BUFSIZE = 1024
2196};
2197
2198#ifndef NO_PSK
2199 typedef unsigned int (*wc_psk_client_callback)(WOLFSSL*, const char*, char*,
2200 unsigned int, unsigned char*, unsigned int);
2201 WOLFSSL_API void wolfSSL_CTX_set_psk_client_callback(WOLFSSL_CTX*,
2202 wc_psk_client_callback);
2203 WOLFSSL_API void wolfSSL_set_psk_client_callback(WOLFSSL*,
2204 wc_psk_client_callback);
2205 #ifdef OPENSSL_EXTRA
2206 typedef int (*wc_psk_use_session_cb_func)(WOLFSSL* ssl,
2207 const WOLFSSL_EVP_MD* md, const unsigned char **id,
2208 size_t* idlen, WOLFSSL_SESSION **sess);
2209 WOLFSSL_API void wolfSSL_set_psk_use_session_callback(WOLFSSL* ssl,
2210 wc_psk_use_session_cb_func cb);
2211 #endif
2212#ifdef WOLFSSL_TLS13
2213 typedef unsigned int (*wc_psk_client_cs_callback)(WOLFSSL*, const char*,
2214 char*, unsigned int, unsigned char*, unsigned int, const char*);
2215 WOLFSSL_API void wolfSSL_CTX_set_psk_client_cs_callback(WOLFSSL_CTX*,
2216 wc_psk_client_cs_callback);
2217 WOLFSSL_API void wolfSSL_set_psk_client_cs_callback(WOLFSSL*,
2218 wc_psk_client_cs_callback);
2219
2220 typedef unsigned int (*wc_psk_client_tls13_callback)(WOLFSSL*, const char*,
2221 char*, unsigned int, unsigned char*, unsigned int, const char**);
2222 WOLFSSL_API void wolfSSL_CTX_set_psk_client_tls13_callback(WOLFSSL_CTX*,
2223 wc_psk_client_tls13_callback);
2224 WOLFSSL_API void wolfSSL_set_psk_client_tls13_callback(WOLFSSL*,
2225 wc_psk_client_tls13_callback);
2226#endif
2227
2228 WOLFSSL_API const char* wolfSSL_get_psk_identity_hint(const WOLFSSL*);
2229 WOLFSSL_API const char* wolfSSL_get_psk_identity(const WOLFSSL*);
2230
2231 WOLFSSL_API int wolfSSL_CTX_use_psk_identity_hint(WOLFSSL_CTX*, const char*);
2232 WOLFSSL_API int wolfSSL_use_psk_identity_hint(WOLFSSL*, const char*);
2233
2234 typedef unsigned int (*wc_psk_server_callback)(WOLFSSL*, const char*,
2235 unsigned char*, unsigned int);
2236 WOLFSSL_API void wolfSSL_CTX_set_psk_server_callback(WOLFSSL_CTX*,
2237 wc_psk_server_callback);
2238 WOLFSSL_API void wolfSSL_set_psk_server_callback(WOLFSSL*,
2239 wc_psk_server_callback);
2240#ifdef WOLFSSL_TLS13
2241 typedef unsigned int (*wc_psk_server_tls13_callback)(WOLFSSL*, const char*,
2242 unsigned char*, unsigned int, const char**);
2243 WOLFSSL_API void wolfSSL_CTX_set_psk_server_tls13_callback(WOLFSSL_CTX*,
2244 wc_psk_server_tls13_callback);
2245 WOLFSSL_API void wolfSSL_set_psk_server_tls13_callback(WOLFSSL*,
2246 wc_psk_server_tls13_callback);
2247#endif
2248 WOLFSSL_API void* wolfSSL_get_psk_callback_ctx(WOLFSSL*);
2249 WOLFSSL_API int wolfSSL_set_psk_callback_ctx(WOLFSSL*, void*);
2250
2251 WOLFSSL_API void* wolfSSL_CTX_get_psk_callback_ctx(WOLFSSL_CTX*);
2252 WOLFSSL_API int wolfSSL_CTX_set_psk_callback_ctx(WOLFSSL_CTX*, void*);
2253
2254 #define PSK_TYPES_DEFINED
2255
2256#ifdef WOLFSSL_TLS13
2257 WOLFSSL_API const char* wolfSSL_get_cipher_name_by_hash(WOLFSSL* ssl,
2258 const char* hash);
2259#endif
2260#endif /* NO_PSK */
2261
2262
2263#ifdef HAVE_ANON
2264 WOLFSSL_API int wolfSSL_CTX_allow_anon_cipher(WOLFSSL_CTX*);
2265#endif /* HAVE_ANON */
2266
2267
2268/* extra begins */
2269#ifdef OPENSSL_EXTRA
2270enum { /* ERR Constants */
2271 ERR_TXT_STRING = 1
2272};
2273
2274/* bio misc */
2275enum {
2276 WOLFSSL_BIO_ERROR = -1,
2277 WOLFSSL_BIO_UNSET = -2,
2278 WOLFSSL_BIO_SIZE = 17000 /* default BIO write size if not set */
2279};
2280#endif
2281
2282WOLFSSL_API void wolfSSL_ERR_put_error(int lib, int fun, int err,
2283 const char* file, int line);
2284WOLFSSL_API unsigned long wolfSSL_ERR_get_error_line(const char**, int*);
2285WOLFSSL_API unsigned long wolfSSL_ERR_get_error_line_data(const char**, int*,
2286 const char**, int *);
2287
2288WOLFSSL_API unsigned long wolfSSL_ERR_get_error(void);
2289WOLFSSL_API void wolfSSL_ERR_clear_error(void);
2290
2291
2292WOLFSSL_API int wolfSSL_RAND_status(void);
2293WOLFSSL_API int wolfSSL_RAND_pseudo_bytes(unsigned char* buf, int num);
2294WOLFSSL_API int wolfSSL_RAND_bytes(unsigned char* buf, int num);
2295WOLFSSL_API WOLFSSL_METHOD *wolfSSLv23_server_method(void);
2296WOLFSSL_API long wolfSSL_CTX_set_options(WOLFSSL_CTX*, long);
2297WOLFSSL_API long wolfSSL_CTX_get_options(WOLFSSL_CTX* ctx);
2298WOLFSSL_API long wolfSSL_CTX_clear_options(WOLFSSL_CTX*, long);
2299
2300#if !defined(NO_CHECK_PRIVATE_KEY)
2301 WOLFSSL_API int wolfSSL_CTX_check_private_key(const WOLFSSL_CTX*);
2302#endif
2303WOLFSSL_API void wolfSSL_ERR_free_strings(void);
2304WOLFSSL_API void wolfSSL_ERR_remove_state(unsigned long);
2305WOLFSSL_API int wolfSSL_clear(WOLFSSL* ssl);
2306WOLFSSL_API int wolfSSL_state(WOLFSSL* ssl);
2307
2308WOLFSSL_API void wolfSSL_cleanup_all_ex_data(void);
2309WOLFSSL_API long wolfSSL_CTX_set_mode(WOLFSSL_CTX* ctx, long mode);
2310WOLFSSL_API long wolfSSL_CTX_get_mode(WOLFSSL_CTX* ctx);
2311WOLFSSL_API void wolfSSL_CTX_set_default_read_ahead(WOLFSSL_CTX* ctx, int m);
2312WOLFSSL_API long wolfSSL_SSL_get_mode(WOLFSSL* ssl);
2313
2314
2315WOLFSSL_API int wolfSSL_CTX_set_default_verify_paths(WOLFSSL_CTX*);
2316WOLFSSL_API int wolfSSL_CTX_set_session_id_context(WOLFSSL_CTX*,
2317 const unsigned char*, unsigned int);
2318WOLFSSL_ABI WOLFSSL_API WOLFSSL_X509* wolfSSL_get_peer_certificate(WOLFSSL*);
2319#ifdef OPENSSL_EXTRA
2320WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509)* wolfSSL_get_peer_cert_chain(const WOLFSSL*);
2321WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509)* wolfSSL_set_peer_cert_chain(WOLFSSL* ssl);
2322#endif
2323
2324#ifdef OPENSSL_EXTRA
2325WOLFSSL_API int wolfSSL_want(WOLFSSL*);
2326#endif
2327WOLFSSL_API int wolfSSL_want_read(WOLFSSL*);
2328WOLFSSL_API int wolfSSL_want_write(WOLFSSL*);
2329
2330#if !defined(NO_FILESYSTEM) && defined (OPENSSL_EXTRA)
2331#include <stdarg.h> /* var_arg */
2332WOLFSSL_API int wolfSSL_BIO_vprintf(WOLFSSL_BIO* bio, const char* format,
2333 va_list args);
2334#endif
2335WOLFSSL_API int wolfSSL_BIO_printf(WOLFSSL_BIO*, const char*, ...);
2336WOLFSSL_API int wolfSSL_BIO_dump(WOLFSSL_BIO *bio, const char*, int);
2337WOLFSSL_API int wolfSSL_ASN1_UTCTIME_print(WOLFSSL_BIO*,
2338 const WOLFSSL_ASN1_UTCTIME*);
2339WOLFSSL_API int wolfSSL_ASN1_GENERALIZEDTIME_print(WOLFSSL_BIO*,
2340 const WOLFSSL_ASN1_GENERALIZEDTIME*);
2341WOLFSSL_API void wolfSSL_ASN1_GENERALIZEDTIME_free(WOLFSSL_ASN1_GENERALIZEDTIME*);
2342WOLFSSL_API int wolfSSL_ASN1_TIME_check(const WOLFSSL_ASN1_TIME*);
2343WOLFSSL_API int wolfSSL_ASN1_TIME_diff(int *pday, int *psec,
2344 const WOLFSSL_ASN1_TIME *from, const WOLFSSL_ASN1_TIME *to);
2345#ifdef OPENSSL_EXTRA
2346WOLFSSL_API WOLFSSL_ASN1_TIME *wolfSSL_ASN1_TIME_set(WOLFSSL_ASN1_TIME *s, time_t t);
2347WOLFSSL_API int wolfSSL_ASN1_TIME_set_string(WOLFSSL_ASN1_TIME *s, const char *str);
2348#endif
2349
2350WOLFSSL_API int wolfSSL_sk_num(const WOLFSSL_STACK* sk);
2351WOLFSSL_API void* wolfSSL_sk_value(const WOLFSSL_STACK* sk, int i);
2352
2353#if defined(HAVE_EX_DATA) || defined(FORTRESS) || defined(WOLFSSL_WPAS_SMALL)
2354
2355WOLFSSL_API void* wolfSSL_CRYPTO_get_ex_data(const WOLFSSL_CRYPTO_EX_DATA* ex_data,
2356 int idx);
2357#ifdef HAVE_EX_DATA_CLEANUP_HOOKS
2358WOLFSSL_API int wolfSSL_CRYPTO_set_ex_data_with_cleanup(
2359 WOLFSSL_CRYPTO_EX_DATA* ex_data,
2360 int idx,
2361 void *data,
2362 wolfSSL_ex_data_cleanup_routine_t cleanup_routine);
2363#endif
2364WOLFSSL_API int wolfSSL_CRYPTO_set_ex_data(WOLFSSL_CRYPTO_EX_DATA* ex_data, int idx,
2365 void *data);
2366#endif
2367
2368/* stunnel 4.28 needs */
2369WOLFSSL_API void* wolfSSL_CTX_get_ex_data(const WOLFSSL_CTX*, int);
2370WOLFSSL_API int wolfSSL_CTX_set_ex_data(WOLFSSL_CTX*, int, void*);
2371#ifdef HAVE_EX_DATA_CLEANUP_HOOKS
2372WOLFSSL_API int wolfSSL_CTX_set_ex_data_with_cleanup(
2373 WOLFSSL_CTX* ctx,
2374 int idx,
2375 void* data,
2376 wolfSSL_ex_data_cleanup_routine_t cleanup_routine);
2377#endif
2378WOLFSSL_API void wolfSSL_CTX_sess_set_get_cb(WOLFSSL_CTX*,
2379 WOLFSSL_SESSION*(*f)(WOLFSSL*, unsigned char*, int, int*));
2380WOLFSSL_API void wolfSSL_CTX_sess_set_new_cb(WOLFSSL_CTX*,
2381 int (*f)(WOLFSSL*, WOLFSSL_SESSION*));
2382WOLFSSL_API void wolfSSL_CTX_sess_set_remove_cb(WOLFSSL_CTX*,
2383 void (*f)(WOLFSSL_CTX*, WOLFSSL_SESSION*));
2384
2385WOLFSSL_API int wolfSSL_i2d_SSL_SESSION(WOLFSSL_SESSION*,unsigned char**);
2386WOLFSSL_API WOLFSSL_SESSION* wolfSSL_d2i_SSL_SESSION(WOLFSSL_SESSION**,
2387 const unsigned char**, long);
2388
2389WOLFSSL_API long wolfSSL_SESSION_get_timeout(const WOLFSSL_SESSION*);
2390WOLFSSL_API long wolfSSL_SESSION_get_time(const WOLFSSL_SESSION*);
2391WOLFSSL_API int wolfSSL_CTX_get_ex_new_index(long, void*, void*, void*, void*);
2392
2393
2394/* extra ends */
2395
2396
2397/* wolfSSL extensions */
2398
2399/* call before SSL_connect, if verifying will add name check to
2400 date check and signature check */
2401WOLFSSL_ABI WOLFSSL_API int wolfSSL_check_domain_name(WOLFSSL*, const char*);
2402
2403/* need to call once to load library (session cache) */
2404WOLFSSL_ABI WOLFSSL_API int wolfSSL_Init(void);
2405/* call when done to cleanup/free session cache mutex / resources */
2406WOLFSSL_ABI WOLFSSL_API int wolfSSL_Cleanup(void);
2407
2408/* which library version do we have */
2409WOLFSSL_API const char* wolfSSL_lib_version(void);
2410#if defined(OPENSSL_VERSION_NUMBER) && OPENSSL_VERSION_NUMBER >= 0x10100000L
2411WOLFSSL_API const char* wolfSSL_OpenSSL_version(int a);
2412#else
2413WOLFSSL_API const char* wolfSSL_OpenSSL_version(void);
2414#endif
2415/* which library version do we have in hex */
2416WOLFSSL_API word32 wolfSSL_lib_version_hex(void);
2417
2418/* do accept or connect depedning on side */
2419WOLFSSL_API int wolfSSL_negotiate(WOLFSSL* ssl);
2420/* turn on wolfSSL data compression */
2421WOLFSSL_API int wolfSSL_set_compression(WOLFSSL* ssl);
2422
2423WOLFSSL_ABI WOLFSSL_API int wolfSSL_set_timeout(WOLFSSL*, unsigned int);
2424WOLFSSL_ABI WOLFSSL_API int wolfSSL_CTX_set_timeout(WOLFSSL_CTX*, unsigned int);
2425WOLFSSL_API void wolfSSL_CTX_set_current_time_cb(WOLFSSL_CTX* ctx,
2426 void (*cb)(const WOLFSSL* ssl, WOLFSSL_TIMEVAL* out_clock));
2427
2428/* get wolfSSL peer X509_CHAIN */
2429WOLFSSL_API WOLFSSL_X509_CHAIN* wolfSSL_get_peer_chain(WOLFSSL* ssl);
2430#ifdef WOLFSSL_ALT_CERT_CHAINS
2431WOLFSSL_API int wolfSSL_is_peer_alt_cert_chain(const WOLFSSL* ssl);
2432/* get wolfSSL alternate peer X509_CHAIN */
2433WOLFSSL_API WOLFSSL_X509_CHAIN* wolfSSL_get_peer_alt_chain(WOLFSSL* ssl);
2434#endif
2435/* peer chain count */
2436WOLFSSL_API int wolfSSL_get_chain_count(WOLFSSL_X509_CHAIN* chain);
2437/* index cert length */
2438WOLFSSL_API int wolfSSL_get_chain_length(WOLFSSL_X509_CHAIN*, int idx);
2439/* index cert */
2440WOLFSSL_API unsigned char* wolfSSL_get_chain_cert(WOLFSSL_X509_CHAIN*, int idx);
2441/* index cert in X509 */
2442WOLFSSL_API WOLFSSL_X509* wolfSSL_get_chain_X509(WOLFSSL_X509_CHAIN*, int idx);
2443/* free X509 */
2444#define wolfSSL_FreeX509(x509) wolfSSL_X509_free((x509))
2445WOLFSSL_ABI WOLFSSL_API void wolfSSL_X509_free(WOLFSSL_X509*);
2446/* get index cert in PEM */
2447WOLFSSL_API int wolfSSL_get_chain_cert_pem(WOLFSSL_X509_CHAIN*, int idx,
2448 unsigned char* buf, int inLen, int* outLen);
2449WOLFSSL_ABI WOLFSSL_API const unsigned char* wolfSSL_get_sessionID(
2450 const WOLFSSL_SESSION* s);
2451WOLFSSL_API int wolfSSL_X509_get_serial_number(WOLFSSL_X509*,unsigned char*,int*);
2452WOLFSSL_API char* wolfSSL_X509_get_subjectCN(WOLFSSL_X509*);
2453WOLFSSL_API const unsigned char* wolfSSL_X509_get_der(WOLFSSL_X509*, int*);
2454WOLFSSL_API const unsigned char* wolfSSL_X509_get_tbs(WOLFSSL_X509*, int*);
2455WOLFSSL_ABI WOLFSSL_API const byte* wolfSSL_X509_notBefore(WOLFSSL_X509*);
2456WOLFSSL_ABI WOLFSSL_API const byte* wolfSSL_X509_notAfter(WOLFSSL_X509*);
2457WOLFSSL_API int wolfSSL_X509_version(WOLFSSL_X509*);
2458
2459WOLFSSL_API int wolfSSL_cmp_peer_cert_to_file(WOLFSSL*, const char*);
2460
2461WOLFSSL_ABI WOLFSSL_API char* wolfSSL_X509_get_next_altname(WOLFSSL_X509*);
2462WOLFSSL_API int wolfSSL_X509_add_altname_ex(WOLFSSL_X509*, const char*, word32, int);
2463WOLFSSL_API int wolfSSL_X509_add_altname(WOLFSSL_X509*, const char*, int);
2464
2465WOLFSSL_API WOLFSSL_X509* wolfSSL_d2i_X509(WOLFSSL_X509** x509,
2466 const unsigned char** in, int len);
2467WOLFSSL_API WOLFSSL_X509*
2468 wolfSSL_X509_d2i(WOLFSSL_X509** x509, const unsigned char* in, int len);
2469#ifdef WOLFSSL_CERT_REQ
2470WOLFSSL_API WOLFSSL_X509*
2471 wolfSSL_X509_REQ_d2i(WOLFSSL_X509** x509, const unsigned char* in, int len);
2472#endif
2473WOLFSSL_API int wolfSSL_i2d_X509(WOLFSSL_X509* x509, unsigned char** out);
2474WOLFSSL_API WOLFSSL_X509_CRL *wolfSSL_d2i_X509_CRL(WOLFSSL_X509_CRL **crl,
2475 const unsigned char *in, int len);
2476WOLFSSL_API WOLFSSL_X509_CRL *wolfSSL_d2i_X509_CRL_bio(WOLFSSL_BIO *bp,
2477 WOLFSSL_X509_CRL **crl);
2478#if !defined(NO_FILESYSTEM) && !defined(NO_STDIO_FILESYSTEM)
2479WOLFSSL_API WOLFSSL_X509_CRL *wolfSSL_d2i_X509_CRL_fp(XFILE file, WOLFSSL_X509_CRL **crl);
2480#endif
2481WOLFSSL_API void wolfSSL_X509_CRL_free(WOLFSSL_X509_CRL *crl);
2482
2483#ifndef NO_FILESYSTEM
2484 #ifndef NO_STDIO_FILESYSTEM
2485 WOLFSSL_API WOLFSSL_X509*
2486 wolfSSL_X509_d2i_fp(WOLFSSL_X509** x509, XFILE file);
2487 #endif
2488WOLFSSL_ABI WOLFSSL_API WOLFSSL_X509*
2489 wolfSSL_X509_load_certificate_file(const char* fname, int format);
2490#endif
2491WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_load_certificate_buffer(
2492 const unsigned char* buf, int sz, int format);
2493#ifdef WOLFSSL_CERT_REQ
2494WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_REQ_load_certificate_buffer(
2495 const unsigned char* buf, int sz, int format);
2496#endif
2497
2498#ifdef WOLFSSL_SEP
2499 WOLFSSL_API unsigned char*
2500 wolfSSL_X509_get_device_type(WOLFSSL_X509*, unsigned char*, int*);
2501 WOLFSSL_API unsigned char*
2502 wolfSSL_X509_get_hw_type(WOLFSSL_X509*, unsigned char*, int*);
2503 WOLFSSL_API unsigned char*
2504 wolfSSL_X509_get_hw_serial_number(WOLFSSL_X509*, unsigned char*, int*);
2505#endif
2506
2507/* connect enough to get peer cert */
2508WOLFSSL_API int wolfSSL_connect_cert(WOLFSSL* ssl);
2509
2510
2511
2512/* PKCS12 compatibility */
2513typedef struct WC_PKCS12 WC_PKCS12;
2514WOLFSSL_API WC_PKCS12* wolfSSL_d2i_PKCS12_bio(WOLFSSL_BIO* bio,
2515 WC_PKCS12** pkcs12);
2516WOLFSSL_API int wolfSSL_i2d_PKCS12_bio(WOLFSSL_BIO *bio, WC_PKCS12 *pkcs12);
2517#if !defined(NO_FILESYSTEM) && !defined(NO_STDIO_FILESYSTEM)
2518WOLFSSL_API WOLFSSL_X509_PKCS12* wolfSSL_d2i_PKCS12_fp(XFILE fp,
2519 WOLFSSL_X509_PKCS12** pkcs12);
2520#endif
2521WOLFSSL_API int wolfSSL_PKCS12_parse(WC_PKCS12* pkcs12, const char* psw,
2522 WOLFSSL_EVP_PKEY** pkey, WOLFSSL_X509** cert,
2523 WOLF_STACK_OF(WOLFSSL_X509)** ca);
2524WOLFSSL_API int wolfSSL_PKCS12_verify_mac(WC_PKCS12 *pkcs12, const char *psw,
2525 int pswLen);
2526WOLFSSL_API WC_PKCS12* wolfSSL_PKCS12_create(char* pass, char* name,
2527 WOLFSSL_EVP_PKEY* pkey, WOLFSSL_X509* cert,
2528 WOLF_STACK_OF(WOLFSSL_X509)* ca,
2529 int keyNID, int certNID, int itt, int macItt, int keytype);
2530WOLFSSL_API void wolfSSL_PKCS12_PBE_add(void);
2531
2532
2533
2534#ifndef NO_DH
2535/* server Diffie-Hellman parameters */
2536WOLFSSL_API int wolfSSL_SetTmpDH(WOLFSSL*, const unsigned char* p, int pSz,
2537 const unsigned char* g, int gSz);
2538WOLFSSL_API int wolfSSL_SetTmpDH_buffer(WOLFSSL*, const unsigned char* b, long sz,
2539 int format);
2540WOLFSSL_API int wolfSSL_SetEnableDhKeyTest(WOLFSSL*, int);
2541#ifndef NO_FILESYSTEM
2542 WOLFSSL_API int wolfSSL_SetTmpDH_file(WOLFSSL*, const char* f, int format);
2543#endif
2544
2545/* server ctx Diffie-Hellman parameters */
2546WOLFSSL_API int wolfSSL_CTX_SetTmpDH(WOLFSSL_CTX*, const unsigned char* p,
2547 int pSz, const unsigned char* g, int gSz);
2548WOLFSSL_API int wolfSSL_CTX_SetTmpDH_buffer(WOLFSSL_CTX*, const unsigned char* b,
2549 long sz, int format);
2550
2551#ifndef NO_FILESYSTEM
2552 WOLFSSL_API int wolfSSL_CTX_SetTmpDH_file(WOLFSSL_CTX*, const char* f,
2553 int format);
2554#endif
2555
2556WOLFSSL_API int wolfSSL_CTX_SetMinDhKey_Sz(WOLFSSL_CTX*, word16);
2557WOLFSSL_API int wolfSSL_SetMinDhKey_Sz(WOLFSSL*, word16);
2558WOLFSSL_API int wolfSSL_CTX_SetMaxDhKey_Sz(WOLFSSL_CTX*, word16);
2559WOLFSSL_API int wolfSSL_SetMaxDhKey_Sz(WOLFSSL*, word16);
2560WOLFSSL_API int wolfSSL_GetDhKey_Sz(WOLFSSL*);
2561#endif /* NO_DH */
2562
2563#ifndef NO_RSA
2564WOLFSSL_API int wolfSSL_CTX_SetMinRsaKey_Sz(WOLFSSL_CTX*, short);
2565WOLFSSL_API int wolfSSL_SetMinRsaKey_Sz(WOLFSSL*, short);
2566#endif /* NO_RSA */
2567
2568#ifdef HAVE_ECC
2569WOLFSSL_API int wolfSSL_CTX_SetMinEccKey_Sz(WOLFSSL_CTX*, short);
2570WOLFSSL_API int wolfSSL_SetMinEccKey_Sz(WOLFSSL*, short);
2571#endif /* NO_RSA */
2572
2573WOLFSSL_API int wolfSSL_SetTmpEC_DHE_Sz(WOLFSSL*, word16);
2574WOLFSSL_API int wolfSSL_CTX_SetTmpEC_DHE_Sz(WOLFSSL_CTX*, word16);
2575
2576/* keyblock size in bytes or -1 */
2577/* need to call wolfSSL_KeepArrays before handshake to save keys */
2578WOLFSSL_API int wolfSSL_get_keyblock_size(WOLFSSL*);
2579WOLFSSL_API int wolfSSL_get_keys(WOLFSSL*,unsigned char** ms, unsigned int* msLen,
2580 unsigned char** sr, unsigned int* srLen,
2581 unsigned char** cr, unsigned int* crLen);
2582
2583/* Computes EAP-TLS and EAP-TTLS keying material from the master_secret. */
2584WOLFSSL_API int wolfSSL_make_eap_keys(WOLFSSL*, void* key, unsigned int len,
2585 const char* label);
2586
2587
2588#ifndef _WIN32
2589 #ifndef NO_WRITEV
2590 #ifdef __PPU
2591 #include <sys/types.h>
2592 #include <sys/socket.h>
2593 #elif !defined(WOLFSSL_MDK_ARM) && !defined(WOLFSSL_IAR_ARM) && \
2594 !defined(WOLFSSL_PICOTCP) && !defined(WOLFSSL_ROWLEY_ARM) && \
2595 !defined(WOLFSSL_EMBOS) && !defined(WOLFSSL_FROSTED) && \
2596 !defined(WOLFSSL_CHIBIOS) && !defined(WOLFSSL_CONTIKI) && \
2597 !defined(WOLFSSL_ZEPHYR)
2598 #include <sys/uio.h>
2599 #endif
2600 /* allow writev style writing */
2601 WOLFSSL_API int wolfSSL_writev(WOLFSSL* ssl, const struct iovec* iov,
2602 int iovcnt);
2603 #endif
2604#endif
2605
2606
2607#ifndef NO_CERTS
2608 /* SSL_CTX versions */
2609 WOLFSSL_API int wolfSSL_CTX_UnloadCAs(WOLFSSL_CTX*);
2610#ifdef WOLFSSL_TRUST_PEER_CERT
2611 WOLFSSL_API int wolfSSL_CTX_Unload_trust_peers(WOLFSSL_CTX*);
2612 WOLFSSL_API int wolfSSL_CTX_trust_peer_buffer(WOLFSSL_CTX*,
2613 const unsigned char*, long, int);
2614#endif
2615 WOLFSSL_API int wolfSSL_CTX_load_verify_buffer_ex(WOLFSSL_CTX*,
2616 const unsigned char*, long, int,
2617 int, word32);
2618 WOLFSSL_API int wolfSSL_CTX_load_verify_buffer(WOLFSSL_CTX*,
2619 const unsigned char*, long, int);
2620 WOLFSSL_API int wolfSSL_CTX_load_verify_chain_buffer_format(WOLFSSL_CTX*,
2621 const unsigned char*, long, int);
2622 WOLFSSL_API int wolfSSL_CTX_use_certificate_buffer(WOLFSSL_CTX*,
2623 const unsigned char*, long, int);
2624 WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_buffer(WOLFSSL_CTX*,
2625 const unsigned char*, long, int);
2626 WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_id(WOLFSSL_CTX*,
2627 const unsigned char*, long,
2628 int, long);
2629 WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_Id(WOLFSSL_CTX*,
2630 const unsigned char*, long,
2631 int);
2632 WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_Label(WOLFSSL_CTX*, const char*,
2633 int);
2634 WOLFSSL_API int wolfSSL_CTX_use_certificate_chain_buffer_format(WOLFSSL_CTX*,
2635 const unsigned char*, long, int);
2636 WOLFSSL_API int wolfSSL_CTX_use_certificate_chain_buffer(WOLFSSL_CTX*,
2637 const unsigned char*, long);
2638
2639 /* SSL versions */
2640 WOLFSSL_API int wolfSSL_use_certificate_buffer(WOLFSSL*, const unsigned char*,
2641 long, int);
2642 WOLFSSL_API int wolfSSL_use_certificate_ASN1(WOLFSSL* ssl,
2643 const unsigned char* der, int derSz);
2644 WOLFSSL_API int wolfSSL_use_PrivateKey_buffer(WOLFSSL*, const unsigned char*,
2645 long, int);
2646 WOLFSSL_API int wolfSSL_use_PrivateKey_id(WOLFSSL*, const unsigned char*,
2647 long, int, long);
2648 WOLFSSL_API int wolfSSL_use_PrivateKey_Id(WOLFSSL*, const unsigned char*,
2649 long, int);
2650 WOLFSSL_API int wolfSSL_use_PrivateKey_Label(WOLFSSL*, const char*, int);
2651 WOLFSSL_API int wolfSSL_use_certificate_chain_buffer_format(WOLFSSL*,
2652 const unsigned char*, long, int);
2653 WOLFSSL_API int wolfSSL_use_certificate_chain_buffer(WOLFSSL*,
2654 const unsigned char*, long);
2655 WOLFSSL_API int wolfSSL_UnloadCertsKeys(WOLFSSL*);
2656
2657 #if (defined(OPENSSL_EXTRA) || defined(OPENSSL_EXTRA_X509_SMALL)) && \
2658 defined(KEEP_OUR_CERT)
2659 WOLFSSL_API WOLFSSL_X509* wolfSSL_get_certificate(WOLFSSL* ssl);
2660 WOLFSSL_API WOLFSSL_X509* wolfSSL_CTX_get0_certificate(WOLFSSL_CTX* ctx);
2661 #endif
2662#endif
2663
2664WOLFSSL_API int wolfSSL_CTX_set_group_messages(WOLFSSL_CTX*);
2665WOLFSSL_API int wolfSSL_set_group_messages(WOLFSSL*);
2666
2667
2668#ifdef HAVE_FUZZER
2669enum fuzzer_type {
2670 FUZZ_HMAC = 0,
2671 FUZZ_ENCRYPT = 1,
2672 FUZZ_SIGNATURE = 2,
2673 FUZZ_HASH = 3,
2674 FUZZ_HEAD = 4
2675};
2676
2677typedef int (*CallbackFuzzer)(WOLFSSL* ssl, const unsigned char* buf, int sz,
2678 int type, void* fuzzCtx);
2679
2680WOLFSSL_API void wolfSSL_SetFuzzerCb(WOLFSSL* ssl, CallbackFuzzer cbf, void* fCtx);
2681#endif
2682
2683
2684WOLFSSL_API int wolfSSL_DTLS_SetCookieSecret(WOLFSSL*, const byte*, word32);
2685
2686
2687/* I/O Callback default errors */
2688enum IOerrors {
2689 WOLFSSL_CBIO_ERR_GENERAL = -1, /* general unexpected err */
2690 WOLFSSL_CBIO_ERR_WANT_READ = -2, /* need to call read again */
2691 WOLFSSL_CBIO_ERR_WANT_WRITE = -2, /* need to call write again */
2692 WOLFSSL_CBIO_ERR_CONN_RST = -3, /* connection reset */
2693 WOLFSSL_CBIO_ERR_ISR = -4, /* interrupt */
2694 WOLFSSL_CBIO_ERR_CONN_CLOSE = -5, /* connection closed or epipe */
2695 WOLFSSL_CBIO_ERR_TIMEOUT = -6 /* socket timeout */
2696};
2697
2698
2699/* CA cache callbacks */
2700enum {
2701 WOLFSSL_SSLV3 = 0,
2702 WOLFSSL_TLSV1 = 1,
2703 WOLFSSL_TLSV1_1 = 2,
2704 WOLFSSL_TLSV1_2 = 3,
2705 WOLFSSL_TLSV1_3 = 4,
2706 WOLFSSL_USER_CA = 1, /* user added as trusted */
2707 WOLFSSL_CHAIN_CA = 2 /* added to cache from trusted chain */
2708};
2709
2710WOLFSSL_ABI WOLFSSL_API WC_RNG* wolfSSL_GetRNG(WOLFSSL*);
2711
2712WOLFSSL_ABI WOLFSSL_API int wolfSSL_CTX_SetMinVersion(WOLFSSL_CTX*, int);
2713WOLFSSL_API int wolfSSL_SetMinVersion(WOLFSSL*, int);
2714WOLFSSL_API int wolfSSL_GetObjectSize(void); /* object size based on build */
2715WOLFSSL_API int wolfSSL_CTX_GetObjectSize(void);
2716WOLFSSL_API int wolfSSL_METHOD_GetObjectSize(void);
2717WOLFSSL_API int wolfSSL_GetOutputSize(WOLFSSL*, int);
2718WOLFSSL_API int wolfSSL_GetMaxOutputSize(WOLFSSL*);
2719WOLFSSL_API int wolfSSL_GetVersion(const WOLFSSL* ssl);
2720WOLFSSL_API int wolfSSL_SetVersion(WOLFSSL* ssl, int version);
2721
2722/* moved to asn.c, old names kept for backwards compatibility */
2723#define wolfSSL_KeyPemToDer wc_KeyPemToDer
2724#define wolfSSL_CertPemToDer wc_CertPemToDer
2725#define wolfSSL_PemPubKeyToDer wc_PemPubKeyToDer
2726#define wolfSSL_PubKeyPemToDer wc_PubKeyPemToDer
2727#define wolfSSL_PemCertToDer wc_PemCertToDer
2728
2729
2730typedef void (*CallbackCACache)(unsigned char* der, int sz, int type);
2731typedef void (*CbMissingCRL)(const char* url);
2732typedef int (*CbOCSPIO)(void*, const char*, int,
2733 unsigned char*, int, unsigned char**);
2734typedef void (*CbOCSPRespFree)(void*,unsigned char*);
2735
2736#ifdef HAVE_CRL_IO
2737typedef int (*CbCrlIO)(WOLFSSL_CRL* crl, const char* url, int urlSz);
2738#endif
2739
2740/* User Atomic Record Layer CallBacks */
2741typedef int (*CallbackMacEncrypt)(WOLFSSL* ssl, unsigned char* macOut,
2742 const unsigned char* macIn, unsigned int macInSz, int macContent,
2743 int macVerify, unsigned char* encOut, const unsigned char* encIn,
2744 unsigned int encSz, void* ctx);
2745WOLFSSL_API void wolfSSL_CTX_SetMacEncryptCb(WOLFSSL_CTX*, CallbackMacEncrypt);
2746WOLFSSL_API void wolfSSL_SetMacEncryptCtx(WOLFSSL* ssl, void *ctx);
2747WOLFSSL_API void* wolfSSL_GetMacEncryptCtx(WOLFSSL* ssl);
2748
2749typedef int (*CallbackDecryptVerify)(WOLFSSL* ssl,
2750 unsigned char* decOut, const unsigned char* decIn,
2751 unsigned int decSz, int content, int verify, unsigned int* padSz,
2752 void* ctx);
2753WOLFSSL_API void wolfSSL_CTX_SetDecryptVerifyCb(WOLFSSL_CTX*,
2754 CallbackDecryptVerify);
2755WOLFSSL_API void wolfSSL_SetDecryptVerifyCtx(WOLFSSL* ssl, void *ctx);
2756WOLFSSL_API void* wolfSSL_GetDecryptVerifyCtx(WOLFSSL* ssl);
2757
2758typedef int (*CallbackEncryptMac)(WOLFSSL* ssl, unsigned char* macOut,
2759 int content, int macVerify, unsigned char* encOut,
2760 const unsigned char* encIn, unsigned int encSz, void* ctx);
2761WOLFSSL_API void wolfSSL_CTX_SetEncryptMacCb(WOLFSSL_CTX*, CallbackEncryptMac);
2762WOLFSSL_API void wolfSSL_SetEncryptMacCtx(WOLFSSL* ssl, void *ctx);
2763WOLFSSL_API void* wolfSSL_GetEncryptMacCtx(WOLFSSL* ssl);
2764
2765typedef int (*CallbackVerifyDecrypt)(WOLFSSL* ssl,
2766 unsigned char* decOut, const unsigned char* decIn,
2767 unsigned int decSz, int content, int verify, unsigned int* padSz,
2768 void* ctx);
2769WOLFSSL_API void wolfSSL_CTX_SetVerifyDecryptCb(WOLFSSL_CTX*,
2770 CallbackVerifyDecrypt);
2771WOLFSSL_API void wolfSSL_SetVerifyDecryptCtx(WOLFSSL* ssl, void *ctx);
2772WOLFSSL_API void* wolfSSL_GetVerifyDecryptCtx(WOLFSSL* ssl);
2773
2774WOLFSSL_API const unsigned char* wolfSSL_GetMacSecret(WOLFSSL*, int);
2775WOLFSSL_API const unsigned char* wolfSSL_GetDtlsMacSecret(WOLFSSL*, int, int);
2776WOLFSSL_API const unsigned char* wolfSSL_GetClientWriteKey(WOLFSSL*);
2777WOLFSSL_API const unsigned char* wolfSSL_GetClientWriteIV(WOLFSSL*);
2778WOLFSSL_API const unsigned char* wolfSSL_GetServerWriteKey(WOLFSSL*);
2779WOLFSSL_API const unsigned char* wolfSSL_GetServerWriteIV(WOLFSSL*);
2780WOLFSSL_API int wolfSSL_GetKeySize(WOLFSSL*);
2781WOLFSSL_API int wolfSSL_GetIVSize(WOLFSSL*);
2782WOLFSSL_API int wolfSSL_GetSide(WOLFSSL*);
2783WOLFSSL_API int wolfSSL_IsTLSv1_1(WOLFSSL*);
2784WOLFSSL_API int wolfSSL_GetBulkCipher(WOLFSSL*);
2785WOLFSSL_API int wolfSSL_GetCipherBlockSize(WOLFSSL*);
2786WOLFSSL_API int wolfSSL_GetAeadMacSize(WOLFSSL*);
2787WOLFSSL_API int wolfSSL_GetHmacSize(WOLFSSL*);
2788WOLFSSL_API int wolfSSL_GetHmacType(WOLFSSL*);
2789WOLFSSL_API int wolfSSL_GetCipherType(WOLFSSL*);
2790WOLFSSL_API int wolfSSL_SetTlsHmacInner(WOLFSSL*, unsigned char*,
2791 word32, int, int);
2792
2793/* Atomic User Needs */
2794enum {
2795 WOLFSSL_SERVER_END = 0,
2796 WOLFSSL_CLIENT_END = 1,
2797 WOLFSSL_NEITHER_END = 3,
2798 WOLFSSL_BLOCK_TYPE = 2,
2799 WOLFSSL_STREAM_TYPE = 3,
2800 WOLFSSL_AEAD_TYPE = 4,
2801 WOLFSSL_TLS_HMAC_INNER_SZ = 13 /* SEQ_SZ + ENUM + VERSION_SZ + LEN_SZ */
2802};
2803
2804/* for GetBulkCipher and internal use */
2805enum BulkCipherAlgorithm {
2806 wolfssl_cipher_null,
2807 wolfssl_rc4,
2808 wolfssl_rc2,
2809 wolfssl_des,
2810 wolfssl_triple_des, /* leading 3 (3des) not valid identifier */
2811 wolfssl_des40,
2812#ifdef HAVE_IDEA
2813 wolfssl_idea,
2814#endif
2815 wolfssl_aes,
2816 wolfssl_aes_gcm,
2817 wolfssl_aes_ccm,
2818 wolfssl_chacha,
2819 wolfssl_camellia,
2820 wolfssl_hc128, /* wolfSSL extensions */
2821 wolfssl_rabbit
2822};
2823
2824
2825/* for KDF TLS 1.2 mac types */
2826enum KDF_MacAlgorithm {
2827 wolfssl_sha256 = 4, /* needs to match hash.h wc_MACAlgorithm */
2828 wolfssl_sha384,
2829 wolfssl_sha512
2830};
2831
2832
2833/* Public Key Callback support */
2834#ifdef HAVE_PK_CALLBACKS
2835#ifdef HAVE_ECC
2836
2837struct ecc_key;
2838
2839typedef int (*CallbackEccKeyGen)(WOLFSSL* ssl, struct ecc_key* key,
2840 unsigned int keySz, int ecc_curve, void* ctx);
2841WOLFSSL_API void wolfSSL_CTX_SetEccKeyGenCb(WOLFSSL_CTX*, CallbackEccKeyGen);
2842WOLFSSL_API void wolfSSL_SetEccKeyGenCtx(WOLFSSL* ssl, void *ctx);
2843WOLFSSL_API void* wolfSSL_GetEccKeyGenCtx(WOLFSSL* ssl);
2844
2845typedef int (*CallbackEccSign)(WOLFSSL* ssl,
2846 const unsigned char* in, unsigned int inSz,
2847 unsigned char* out, word32* outSz,
2848 const unsigned char* keyDer, unsigned int keySz,
2849 void* ctx);
2850WOLFSSL_ABI WOLFSSL_API void wolfSSL_CTX_SetEccSignCb(WOLFSSL_CTX*,
2851 CallbackEccSign);
2852WOLFSSL_API void wolfSSL_SetEccSignCtx(WOLFSSL* ssl, void *ctx);
2853WOLFSSL_API void* wolfSSL_GetEccSignCtx(WOLFSSL* ssl);
2854
2855typedef int (*CallbackEccVerify)(WOLFSSL* ssl,
2856 const unsigned char* sig, unsigned int sigSz,
2857 const unsigned char* hash, unsigned int hashSz,
2858 const unsigned char* keyDer, unsigned int keySz,
2859 int* result, void* ctx);
2860WOLFSSL_API void wolfSSL_CTX_SetEccVerifyCb(WOLFSSL_CTX*, CallbackEccVerify);
2861WOLFSSL_API void wolfSSL_SetEccVerifyCtx(WOLFSSL* ssl, void *ctx);
2862WOLFSSL_API void* wolfSSL_GetEccVerifyCtx(WOLFSSL* ssl);
2863
2864typedef int (*CallbackEccSharedSecret)(WOLFSSL* ssl, struct ecc_key* otherKey,
2865 unsigned char* pubKeyDer, word32* pubKeySz,
2866 unsigned char* out, word32* outlen,
2867 int side, void* ctx); /* side is WOLFSSL_CLIENT_END or WOLFSSL_SERVER_END */
2868WOLFSSL_API void wolfSSL_CTX_SetEccSharedSecretCb(WOLFSSL_CTX*, CallbackEccSharedSecret);
2869WOLFSSL_API void wolfSSL_SetEccSharedSecretCtx(WOLFSSL* ssl, void *ctx);
2870WOLFSSL_API void* wolfSSL_GetEccSharedSecretCtx(WOLFSSL* ssl);
2871#endif
2872
2873#ifndef NO_DH
2874/* Public DH Key Callback support */
2875struct DhKey;
2876typedef int (*CallbackDhAgree)(WOLFSSL* ssl, struct DhKey* key,
2877 const unsigned char* priv, unsigned int privSz,
2878 const unsigned char* otherPubKeyDer, unsigned int otherPubKeySz,
2879 unsigned char* out, word32* outlen,
2880 void* ctx);
2881WOLFSSL_API void wolfSSL_CTX_SetDhAgreeCb(WOLFSSL_CTX*, CallbackDhAgree);
2882WOLFSSL_API void wolfSSL_SetDhAgreeCtx(WOLFSSL* ssl, void *ctx);
2883WOLFSSL_API void* wolfSSL_GetDhAgreeCtx(WOLFSSL* ssl);
2884#endif /* !NO_DH */
2885
2886#ifdef HAVE_ED25519
2887struct ed25519_key;
2888typedef int (*CallbackEd25519Sign)(WOLFSSL* ssl,
2889 const unsigned char* in, unsigned int inSz,
2890 unsigned char* out, unsigned int* outSz,
2891 const unsigned char* keyDer, unsigned int keySz,
2892 void* ctx);
2893WOLFSSL_API void wolfSSL_CTX_SetEd25519SignCb(WOLFSSL_CTX*,
2894 CallbackEd25519Sign);
2895WOLFSSL_API void wolfSSL_SetEd25519SignCtx(WOLFSSL* ssl, void *ctx);
2896WOLFSSL_API void* wolfSSL_GetEd25519SignCtx(WOLFSSL* ssl);
2897
2898typedef int (*CallbackEd25519Verify)(WOLFSSL* ssl,
2899 const unsigned char* sig, unsigned int sigSz,
2900 const unsigned char* msg, unsigned int msgSz,
2901 const unsigned char* keyDer, unsigned int keySz,
2902 int* result, void* ctx);
2903WOLFSSL_API void wolfSSL_CTX_SetEd25519VerifyCb(WOLFSSL_CTX*,
2904 CallbackEd25519Verify);
2905WOLFSSL_API void wolfSSL_SetEd25519VerifyCtx(WOLFSSL* ssl, void *ctx);
2906WOLFSSL_API void* wolfSSL_GetEd25519VerifyCtx(WOLFSSL* ssl);
2907#endif
2908
2909#ifdef HAVE_CURVE25519
2910struct curve25519_key;
2911
2912typedef int (*CallbackX25519KeyGen)(WOLFSSL* ssl, struct curve25519_key* key,
2913 unsigned int keySz, void* ctx);
2914WOLFSSL_API void wolfSSL_CTX_SetX25519KeyGenCb(WOLFSSL_CTX*, CallbackX25519KeyGen);
2915WOLFSSL_API void wolfSSL_SetX25519KeyGenCtx(WOLFSSL* ssl, void *ctx);
2916WOLFSSL_API void* wolfSSL_GetX25519KeyGenCtx(WOLFSSL* ssl);
2917
2918typedef int (*CallbackX25519SharedSecret)(WOLFSSL* ssl,
2919 struct curve25519_key* otherKey,
2920 unsigned char* pubKeyDer, unsigned int* pubKeySz,
2921 unsigned char* out, unsigned int* outlen,
2922 int side, void* ctx);
2923 /* side is WOLFSSL_CLIENT_END or WOLFSSL_SERVER_END */
2924WOLFSSL_API void wolfSSL_CTX_SetX25519SharedSecretCb(WOLFSSL_CTX*,
2925 CallbackX25519SharedSecret);
2926WOLFSSL_API void wolfSSL_SetX25519SharedSecretCtx(WOLFSSL* ssl, void *ctx);
2927WOLFSSL_API void* wolfSSL_GetX25519SharedSecretCtx(WOLFSSL* ssl);
2928#endif
2929
2930#ifdef HAVE_ED448
2931struct ed448_key;
2932typedef int (*CallbackEd448Sign)(WOLFSSL* ssl,
2933 const unsigned char* in, unsigned int inSz,
2934 unsigned char* out, unsigned int* outSz,
2935 const unsigned char* keyDer, unsigned int keySz,
2936 void* ctx);
2937WOLFSSL_API void wolfSSL_CTX_SetEd448SignCb(WOLFSSL_CTX*,
2938 CallbackEd448Sign);
2939WOLFSSL_API void wolfSSL_SetEd448SignCtx(WOLFSSL* ssl, void *ctx);
2940WOLFSSL_API void* wolfSSL_GetEd448SignCtx(WOLFSSL* ssl);
2941
2942typedef int (*CallbackEd448Verify)(WOLFSSL* ssl,
2943 const unsigned char* sig, unsigned int sigSz,
2944 const unsigned char* msg, unsigned int msgSz,
2945 const unsigned char* keyDer, unsigned int keySz,
2946 int* result, void* ctx);
2947WOLFSSL_API void wolfSSL_CTX_SetEd448VerifyCb(WOLFSSL_CTX*,
2948 CallbackEd448Verify);
2949WOLFSSL_API void wolfSSL_SetEd448VerifyCtx(WOLFSSL* ssl, void *ctx);
2950WOLFSSL_API void* wolfSSL_GetEd448VerifyCtx(WOLFSSL* ssl);
2951#endif
2952
2953#ifdef HAVE_CURVE448
2954struct curve448_key;
2955
2956typedef int (*CallbackX448KeyGen)(WOLFSSL* ssl, struct curve448_key* key,
2957 unsigned int keySz, void* ctx);
2958WOLFSSL_API void wolfSSL_CTX_SetX448KeyGenCb(WOLFSSL_CTX*, CallbackX448KeyGen);
2959WOLFSSL_API void wolfSSL_SetX448KeyGenCtx(WOLFSSL* ssl, void *ctx);
2960WOLFSSL_API void* wolfSSL_GetX448KeyGenCtx(WOLFSSL* ssl);
2961
2962typedef int (*CallbackX448SharedSecret)(WOLFSSL* ssl,
2963 struct curve448_key* otherKey,
2964 unsigned char* pubKeyDer, unsigned int* pubKeySz,
2965 unsigned char* out, unsigned int* outlen,
2966 int side, void* ctx);
2967 /* side is WOLFSSL_CLIENT_END or WOLFSSL_SERVER_END */
2968WOLFSSL_API void wolfSSL_CTX_SetX448SharedSecretCb(WOLFSSL_CTX*,
2969 CallbackX448SharedSecret);
2970WOLFSSL_API void wolfSSL_SetX448SharedSecretCtx(WOLFSSL* ssl, void *ctx);
2971WOLFSSL_API void* wolfSSL_GetX448SharedSecretCtx(WOLFSSL* ssl);
2972#endif
2973
2974#ifndef NO_RSA
2975typedef int (*CallbackRsaSign)(WOLFSSL* ssl,
2976 const unsigned char* in, unsigned int inSz,
2977 unsigned char* out, word32* outSz,
2978 const unsigned char* keyDer, unsigned int keySz,
2979 void* ctx);
2980WOLFSSL_API void wolfSSL_CTX_SetRsaSignCb(WOLFSSL_CTX*, CallbackRsaSign);
2981WOLFSSL_API void wolfSSL_SetRsaSignCtx(WOLFSSL* ssl, void *ctx);
2982WOLFSSL_API void* wolfSSL_GetRsaSignCtx(WOLFSSL* ssl);
2983
2984typedef int (*CallbackRsaVerify)(WOLFSSL* ssl,
2985 unsigned char* sig, unsigned int sigSz,
2986 unsigned char** out,
2987 const unsigned char* keyDer, unsigned int keySz,
2988 void* ctx);
2989WOLFSSL_API void wolfSSL_CTX_SetRsaVerifyCb(WOLFSSL_CTX*, CallbackRsaVerify);
2990WOLFSSL_API void wolfSSL_CTX_SetRsaSignCheckCb(WOLFSSL_CTX*, CallbackRsaVerify);
2991WOLFSSL_API void wolfSSL_SetRsaVerifyCtx(WOLFSSL* ssl, void *ctx);
2992WOLFSSL_API void* wolfSSL_GetRsaVerifyCtx(WOLFSSL* ssl);
2993
2994#ifdef WC_RSA_PSS
2995typedef int (*CallbackRsaPssSign)(WOLFSSL* ssl,
2996 const unsigned char* in, unsigned int inSz,
2997 unsigned char* out, unsigned int* outSz,
2998 int hash, int mgf,
2999 const unsigned char* keyDer, unsigned int keySz,
3000 void* ctx);
3001WOLFSSL_API void wolfSSL_CTX_SetRsaPssSignCb(WOLFSSL_CTX*, CallbackRsaPssSign);
3002WOLFSSL_API void wolfSSL_SetRsaPssSignCtx(WOLFSSL* ssl, void *ctx);
3003WOLFSSL_API void* wolfSSL_GetRsaPssSignCtx(WOLFSSL* ssl);
3004
3005typedef int (*CallbackRsaPssVerify)(WOLFSSL* ssl,
3006 unsigned char* sig, unsigned int sigSz,
3007 unsigned char** out,
3008 int hash, int mgf,
3009 const unsigned char* keyDer, unsigned int keySz,
3010 void* ctx);
3011WOLFSSL_API void wolfSSL_CTX_SetRsaPssVerifyCb(WOLFSSL_CTX*,
3012 CallbackRsaPssVerify);
3013WOLFSSL_API void wolfSSL_CTX_SetRsaPssSignCheckCb(WOLFSSL_CTX*,
3014 CallbackRsaPssVerify);
3015WOLFSSL_API void wolfSSL_SetRsaPssVerifyCtx(WOLFSSL* ssl, void *ctx);
3016WOLFSSL_API void* wolfSSL_GetRsaPssVerifyCtx(WOLFSSL* ssl);
3017#endif
3018
3019/* RSA Public Encrypt cb */
3020typedef int (*CallbackRsaEnc)(WOLFSSL* ssl,
3021 const unsigned char* in, unsigned int inSz,
3022 unsigned char* out, word32* outSz,
3023 const unsigned char* keyDer, unsigned int keySz,
3024 void* ctx);
3025WOLFSSL_API void wolfSSL_CTX_SetRsaEncCb(WOLFSSL_CTX*, CallbackRsaEnc);
3026WOLFSSL_API void wolfSSL_SetRsaEncCtx(WOLFSSL* ssl, void *ctx);
3027WOLFSSL_API void* wolfSSL_GetRsaEncCtx(WOLFSSL* ssl);
3028
3029/* RSA Private Decrypt cb */
3030typedef int (*CallbackRsaDec)(WOLFSSL* ssl,
3031 unsigned char* in, unsigned int inSz,
3032 unsigned char** out,
3033 const unsigned char* keyDer, unsigned int keySz,
3034 void* ctx);
3035WOLFSSL_API void wolfSSL_CTX_SetRsaDecCb(WOLFSSL_CTX*, CallbackRsaDec);
3036WOLFSSL_API void wolfSSL_SetRsaDecCtx(WOLFSSL* ssl, void *ctx);
3037WOLFSSL_API void* wolfSSL_GetRsaDecCtx(WOLFSSL* ssl);
3038#endif
3039#endif /* HAVE_PK_CALLBACKS */
3040
3041#ifndef NO_CERTS
3042 WOLFSSL_API void wolfSSL_CTX_SetCACb(WOLFSSL_CTX*, CallbackCACache);
3043
3044 WOLFSSL_API WOLFSSL_CERT_MANAGER* wolfSSL_CTX_GetCertManager(WOLFSSL_CTX*);
3045
3046 WOLFSSL_API WOLFSSL_CERT_MANAGER* wolfSSL_CertManagerNew_ex(void* heap);
3047 WOLFSSL_API WOLFSSL_CERT_MANAGER* wolfSSL_CertManagerNew(void);
3048 WOLFSSL_API void wolfSSL_CertManagerFree(WOLFSSL_CERT_MANAGER*);
3049 WOLFSSL_API int wolfSSL_CertManager_up_ref(WOLFSSL_CERT_MANAGER*);
3050
3051 WOLFSSL_API int wolfSSL_CertManagerLoadCA(WOLFSSL_CERT_MANAGER*, const char* f,
3052 const char* d);
3053 WOLFSSL_API int wolfSSL_CertManagerLoadCABuffer(WOLFSSL_CERT_MANAGER*,
3054 const unsigned char* in, long sz, int format);
3055 WOLFSSL_API int wolfSSL_CertManagerUnloadCAs(WOLFSSL_CERT_MANAGER* cm);
3056#ifdef WOLFSSL_TRUST_PEER_CERT
3057 WOLFSSL_API int wolfSSL_CertManagerUnload_trust_peers(WOLFSSL_CERT_MANAGER* cm);
3058#endif
3059 WOLFSSL_API int wolfSSL_CertManagerVerify(WOLFSSL_CERT_MANAGER*, const char* f,
3060 int format);
3061 WOLFSSL_API int wolfSSL_CertManagerVerifyBuffer(WOLFSSL_CERT_MANAGER* cm,
3062 const unsigned char* buff, long sz, int format);
3063 WOLFSSL_API int wolfSSL_CertManagerCheckCRL(WOLFSSL_CERT_MANAGER*,
3064 unsigned char*, int sz);
3065 WOLFSSL_API int wolfSSL_CertManagerEnableCRL(WOLFSSL_CERT_MANAGER*,
3066 int options);
3067 WOLFSSL_API int wolfSSL_CertManagerDisableCRL(WOLFSSL_CERT_MANAGER*);
3068 WOLFSSL_API void wolfSSL_CertManagerSetVerify(WOLFSSL_CERT_MANAGER* cm,
3069 VerifyCallback vc);
3070 WOLFSSL_API int wolfSSL_CertManagerLoadCRL(WOLFSSL_CERT_MANAGER*,
3071 const char*, int, int);
3072 WOLFSSL_API int wolfSSL_CertManagerLoadCRLBuffer(WOLFSSL_CERT_MANAGER*,
3073 const unsigned char*, long sz, int);
3074 WOLFSSL_API int wolfSSL_CertManagerSetCRL_Cb(WOLFSSL_CERT_MANAGER*,
3075 CbMissingCRL);
3076 WOLFSSL_API int wolfSSL_CertManagerFreeCRL(WOLFSSL_CERT_MANAGER *);
3077#ifdef HAVE_CRL_IO
3078 WOLFSSL_API int wolfSSL_CertManagerSetCRL_IOCb(WOLFSSL_CERT_MANAGER*,
3079 CbCrlIO);
3080#endif
3081#if defined(HAVE_OCSP)
3082 WOLFSSL_API int wolfSSL_CertManagerCheckOCSPResponse(WOLFSSL_CERT_MANAGER *,
3083 byte *response, int responseSz, WOLFSSL_BUFFER_INFO *responseBuffer,
3084 CertStatus *status, OcspEntry *entry, OcspRequest *ocspRequest);
3085#endif
3086 WOLFSSL_API int wolfSSL_CertManagerCheckOCSP(WOLFSSL_CERT_MANAGER*,
3087 unsigned char*, int sz);
3088 WOLFSSL_API int wolfSSL_CertManagerEnableOCSP(WOLFSSL_CERT_MANAGER*,
3089 int options);
3090 WOLFSSL_API int wolfSSL_CertManagerDisableOCSP(WOLFSSL_CERT_MANAGER*);
3091 WOLFSSL_API int wolfSSL_CertManagerSetOCSPOverrideURL(WOLFSSL_CERT_MANAGER*,
3092 const char*);
3093 WOLFSSL_API int wolfSSL_CertManagerSetOCSP_Cb(WOLFSSL_CERT_MANAGER*,
3094 CbOCSPIO, CbOCSPRespFree, void*);
3095
3096 WOLFSSL_API int wolfSSL_CertManagerEnableOCSPStapling(
3097 WOLFSSL_CERT_MANAGER* cm);
3098 WOLFSSL_API int wolfSSL_CertManagerDisableOCSPStapling(
3099 WOLFSSL_CERT_MANAGER* cm);
3100 WOLFSSL_API int wolfSSL_CertManagerEnableOCSPMustStaple(
3101 WOLFSSL_CERT_MANAGER* cm);
3102 WOLFSSL_API int wolfSSL_CertManagerDisableOCSPMustStaple(
3103 WOLFSSL_CERT_MANAGER* cm);
3104#if defined(OPENSSL_EXTRA) && defined(WOLFSSL_SIGNER_DER_CERT) && \
3105 !defined(NO_FILESYSTEM)
3106WOLFSSL_API WOLFSSL_STACK* wolfSSL_CertManagerGetCerts(WOLFSSL_CERT_MANAGER* cm);
3107WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509)* wolfSSL_X509_STORE_get1_certs(
3108 WOLFSSL_X509_STORE_CTX*, WOLFSSL_X509_NAME*);
3109#endif /* OPENSSL_EXTRA && WOLFSSL_SIGNER_DER_CERT && !NO_FILESYSTEM */
3110 WOLFSSL_API int wolfSSL_EnableCRL(WOLFSSL* ssl, int options);
3111 WOLFSSL_API int wolfSSL_DisableCRL(WOLFSSL* ssl);
3112 WOLFSSL_API int wolfSSL_LoadCRL(WOLFSSL*, const char*, int, int);
3113 WOLFSSL_API int wolfSSL_LoadCRLBuffer(WOLFSSL*,
3114 const unsigned char*, long sz, int);
3115 WOLFSSL_API int wolfSSL_SetCRL_Cb(WOLFSSL*, CbMissingCRL);
3116#ifdef HAVE_CRL_IO
3117 WOLFSSL_API int wolfSSL_SetCRL_IOCb(WOLFSSL* ssl, CbCrlIO cb);
3118#endif
3119 WOLFSSL_API int wolfSSL_EnableOCSP(WOLFSSL*, int options);
3120 WOLFSSL_API int wolfSSL_DisableOCSP(WOLFSSL*);
3121 WOLFSSL_API int wolfSSL_SetOCSP_OverrideURL(WOLFSSL*, const char*);
3122 WOLFSSL_API int wolfSSL_SetOCSP_Cb(WOLFSSL*, CbOCSPIO, CbOCSPRespFree, void*);
3123 WOLFSSL_API int wolfSSL_EnableOCSPStapling(WOLFSSL*);
3124 WOLFSSL_API int wolfSSL_DisableOCSPStapling(WOLFSSL*);
3125
3126 WOLFSSL_API int wolfSSL_CTX_EnableCRL(WOLFSSL_CTX* ctx, int options);
3127 WOLFSSL_API int wolfSSL_CTX_DisableCRL(WOLFSSL_CTX* ctx);
3128 WOLFSSL_API int wolfSSL_CTX_LoadCRL(WOLFSSL_CTX*, const char*, int, int);
3129 WOLFSSL_API int wolfSSL_CTX_LoadCRLBuffer(WOLFSSL_CTX*,
3130 const unsigned char*, long sz, int);
3131 WOLFSSL_API int wolfSSL_CTX_SetCRL_Cb(WOLFSSL_CTX*, CbMissingCRL);
3132#ifdef HAVE_CRL_IO
3133 WOLFSSL_API int wolfSSL_CTX_SetCRL_IOCb(WOLFSSL_CTX*, CbCrlIO);
3134#endif
3135
3136 WOLFSSL_API int wolfSSL_CTX_EnableOCSP(WOLFSSL_CTX*, int options);
3137 WOLFSSL_API int wolfSSL_CTX_DisableOCSP(WOLFSSL_CTX*);
3138 WOLFSSL_API int wolfSSL_CTX_SetOCSP_OverrideURL(WOLFSSL_CTX*, const char*);
3139 WOLFSSL_API int wolfSSL_CTX_SetOCSP_Cb(WOLFSSL_CTX*,
3140 CbOCSPIO, CbOCSPRespFree, void*);
3141 WOLFSSL_API int wolfSSL_CTX_EnableOCSPStapling(WOLFSSL_CTX*);
3142 WOLFSSL_API int wolfSSL_CTX_DisableOCSPStapling(WOLFSSL_CTX*);
3143 WOLFSSL_API int wolfSSL_CTX_EnableOCSPMustStaple(WOLFSSL_CTX*);
3144 WOLFSSL_API int wolfSSL_CTX_DisableOCSPMustStaple(WOLFSSL_CTX*);
3145#endif /* !NO_CERTS */
3146
3147
3148#ifdef SINGLE_THREADED
3149 WOLFSSL_API int wolfSSL_CTX_new_rng(WOLFSSL_CTX*);
3150#endif
3151
3152/* end of handshake frees temporary arrays, if user needs for get_keys or
3153 psk hints, call KeepArrays before handshake and then FreeArrays when done
3154 if don't want to wait for object free */
3155WOLFSSL_API void wolfSSL_KeepArrays(WOLFSSL*);
3156WOLFSSL_API void wolfSSL_FreeArrays(WOLFSSL*);
3157
3158WOLFSSL_API int wolfSSL_KeepHandshakeResources(WOLFSSL* ssl);
3159WOLFSSL_API int wolfSSL_FreeHandshakeResources(WOLFSSL* ssl);
3160
3161WOLFSSL_API int wolfSSL_CTX_UseClientSuites(WOLFSSL_CTX* ctx);
3162WOLFSSL_API int wolfSSL_UseClientSuites(WOLFSSL* ssl);
3163
3164/* async additions */
3165#define wolfSSL_UseAsync wolfSSL_SetDevId
3166#define wolfSSL_CTX_UseAsync wolfSSL_CTX_SetDevId
3167WOLFSSL_ABI WOLFSSL_API int wolfSSL_SetDevId(WOLFSSL*, int devId);
3168WOLFSSL_ABI WOLFSSL_API int wolfSSL_CTX_SetDevId(WOLFSSL_CTX*, int devId);
3169
3170/* helpers to get device id and heap */
3171WOLFSSL_ABI WOLFSSL_API int wolfSSL_CTX_GetDevId(WOLFSSL_CTX*, WOLFSSL*);
3172WOLFSSL_API void* wolfSSL_CTX_GetHeap(WOLFSSL_CTX* ctx, WOLFSSL* ssl);
3173
3174/* TLS Extensions */
3175
3176/* Server Name Indication */
3177#ifdef HAVE_SNI
3178
3179/* SNI types */
3180enum {
3181 WOLFSSL_SNI_HOST_NAME = 0
3182};
3183
3184WOLFSSL_ABI WOLFSSL_API int wolfSSL_UseSNI(WOLFSSL*, unsigned char,
3185 const void*, unsigned short);
3186WOLFSSL_ABI WOLFSSL_API int wolfSSL_CTX_UseSNI(WOLFSSL_CTX*, unsigned char,
3187 const void*, unsigned short);
3188
3189#ifndef NO_WOLFSSL_SERVER
3190
3191/* SNI options */
3192enum {
3193 /* Do not abort the handshake if the requested SNI didn't match. */
3194 WOLFSSL_SNI_CONTINUE_ON_MISMATCH = 0x01,
3195
3196 /* Behave as if the requested SNI matched in a case of mismatch. */
3197 /* In this case, the status will be set to WOLFSSL_SNI_FAKE_MATCH. */
3198 WOLFSSL_SNI_ANSWER_ON_MISMATCH = 0x02,
3199
3200 /* Abort the handshake if the client didn't send a SNI request. */
3201 WOLFSSL_SNI_ABORT_ON_ABSENCE = 0x04,
3202};
3203
3204WOLFSSL_API void wolfSSL_SNI_SetOptions(WOLFSSL* ssl, unsigned char type,
3205 unsigned char options);
3206WOLFSSL_API void wolfSSL_CTX_SNI_SetOptions(WOLFSSL_CTX* ctx,
3207 unsigned char type, unsigned char options);
3208WOLFSSL_API int wolfSSL_SNI_GetFromBuffer(
3209 const unsigned char* clientHello, unsigned int helloSz,
3210 unsigned char type, unsigned char* sni, unsigned int* inOutSz);
3211
3212#endif /* NO_WOLFSSL_SERVER */
3213
3214/* SNI status */
3215enum {
3216 WOLFSSL_SNI_NO_MATCH = 0,
3217 WOLFSSL_SNI_FAKE_MATCH = 1, /**< @see WOLFSSL_SNI_ANSWER_ON_MISMATCH */
3218 WOLFSSL_SNI_REAL_MATCH = 2,
3219 WOLFSSL_SNI_FORCE_KEEP = 3 /** Used with -DWOLFSSL_ALWAYS_KEEP_SNI */
3220};
3221
3222WOLFSSL_API unsigned char wolfSSL_SNI_Status(WOLFSSL* ssl, unsigned char type);
3223
3224WOLFSSL_API unsigned short wolfSSL_SNI_GetRequest(WOLFSSL *ssl,
3225 unsigned char type, void** data);
3226
3227#endif /* HAVE_SNI */
3228
3229/* Trusted CA Key Indication - RFC 6066 (Section 6) */
3230#ifdef HAVE_TRUSTED_CA
3231
3232/* TCA Identifier Type */
3233enum {
3234 WOLFSSL_TRUSTED_CA_PRE_AGREED = 0,
3235 WOLFSSL_TRUSTED_CA_KEY_SHA1 = 1,
3236 WOLFSSL_TRUSTED_CA_X509_NAME = 2,
3237 WOLFSSL_TRUSTED_CA_CERT_SHA1 = 3
3238};
3239
3240WOLFSSL_API int wolfSSL_UseTrustedCA(WOLFSSL* ssl, unsigned char type,
3241 const unsigned char* certId, unsigned int certIdSz);
3242#endif /* HAVE_TRUSTED_CA */
3243
3244/* Application-Layer Protocol Negotiation */
3245#ifdef HAVE_ALPN
3246
3247/* ALPN status code */
3248enum {
3249 WOLFSSL_ALPN_NO_MATCH = 0,
3250 WOLFSSL_ALPN_MATCH = 1,
3251 WOLFSSL_ALPN_CONTINUE_ON_MISMATCH = 2,
3252 WOLFSSL_ALPN_FAILED_ON_MISMATCH = 4,
3253};
3254
3255enum {
3256 WOLFSSL_MAX_ALPN_PROTO_NAME_LEN = 255,
3257 WOLFSSL_MAX_ALPN_NUMBER = 257
3258};
3259
3260#if defined(OPENSSL_ALL) || defined(WOLFSSL_NGINX) || defined(WOLFSSL_HAPROXY) || defined(HAVE_LIGHTY)
3261typedef int (*CallbackALPNSelect)(WOLFSSL* ssl, const unsigned char** out,
3262 unsigned char* outLen, const unsigned char* in, unsigned int inLen,
3263 void *arg);
3264#endif
3265
3266WOLFSSL_ABI WOLFSSL_API int wolfSSL_UseALPN(WOLFSSL* ssl,
3267 char *protocol_name_list,
3268 unsigned int protocol_name_listSz,
3269 unsigned char options);
3270
3271WOLFSSL_API int wolfSSL_ALPN_GetProtocol(WOLFSSL* ssl, char **protocol_name,
3272 unsigned short *size);
3273
3274WOLFSSL_API int wolfSSL_ALPN_GetPeerProtocol(WOLFSSL* ssl, char **list,
3275 unsigned short *listSz);
3276WOLFSSL_API int wolfSSL_ALPN_FreePeerProtocol(WOLFSSL* ssl, char **list);
3277#endif /* HAVE_ALPN */
3278
3279/* Maximum Fragment Length */
3280#ifdef HAVE_MAX_FRAGMENT
3281
3282/* Fragment lengths */
3283enum {
3284 WOLFSSL_MFL_2_9 = 1, /* 512 bytes */
3285 WOLFSSL_MFL_2_10 = 2, /* 1024 bytes */
3286 WOLFSSL_MFL_2_11 = 3, /* 2048 bytes */
3287 WOLFSSL_MFL_2_12 = 4, /* 4096 bytes */
3288 WOLFSSL_MFL_2_13 = 5, /* 8192 bytes *//* wolfSSL ONLY!!! */
3289 WOLFSSL_MFL_2_8 = 6, /* 256 bytes *//* wolfSSL ONLY!!! */
3290 WOLFSSL_MFL_MIN = WOLFSSL_MFL_2_9,
3291 WOLFSSL_MFL_MAX = WOLFSSL_MFL_2_8,
3292};
3293
3294#ifndef NO_WOLFSSL_CLIENT
3295
3296WOLFSSL_API int wolfSSL_UseMaxFragment(WOLFSSL* ssl, unsigned char mfl);
3297WOLFSSL_API int wolfSSL_CTX_UseMaxFragment(WOLFSSL_CTX* ctx, unsigned char mfl);
3298
3299#endif
3300#endif /* HAVE_MAX_FRAGMENT */
3301
3302/* Truncated HMAC */
3303#ifdef HAVE_TRUNCATED_HMAC
3304#ifndef NO_WOLFSSL_CLIENT
3305
3306WOLFSSL_API int wolfSSL_UseTruncatedHMAC(WOLFSSL* ssl);
3307WOLFSSL_API int wolfSSL_CTX_UseTruncatedHMAC(WOLFSSL_CTX* ctx);
3308
3309#endif
3310#endif
3311
3312/* Certificate Status Request */
3313/* Certificate Status Type */
3314enum {
3315 WOLFSSL_CSR_OCSP = 1
3316};
3317
3318/* Certificate Status Options (flags) */
3319enum {
3320 WOLFSSL_CSR_OCSP_USE_NONCE = 0x01
3321};
3322
3323#ifdef HAVE_CERTIFICATE_STATUS_REQUEST
3324#ifndef NO_WOLFSSL_CLIENT
3325
3326WOLFSSL_API int wolfSSL_UseOCSPStapling(WOLFSSL* ssl,
3327 unsigned char status_type, unsigned char options);
3328
3329WOLFSSL_API int wolfSSL_CTX_UseOCSPStapling(WOLFSSL_CTX* ctx,
3330 unsigned char status_type, unsigned char options);
3331
3332#endif
3333#endif
3334
3335/* Certificate Status Request v2 */
3336/* Certificate Status Type */
3337enum {
3338 WOLFSSL_CSR2_OCSP = 1,
3339 WOLFSSL_CSR2_OCSP_MULTI = 2
3340};
3341
3342/* Certificate Status v2 Options (flags) */
3343enum {
3344 WOLFSSL_CSR2_OCSP_USE_NONCE = 0x01
3345};
3346
3347#ifdef HAVE_CERTIFICATE_STATUS_REQUEST_V2
3348#ifndef NO_WOLFSSL_CLIENT
3349
3350WOLFSSL_API int wolfSSL_UseOCSPStaplingV2(WOLFSSL* ssl,
3351 unsigned char status_type, unsigned char options);
3352
3353WOLFSSL_API int wolfSSL_CTX_UseOCSPStaplingV2(WOLFSSL_CTX* ctx,
3354 unsigned char status_type, unsigned char options);
3355
3356#endif
3357#endif
3358
3359/* Named Groups */
3360enum {
3361#if 0 /* Not Supported */
3362 WOLFSSL_ECC_SECT163K1 = 1,
3363 WOLFSSL_ECC_SECT163R1 = 2,
3364 WOLFSSL_ECC_SECT163R2 = 3,
3365 WOLFSSL_ECC_SECT193R1 = 4,
3366 WOLFSSL_ECC_SECT193R2 = 5,
3367 WOLFSSL_ECC_SECT233K1 = 6,
3368 WOLFSSL_ECC_SECT233R1 = 7,
3369 WOLFSSL_ECC_SECT239K1 = 8,
3370 WOLFSSL_ECC_SECT283K1 = 9,
3371 WOLFSSL_ECC_SECT283R1 = 10,
3372 WOLFSSL_ECC_SECT409K1 = 11,
3373 WOLFSSL_ECC_SECT409R1 = 12,
3374 WOLFSSL_ECC_SECT571K1 = 13,
3375 WOLFSSL_ECC_SECT571R1 = 14,
3376#endif
3377 WOLFSSL_ECC_SECP160K1 = 15,
3378 WOLFSSL_ECC_SECP160R1 = 16,
3379 WOLFSSL_ECC_SECP160R2 = 17,
3380 WOLFSSL_ECC_SECP192K1 = 18,
3381 WOLFSSL_ECC_SECP192R1 = 19,
3382 WOLFSSL_ECC_SECP224K1 = 20,
3383 WOLFSSL_ECC_SECP224R1 = 21,
3384 WOLFSSL_ECC_SECP256K1 = 22,
3385 WOLFSSL_ECC_SECP256R1 = 23,
3386 WOLFSSL_ECC_SECP384R1 = 24,
3387 WOLFSSL_ECC_SECP521R1 = 25,
3388 WOLFSSL_ECC_BRAINPOOLP256R1 = 26,
3389 WOLFSSL_ECC_BRAINPOOLP384R1 = 27,
3390 WOLFSSL_ECC_BRAINPOOLP512R1 = 28,
3391 WOLFSSL_ECC_X25519 = 29,
3392 WOLFSSL_ECC_X448 = 30,
3393 WOLFSSL_ECC_MAX = 30,
3394
3395 WOLFSSL_FFDHE_2048 = 256,
3396 WOLFSSL_FFDHE_3072 = 257,
3397 WOLFSSL_FFDHE_4096 = 258,
3398 WOLFSSL_FFDHE_6144 = 259,
3399 WOLFSSL_FFDHE_8192 = 260,
3400};
3401
3402enum {
3403 WOLFSSL_EC_PF_UNCOMPRESSED = 0,
3404#if 0 /* Not Supported */
3405 WOLFSSL_EC_PF_X962_COMP_PRIME = 1,
3406 WOLFSSL_EC_PF_X962_COMP_CHAR2 = 2,
3407#endif
3408};
3409
3410#ifdef HAVE_SUPPORTED_CURVES
3411WOLFSSL_API int wolfSSL_UseSupportedCurve(WOLFSSL* ssl, word16 name);
3412WOLFSSL_API int wolfSSL_CTX_UseSupportedCurve(WOLFSSL_CTX* ctx,
3413 word16 name);
3414#endif
3415
3416#ifdef WOLFSSL_TLS13
3417WOLFSSL_API int wolfSSL_UseKeyShare(WOLFSSL* ssl, word16 group);
3418WOLFSSL_API int wolfSSL_NoKeyShares(WOLFSSL* ssl);
3419#endif
3420
3421
3422/* Secure Renegotiation */
3423#ifdef HAVE_SECURE_RENEGOTIATION
3424
3425WOLFSSL_API int wolfSSL_UseSecureRenegotiation(WOLFSSL* ssl);
3426WOLFSSL_API int wolfSSL_CTX_UseSecureRenegotiation(WOLFSSL_CTX* ctx);
3427WOLFSSL_API int wolfSSL_StartSecureRenegotiation(WOLFSSL* ssl, int resume);
3428WOLFSSL_API int wolfSSL_Rehandshake(WOLFSSL* ssl);
3429WOLFSSL_API int wolfSSL_SecureResume(WOLFSSL* ssl);
3430WOLFSSL_API long wolfSSL_SSL_get_secure_renegotiation_support(WOLFSSL* ssl);
3431
3432#endif
3433
3434#if defined(HAVE_SELFTEST) && \
3435 (!defined(HAVE_SELFTEST_VERSION) || (HAVE_SELFTEST_VERSION < 2))
3436
3437 /* Needed by session ticket stuff below */
3438 #ifndef WOLFSSL_AES_KEY_SIZE_ENUM
3439 #define WOLFSSL_AES_KEY_SIZE_ENUM
3440 enum SSL_Misc {
3441 AES_IV_SIZE = 16,
3442 AES_128_KEY_SIZE = 16,
3443 AES_192_KEY_SIZE = 24,
3444 AES_256_KEY_SIZE = 32
3445 };
3446 #endif
3447#endif
3448
3449/* Session Ticket */
3450#ifdef HAVE_SESSION_TICKET
3451
3452#if !defined(WOLFSSL_NO_DEF_TICKET_ENC_CB) && !defined(WOLFSSL_NO_SERVER)
3453 #if defined(HAVE_CHACHA) && defined(HAVE_POLY1305) && \
3454 !defined(WOLFSSL_TICKET_ENC_AES128_GCM) && \
3455 !defined(WOLFSSL_TICKET_ENC_AES256_GCM)
3456 #define WOLFSSL_TICKET_KEY_SZ CHACHA20_POLY1305_AEAD_KEYSIZE
3457 #elif defined(WOLFSSL_TICKET_ENC_AES256_GCM)
3458 #define WOLFSSL_TICKET_KEY_SZ AES_256_KEY_SIZE
3459 #else
3460 #define WOLFSSL_TICKET_KEY_SZ AES_128_KEY_SIZE
3461 #endif
3462
3463 #define WOLFSSL_TICKET_KEYS_SZ (WOLFSSL_TICKET_NAME_SZ + \
3464 2 * WOLFSSL_TICKET_KEY_SZ + \
3465 sizeof(word32) * 2)
3466#endif
3467
3468#ifndef NO_WOLFSSL_CLIENT
3469WOLFSSL_API int wolfSSL_UseSessionTicket(WOLFSSL* ssl);
3470WOLFSSL_API int wolfSSL_CTX_UseSessionTicket(WOLFSSL_CTX* ctx);
3471WOLFSSL_API int wolfSSL_get_SessionTicket(WOLFSSL*, unsigned char*, word32*);
3472WOLFSSL_API int wolfSSL_set_SessionTicket(WOLFSSL*, const unsigned char*, word32);
3473typedef int (*CallbackSessionTicket)(WOLFSSL*, const unsigned char*, int, void*);
3474WOLFSSL_API int wolfSSL_set_SessionTicket_cb(WOLFSSL*,
3475 CallbackSessionTicket, void*);
3476#endif /* NO_WOLFSSL_CLIENT */
3477
3478
3479#define WOLFSSL_TICKET_NAME_SZ 16
3480#define WOLFSSL_TICKET_IV_SZ 16
3481#define WOLFSSL_TICKET_MAC_SZ 32
3482
3483enum TicketEncRet {
3484 WOLFSSL_TICKET_RET_FATAL = -1, /* fatal error, don't use ticket */
3485 WOLFSSL_TICKET_RET_OK = 0, /* ok, use ticket */
3486 WOLFSSL_TICKET_RET_REJECT, /* don't use ticket, but not fatal */
3487 WOLFSSL_TICKET_RET_CREATE /* existing ticket ok and create new one */
3488};
3489
3490#ifndef NO_WOLFSSL_SERVER
3491
3492WOLFSSL_API int wolfSSL_CTX_NoTicketTLSv12(WOLFSSL_CTX* ctx);
3493WOLFSSL_API int wolfSSL_NoTicketTLSv12(WOLFSSL* ssl);
3494
3495typedef int (*SessionTicketEncCb)(WOLFSSL*,
3496 unsigned char key_name[WOLFSSL_TICKET_NAME_SZ],
3497 unsigned char iv[WOLFSSL_TICKET_IV_SZ],
3498 unsigned char mac[WOLFSSL_TICKET_MAC_SZ],
3499 int enc, unsigned char*, int, int*, void*);
3500WOLFSSL_API int wolfSSL_CTX_set_TicketEncCb(WOLFSSL_CTX* ctx,
3501 SessionTicketEncCb);
3502WOLFSSL_API int wolfSSL_CTX_set_TicketHint(WOLFSSL_CTX* ctx, int);
3503WOLFSSL_API int wolfSSL_CTX_set_TicketEncCtx(WOLFSSL_CTX* ctx, void*);
3504WOLFSSL_API void* wolfSSL_CTX_get_TicketEncCtx(WOLFSSL_CTX* ctx);
3505
3506#endif /* NO_WOLFSSL_SERVER */
3507
3508#endif /* HAVE_SESSION_TICKET */
3509
3510#ifdef HAVE_QSH
3511/* Quantum-safe Crypto Schemes */
3512enum {
3513 WOLFSSL_NTRU_EESS439 = 0x0101, /* max plaintext length of 65 */
3514 WOLFSSL_NTRU_EESS593 = 0x0102, /* max plaintext length of 86 */
3515 WOLFSSL_NTRU_EESS743 = 0x0103, /* max plaintext length of 106 */
3516 WOLFSSL_LWE_XXX = 0x0201, /* Learning With Error encryption scheme */
3517 WOLFSSL_HFE_XXX = 0x0301, /* Hidden Field Equation scheme */
3518 WOLFSSL_NULL_QSH = 0xFFFF /* QSHScheme is not used */
3519};
3520
3521
3522/* test if the connection is using a QSH secure connection return 1 if so */
3523WOLFSSL_API int wolfSSL_isQSH(WOLFSSL* ssl);
3524WOLFSSL_API int wolfSSL_UseSupportedQSH(WOLFSSL* ssl, unsigned short name);
3525#ifndef NO_WOLFSSL_CLIENT
3526 /* user control over sending client public key in hello
3527 when flag = 1 will send keys if flag is 0 or function is not called
3528 then will not send keys in the hello extension */
3529 WOLFSSL_API int wolfSSL_UseClientQSHKeys(WOLFSSL* ssl, unsigned char flag);
3530#endif
3531
3532#endif /* QSH */
3533
3534/* TLS Extended Master Secret Extension */
3535WOLFSSL_API int wolfSSL_DisableExtendedMasterSecret(WOLFSSL* ssl);
3536WOLFSSL_API int wolfSSL_CTX_DisableExtendedMasterSecret(WOLFSSL_CTX* ctx);
3537
3538
3539#define WOLFSSL_CRL_MONITOR 0x01 /* monitor this dir flag */
3540#define WOLFSSL_CRL_START_MON 0x02 /* start monitoring flag */
3541
3542
3543/* notify user the handshake is done */
3544typedef int (*HandShakeDoneCb)(WOLFSSL*, void*);
3545WOLFSSL_API int wolfSSL_SetHsDoneCb(WOLFSSL*, HandShakeDoneCb, void*);
3546
3547
3548WOLFSSL_API int wolfSSL_PrintSessionStats(void);
3549WOLFSSL_API int wolfSSL_get_session_stats(unsigned int* active,
3550 unsigned int* total,
3551 unsigned int* peak,
3552 unsigned int* maxSessions);
3553/* External facing KDF */
3554WOLFSSL_API
3555int wolfSSL_MakeTlsMasterSecret(unsigned char* ms, word32 msLen,
3556 const unsigned char* pms, word32 pmsLen,
3557 const unsigned char* cr, const unsigned char* sr,
3558 int tls1_2, int hash_type);
3559
3560WOLFSSL_API
3561int wolfSSL_MakeTlsExtendedMasterSecret(unsigned char* ms, word32 msLen,
3562 const unsigned char* pms, word32 pmsLen,
3563 const unsigned char* sHash, word32 sHashLen,
3564 int tls1_2, int hash_type);
3565
3566WOLFSSL_API
3567int wolfSSL_DeriveTlsKeys(unsigned char* key_data, word32 keyLen,
3568 const unsigned char* ms, word32 msLen,
3569 const unsigned char* sr, const unsigned char* cr,
3570 int tls1_2, int hash_type);
3571
3572#ifdef WOLFSSL_CALLBACKS
3573
3574typedef int (*HandShakeCallBack)(HandShakeInfo*);
3575typedef int (*TimeoutCallBack)(TimeoutInfo*);
3576
3577/* wolfSSL connect extension allowing HandShakeCallBack and/or TimeoutCallBack
3578 for diagnostics */
3579WOLFSSL_API int wolfSSL_connect_ex(WOLFSSL*, HandShakeCallBack, TimeoutCallBack,
3580 WOLFSSL_TIMEVAL);
3581WOLFSSL_API int wolfSSL_accept_ex(WOLFSSL*, HandShakeCallBack, TimeoutCallBack,
3582 WOLFSSL_TIMEVAL);
3583
3584#endif /* WOLFSSL_CALLBACKS */
3585
3586
3587#ifdef WOLFSSL_HAVE_WOLFSCEP
3588 WOLFSSL_API void wolfSSL_wolfSCEP(void);
3589#endif /* WOLFSSL_HAVE_WOLFSCEP */
3590
3591#ifdef WOLFSSL_HAVE_CERT_SERVICE
3592 WOLFSSL_API void wolfSSL_cert_service(void);
3593#endif
3594
3595#if defined(OPENSSL_ALL) || defined(OPENSSL_EXTRA) || defined(OPENSSL_EXTRA_X509_SMALL)
3596/* Smaller subset of X509 compatibility functions. Avoid increasing the size of
3597 * this subset and its memory usage */
3598
3599#include <wolfssl/openssl/asn1.h>
3600struct WOLFSSL_X509_NAME_ENTRY {
3601 WOLFSSL_ASN1_OBJECT* object; /* static object just for keeping grp, type */
3602 WOLFSSL_ASN1_STRING* value; /* points to data, for lighttpd port */
3603 int nid; /* i.e. ASN_COMMON_NAME */
3604 int set;
3605 int size;
3606};
3607
3608WOLFSSL_API int wolfSSL_X509_NAME_get_index_by_OBJ(WOLFSSL_X509_NAME *name,
3609 const WOLFSSL_ASN1_OBJECT *obj,
3610 int idx);
3611
3612
3613
3614enum {
3615 WOLFSSL_SYS_ACCEPT = 0,
3616 WOLFSSL_SYS_BIND,
3617 WOLFSSL_SYS_CONNECT,
3618 WOLFSSL_SYS_FOPEN,
3619 WOLFSSL_SYS_FREAD,
3620 WOLFSSL_SYS_GETADDRINFO,
3621 WOLFSSL_SYS_GETSOCKOPT,
3622 WOLFSSL_SYS_GETSOCKNAME,
3623 WOLFSSL_SYS_GETHOSTBYNAME,
3624 WOLFSSL_SYS_GETNAMEINFO,
3625 WOLFSSL_SYS_GETSERVBYNAME,
3626 WOLFSSL_SYS_IOCTLSOCKET,
3627 WOLFSSL_SYS_LISTEN,
3628 WOLFSSL_SYS_OPENDIR,
3629 WOLFSSL_SYS_SETSOCKOPT,
3630 WOLFSSL_SYS_SOCKET
3631};
3632
3633/* Object functions */
3634WOLFSSL_API const char* wolfSSL_OBJ_nid2sn(int n);
3635WOLFSSL_API int wolfSSL_OBJ_obj2nid(const WOLFSSL_ASN1_OBJECT *o);
3636WOLFSSL_API int wolfSSL_OBJ_get_type(const WOLFSSL_ASN1_OBJECT *o);
3637WOLFSSL_API int wolfSSL_OBJ_sn2nid(const char *sn);
3638
3639WOLFSSL_API const char* wolfSSL_OBJ_nid2ln(int n);
3640WOLFSSL_API int wolfSSL_OBJ_ln2nid(const char *ln);
3641WOLFSSL_API int wolfSSL_OBJ_cmp(const WOLFSSL_ASN1_OBJECT* a,
3642 const WOLFSSL_ASN1_OBJECT* b);
3643WOLFSSL_API int wolfSSL_OBJ_txt2nid(const char *sn);
3644WOLFSSL_API WOLFSSL_ASN1_OBJECT* wolfSSL_OBJ_txt2obj(const char* s, int no_name);
3645
3646WOLFSSL_API WOLFSSL_ASN1_OBJECT* wolfSSL_OBJ_nid2obj(int n);
3647WOLFSSL_LOCAL WOLFSSL_ASN1_OBJECT* wolfSSL_OBJ_nid2obj_ex(int n, WOLFSSL_ASN1_OBJECT *arg_obj);
3648WOLFSSL_API int wolfSSL_OBJ_obj2txt(char *buf, int buf_len, WOLFSSL_ASN1_OBJECT *a, int no_name);
3649
3650WOLFSSL_API void wolfSSL_OBJ_cleanup(void);
3651WOLFSSL_API int wolfSSL_OBJ_create(const char *oid, const char *sn, const char *ln);
3652#ifdef HAVE_ECC
3653WOLFSSL_LOCAL int NIDToEccEnum(int n);
3654#endif
3655/* end of object functions */
3656
3657WOLFSSL_API unsigned long wolfSSL_ERR_peek_last_error_line(const char **file, int *line);
3658WOLFSSL_API long wolfSSL_CTX_ctrl(WOLFSSL_CTX* ctx, int cmd, long opt,void* pt);
3659WOLFSSL_API long wolfSSL_CTX_callback_ctrl(WOLFSSL_CTX* ctx, int cmd, void (*fp)(void));
3660WOLFSSL_API long wolfSSL_CTX_clear_extra_chain_certs(WOLFSSL_CTX* ctx);
3661
3662#ifndef NO_CERTS
3663WOLFSSL_API WOLFSSL_X509_NAME_ENTRY* wolfSSL_X509_NAME_ENTRY_create_by_NID(
3664 WOLFSSL_X509_NAME_ENTRY** out, int nid, int type,
3665 const unsigned char* data, int dataSz);
3666WOLFSSL_API WOLFSSL_X509_NAME_ENTRY* wolfSSL_X509_NAME_ENTRY_create_by_txt(
3667 WOLFSSL_X509_NAME_ENTRY **neIn, const char *txt, int format,
3668 const unsigned char *data, int dataSz);
3669WOLFSSL_API int wolfSSL_X509_NAME_add_entry(WOLFSSL_X509_NAME* name,
3670 WOLFSSL_X509_NAME_ENTRY* entry, int idx, int set);
3671WOLFSSL_API int wolfSSL_X509_NAME_add_entry_by_txt(WOLFSSL_X509_NAME *name,
3672 const char *field, int type, const unsigned char *bytes, int len, int loc,
3673 int set);
3674WOLFSSL_API int wolfSSL_X509_NAME_add_entry_by_NID(WOLFSSL_X509_NAME *name, int nid,
3675 int type, const unsigned char *bytes,
3676 int len, int loc, int set);
3677WOLFSSL_API WOLFSSL_X509_NAME_ENTRY *wolfSSL_X509_NAME_delete_entry(
3678 WOLFSSL_X509_NAME *name, int loc);
3679WOLFSSL_API int wolfSSL_X509_NAME_cmp(const WOLFSSL_X509_NAME* x,
3680 const WOLFSSL_X509_NAME* y);
3681WOLFSSL_API WOLFSSL_X509_NAME* wolfSSL_X509_NAME_new(void);
3682WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_dup(WOLFSSL_X509*);
3683WOLFSSL_API WOLFSSL_X509_NAME* wolfSSL_X509_NAME_dup(WOLFSSL_X509_NAME*);
3684WOLFSSL_API int wolfSSL_X509_NAME_copy(WOLFSSL_X509_NAME*, WOLFSSL_X509_NAME*);
3685WOLFSSL_API int wolfSSL_check_private_key(const WOLFSSL* ssl);
3686#endif /* !NO_CERTS */
3687#endif /* OPENSSL_ALL || OPENSSL_EXTRA || OPENSSL_EXTRA_X509_SMALL */
3688
3689#if defined(OPENSSL_ALL) || defined(WOLFSSL_ASIO) || defined(WOLFSSL_HAPROXY) \
3690 || defined(WOLFSSL_NGINX) || defined(WOLFSSL_QT)
3691WOLFSSL_API long wolfSSL_ctrl(WOLFSSL* ssl, int cmd, long opt, void* pt);
3692#endif
3693
3694#if defined(OPENSSL_EXTRA) || defined(WOLFSSL_WPAS_SMALL)
3695WOLFSSL_API void* wolfSSL_X509_get_ext_d2i(const WOLFSSL_X509* x509,
3696 int nid, int* c, int* idx);
3697#endif /* OPENSSL_EXTRA || WOLFSSL_WPAS_SMALL */
3698
3699#if defined(OPENSSL_EXTRA) || defined(OPENSSL_ALL)
3700#ifndef NO_CERTS
3701WOLFSSL_API int wolfSSL_X509_get_ext_count(const WOLFSSL_X509* passedCert);
3702WOLFSSL_API int wolfSSL_X509_get_ext_by_NID(const WOLFSSL_X509 *x, int nid, int lastpos);
3703WOLFSSL_API int wolfSSL_X509_add_ext(WOLFSSL_X509 *x, WOLFSSL_X509_EXTENSION *ex, int loc);
3704WOLFSSL_API WOLFSSL_X509_EXTENSION *wolfSSL_X509V3_EXT_i2d(int nid, int crit,
3705 void *data);
3706WOLFSSL_API WOLFSSL_X509_EXTENSION *wolfSSL_X509_delete_ext(WOLFSSL_X509 *x509, int loc);
3707WOLFSSL_API WOLFSSL_X509_EXTENSION* wolfSSL_X509V3_EXT_conf_nid(
3708 WOLF_LHASH_OF(CONF_VALUE)* conf, WOLFSSL_X509V3_CTX* ctx, int nid,
3709 char* value);
3710WOLFSSL_API void wolfSSL_X509V3_set_ctx(WOLFSSL_X509V3_CTX* ctx,
3711 WOLFSSL_X509* issuer, WOLFSSL_X509* subject, WOLFSSL_X509* req,
3712 WOLFSSL_X509_CRL* crl, int flag);
3713WOLFSSL_API void wolfSSL_X509V3_set_ctx_nodb(WOLFSSL_X509V3_CTX* ctx);
3714WOLFSSL_API int wolfSSL_X509_digest(const WOLFSSL_X509* x509,
3715 const WOLFSSL_EVP_MD* digest, unsigned char* buf, unsigned int* len);
3716WOLFSSL_API int wolfSSL_X509_pubkey_digest(const WOLFSSL_X509 *x509,
3717 const WOLFSSL_EVP_MD *digest, unsigned char* buf, unsigned int* len);
3718WOLFSSL_API int wolfSSL_use_certificate(WOLFSSL* ssl, WOLFSSL_X509* x509);
3719WOLFSSL_API int wolfSSL_use_PrivateKey(WOLFSSL* ssl, WOLFSSL_EVP_PKEY* pkey);
3720WOLFSSL_API int wolfSSL_use_PrivateKey_ASN1(int pri, WOLFSSL* ssl,
3721 const unsigned char* der, long derSz);
3722WOLFSSL_API WOLFSSL_EVP_PKEY *wolfSSL_get_privatekey(const WOLFSSL *ssl);
3723#ifndef NO_RSA
3724WOLFSSL_API int wolfSSL_use_RSAPrivateKey_ASN1(WOLFSSL* ssl, unsigned char* der,
3725 long derSz);
3726#endif
3727WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_ASN1(int pri, WOLFSSL_CTX* ctx,
3728 unsigned char* der, long derSz);
3729
3730#if defined(WOLFSSL_QT) || defined(OPENSSL_ALL)
3731WOLFSSL_API int wolfSSL_X509_cmp(const WOLFSSL_X509* a, const WOLFSSL_X509* b);
3732WOLFSSL_API const WOLFSSL_STACK *wolfSSL_X509_get0_extensions(const WOLFSSL_X509 *x);
3733WOLFSSL_API const WOLFSSL_STACK *wolfSSL_X509_REQ_get_extensions(const WOLFSSL_X509 *x);
3734WOLFSSL_API WOLFSSL_X509_EXTENSION* wolfSSL_X509_get_ext(const WOLFSSL_X509* x, int loc);
3735WOLFSSL_API int wolfSSL_X509_get_ext_by_OBJ(const WOLFSSL_X509 *x,
3736 const WOLFSSL_ASN1_OBJECT *obj, int lastpos);
3737WOLFSSL_API WOLFSSL_X509_EXTENSION* wolfSSL_X509_set_ext(WOLFSSL_X509* x, int loc);
3738WOLFSSL_API int wolfSSL_X509_EXTENSION_get_critical(const WOLFSSL_X509_EXTENSION* ex);
3739WOLFSSL_API WOLFSSL_X509_EXTENSION* wolfSSL_X509_EXTENSION_new(void);
3740WOLFSSL_API int wolfSSL_sk_X509_EXTENSION_push(WOLFSSL_STACK* sk,
3741 WOLFSSL_X509_EXTENSION* ext);
3742WOLFSSL_API void wolfSSL_sk_X509_EXTENSION_free(WOLFSSL_STACK* sk);
3743WOLFSSL_API void wolfSSL_X509_EXTENSION_free(WOLFSSL_X509_EXTENSION* ext_to_free);
3744WOLFSSL_API WOLFSSL_STACK* wolfSSL_sk_new_x509_ext(void);
3745#endif
3746
3747WOLFSSL_API WOLFSSL_ASN1_OBJECT* wolfSSL_X509_EXTENSION_get_object(WOLFSSL_X509_EXTENSION* ext);
3748WOLFSSL_API WOLFSSL_ASN1_STRING* wolfSSL_X509_EXTENSION_get_data(WOLFSSL_X509_EXTENSION* ext);
3749#endif /* !NO_CERTS */
3750
3751WOLFSSL_API WOLFSSL_DH *wolfSSL_DSA_dup_DH(const WOLFSSL_DSA *r);
3752
3753WOLFSSL_API int wolfSSL_SESSION_get_master_key(const WOLFSSL_SESSION* ses,
3754 unsigned char* out, int outSz);
3755WOLFSSL_API int wolfSSL_SESSION_get_master_key_length(const WOLFSSL_SESSION* ses);
3756
3757WOLFSSL_API int wolfSSL_i2d_X509_bio(WOLFSSL_BIO* bio, WOLFSSL_X509* x509);
3758#ifdef WOLFSSL_CERT_REQ
3759WOLFSSL_API int wolfSSL_i2d_X509_REQ_bio(WOLFSSL_BIO* bio, WOLFSSL_X509* x509);
3760#endif
3761#if !defined(NO_FILESYSTEM)
3762WOLFSSL_API WOLFSSL_X509* wolfSSL_d2i_X509_fp(XFILE fp,
3763 WOLFSSL_X509** x509);
3764WOLFSSL_API WOLFSSL_STACK* wolfSSL_X509_STORE_GetCerts(WOLFSSL_X509_STORE_CTX* s);
3765#endif
3766WOLFSSL_API WOLFSSL_X509* wolfSSL_d2i_X509_bio(WOLFSSL_BIO* bio,
3767 WOLFSSL_X509** x509);
3768#ifdef WOLFSSL_CERT_REQ
3769WOLFSSL_API WOLFSSL_X509* wolfSSL_d2i_X509_REQ_bio(WOLFSSL_BIO* bio,
3770 WOLFSSL_X509** x509);
3771#endif
3772#endif /* OPENSSL_EXTRA || OPENSSL_ALL */
3773
3774#if defined(OPENSSL_EXTRA) || defined(WOLFSSL_WPAS_SMALL)
3775WOLFSSL_API void wolfSSL_CTX_set_cert_store(WOLFSSL_CTX* ctx,
3776 WOLFSSL_X509_STORE* str);
3777WOLFSSL_API WOLFSSL_X509_STORE* wolfSSL_CTX_get_cert_store(WOLFSSL_CTX* ctx);
3778#endif /* OPENSSL_EXTRA || WOLFSSL_WPAS_SMALL */
3779#if defined(OPENSSL_EXTRA) || defined(WOLFSSL_WPAS_SMALL) || \
3780 defined(HAVE_SECRET_CALLBACK)
3781WOLFSSL_API size_t wolfSSL_get_server_random(const WOLFSSL *ssl,
3782 unsigned char *out, size_t outlen);
3783WOLFSSL_API size_t wolfSSL_get_client_random(const WOLFSSL* ssl,
3784 unsigned char* out, size_t outSz);
3785#endif /* OPENSSL_EXTRA || WOLFSSL_WPAS_SMALL || HAVE_SECRET_CALLBACK */
3786
3787#if defined(OPENSSL_EXTRA) || defined(OPENSSL_ALL)
3788WOLFSSL_API size_t wolfSSL_BIO_wpending(const WOLFSSL_BIO *bio);
3789/* non-standard API to determine if BIO supports "pending" */
3790WOLFSSL_API int wolfSSL_BIO_supports_pending(const WOLFSSL_BIO *bio);
3791WOLFSSL_API size_t wolfSSL_BIO_ctrl_pending(WOLFSSL_BIO *b);
3792
3793WOLFSSL_API int wolfSSL_get_server_tmp_key(const WOLFSSL*, WOLFSSL_EVP_PKEY**);
3794
3795WOLFSSL_API int wolfSSL_CTX_set_min_proto_version(WOLFSSL_CTX*, int);
3796WOLFSSL_API int wolfSSL_CTX_set_max_proto_version(WOLFSSL_CTX*, int);
3797WOLFSSL_API int wolfSSL_CTX_get_min_proto_version(WOLFSSL_CTX*);
3798
3799WOLFSSL_API int wolfSSL_CTX_use_PrivateKey(WOLFSSL_CTX *ctx, WOLFSSL_EVP_PKEY *pkey);
3800WOLFSSL_API WOLFSSL_X509 *wolfSSL_PEM_read_bio_X509(WOLFSSL_BIO *bp, WOLFSSL_X509 **x, pem_password_cb *cb, void *u);
3801#ifdef WOLFSSL_CERT_REQ
3802WOLFSSL_API WOLFSSL_X509 *wolfSSL_PEM_read_bio_X509_REQ(WOLFSSL_BIO *bp, WOLFSSL_X509 **x, pem_password_cb *cb, void *u);
3803#endif
3804WOLFSSL_API WOLFSSL_X509_CRL *wolfSSL_PEM_read_bio_X509_CRL(WOLFSSL_BIO *bp,
3805 WOLFSSL_X509_CRL **x, pem_password_cb *cb, void *u);
3806WOLFSSL_API WOLFSSL_X509 *wolfSSL_PEM_read_bio_X509_AUX
3807 (WOLFSSL_BIO *bp, WOLFSSL_X509 **x, pem_password_cb *cb, void *u);
3808WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509_INFO)* wolfSSL_PEM_X509_INFO_read_bio(
3809 WOLFSSL_BIO* bio, WOLF_STACK_OF(WOLFSSL_X509_INFO)* sk,
3810 pem_password_cb* cb, void* u);
3811#ifndef NO_FILESYSTEM
3812WOLFSSL_API WOLFSSL_X509_CRL *wolfSSL_PEM_read_X509_CRL(XFILE fp,
3813 WOLFSSL_X509_CRL **x, pem_password_cb *cb, void *u);
3814#endif
3815WOLFSSL_API int wolfSSL_PEM_get_EVP_CIPHER_INFO(const char* header,
3816 EncryptedInfo* cipher);
3817WOLFSSL_API int wolfSSL_PEM_do_header(EncryptedInfo* cipher,
3818 unsigned char* data, long* len,
3819 pem_password_cb* callback, void* ctx);
3820#endif /* OPENSSL_EXTRA || OPENSSL_ALL */
3821
3822/*lighttp compatibility */
3823
3824#if defined(OPENSSL_EXTRA) || defined(WOLFSSL_WPAS_SMALL) || \
3825 defined(OPENSSL_EXTRA_X509_SMALL)
3826struct WOLFSSL_ASN1_BIT_STRING {
3827 int length;
3828 int type;
3829 byte* data;
3830 long flags;
3831};
3832
3833struct WOLFSSL_CONF_CTX {
3834 unsigned int flags;
3835 WOLFSSL_CTX* ctx;
3836 WOLFSSL* ssl;
3837};
3838
3839WOLFSSL_API WOLFSSL_X509_NAME_ENTRY *wolfSSL_X509_NAME_get_entry(WOLFSSL_X509_NAME *name, int loc);
3840#endif /* OPENSSL_EXTRA || WOLFSSL_WPAS_SMALL */
3841
3842#if defined(OPENSSL_EXTRA) || defined(OPENSSL_ALL)|| \
3843 defined(OPENSSL_EXTRA_X509_SMALL)
3844
3845#if defined(OPENSSL_EXTRA) \
3846 || defined(OPENSSL_ALL) \
3847 || defined(HAVE_LIGHTY) \
3848 || defined(WOLFSSL_MYSQL_COMPATIBLE) \
3849 || defined(HAVE_STUNNEL) \
3850 || defined(WOLFSSL_NGINX) \
3851 || defined(WOLFSSL_HAPROXY) \
3852 || defined(OPENSSL_EXTRA_X509_SMALL)
3853WOLFSSL_API void wolfSSL_X509_NAME_ENTRY_free(WOLFSSL_X509_NAME_ENTRY* ne);
3854WOLFSSL_API WOLFSSL_X509_NAME_ENTRY* wolfSSL_X509_NAME_ENTRY_new(void);
3855WOLFSSL_API void wolfSSL_X509_NAME_free(WOLFSSL_X509_NAME* name);
3856WOLFSSL_API char wolfSSL_CTX_use_certificate(WOLFSSL_CTX*, WOLFSSL_X509*);
3857WOLFSSL_API int wolfSSL_CTX_add1_chain_cert(WOLFSSL_CTX*, WOLFSSL_X509*);
3858WOLFSSL_API int wolfSSL_BIO_read_filename(WOLFSSL_BIO *b, const char *name);
3859/* These are to be merged shortly */
3860WOLFSSL_API void wolfSSL_set_verify_depth(WOLFSSL *ssl,int depth);
3861WOLFSSL_API void* wolfSSL_get_app_data( const WOLFSSL *ssl);
3862WOLFSSL_API int wolfSSL_set_app_data(WOLFSSL *ssl, void *arg);
3863WOLFSSL_API WOLFSSL_ASN1_OBJECT * wolfSSL_X509_NAME_ENTRY_get_object(WOLFSSL_X509_NAME_ENTRY *ne);
3864WOLFSSL_API unsigned char *wolfSSL_SHA1(const unsigned char *d, size_t n, unsigned char *md);
3865WOLFSSL_API unsigned char *wolfSSL_SHA224(const unsigned char *d, size_t n, unsigned char *md);
3866WOLFSSL_API unsigned char *wolfSSL_SHA256(const unsigned char *d, size_t n, unsigned char *md);
3867WOLFSSL_API unsigned char *wolfSSL_SHA384(const unsigned char *d, size_t n, unsigned char *md);
3868WOLFSSL_API unsigned char *wolfSSL_SHA512(const unsigned char *d, size_t n, unsigned char *md);
3869WOLFSSL_API int wolfSSL_X509_check_private_key(WOLFSSL_X509*, WOLFSSL_EVP_PKEY*);
3870WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509_NAME) *wolfSSL_dup_CA_list( WOLF_STACK_OF(WOLFSSL_X509_NAME) *sk );
3871WOLFSSL_API int wolfSSL_X509_check_ca(WOLFSSL_X509 *x509);
3872
3873#ifndef NO_FILESYSTEM
3874WOLFSSL_API long wolfSSL_BIO_set_fp(WOLFSSL_BIO *bio, XFILE fp, int c);
3875WOLFSSL_API long wolfSSL_BIO_get_fp(WOLFSSL_BIO *bio, XFILE* fp);
3876WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new_fp(XFILE fp, int c);
3877#endif
3878
3879#endif /* OPENSSL_EXTRA || OPENSSL_ALL || HAVE_LIGHTY || WOLFSSL_MYSQL_COMPATIBLE || HAVE_STUNNEL || WOLFSSL_NGINX || WOLFSSL_HAPROXY */
3880
3881#endif /* OPENSSL_EXTRA || OPENSSL_ALL */
3882
3883
3884#if defined(OPENSSL_ALL) \
3885 || defined(HAVE_STUNNEL) \
3886 || defined(HAVE_LIGHTY) \
3887 || defined(WOLFSSL_MYSQL_COMPATIBLE) \
3888 || defined(WOLFSSL_HAPROXY) \
3889 || defined(OPENSSL_EXTRA)
3890#define X509_BUFFER_SZ 8192
3891
3892WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new_file(const char *filename, const char *mode);
3893WOLFSSL_API long wolfSSL_CTX_set_tmp_dh(WOLFSSL_CTX*, WOLFSSL_DH*);
3894WOLFSSL_API WOLFSSL_DH *wolfSSL_PEM_read_bio_DHparams(WOLFSSL_BIO *bp,
3895 WOLFSSL_DH **x, pem_password_cb *cb, void *u);
3896WOLFSSL_API WOLFSSL_DSA *wolfSSL_PEM_read_bio_DSAparams(WOLFSSL_BIO *bp,
3897 WOLFSSL_DSA **x, pem_password_cb *cb, void *u);
3898WOLFSSL_API int wolfSSL_PEM_write_bio_X509_REQ(WOLFSSL_BIO *bp,WOLFSSL_X509 *x);
3899WOLFSSL_API int wolfSSL_PEM_write_bio_X509_AUX(WOLFSSL_BIO *bp,WOLFSSL_X509 *x);
3900WOLFSSL_API int wolfSSL_PEM_write_bio_X509(WOLFSSL_BIO *bp, WOLFSSL_X509 *x);
3901#endif /* HAVE_STUNNEL || HAVE_LIGHTY */
3902
3903#if defined(OPENSSL_EXTRA) && !defined(NO_CERTS) && defined(WOLFSSL_CERT_GEN) && \
3904 defined(WOLFSSL_CERT_REQ)
3905WOLFSSL_API int wolfSSL_i2d_X509_REQ(WOLFSSL_X509* req, unsigned char** out);
3906WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_REQ_new(void);
3907WOLFSSL_API void wolfSSL_X509_REQ_free(WOLFSSL_X509* req);
3908WOLFSSL_API int wolfSSL_X509_REQ_sign(WOLFSSL_X509 *req, WOLFSSL_EVP_PKEY *pkey,
3909 const WOLFSSL_EVP_MD *md);
3910WOLFSSL_API int wolfSSL_X509_REQ_sign_ctx(WOLFSSL_X509 *req,
3911 WOLFSSL_EVP_MD_CTX* md_ctx);
3912WOLFSSL_API int wolfSSL_X509_REQ_add_extensions(WOLFSSL_X509* req,
3913 WOLF_STACK_OF(WOLFSSL_X509_EXTENSION)* ext_sk);
3914WOLFSSL_API int wolfSSL_X509_REQ_set_subject_name(WOLFSSL_X509 *req,
3915 WOLFSSL_X509_NAME *name);
3916WOLFSSL_API int wolfSSL_X509_REQ_set_pubkey(WOLFSSL_X509 *req,
3917 WOLFSSL_EVP_PKEY *pkey);
3918WOLFSSL_API int wolfSSL_X509_REQ_add1_attr_by_NID(WOLFSSL_X509 *req,
3919 int nid, int type,
3920 const unsigned char *bytes,
3921 int len);
3922WOLFSSL_API int wolfSSL_X509_REQ_get_attr_by_NID(const WOLFSSL_X509 *req,
3923 int nid, int lastpos);
3924WOLFSSL_API int wolfSSL_X509_REQ_add1_attr_by_txt(WOLFSSL_X509 *req,
3925 const char *attrname, int type,
3926 const unsigned char *bytes, int len);
3927WOLFSSL_API WOLFSSL_X509_ATTRIBUTE *wolfSSL_X509_REQ_get_attr(
3928 const WOLFSSL_X509 *req, int loc);
3929WOLFSSL_API WOLFSSL_X509_ATTRIBUTE* wolfSSL_X509_ATTRIBUTE_new(void);
3930WOLFSSL_API void wolfSSL_X509_ATTRIBUTE_free(WOLFSSL_X509_ATTRIBUTE* attr);
3931WOLFSSL_API WOLFSSL_ASN1_TYPE *wolfSSL_X509_ATTRIBUTE_get0_type(
3932 WOLFSSL_X509_ATTRIBUTE *attr, int idx);
3933WOLFSSL_API WOLFSSL_X509 *wolfSSL_X509_to_X509_REQ(WOLFSSL_X509 *x,
3934 WOLFSSL_EVP_PKEY *pkey, const WOLFSSL_EVP_MD *md);
3935#endif
3936
3937
3938#if defined(OPENSSL_ALL) || defined(HAVE_STUNNEL) || defined(WOLFSSL_NGINX) \
3939 || defined(WOLFSSL_HAPROXY) || defined(OPENSSL_EXTRA) || defined(HAVE_LIGHTY)
3940
3941#include <wolfssl/openssl/crypto.h>
3942
3943WOLFSSL_API int wolfSSL_CRYPTO_set_mem_ex_functions(void *(*m) (size_t, const char *, int),
3944 void *(*r) (void *, size_t, const char *, int), void (*f) (void *));
3945
3946WOLFSSL_API void wolfSSL_CRYPTO_cleanup_all_ex_data(void);
3947
3948WOLFSSL_API int wolfSSL_CRYPTO_memcmp(const void *a, const void *b, size_t size);
3949
3950WOLFSSL_API WOLFSSL_BIGNUM* wolfSSL_DH_768_prime(WOLFSSL_BIGNUM* bn);
3951WOLFSSL_API WOLFSSL_BIGNUM* wolfSSL_DH_1024_prime(WOLFSSL_BIGNUM* bn);
3952WOLFSSL_API WOLFSSL_BIGNUM* wolfSSL_DH_1536_prime(WOLFSSL_BIGNUM* bn);
3953WOLFSSL_API WOLFSSL_BIGNUM* wolfSSL_DH_2048_prime(WOLFSSL_BIGNUM* bn);
3954WOLFSSL_API WOLFSSL_BIGNUM* wolfSSL_DH_3072_prime(WOLFSSL_BIGNUM* bn);
3955WOLFSSL_API WOLFSSL_BIGNUM* wolfSSL_DH_4096_prime(WOLFSSL_BIGNUM* bn);
3956WOLFSSL_API WOLFSSL_BIGNUM* wolfSSL_DH_6144_prime(WOLFSSL_BIGNUM* bn);
3957WOLFSSL_API WOLFSSL_BIGNUM* wolfSSL_DH_8192_prime(WOLFSSL_BIGNUM* bn);
3958
3959WOLFSSL_API WOLFSSL_DH *wolfSSL_DH_generate_parameters(int prime_len, int generator,
3960 void (*callback) (int, int, void *), void *cb_arg);
3961
3962WOLFSSL_API int wolfSSL_DH_generate_parameters_ex(WOLFSSL_DH*, int, int,
3963 void (*callback) (int, int, void *));
3964
3965WOLFSSL_API void wolfSSL_ERR_load_crypto_strings(void);
3966
3967WOLFSSL_API unsigned long wolfSSL_ERR_peek_last_error(void);
3968
3969WOLFSSL_API int wolfSSL_FIPS_mode(void);
3970
3971WOLFSSL_API int wolfSSL_FIPS_mode_set(int r);
3972
3973WOLFSSL_API int wolfSSL_RAND_set_rand_method(const WOLFSSL_RAND_METHOD *methods);
3974
3975WOLFSSL_API int wolfSSL_CIPHER_get_bits(const WOLFSSL_CIPHER *c, int *alg_bits);
3976
3977WOLFSSL_API WOLFSSL_STACK* wolfSSL_sk_X509_new(void);
3978WOLFSSL_API int wolfSSL_sk_X509_num(const WOLF_STACK_OF(WOLFSSL_X509) *s);
3979
3980WOLFSSL_API WOLFSSL_X509_INFO *wolfSSL_X509_INFO_new(void);
3981WOLFSSL_API void wolfSSL_X509_INFO_free(WOLFSSL_X509_INFO* info);
3982
3983WOLFSSL_API WOLFSSL_STACK* wolfSSL_sk_X509_INFO_new_null(void);
3984WOLFSSL_API int wolfSSL_sk_X509_INFO_num(const WOLF_STACK_OF(WOLFSSL_X509_INFO)*);
3985WOLFSSL_API WOLFSSL_X509_INFO* wolfSSL_sk_X509_INFO_value(
3986 const WOLF_STACK_OF(WOLFSSL_X509_INFO)*, int);
3987WOLFSSL_API int wolfSSL_sk_X509_INFO_push(WOLF_STACK_OF(WOLFSSL_X509_INFO)*,
3988 WOLFSSL_X509_INFO*);
3989WOLFSSL_API WOLFSSL_X509_INFO* wolfSSL_sk_X509_INFO_pop(WOLF_STACK_OF(WOLFSSL_X509_INFO)*);
3990WOLFSSL_API void wolfSSL_sk_X509_INFO_pop_free(WOLF_STACK_OF(WOLFSSL_X509_INFO)*,
3991 void (*f) (WOLFSSL_X509_INFO*));
3992WOLFSSL_API void wolfSSL_sk_X509_INFO_free(WOLF_STACK_OF(WOLFSSL_X509_INFO)*);
3993
3994typedef int (*wolf_sk_compare_cb)(const void* a,
3995 const void* b);
3996typedef unsigned long (*wolf_sk_hash_cb) (const void *v);
3997WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509_NAME)* wolfSSL_sk_X509_NAME_new(
3998 wolf_sk_compare_cb);
3999WOLFSSL_API int wolfSSL_sk_X509_NAME_push(WOLF_STACK_OF(WOLFSSL_X509_NAME)*,
4000 WOLFSSL_X509_NAME*);
4001WOLFSSL_API int wolfSSL_sk_X509_NAME_find(const WOLF_STACK_OF(WOLFSSL_X509_NAME)*,
4002 WOLFSSL_X509_NAME*);
4003WOLFSSL_API int wolfSSL_sk_X509_NAME_set_cmp_func(
4004 WOLF_STACK_OF(WOLFSSL_X509_NAME)*, wolf_sk_compare_cb);
4005WOLFSSL_API WOLFSSL_X509_NAME* wolfSSL_sk_X509_NAME_value(const WOLF_STACK_OF(WOLFSSL_X509_NAME)*, int);
4006WOLFSSL_API int wolfSSL_sk_X509_NAME_num(const WOLF_STACK_OF(WOLFSSL_X509_NAME)*);
4007WOLFSSL_API WOLFSSL_X509_NAME* wolfSSL_sk_X509_NAME_pop(WOLF_STACK_OF(WOLFSSL_X509_NAME)*);
4008WOLFSSL_API void wolfSSL_sk_X509_NAME_pop_free(WOLF_STACK_OF(WOLFSSL_X509_NAME)*,
4009 void (*f) (WOLFSSL_X509_NAME*));
4010WOLFSSL_API void wolfSSL_sk_X509_NAME_free(WOLF_STACK_OF(WOLFSSL_X509_NAME) *);
4011
4012WOLFSSL_API int wolfSSL_sk_X509_OBJECT_num(const WOLF_STACK_OF(WOLFSSL_X509_OBJECT) *s);
4013
4014WOLFSSL_API int wolfSSL_X509_NAME_print_ex(WOLFSSL_BIO*,WOLFSSL_X509_NAME*,int,
4015 unsigned long);
4016#ifndef NO_FILESYSTEM
4017WOLFSSL_API int wolfSSL_X509_NAME_print_ex_fp(XFILE,WOLFSSL_X509_NAME*,int,
4018 unsigned long);
4019#endif
4020
4021WOLFSSL_API WOLFSSL_STACK *wolfSSL_sk_CONF_VALUE_new(wolf_sk_compare_cb compFunc);
4022WOLFSSL_API void wolfSSL_sk_CONF_VALUE_free(struct WOLFSSL_STACK *sk);
4023WOLFSSL_API int wolfSSL_sk_CONF_VALUE_num(const WOLFSSL_STACK *sk);
4024WOLFSSL_API WOLFSSL_CONF_VALUE *wolfSSL_sk_CONF_VALUE_value(
4025 const struct WOLFSSL_STACK *sk, int i);
4026WOLFSSL_API int wolfSSL_sk_CONF_VALUE_push(WOLF_STACK_OF(WOLFSSL_CONF_VALUE)* sk,
4027 WOLFSSL_CONF_VALUE* val);
4028#endif /* OPENSSL_ALL || HAVE_STUNNEL || WOLFSSL_NGINX || WOLFSSL_HAPROXY || OPENSSL_EXTRA || HAVE_LIGHTY */
4029
4030#if defined(OPENSSL_EXTRA) || defined(WOLFSSL_WPAS_SMALL)
4031WOLFSSL_API WOLFSSL_ASN1_BIT_STRING* wolfSSL_ASN1_BIT_STRING_new(void);
4032WOLFSSL_API void wolfSSL_ASN1_BIT_STRING_free(WOLFSSL_ASN1_BIT_STRING*);
4033WOLFSSL_API WOLFSSL_ASN1_BIT_STRING* wolfSSL_X509_get0_pubkey_bitstr(
4034 const WOLFSSL_X509*);
4035WOLFSSL_API int wolfSSL_ASN1_BIT_STRING_get_bit(
4036 const WOLFSSL_ASN1_BIT_STRING*, int);
4037WOLFSSL_API int wolfSSL_ASN1_BIT_STRING_set_bit(
4038 WOLFSSL_ASN1_BIT_STRING*, int, int);
4039#endif /* OPENSSL_EXTRA || WOLFSSL_WPAS_SMALL */
4040
4041#if defined(OPENSSL_ALL) || defined(HAVE_STUNNEL) || defined(WOLFSSL_NGINX) \
4042 || defined(WOLFSSL_HAPROXY) || defined(OPENSSL_EXTRA) || defined(HAVE_LIGHTY)
4043
4044WOLFSSL_API int wolfSSL_CTX_add_session(WOLFSSL_CTX*, WOLFSSL_SESSION*);
4045
4046WOLFSSL_API int wolfSSL_version(WOLFSSL*);
4047
4048WOLFSSL_API int wolfSSL_get_state(const WOLFSSL*);
4049
4050WOLFSSL_API WOLFSSL_X509* wolfSSL_sk_X509_value(WOLF_STACK_OF(WOLFSSL_X509)*, int);
4051
4052WOLFSSL_API WOLFSSL_X509* wolfSSL_sk_X509_shift(WOLF_STACK_OF(WOLFSSL_X509)*);
4053
4054WOLFSSL_API void* wolfSSL_sk_X509_OBJECT_value(WOLF_STACK_OF(WOLFSSL_X509_OBJECT)*, int);
4055#endif /* OPENSSL_ALL || HAVE_STUNNEL || WOLFSSL_NGINX || WOLFSSL_HAPROXY || OPENSSL_EXTRA || HAVE_LIGHTY */
4056
4057#if defined(OPENSSL_EXTRA) || defined(WOLFSSL_WPAS_SMALL)
4058WOLFSSL_API void* wolfSSL_SESSION_get_ex_data(const WOLFSSL_SESSION*, int);
4059
4060WOLFSSL_API int wolfSSL_SESSION_set_ex_data(WOLFSSL_SESSION*, int, void*);
4061#ifdef HAVE_EX_DATA_CLEANUP_HOOKS
4062WOLFSSL_API int wolfSSL_SESSION_set_ex_data_with_cleanup(
4063 WOLFSSL_SESSION* session,
4064 int idx,
4065 void* data,
4066 wolfSSL_ex_data_cleanup_routine_t cleanup_routine);
4067#endif
4068#endif /* OPENSSL_EXTRA || WOLFSSL_WPAS_SMALL */
4069
4070#if defined(OPENSSL_ALL) || defined(HAVE_STUNNEL) || defined(WOLFSSL_NGINX) \
4071 || defined(WOLFSSL_HAPROXY) || defined(OPENSSL_EXTRA) || defined(HAVE_LIGHTY)
4072
4073WOLFSSL_API int wolfSSL_SESSION_get_ex_new_index(long,void*,void*,void*,
4074 CRYPTO_free_func*);
4075
4076WOLFSSL_API int wolfSSL_X509_NAME_get_sz(WOLFSSL_X509_NAME*);
4077
4078WOLFSSL_API const unsigned char* wolfSSL_SESSION_get_id(WOLFSSL_SESSION*,
4079 unsigned int*);
4080
4081WOLFSSL_API int wolfSSL_SESSION_print(WOLFSSL_BIO*, const WOLFSSL_SESSION*);
4082
4083WOLFSSL_API int wolfSSL_set_tlsext_host_name(WOLFSSL *, const char *);
4084
4085WOLFSSL_API const char* wolfSSL_get_servername(WOLFSSL *, unsigned char);
4086
4087WOLFSSL_API WOLFSSL_CTX* wolfSSL_set_SSL_CTX(WOLFSSL*,WOLFSSL_CTX*);
4088
4089WOLFSSL_API VerifyCallback wolfSSL_CTX_get_verify_callback(WOLFSSL_CTX*);
4090
4091WOLFSSL_API VerifyCallback wolfSSL_get_verify_callback(WOLFSSL*);
4092
4093#endif /* OPENSSL_ALL || HAVE_STUNNEL || WOLFSSL_NGINX || WOLFSSL_HAPROXY || HAVE_LIGHTY */
4094
4095#ifdef HAVE_SNI
4096/* SNI received callback type */
4097typedef int (*CallbackSniRecv)(WOLFSSL *ssl, int *ret, void* exArg);
4098
4099WOLFSSL_API void wolfSSL_CTX_set_servername_callback(WOLFSSL_CTX *,
4100 CallbackSniRecv);
4101WOLFSSL_API int wolfSSL_CTX_set_tlsext_servername_callback(WOLFSSL_CTX *,
4102 CallbackSniRecv);
4103
4104WOLFSSL_API int wolfSSL_CTX_set_servername_arg(WOLFSSL_CTX *, void*);
4105#endif
4106
4107#if defined(OPENSSL_ALL) || defined(HAVE_STUNNEL) || defined(WOLFSSL_NGINX) \
4108 || defined(WOLFSSL_HAPROXY) || defined(OPENSSL_EXTRA) || defined(HAVE_LIGHTY)
4109
4110WOLFSSL_API void wolfSSL_ERR_remove_thread_state(void*);
4111
4112/* support for deprecated old name */
4113#define WOLFSSL_ERR_remove_thread_state wolfSSL_ERR_remove_thread_state
4114
4115#ifndef NO_FILESYSTEM
4116WOLFSSL_API void wolfSSL_print_all_errors_fp(XFILE fp);
4117#endif
4118
4119WOLFSSL_API void wolfSSL_THREADID_set_callback(void (*threadid_func)(void*));
4120
4121WOLFSSL_API void wolfSSL_THREADID_set_numeric(void* id, unsigned long val);
4122WOLFSSL_API void wolfSSL_THREADID_current(WOLFSSL_CRYPTO_THREADID* id);
4123WOLFSSL_API unsigned long wolfSSL_THREADID_hash(
4124 const WOLFSSL_CRYPTO_THREADID* id);
4125
4126WOLFSSL_API WOLF_STACK_OF(WOLFSSL_X509_OBJECT)*
4127 wolfSSL_X509_STORE_get0_objects(WOLFSSL_X509_STORE *);
4128WOLFSSL_API WOLFSSL_X509_OBJECT*
4129 wolfSSL_sk_X509_OBJECT_delete(WOLF_STACK_OF(WOLFSSL_X509_OBJECT)* sk, int i);
4130WOLFSSL_API void wolfSSL_X509_OBJECT_free(WOLFSSL_X509_OBJECT *a);
4131#endif /* OPENSSL_ALL || HAVE_STUNNEL || WOLFSSL_NGINX || WOLFSSL_HAPROXY || HAVE_LIGHTY */
4132
4133#if defined(OPENSSL_EXTRA) || defined(WOLFSSL_WPAS_SMALL)
4134#include <wolfssl/openssl/stack.h>
4135WOLFSSL_API void wolfSSL_sk_X509_pop_free(WOLF_STACK_OF(WOLFSSL_X509)* sk, void (*f) (WOLFSSL_X509*));
4136#endif /* OPENSSL_EXTRA || WOLFSSL_WPAS_SMALL */
4137
4138#if defined(OPENSSL_EXTRA) && defined(HAVE_ECC)
4139WOLFSSL_API int wolfSSL_CTX_set1_curves_list(WOLFSSL_CTX* ctx, const char* names);
4140WOLFSSL_API int wolfSSL_set1_curves_list(WOLFSSL* ssl, const char* names);
4141#endif /* OPENSSL_EXTRA && HAVE_ECC */
4142
4143#if defined(OPENSSL_ALL) || \
4144 defined(HAVE_STUNNEL) || defined(WOLFSSL_MYSQL_COMPATIBLE) || \
4145 defined(WOLFSSL_NGINX) || defined(WOLFSSL_HAPROXY)
4146
4147WOLFSSL_API int wolfSSL_get_verify_mode(const WOLFSSL* ssl);
4148WOLFSSL_API int wolfSSL_CTX_get_verify_mode(const WOLFSSL_CTX* ctx);
4149
4150#endif
4151
4152#ifdef WOLFSSL_JNI
4153WOLFSSL_API int wolfSSL_set_jobject(WOLFSSL* ssl, void* objPtr);
4154WOLFSSL_API void* wolfSSL_get_jobject(WOLFSSL* ssl);
4155#endif /* WOLFSSL_JNI */
4156
4157
4158#ifdef WOLFSSL_ASYNC_CRYPT
4159WOLFSSL_API int wolfSSL_AsyncPoll(WOLFSSL* ssl, WOLF_EVENT_FLAG flags);
4160WOLFSSL_API int wolfSSL_CTX_AsyncPoll(WOLFSSL_CTX* ctx, WOLF_EVENT** events, int maxEvents,
4161 WOLF_EVENT_FLAG flags, int* eventCount);
4162#endif /* WOLFSSL_ASYNC_CRYPT */
4163
4164#ifdef OPENSSL_EXTRA
4165typedef void (*SSL_Msg_Cb)(int write_p, int version, int content_type,
4166 const void *buf, size_t len, WOLFSSL *ssl, void *arg);
4167
4168#if defined(HAVE_SECRET_CALLBACK)
4169typedef void (*wolfSSL_CTX_keylog_cb_func)
4170 (const WOLFSSL* ssl, const char* line);
4171WOLFSSL_API void wolfSSL_CTX_set_keylog_callback(WOLFSSL_CTX* ctx,
4172 wolfSSL_CTX_keylog_cb_func cb);
4173WOLFSSL_API wolfSSL_CTX_keylog_cb_func wolfSSL_CTX_get_keylog_callback(
4174 const WOLFSSL_CTX* ctx);
4175#endif /* HAVE_SECRET_CALLBACK */
4176
4177WOLFSSL_API int wolfSSL_CTX_set_msg_callback(WOLFSSL_CTX *ctx, SSL_Msg_Cb cb);
4178WOLFSSL_API int wolfSSL_set_msg_callback(WOLFSSL *ssl, SSL_Msg_Cb cb);
4179WOLFSSL_API int wolfSSL_CTX_set_msg_callback_arg(WOLFSSL_CTX *ctx, void* arg);
4180WOLFSSL_API int wolfSSL_set_msg_callback_arg(WOLFSSL *ssl, void* arg);
4181WOLFSSL_API unsigned long wolfSSL_ERR_peek_error_line_data(const char **file,
4182 int *line, const char **data, int *flags);
4183WOLFSSL_API int wolfSSL_CTX_set_alpn_protos(WOLFSSL_CTX *ctx,
4184 const unsigned char *protos, unsigned int protos_len);
4185WOLFSSL_API int wolfSSL_set_alpn_protos(WOLFSSL* ssl,
4186 const unsigned char* protos, unsigned int protos_len);
4187WOLFSSL_API void *wolfSSL_OPENSSL_memdup(const void *data,
4188 size_t siz, const char* file, int line);
4189WOLFSSL_API void wolfSSL_OPENSSL_cleanse(void *ptr, size_t len);
4190WOLFSSL_API void wolfSSL_ERR_load_BIO_strings(void);
4191WOLFSSL_API void wolfSSL_DH_get0_pqg(const WOLFSSL_DH* dh,
4192const WOLFSSL_BIGNUM** p, const WOLFSSL_BIGNUM** q, const WOLFSSL_BIGNUM** g);
4193#endif
4194
4195#if defined(HAVE_OCSP) && !defined(NO_ASN_TIME)
4196 WOLFSSL_API int wolfSSL_get_ocsp_producedDate(
4197 WOLFSSL *ssl,
4198 byte *producedDate,
4199 size_t producedDate_space,
4200 int *producedDateFormat);
4201 WOLFSSL_API int wolfSSL_get_ocsp_producedDate_tm(WOLFSSL *ssl,
4202 struct tm *produced_tm);
4203#endif
4204
4205#if defined(OPENSSL_ALL) \
4206 || defined(WOLFSSL_NGINX) \
4207 || defined(WOLFSSL_HAPROXY) \
4208 || defined(OPENSSL_EXTRA) \
4209 || defined(HAVE_STUNNEL)
4210WOLFSSL_API void wolfSSL_OPENSSL_config(char *config_name);
4211#endif
4212
4213#if defined(OPENSSL_ALL) || defined(WOLFSSL_NGINX) || defined(WOLFSSL_HAPROXY)
4214/* Not an OpenSSL API. */
4215WOLFSSL_LOCAL int wolfSSL_get_ocsp_response(WOLFSSL* ssl, byte** response);
4216/* Not an OpenSSL API. */
4217WOLFSSL_LOCAL char* wolfSSL_get_ocsp_url(WOLFSSL* ssl);
4218/* Not an OpenSSL API. */
4219WOLFSSL_API int wolfSSL_set_ocsp_url(WOLFSSL* ssl, char* url);
4220#endif
4221
4222#if defined(OPENSSL_EXTRA) || defined(OPENSSL_EXTRA_X509_SMALL) \
4223 || defined(WOLFSSL_WPAS_SMALL)
4224WOLFSSL_API void *wolfSSL_X509_get_ex_data(WOLFSSL_X509 *x509, int idx);
4225WOLFSSL_API int wolfSSL_X509_set_ex_data(WOLFSSL_X509 *x509, int idx,
4226 void *data);
4227#ifdef HAVE_EX_DATA_CLEANUP_HOOKS
4228WOLFSSL_API int wolfSSL_X509_set_ex_data_with_cleanup(
4229 X509 *x509,
4230 int idx,
4231 void *data,
4232 wolfSSL_ex_data_cleanup_routine_t cleanup_routine);
4233#endif
4234#endif /* OPENSSL_EXTRA || OPENSSL_EXTRA_X509_SMALL || WOLFSSL_WPAS_SMALL */
4235
4236#if defined(OPENSSL_ALL) || defined(WOLFSSL_NGINX) || defined(WOLFSSL_HAPROXY) \
4237 || defined(OPENSSL_EXTRA) || defined(HAVE_LIGHTY)
4238WOLFSSL_API WOLF_STACK_OF(WOLFSSL_CIPHER) *wolfSSL_get_ciphers_compat(const WOLFSSL *ssl);
4239WOLFSSL_API int wolfSSL_X509_get_ex_new_index(int idx, void *arg, void *a,
4240 void *b, void *c);
4241WOLFSSL_API int wolfSSL_X509_NAME_digest(const WOLFSSL_X509_NAME *data,
4242 const WOLFSSL_EVP_MD *type, unsigned char *md, unsigned int *len);
4243
4244WOLFSSL_API long wolfSSL_SSL_CTX_get_timeout(const WOLFSSL_CTX *ctx);
4245WOLFSSL_API long wolfSSL_get_timeout(WOLFSSL* ssl);
4246WOLFSSL_API int wolfSSL_SSL_CTX_set_tmp_ecdh(WOLFSSL_CTX *ctx,
4247 WOLFSSL_EC_KEY *ecdh);
4248WOLFSSL_API int wolfSSL_SSL_CTX_remove_session(WOLFSSL_CTX *,
4249 WOLFSSL_SESSION *c);
4250
4251WOLFSSL_API WOLFSSL_BIO *wolfSSL_SSL_get_rbio(const WOLFSSL *s);
4252WOLFSSL_API WOLFSSL_BIO *wolfSSL_SSL_get_wbio(const WOLFSSL *s);
4253WOLFSSL_API int wolfSSL_SSL_do_handshake(WOLFSSL *s);
4254#if defined(OPENSSL_VERSION_NUMBER) && OPENSSL_VERSION_NUMBER >= 0x10100000L
4255WOLFSSL_API int wolfSSL_SSL_in_init(const WOLFSSL*);
4256#else
4257WOLFSSL_API int wolfSSL_SSL_in_init(WOLFSSL*);
4258#endif
4259WOLFSSL_API int wolfSSL_SSL_in_connect_init(WOLFSSL*);
4260
4261#ifndef NO_SESSION_CACHE
4262 WOLFSSL_API WOLFSSL_SESSION *wolfSSL_SSL_get0_session(const WOLFSSL *s);
4263#endif
4264
4265WOLFSSL_API int wolfSSL_i2a_ASN1_INTEGER(WOLFSSL_BIO *bp,
4266 const WOLFSSL_ASN1_INTEGER *a);
4267
4268#ifdef HAVE_SESSION_TICKET
4269typedef int (*ticketCompatCb)(WOLFSSL *ssl, unsigned char *name, unsigned char *iv,
4270 WOLFSSL_EVP_CIPHER_CTX *ectx, WOLFSSL_HMAC_CTX *hctx, int enc);
4271WOLFSSL_API int wolfSSL_CTX_set_tlsext_ticket_key_cb(WOLFSSL_CTX *, ticketCompatCb);
4272#endif
4273
4274#if defined(HAVE_OCSP) || defined(OPENSSL_EXTRA) || defined(OPENSSL_ALL) || \
4275 defined(WOLFSSL_NGINX) || defined(WOLFSSL_HAPROXY)
4276WOLFSSL_API int wolfSSL_CTX_get_extra_chain_certs(WOLFSSL_CTX* ctx,
4277 WOLF_STACK_OF(X509)** chain);
4278WOLFSSL_API int wolfSSL_CTX_set_tlsext_status_cb(WOLFSSL_CTX* ctx,
4279 int(*)(WOLFSSL*, void*));
4280
4281WOLFSSL_API int wolfSSL_X509_STORE_CTX_get1_issuer(WOLFSSL_X509 **issuer,
4282 WOLFSSL_X509_STORE_CTX *ctx, WOLFSSL_X509 *x);
4283
4284WOLFSSL_API void wolfSSL_X509_email_free(WOLF_STACK_OF(WOLFSSL_STRING) *sk);
4285WOLFSSL_API WOLF_STACK_OF(WOLFSSL_STRING) *wolfSSL_X509_get1_ocsp(WOLFSSL_X509 *x);
4286
4287WOLFSSL_API int wolfSSL_X509_check_issued(WOLFSSL_X509 *issuer,
4288 WOLFSSL_X509 *subject);
4289
4290WOLFSSL_API WOLF_STACK_OF(WOLFSSL_STRING)* wolfSSL_sk_WOLFSSL_STRING_new(void);
4291WOLFSSL_API void wolfSSL_sk_WOLFSSL_STRING_free(WOLF_STACK_OF(WOLFSSL_STRING)* sk);
4292WOLFSSL_API WOLFSSL_STRING wolfSSL_sk_WOLFSSL_STRING_value(
4293 WOLF_STACK_OF(WOLFSSL_STRING)* strings, int idx);
4294WOLFSSL_API int wolfSSL_sk_WOLFSSL_STRING_num(
4295 WOLF_STACK_OF(WOLFSSL_STRING)* strings);
4296#endif /* HAVE_OCSP || OPENSSL_EXTRA || OPENSSL_ALL || WOLFSSL_NGINX || WOLFSSL_HAPROXY */
4297
4298WOLFSSL_API int PEM_write_bio_WOLFSSL_X509(WOLFSSL_BIO *bio,
4299 WOLFSSL_X509 *cert);
4300
4301#endif /* OPENSSL_ALL || WOLFSSL_NGINX || WOLFSSL_HAPROXY ||
4302 OPENSSL_EXTRA || HAVE_LIGHTY */
4303
4304#if defined(HAVE_SESSION_TICKET) && !defined(WOLFSSL_NO_DEF_TICKET_ENC_CB) && \
4305 !defined(NO_WOLFSSL_SERVER)
4306WOLFSSL_API long wolfSSL_CTX_get_tlsext_ticket_keys(WOLFSSL_CTX *ctx,
4307 unsigned char *keys, int keylen);
4308WOLFSSL_API long wolfSSL_CTX_set_tlsext_ticket_keys(WOLFSSL_CTX *ctx,
4309 unsigned char *keys, int keylen);
4310#endif
4311
4312WOLFSSL_API void wolfSSL_get0_alpn_selected(const WOLFSSL *ssl,
4313 const unsigned char **data, unsigned int *len);
4314WOLFSSL_API int wolfSSL_select_next_proto(unsigned char **out,
4315 unsigned char *outlen,
4316 const unsigned char *in, unsigned int inlen,
4317 const unsigned char *client,
4318 unsigned int client_len);
4319WOLFSSL_API void wolfSSL_CTX_set_alpn_select_cb(WOLFSSL_CTX *ctx,
4320 int (*cb) (WOLFSSL *ssl,
4321 const unsigned char **out,
4322 unsigned char *outlen,
4323 const unsigned char *in,
4324 unsigned int inlen,
4325 void *arg), void *arg);
4326WOLFSSL_API void wolfSSL_CTX_set_next_protos_advertised_cb(WOLFSSL_CTX *s,
4327 int (*cb) (WOLFSSL *ssl,
4328 const unsigned char **out,
4329 unsigned int *outlen,
4330 void *arg), void *arg);
4331WOLFSSL_API void wolfSSL_CTX_set_next_proto_select_cb(WOLFSSL_CTX *s,
4332 int (*cb) (WOLFSSL *ssl,
4333 unsigned char **out,
4334 unsigned char *outlen,
4335 const unsigned char *in,
4336 unsigned int inlen,
4337 void *arg), void *arg);
4338WOLFSSL_API void wolfSSL_get0_next_proto_negotiated(const WOLFSSL *s, const unsigned char **data,
4339 unsigned *len);
4340
4341#ifndef NO_ASN
4342WOLFSSL_API int wolfSSL_X509_check_host(WOLFSSL_X509 *x, const char *chk,
4343 size_t chklen, unsigned int flags, char **peername);
4344WOLFSSL_API int wolfSSL_X509_check_ip_asc(WOLFSSL_X509 *x, const char *ipasc,
4345 unsigned int flags);
4346#endif
4347#if defined(OPENSSL_EXTRA) && defined(WOLFSSL_CERT_GEN)
4348WOLFSSL_API int wolfSSL_X509_check_email(WOLFSSL_X509 *x, const char *chk,
4349 size_t chkLen, unsigned int flags);
4350#endif /* OPENSSL_EXTRA && WOLFSSL_CERT_GEN */
4351
4352#if defined(OPENSSL_EXTRA) || defined(OPENSSL_EXTRA_X509_SMALL)
4353#if defined(OPENSSL_ALL) || defined(WOLFSSL_NGINX) || defined(WOLFSSL_HAPROXY)
4354WOLFSSL_API const unsigned char *SSL_SESSION_get0_id_context(
4355 const WOLFSSL_SESSION *sess, unsigned int *sid_ctx_length);
4356WOLFSSL_API size_t wolfSSL_get_finished(const WOLFSSL *ssl, void *buf, size_t count);
4357WOLFSSL_API size_t wolfSSL_get_peer_finished(const WOLFSSL *ssl, void *buf, size_t count);
4358#endif
4359
4360WOLFSSL_API int SSL_SESSION_set1_id(WOLFSSL_SESSION *s, const unsigned char *sid, unsigned int sid_len);
4361WOLFSSL_API int SSL_SESSION_set1_id_context(WOLFSSL_SESSION *s, const unsigned char *sid_ctx, unsigned int sid_ctx_len);
4362WOLFSSL_API WOLFSSL_X509_ALGOR* wolfSSL_X509_ALGOR_new(void);
4363WOLFSSL_API void wolfSSL_X509_ALGOR_free(WOLFSSL_X509_ALGOR *alg);
4364WOLFSSL_API const WOLFSSL_X509_ALGOR* wolfSSL_X509_get0_tbs_sigalg(const WOLFSSL_X509 *x);
4365WOLFSSL_API void wolfSSL_X509_ALGOR_get0(const WOLFSSL_ASN1_OBJECT **paobj, int *pptype, const void **ppval, const WOLFSSL_X509_ALGOR *algor);
4366WOLFSSL_API int wolfSSL_X509_ALGOR_set0(WOLFSSL_X509_ALGOR *algor, WOLFSSL_ASN1_OBJECT *aobj, int ptype, void *pval);
4367WOLFSSL_API WOLFSSL_ASN1_TYPE* wolfSSL_ASN1_TYPE_new(void);
4368WOLFSSL_API void wolfSSL_ASN1_TYPE_free(WOLFSSL_ASN1_TYPE* at);
4369WOLFSSL_API WOLFSSL_X509_PUBKEY *wolfSSL_X509_PUBKEY_new(void);
4370WOLFSSL_API void wolfSSL_X509_PUBKEY_free(WOLFSSL_X509_PUBKEY *x);
4371WOLFSSL_API WOLFSSL_X509_PUBKEY *wolfSSL_X509_get_X509_PUBKEY(const WOLFSSL_X509* x509);
4372WOLFSSL_API int wolfSSL_X509_PUBKEY_get0_param(WOLFSSL_ASN1_OBJECT **ppkalg, const unsigned char **pk, int *ppklen, WOLFSSL_X509_ALGOR **pa, WOLFSSL_X509_PUBKEY *pub);
4373WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_X509_PUBKEY_get(WOLFSSL_X509_PUBKEY* key);
4374WOLFSSL_API int wolfSSL_X509_PUBKEY_set(WOLFSSL_X509_PUBKEY **x, WOLFSSL_EVP_PKEY *key);
4375WOLFSSL_API int i2t_ASN1_OBJECT(char *buf, int buf_len, WOLFSSL_ASN1_OBJECT *a);
4376WOLFSSL_API WOLFSSL_ASN1_OBJECT *wolfSSL_d2i_ASN1_OBJECT(WOLFSSL_ASN1_OBJECT **a,
4377 const unsigned char **der,
4378 long length);
4379WOLFSSL_API int wolfSSL_i2a_ASN1_OBJECT(WOLFSSL_BIO *bp, WOLFSSL_ASN1_OBJECT *a);
4380WOLFSSL_API int wolfSSL_i2d_ASN1_OBJECT(WOLFSSL_ASN1_OBJECT *a, unsigned char **pp);
4381WOLFSSL_API void SSL_CTX_set_tmp_dh_callback(WOLFSSL_CTX *ctx, WOLFSSL_DH *(*dh) (WOLFSSL *ssl, int is_export, int keylength));
4382WOLFSSL_API WOLF_STACK_OF(SSL_COMP) *SSL_COMP_get_compression_methods(void);
4383WOLFSSL_API int wolfSSL_X509_STORE_load_locations(WOLFSSL_X509_STORE *str, const char *file, const char *dir);
4384WOLFSSL_API int wolfSSL_X509_STORE_add_crl(WOLFSSL_X509_STORE *ctx, WOLFSSL_X509_CRL *x);
4385WOLFSSL_API int wolfSSL_sk_SSL_CIPHER_num(const WOLF_STACK_OF(WOLFSSL_CIPHER)* p);
4386WOLFSSL_API int wolfSSL_sk_SSL_CIPHER_find(
4387 WOLF_STACK_OF(WOLFSSL_CIPHER)* sk, const WOLFSSL_CIPHER* toFind);
4388WOLFSSL_API void wolfSSL_sk_SSL_CIPHER_free(WOLF_STACK_OF(WOLFSSL_CIPHER)* sk);
4389WOLFSSL_API int wolfSSL_sk_SSL_COMP_zero(WOLFSSL_STACK* st);
4390WOLFSSL_API int wolfSSL_sk_SSL_COMP_num(WOLF_STACK_OF(WOLFSSL_COMP)* sk);
4391WOLFSSL_API WOLFSSL_CIPHER* wolfSSL_sk_SSL_CIPHER_value(WOLFSSL_STACK* sk, int i);
4392WOLFSSL_API void ERR_load_SSL_strings(void);
4393WOLFSSL_API void wolfSSL_EC_POINT_dump(const char *msg, const WOLFSSL_EC_POINT *p);
4394
4395WOLFSSL_API const char *wolfSSL_ASN1_tag2str(int tag);
4396WOLFSSL_API int wolfSSL_ASN1_STRING_print_ex(WOLFSSL_BIO *out, WOLFSSL_ASN1_STRING *str, unsigned long flags);
4397WOLFSSL_API int wolfSSL_ASN1_STRING_print(WOLFSSL_BIO *out, WOLFSSL_ASN1_STRING *str);
4398WOLFSSL_API int wolfSSL_ASN1_TIME_get_length(WOLFSSL_ASN1_TIME *t);
4399WOLFSSL_API unsigned char* wolfSSL_ASN1_TIME_get_data(WOLFSSL_ASN1_TIME *t);
4400WOLFSSL_API WOLFSSL_ASN1_TIME *wolfSSL_ASN1_TIME_to_generalizedtime(WOLFSSL_ASN1_TIME *t,
4401 WOLFSSL_ASN1_TIME **out);
4402WOLFSSL_API int wolfSSL_i2c_ASN1_INTEGER(WOLFSSL_ASN1_INTEGER *a, unsigned char **pp);
4403WOLFSSL_API int wolfSSL_a2i_ASN1_INTEGER(WOLFSSL_BIO *bio, WOLFSSL_ASN1_INTEGER *asn1,
4404 char *buf, int size);
4405WOLFSSL_API int wolfSSL_X509_CA_num(WOLFSSL_X509_STORE *store);
4406WOLFSSL_API long wolfSSL_X509_get_version(const WOLFSSL_X509 *x);
4407WOLFSSL_API int wolfSSL_X509_get_signature_nid(const WOLFSSL_X509* x);
4408
4409WOLFSSL_API int wolfSSL_PEM_write_bio_PKCS8PrivateKey(WOLFSSL_BIO* bio,
4410 WOLFSSL_EVP_PKEY* pkey, const WOLFSSL_EVP_CIPHER* enc, char* passwd,
4411 int passwdSz, pem_password_cb* cb, void* ctx);
4412WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_d2i_PKCS8PrivateKey_bio(WOLFSSL_BIO* bio,
4413 WOLFSSL_EVP_PKEY** pkey, pem_password_cb* cb, void* u);
4414WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_d2i_AutoPrivateKey(
4415 WOLFSSL_EVP_PKEY** pkey, const unsigned char** data, long length);
4416
4417
4418#endif /* OPENSSL_EXTRA || OPENSSL_EXTRA_X509_SMALL */
4419
4420#ifdef HAVE_PK_CALLBACKS
4421WOLFSSL_API int wolfSSL_IsPrivatePkSet(WOLFSSL* ssl);
4422WOLFSSL_API int wolfSSL_CTX_IsPrivatePkSet(WOLFSSL_CTX* ctx);
4423#endif
4424
4425#ifdef HAVE_ENCRYPT_THEN_MAC
4426WOLFSSL_API int wolfSSL_CTX_AllowEncryptThenMac(WOLFSSL_CTX *, int);
4427WOLFSSL_API int wolfSSL_AllowEncryptThenMac(WOLFSSL *s, int);
4428#endif
4429
4430/* This feature is used to set a fixed ephemeral key and is for testing only */
4431/* Currently allows ECDHE and DHE only */
4432#ifdef WOLFSSL_STATIC_EPHEMERAL
4433WOLFSSL_API int wolfSSL_CTX_set_ephemeral_key(WOLFSSL_CTX* ctx, int keyAlgo,
4434 const char* key, unsigned int keySz, int format);
4435WOLFSSL_API int wolfSSL_set_ephemeral_key(WOLFSSL* ssl, int keyAlgo,
4436 const char* key, unsigned int keySz, int format);
4437
4438/* returns pointer to loaded key as ASN.1/DER */
4439WOLFSSL_API int wolfSSL_CTX_get_ephemeral_key(WOLFSSL_CTX* ctx, int keyAlgo,
4440 const unsigned char** key, unsigned int* keySz);
4441WOLFSSL_API int wolfSSL_get_ephemeral_key(WOLFSSL* ssl, int keyAlgo,
4442 const unsigned char** key, unsigned int* keySz);
4443#endif
4444
4445#if defined(OPENSSL_EXTRA)
4446WOLFSSL_API int wolfSSL_EVP_PKEY_param_check(WOLFSSL_EVP_PKEY_CTX* ctx);
4447WOLFSSL_API void wolfSSL_CTX_set_security_level(WOLFSSL_CTX* ctx, int level);
4448WOLFSSL_API int wolfSSL_CTX_get_security_level(const WOLFSSL_CTX* ctx);
4449
4450WOLFSSL_API int wolfSSL_SESSION_is_resumable(const WOLFSSL_SESSION *s);
4451
4452WOLFSSL_API void wolfSSL_CRYPTO_free(void *str, const char *file, int line);
4453WOLFSSL_API void *wolfSSL_CRYPTO_malloc(size_t num, const char *file, int line);
4454
4455WOLFSSL_API WOLFSSL_CONF_CTX* wolfSSL_CONF_CTX_new(void);
4456WOLFSSL_API void wolfSSL_CONF_CTX_free(WOLFSSL_CONF_CTX* cctx);
4457WOLFSSL_API void wolfSSL_CONF_CTX_set_ssl_ctx(WOLFSSL_CONF_CTX* cctx, WOLFSSL_CTX *ctx);
4458WOLFSSL_API unsigned int wolfSSL_CONF_CTX_set_flags(WOLFSSL_CONF_CTX* cctx, unsigned int flags);
4459WOLFSSL_API int wolfSSL_CONF_CTX_finish(WOLFSSL_CONF_CTX* cctx);
4460
4461#define WOLFSSL_CONF_FLAG_CMDLINE 0x1
4462#define WOLFSSL_CONF_FLAG_FILE 0x2
4463#define WOLFSSL_CONF_FLAG_CERTIFICATE 0x20
4464
4465#define WOLFSSL_CONF_TYPE_STRING 0x1
4466#define WOLFSSL_CONF_TYPE_FILE 0x2
4467
4468WOLFSSL_API int wolfSSL_CONF_cmd(WOLFSSL_CONF_CTX* cctx, const char* cmd, const char* value);
4469#endif /* OPENSSL_EXTRA */
4470#if defined(HAVE_EX_DATA) || defined(FORTRESS) || defined(WOLFSSL_WPAS_SMALL)
4471WOLFSSL_API int wolfSSL_CRYPTO_get_ex_new_index(int class_index, long argl, void *argp,
4472 WOLFSSL_CRYPTO_EX_new* new_func,
4473 WOLFSSL_CRYPTO_EX_dup* dup_func,
4474 WOLFSSL_CRYPTO_EX_free* free_func);
4475#endif /* HAVE_EX_DATA || FORTRESS */
4476#ifdef __cplusplus
4477 } /* extern "C" */
4478#endif
4479
4480
4481#endif /* WOLFSSL_SSL_H */