source: azure_iot_hub_f767zi/trunk/wolfssl-4.7.0/wolfssl/ssl.h@ 464

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

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