git.sur5r.net Git - freertos/blob - FreeRTOS-Plus/Source/WolfSSL/wolfssl/ssl.h

   1 /* ssl.h
   2  *
   3  * Copyright (C) 2006-2015 wolfSSL Inc.
   4  *
   5  * This file is part of wolfSSL. (formerly known as CyaSSL)
   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-1301, USA
  20  */
  21
  22
  23 /* wolfSSL API */
  24
  25 #ifndef WOLFSSL_SSL_H
  26 #define WOLFSSL_SSL_H
  27
  28
  29 /* for users not using preprocessor flags*/
  30 #include <wolfssl/wolfcrypt/settings.h>
  31 #include <wolfssl/version.h>
  32
  33 #ifndef NO_FILESYSTEM
  34     #ifdef FREESCALE_MQX
  35         #include <fio.h>
  36     #else
  37         #include <stdio.h>   /* ERR_printf */
  38     #endif
  39 #endif
  40
  41 #ifdef WOLFSSL_PREFIX
  42     #include "prefix_ssl.h"
  43 #endif
  44
  45 #ifdef LIBWOLFSSL_VERSION_STRING
  46     #define WOLFSSL_VERSION LIBWOLFSSL_VERSION_STRING
  47 #endif
  48
  49 #ifdef _WIN32
  50     /* wincrypt.h clashes */
  51     #undef OCSP_REQUEST
  52     #undef OCSP_RESPONSE
  53 #endif
  54
  55
  56
  57 #ifdef __cplusplus
  58     extern "C" {
  59 #endif
  60
  61 typedef struct WOLFSSL          WOLFSSL;
  62 typedef struct WOLFSSL_SESSION  WOLFSSL_SESSION;
  63 typedef struct WOLFSSL_METHOD   WOLFSSL_METHOD;
  64 typedef struct WOLFSSL_CTX      WOLFSSL_CTX;
  65
  66 typedef struct WOLFSSL_X509       WOLFSSL_X509;
  67 typedef struct WOLFSSL_X509_NAME  WOLFSSL_X509_NAME;
  68 typedef struct WOLFSSL_X509_CHAIN WOLFSSL_X509_CHAIN;
  69
  70 typedef struct WOLFSSL_CERT_MANAGER WOLFSSL_CERT_MANAGER;
  71 typedef struct WOLFSSL_SOCKADDR     WOLFSSL_SOCKADDR;
  72
  73 /* redeclare guard */
  74 #define WOLFSSL_TYPES_DEFINED
  75
  76
  77 typedef struct WOLFSSL_RSA            WOLFSSL_RSA;
  78 typedef struct WOLFSSL_DSA            WOLFSSL_DSA;
  79 typedef struct WOLFSSL_CIPHER         WOLFSSL_CIPHER;
  80 typedef struct WOLFSSL_X509_LOOKUP    WOLFSSL_X509_LOOKUP;
  81 typedef struct WOLFSSL_X509_LOOKUP_METHOD WOLFSSL_X509_LOOKUP_METHOD;
  82 typedef struct WOLFSSL_X509_CRL       WOLFSSL_X509_CRL;
  83 typedef struct WOLFSSL_BIO            WOLFSSL_BIO;
  84 typedef struct WOLFSSL_BIO_METHOD     WOLFSSL_BIO_METHOD;
  85 typedef struct WOLFSSL_X509_EXTENSION WOLFSSL_X509_EXTENSION;
  86 typedef struct WOLFSSL_ASN1_TIME      WOLFSSL_ASN1_TIME;
  87 typedef struct WOLFSSL_ASN1_INTEGER   WOLFSSL_ASN1_INTEGER;
  88 typedef struct WOLFSSL_ASN1_OBJECT    WOLFSSL_ASN1_OBJECT;
  89 typedef struct WOLFSSL_ASN1_STRING    WOLFSSL_ASN1_STRING;
  90 typedef struct WOLFSSL_dynlock_value  WOLFSSL_dynlock_value;
  91
  92 #define WOLFSSL_ASN1_UTCTIME WOLFSSL_ASN1_TIME
  93
  94 typedef struct WOLFSSL_EVP_PKEY {
  95     int type;         /* openssh dereference */
  96     int save_type;    /* openssh dereference */
  97     int pkey_sz;
  98     union {
  99         char* ptr;
 100     } pkey;
 101     #ifdef HAVE_ECC
 102         int pkey_curve;
 103     #endif
 104 } WOLFSSL_EVP_PKEY;
 105
 106 typedef struct WOLFSSL_MD4_CTX {
 107     int buffer[32];      /* big enough to hold, check size in Init */
 108 } WOLFSSL_MD4_CTX;
 109
 110
 111 typedef struct WOLFSSL_COMP_METHOD {
 112     int type;            /* stunnel dereference */
 113 } WOLFSSL_COMP_METHOD;
 114
 115
 116 typedef struct WOLFSSL_X509_STORE {
 117     int                  cache;          /* stunnel dereference */
 118     WOLFSSL_CERT_MANAGER* cm;
 119 } WOLFSSL_X509_STORE;
 120
 121 typedef struct WOLFSSL_ALERT {
 122     int code;
 123     int level;
 124 } WOLFSSL_ALERT;
 125
 126 typedef struct WOLFSSL_ALERT_HISTORY {
 127     WOLFSSL_ALERT last_rx;
 128     WOLFSSL_ALERT last_tx;
 129 } WOLFSSL_ALERT_HISTORY;
 130
 131 typedef struct WOLFSSL_X509_REVOKED {
 132     WOLFSSL_ASN1_INTEGER* serialNumber;          /* stunnel dereference */
 133 } WOLFSSL_X509_REVOKED;
 134
 135
 136 typedef struct WOLFSSL_X509_OBJECT {
 137     union {
 138         char* ptr;
 139         WOLFSSL_X509_CRL* crl;           /* stunnel dereference */
 140     } data;
 141 } WOLFSSL_X509_OBJECT;
 142
 143
 144 typedef struct WOLFSSL_X509_STORE_CTX {
 145     WOLFSSL_X509_STORE* store;    /* Store full of a CA cert chain */
 146     WOLFSSL_X509* current_cert;   /* stunnel dereference */
 147     char* domain;                /* subject CN domain name */
 148     void* ex_data;               /* external data, for fortress build */
 149     void* userCtx;               /* user ctx */
 150     int   error;                 /* current error */
 151     int   error_depth;           /* cert depth for this error */
 152     int   discardSessionCerts;   /* so verify callback can flag for discard */
 153 } WOLFSSL_X509_STORE_CTX;
 154
 155
 156 /* Valid Alert types from page 16/17 */
 157 enum AlertDescription {
 158     close_notify            = 0,
 159     unexpected_message      = 10,
 160     bad_record_mac          = 20,
 161     record_overflow         = 22,
 162     decompression_failure   = 30,
 163     handshake_failure       = 40,
 164     no_certificate          = 41,
 165     bad_certificate         = 42,
 166     unsupported_certificate = 43,
 167     certificate_revoked     = 44,
 168     certificate_expired     = 45,
 169     certificate_unknown     = 46,
 170     illegal_parameter       = 47,
 171     decrypt_error           = 51,
 172     #ifdef WOLFSSL_MYSQL_COMPATIBLE
 173     /* catch name conflict for enum protocol with MYSQL build */
 174     wc_protocol_version     = 70,
 175     #else
 176     protocol_version        = 70,
 177     #endif
 178     no_renegotiation        = 100,
 179     unrecognized_name       = 112
 180 };
 181
 182
 183 enum AlertLevel {
 184     alert_warning = 1,
 185     alert_fatal = 2
 186 };
 187
 188
 189 WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_server_method(void);
 190 WOLFSSL_API WOLFSSL_METHOD *wolfSSLv3_client_method(void);
 191 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_server_method(void);
 192 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_client_method(void);
 193 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_server_method(void);
 194 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_1_client_method(void);
 195 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_server_method(void);
 196 WOLFSSL_API WOLFSSL_METHOD *wolfTLSv1_2_client_method(void);
 197
 198 #ifdef WOLFSSL_DTLS
 199     WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_client_method(void);
 200     WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_server_method(void);
 201     WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_client_method(void);
 202     WOLFSSL_API WOLFSSL_METHOD *wolfDTLSv1_2_server_method(void);
 203 #endif
 204
 205 #ifdef HAVE_POLY1305
 206     WOLFSSL_API int wolfSSL_use_old_poly(WOLFSSL*, int);
 207 #endif
 208
 209 #if !defined(NO_FILESYSTEM) && !defined(NO_CERTS)
 210
 211 WOLFSSL_API int wolfSSL_CTX_use_certificate_file(WOLFSSL_CTX*, const char*, int);
 212 WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_file(WOLFSSL_CTX*, const char*, int);
 213 WOLFSSL_API int wolfSSL_CTX_load_verify_locations(WOLFSSL_CTX*, const char*,
 214                                                 const char*);
 215 WOLFSSL_API int wolfSSL_CTX_use_certificate_chain_file(WOLFSSL_CTX *,
 216                                                      const char *file);
 217 WOLFSSL_API int wolfSSL_CTX_use_RSAPrivateKey_file(WOLFSSL_CTX*, const char*, int);
 218
 219 WOLFSSL_API long wolfSSL_get_verify_depth(WOLFSSL* ssl);
 220 WOLFSSL_API long wolfSSL_CTX_get_verify_depth(WOLFSSL_CTX* ctx);
 221 WOLFSSL_API int wolfSSL_use_certificate_file(WOLFSSL*, const char*, int);
 222 WOLFSSL_API int wolfSSL_use_PrivateKey_file(WOLFSSL*, const char*, int);
 223 WOLFSSL_API int wolfSSL_use_certificate_chain_file(WOLFSSL*, const char *file);
 224 WOLFSSL_API int wolfSSL_use_RSAPrivateKey_file(WOLFSSL*, const char*, int);
 225
 226 #ifdef WOLFSSL_DER_LOAD
 227     WOLFSSL_API int wolfSSL_CTX_der_load_verify_locations(WOLFSSL_CTX*,
 228                                                     const char*, int);
 229 #endif
 230
 231 #ifdef HAVE_NTRU
 232     WOLFSSL_API int wolfSSL_CTX_use_NTRUPrivateKey_file(WOLFSSL_CTX*, const char*);
 233     /* load NTRU private key blob */
 234 #endif
 235
 236 #ifndef WOLFSSL_PEMCERT_TODER_DEFINED
 237     WOLFSSL_API int wolfSSL_PemCertToDer(const char*, unsigned char*, int);
 238     #define WOLFSSL_PEMCERT_TODER_DEFINED
 239 #endif
 240
 241 #endif /* !NO_FILESYSTEM && !NO_CERTS */
 242
 243 WOLFSSL_API WOLFSSL_CTX* wolfSSL_CTX_new(WOLFSSL_METHOD*);
 244 WOLFSSL_API WOLFSSL* wolfSSL_new(WOLFSSL_CTX*);
 245 WOLFSSL_API int  wolfSSL_set_fd (WOLFSSL*, int);
 246 WOLFSSL_API char* wolfSSL_get_cipher_list(int priority);
 247 WOLFSSL_API int  wolfSSL_get_ciphers(char*, int);
 248 WOLFSSL_API int  wolfSSL_get_fd(const WOLFSSL*);
 249 WOLFSSL_API void wolfSSL_set_using_nonblock(WOLFSSL*, int);
 250 WOLFSSL_API int  wolfSSL_get_using_nonblock(WOLFSSL*);
 251 WOLFSSL_API int  wolfSSL_connect(WOLFSSL*);     /* please see note at top of README
 252                                              if you get an error from connect */
 253 WOLFSSL_API int  wolfSSL_write(WOLFSSL*, const void*, int);
 254 WOLFSSL_API int  wolfSSL_read(WOLFSSL*, void*, int);
 255 WOLFSSL_API int  wolfSSL_peek(WOLFSSL*, void*, int);
 256 WOLFSSL_API int  wolfSSL_accept(WOLFSSL*);
 257 WOLFSSL_API void wolfSSL_CTX_free(WOLFSSL_CTX*);
 258 WOLFSSL_API void wolfSSL_free(WOLFSSL*);
 259 WOLFSSL_API int  wolfSSL_shutdown(WOLFSSL*);
 260 WOLFSSL_API int  wolfSSL_send(WOLFSSL*, const void*, int sz, int flags);
 261 WOLFSSL_API int  wolfSSL_recv(WOLFSSL*, void*, int sz, int flags);
 262
 263 WOLFSSL_API void wolfSSL_CTX_set_quiet_shutdown(WOLFSSL_CTX*, int);
 264 WOLFSSL_API void wolfSSL_set_quiet_shutdown(WOLFSSL*, int);
 265
 266 WOLFSSL_API int  wolfSSL_get_error(WOLFSSL*, int);
 267 WOLFSSL_API int  wolfSSL_get_alert_history(WOLFSSL*, WOLFSSL_ALERT_HISTORY *);
 268
 269 WOLFSSL_API int        wolfSSL_set_session(WOLFSSL* ssl,WOLFSSL_SESSION* session);
 270 WOLFSSL_API long       wolfSSL_SSL_SESSION_set_timeout(WOLFSSL_SESSION* session, long t);
 271 WOLFSSL_API WOLFSSL_SESSION* wolfSSL_get_session(WOLFSSL* ssl);
 272 WOLFSSL_API void       wolfSSL_flush_sessions(WOLFSSL_CTX *ctx, long tm);
 273 WOLFSSL_API int        wolfSSL_SetServerID(WOLFSSL* ssl, const unsigned char*,
 274                                          int, int);
 275
 276 #ifdef SESSION_INDEX
 277 WOLFSSL_API int wolfSSL_GetSessionIndex(WOLFSSL* ssl);
 278 WOLFSSL_API int wolfSSL_GetSessionAtIndex(int index, WOLFSSL_SESSION* session);
 279 #endif /* SESSION_INDEX */
 280
 281 #if defined(SESSION_INDEX) && defined(SESSION_CERTS)
 282 WOLFSSL_API
 283     WOLFSSL_X509_CHAIN* wolfSSL_SESSION_get_peer_chain(WOLFSSL_SESSION* session);
 284 #endif /* SESSION_INDEX && SESSION_CERTS */
 285
 286 typedef int (*VerifyCallback)(int, WOLFSSL_X509_STORE_CTX*);
 287 typedef int (*pem_password_cb)(char*, int, int, void*);
 288
 289 WOLFSSL_API void wolfSSL_CTX_set_verify(WOLFSSL_CTX*, int,
 290                                       VerifyCallback verify_callback);
 291 WOLFSSL_API void wolfSSL_set_verify(WOLFSSL*, int, VerifyCallback verify_callback);
 292 WOLFSSL_API void wolfSSL_SetCertCbCtx(WOLFSSL*, void*);
 293
 294 WOLFSSL_API int  wolfSSL_pending(WOLFSSL*);
 295
 296 WOLFSSL_API void wolfSSL_load_error_strings(void);
 297 WOLFSSL_API int  wolfSSL_library_init(void);
 298 WOLFSSL_API long wolfSSL_CTX_set_session_cache_mode(WOLFSSL_CTX*, long);
 299
 300 #ifdef HAVE_SECRET_CALLBACK
 301 typedef int (*SessionSecretCb)(WOLFSSL* ssl,
 302                                         void* secret, int* secretSz, void* ctx);
 303 WOLFSSL_API int  wolfSSL_set_session_secret_cb(WOLFSSL*, SessionSecretCb, void*);
 304 #endif /* HAVE_SECRET_CALLBACK */
 305
 306 /* session cache persistence */
 307 WOLFSSL_API int  wolfSSL_save_session_cache(const char*);
 308 WOLFSSL_API int  wolfSSL_restore_session_cache(const char*);
 309 WOLFSSL_API int  wolfSSL_memsave_session_cache(void*, int);
 310 WOLFSSL_API int  wolfSSL_memrestore_session_cache(const void*, int);
 311 WOLFSSL_API int  wolfSSL_get_session_cache_memsize(void);
 312
 313 /* certificate cache persistence, uses ctx since certs are per ctx */
 314 WOLFSSL_API int  wolfSSL_CTX_save_cert_cache(WOLFSSL_CTX*, const char*);
 315 WOLFSSL_API int  wolfSSL_CTX_restore_cert_cache(WOLFSSL_CTX*, const char*);
 316 WOLFSSL_API int  wolfSSL_CTX_memsave_cert_cache(WOLFSSL_CTX*, void*, int, int*);
 317 WOLFSSL_API int  wolfSSL_CTX_memrestore_cert_cache(WOLFSSL_CTX*, const void*, int);
 318 WOLFSSL_API int  wolfSSL_CTX_get_cert_cache_memsize(WOLFSSL_CTX*);
 319
 320 /* only supports full name from cipher_name[] delimited by : */
 321 WOLFSSL_API int  wolfSSL_CTX_set_cipher_list(WOLFSSL_CTX*, const char*);
 322 WOLFSSL_API int  wolfSSL_set_cipher_list(WOLFSSL*, const char*);
 323
 324 /* Nonblocking DTLS helper functions */
 325 WOLFSSL_API int  wolfSSL_dtls_get_current_timeout(WOLFSSL* ssl);
 326 WOLFSSL_API int  wolfSSL_dtls_set_timeout_init(WOLFSSL* ssl, int);
 327 WOLFSSL_API int  wolfSSL_dtls_set_timeout_max(WOLFSSL* ssl, int);
 328 WOLFSSL_API int  wolfSSL_dtls_got_timeout(WOLFSSL* ssl);
 329 WOLFSSL_API int  wolfSSL_dtls(WOLFSSL* ssl);
 330
 331 WOLFSSL_API int  wolfSSL_dtls_set_peer(WOLFSSL*, void*, unsigned int);
 332 WOLFSSL_API int  wolfSSL_dtls_get_peer(WOLFSSL*, void*, unsigned int*);
 333
 334 WOLFSSL_API int   wolfSSL_ERR_GET_REASON(int err);
 335 WOLFSSL_API char* wolfSSL_ERR_error_string(unsigned long,char*);
 336 WOLFSSL_API void  wolfSSL_ERR_error_string_n(unsigned long e, char* buf,
 337                                            unsigned long sz);
 338 WOLFSSL_API const char* wolfSSL_ERR_reason_error_string(unsigned long);
 339
 340 /* extras */
 341
 342 #define STACK_OF(x) x
 343
 344 WOLFSSL_API int  wolfSSL_set_ex_data(WOLFSSL*, int, void*);
 345 WOLFSSL_API int  wolfSSL_get_shutdown(const WOLFSSL*);
 346 WOLFSSL_API int  wolfSSL_set_rfd(WOLFSSL*, int);
 347 WOLFSSL_API int  wolfSSL_set_wfd(WOLFSSL*, int);
 348 WOLFSSL_API void wolfSSL_set_shutdown(WOLFSSL*, int);
 349 WOLFSSL_API int  wolfSSL_set_session_id_context(WOLFSSL*, const unsigned char*,
 350                                            unsigned int);
 351 WOLFSSL_API void wolfSSL_set_connect_state(WOLFSSL*);
 352 WOLFSSL_API void wolfSSL_set_accept_state(WOLFSSL*);
 353 WOLFSSL_API int  wolfSSL_session_reused(WOLFSSL*);
 354 WOLFSSL_API void wolfSSL_SESSION_free(WOLFSSL_SESSION* session);
 355 WOLFSSL_API int  wolfSSL_is_init_finished(WOLFSSL*);
 356
 357 WOLFSSL_API const char*  wolfSSL_get_version(WOLFSSL*);
 358 WOLFSSL_API int  wolfSSL_get_current_cipher_suite(WOLFSSL* ssl);
 359 WOLFSSL_API WOLFSSL_CIPHER*  wolfSSL_get_current_cipher(WOLFSSL*);
 360 WOLFSSL_API char*        wolfSSL_CIPHER_description(WOLFSSL_CIPHER*, char*, int);
 361 WOLFSSL_API const char*  wolfSSL_CIPHER_get_name(const WOLFSSL_CIPHER* cipher);
 362 WOLFSSL_API const char*  wolfSSL_get_cipher(WOLFSSL*);
 363 WOLFSSL_API WOLFSSL_SESSION* wolfSSL_get1_session(WOLFSSL* ssl);
 364                            /* what's ref count */
 365
 366 WOLFSSL_API void wolfSSL_X509_free(WOLFSSL_X509*);
 367 WOLFSSL_API void wolfSSL_OPENSSL_free(void*);
 368
 369 WOLFSSL_API int wolfSSL_OCSP_parse_url(char* url, char** host, char** port,
 370                                      char** path, int* ssl);
 371
 372 WOLFSSL_API WOLFSSL_METHOD* wolfSSLv23_client_method(void);
 373 WOLFSSL_API WOLFSSL_METHOD* wolfSSLv2_client_method(void);
 374 WOLFSSL_API WOLFSSL_METHOD* wolfSSLv2_server_method(void);
 375
 376 WOLFSSL_API void wolfSSL_MD4_Init(WOLFSSL_MD4_CTX*);
 377 WOLFSSL_API void wolfSSL_MD4_Update(WOLFSSL_MD4_CTX*, const void*, unsigned long);
 378 WOLFSSL_API void wolfSSL_MD4_Final(unsigned char*, WOLFSSL_MD4_CTX*);
 379
 380
 381 WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new(WOLFSSL_BIO_METHOD*);
 382 WOLFSSL_API int  wolfSSL_BIO_free(WOLFSSL_BIO*);
 383 WOLFSSL_API int  wolfSSL_BIO_free_all(WOLFSSL_BIO*);
 384 WOLFSSL_API int  wolfSSL_BIO_read(WOLFSSL_BIO*, void*, int);
 385 WOLFSSL_API int  wolfSSL_BIO_write(WOLFSSL_BIO*, const void*, int);
 386 WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_push(WOLFSSL_BIO*, WOLFSSL_BIO* append);
 387 WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_pop(WOLFSSL_BIO*);
 388 WOLFSSL_API int  wolfSSL_BIO_flush(WOLFSSL_BIO*);
 389 WOLFSSL_API int  wolfSSL_BIO_pending(WOLFSSL_BIO*);
 390
 391 WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_buffer(void);
 392 WOLFSSL_API long wolfSSL_BIO_set_write_buffer_size(WOLFSSL_BIO*, long size);
 393 WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_ssl(void);
 394 WOLFSSL_API WOLFSSL_BIO*        wolfSSL_BIO_new_socket(int sfd, int flag);
 395 WOLFSSL_API int         wolfSSL_BIO_eof(WOLFSSL_BIO*);
 396
 397 WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_s_mem(void);
 398 WOLFSSL_API WOLFSSL_BIO_METHOD* wolfSSL_BIO_f_base64(void);
 399 WOLFSSL_API void wolfSSL_BIO_set_flags(WOLFSSL_BIO*, int);
 400
 401 WOLFSSL_API int wolfSSL_BIO_get_mem_data(WOLFSSL_BIO* bio,const unsigned char** p);
 402 WOLFSSL_API WOLFSSL_BIO* wolfSSL_BIO_new_mem_buf(void* buf, int len);
 403
 404
 405 WOLFSSL_API long        wolfSSL_BIO_set_ssl(WOLFSSL_BIO*, WOLFSSL*, int flag);
 406 WOLFSSL_API void        wolfSSL_set_bio(WOLFSSL*, WOLFSSL_BIO* rd, WOLFSSL_BIO* wr);
 407
 408 WOLFSSL_API int  wolfSSL_add_all_algorithms(void);
 409
 410 WOLFSSL_API void        wolfSSL_RAND_screen(void);
 411 WOLFSSL_API const char* wolfSSL_RAND_file_name(char*, unsigned long);
 412 WOLFSSL_API int         wolfSSL_RAND_write_file(const char*);
 413 WOLFSSL_API int         wolfSSL_RAND_load_file(const char*, long);
 414 WOLFSSL_API int         wolfSSL_RAND_egd(const char*);
 415 WOLFSSL_API int         wolfSSL_RAND_seed(const void*, int);
 416 WOLFSSL_API void        wolfSSL_RAND_add(const void*, int, double);
 417
 418 WOLFSSL_API WOLFSSL_COMP_METHOD* wolfSSL_COMP_zlib(void);
 419 WOLFSSL_API WOLFSSL_COMP_METHOD* wolfSSL_COMP_rle(void);
 420 WOLFSSL_API int wolfSSL_COMP_add_compression_method(int, void*);
 421
 422 WOLFSSL_API int wolfSSL_get_ex_new_index(long, void*, void*, void*, void*);
 423
 424 WOLFSSL_API void wolfSSL_set_id_callback(unsigned long (*f)(void));
 425 WOLFSSL_API void wolfSSL_set_locking_callback(void (*f)(int, int, const char*,
 426                                                       int));
 427 WOLFSSL_API void wolfSSL_set_dynlock_create_callback(WOLFSSL_dynlock_value* (*f)
 428                                                    (const char*, int));
 429 WOLFSSL_API void wolfSSL_set_dynlock_lock_callback(void (*f)(int,
 430                                       WOLFSSL_dynlock_value*, const char*, int));
 431 WOLFSSL_API void wolfSSL_set_dynlock_destroy_callback(void (*f)
 432                                      (WOLFSSL_dynlock_value*, const char*, int));
 433 WOLFSSL_API int  wolfSSL_num_locks(void);
 434
 435 WOLFSSL_API WOLFSSL_X509* wolfSSL_X509_STORE_CTX_get_current_cert(
 436                                                         WOLFSSL_X509_STORE_CTX*);
 437 WOLFSSL_API int   wolfSSL_X509_STORE_CTX_get_error(WOLFSSL_X509_STORE_CTX*);
 438 WOLFSSL_API int   wolfSSL_X509_STORE_CTX_get_error_depth(WOLFSSL_X509_STORE_CTX*);
 439
 440 WOLFSSL_API char*       wolfSSL_X509_NAME_oneline(WOLFSSL_X509_NAME*, char*, int);
 441 WOLFSSL_API WOLFSSL_X509_NAME*  wolfSSL_X509_get_issuer_name(WOLFSSL_X509*);
 442 WOLFSSL_API WOLFSSL_X509_NAME*  wolfSSL_X509_get_subject_name(WOLFSSL_X509*);
 443 WOLFSSL_API int  wolfSSL_X509_ext_isSet_by_NID(WOLFSSL_X509*, int);
 444 WOLFSSL_API int  wolfSSL_X509_ext_get_critical_by_NID(WOLFSSL_X509*, int);
 445 WOLFSSL_API int  wolfSSL_X509_get_isCA(WOLFSSL_X509*);
 446 WOLFSSL_API int  wolfSSL_X509_get_isSet_pathLength(WOLFSSL_X509*);
 447 WOLFSSL_API unsigned int wolfSSL_X509_get_pathLength(WOLFSSL_X509*);
 448 WOLFSSL_API unsigned int wolfSSL_X509_get_keyUsage(WOLFSSL_X509*);
 449 WOLFSSL_API unsigned char* wolfSSL_X509_get_authorityKeyID(
 450                                             WOLFSSL_X509*, unsigned char*, int*);
 451 WOLFSSL_API unsigned char* wolfSSL_X509_get_subjectKeyID(
 452                                             WOLFSSL_X509*, unsigned char*, int*);
 453 WOLFSSL_API int wolfSSL_X509_NAME_entry_count(WOLFSSL_X509_NAME*);
 454 WOLFSSL_API int wolfSSL_X509_NAME_get_text_by_NID(
 455                                             WOLFSSL_X509_NAME*, int, char*, int);
 456 WOLFSSL_API int         wolfSSL_X509_verify_cert(WOLFSSL_X509_STORE_CTX*);
 457 WOLFSSL_API const char* wolfSSL_X509_verify_cert_error_string(long);
 458 WOLFSSL_API int wolfSSL_X509_get_signature_type(WOLFSSL_X509*);
 459 WOLFSSL_API int wolfSSL_X509_get_signature(WOLFSSL_X509*, unsigned char*, int*);
 460
 461 WOLFSSL_API int wolfSSL_X509_LOOKUP_add_dir(WOLFSSL_X509_LOOKUP*,const char*,long);
 462 WOLFSSL_API int wolfSSL_X509_LOOKUP_load_file(WOLFSSL_X509_LOOKUP*, const char*,
 463                                             long);
 464 WOLFSSL_API WOLFSSL_X509_LOOKUP_METHOD* wolfSSL_X509_LOOKUP_hash_dir(void);
 465 WOLFSSL_API WOLFSSL_X509_LOOKUP_METHOD* wolfSSL_X509_LOOKUP_file(void);
 466
 467 WOLFSSL_API WOLFSSL_X509_LOOKUP* wolfSSL_X509_STORE_add_lookup(WOLFSSL_X509_STORE*,
 468                                                     WOLFSSL_X509_LOOKUP_METHOD*);
 469 WOLFSSL_API WOLFSSL_X509_STORE*  wolfSSL_X509_STORE_new(void);
 470 WOLFSSL_API void         wolfSSL_X509_STORE_free(WOLFSSL_X509_STORE*);
 471 WOLFSSL_API int          wolfSSL_X509_STORE_add_cert(
 472                                               WOLFSSL_X509_STORE*, WOLFSSL_X509*);
 473 WOLFSSL_API int          wolfSSL_X509_STORE_set_default_paths(WOLFSSL_X509_STORE*);
 474 WOLFSSL_API int          wolfSSL_X509_STORE_get_by_subject(WOLFSSL_X509_STORE_CTX*,
 475                                    int, WOLFSSL_X509_NAME*, WOLFSSL_X509_OBJECT*);
 476 WOLFSSL_API WOLFSSL_X509_STORE_CTX* wolfSSL_X509_STORE_CTX_new(void);
 477 WOLFSSL_API int  wolfSSL_X509_STORE_CTX_init(WOLFSSL_X509_STORE_CTX*,
 478                       WOLFSSL_X509_STORE*, WOLFSSL_X509*, STACK_OF(WOLFSSL_X509)*);
 479 WOLFSSL_API void wolfSSL_X509_STORE_CTX_free(WOLFSSL_X509_STORE_CTX*);
 480 WOLFSSL_API void wolfSSL_X509_STORE_CTX_cleanup(WOLFSSL_X509_STORE_CTX*);
 481
 482 WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_X509_CRL_get_lastUpdate(WOLFSSL_X509_CRL*);
 483 WOLFSSL_API WOLFSSL_ASN1_TIME* wolfSSL_X509_CRL_get_nextUpdate(WOLFSSL_X509_CRL*);
 484
 485 WOLFSSL_API WOLFSSL_EVP_PKEY* wolfSSL_X509_get_pubkey(WOLFSSL_X509*);
 486 WOLFSSL_API int       wolfSSL_X509_CRL_verify(WOLFSSL_X509_CRL*, WOLFSSL_EVP_PKEY*);
 487 WOLFSSL_API void      wolfSSL_X509_STORE_CTX_set_error(WOLFSSL_X509_STORE_CTX*,
 488                                                      int);
 489 WOLFSSL_API void      wolfSSL_X509_OBJECT_free_contents(WOLFSSL_X509_OBJECT*);
 490 WOLFSSL_API void      wolfSSL_EVP_PKEY_free(WOLFSSL_EVP_PKEY*);
 491 WOLFSSL_API int       wolfSSL_X509_cmp_current_time(const WOLFSSL_ASN1_TIME*);
 492 WOLFSSL_API int       wolfSSL_sk_X509_REVOKED_num(WOLFSSL_X509_REVOKED*);
 493
 494 WOLFSSL_API WOLFSSL_X509_REVOKED* wolfSSL_X509_CRL_get_REVOKED(WOLFSSL_X509_CRL*);
 495 WOLFSSL_API WOLFSSL_X509_REVOKED* wolfSSL_sk_X509_REVOKED_value(
 496                                                       WOLFSSL_X509_REVOKED*,int);
 497 WOLFSSL_API WOLFSSL_ASN1_INTEGER* wolfSSL_X509_get_serialNumber(WOLFSSL_X509*);
 498
 499 WOLFSSL_API int wolfSSL_ASN1_TIME_print(WOLFSSL_BIO*, const WOLFSSL_ASN1_TIME*);
 500
 501 WOLFSSL_API int  wolfSSL_ASN1_INTEGER_cmp(const WOLFSSL_ASN1_INTEGER*,
 502                                        const WOLFSSL_ASN1_INTEGER*);
 503 WOLFSSL_API long wolfSSL_ASN1_INTEGER_get(const WOLFSSL_ASN1_INTEGER*);
 504
 505 WOLFSSL_API STACK_OF(WOLFSSL_X509_NAME)* wolfSSL_load_client_CA_file(const char*);
 506
 507 WOLFSSL_API void  wolfSSL_CTX_set_client_CA_list(WOLFSSL_CTX*,
 508                                                STACK_OF(WOLFSSL_X509_NAME)*);
 509 WOLFSSL_API void* wolfSSL_X509_STORE_CTX_get_ex_data(WOLFSSL_X509_STORE_CTX*, int);
 510 WOLFSSL_API int   wolfSSL_get_ex_data_X509_STORE_CTX_idx(void);
 511 WOLFSSL_API void* wolfSSL_get_ex_data(const WOLFSSL*, int);
 512
 513 WOLFSSL_API void wolfSSL_CTX_set_default_passwd_cb_userdata(WOLFSSL_CTX*,
 514                                                           void* userdata);
 515 WOLFSSL_API void wolfSSL_CTX_set_default_passwd_cb(WOLFSSL_CTX*, pem_password_cb);
 516
 517
 518 WOLFSSL_API void wolfSSL_CTX_set_info_callback(WOLFSSL_CTX*, void (*)(void));
 519
 520 WOLFSSL_API unsigned long wolfSSL_ERR_peek_error(void);
 521 WOLFSSL_API int           wolfSSL_GET_REASON(int);
 522
 523 WOLFSSL_API char* wolfSSL_alert_type_string_long(int);
 524 WOLFSSL_API char* wolfSSL_alert_desc_string_long(int);
 525 WOLFSSL_API char* wolfSSL_state_string_long(WOLFSSL*);
 526
 527 WOLFSSL_API WOLFSSL_RSA* wolfSSL_RSA_generate_key(int, unsigned long,
 528                                                void(*)(int, int, void*), void*);
 529 WOLFSSL_API void wolfSSL_CTX_set_tmp_rsa_callback(WOLFSSL_CTX*,
 530                                              WOLFSSL_RSA*(*)(WOLFSSL*, int, int));
 531
 532 WOLFSSL_API int wolfSSL_PEM_def_callback(char*, int num, int w, void* key);
 533
 534 WOLFSSL_API long wolfSSL_CTX_sess_accept(WOLFSSL_CTX*);
 535 WOLFSSL_API long wolfSSL_CTX_sess_connect(WOLFSSL_CTX*);
 536 WOLFSSL_API long wolfSSL_CTX_sess_accept_good(WOLFSSL_CTX*);
 537 WOLFSSL_API long wolfSSL_CTX_sess_connect_good(WOLFSSL_CTX*);
 538 WOLFSSL_API long wolfSSL_CTX_sess_accept_renegotiate(WOLFSSL_CTX*);
 539 WOLFSSL_API long wolfSSL_CTX_sess_connect_renegotiate(WOLFSSL_CTX*);
 540 WOLFSSL_API long wolfSSL_CTX_sess_hits(WOLFSSL_CTX*);
 541 WOLFSSL_API long wolfSSL_CTX_sess_cb_hits(WOLFSSL_CTX*);
 542 WOLFSSL_API long wolfSSL_CTX_sess_cache_full(WOLFSSL_CTX*);
 543 WOLFSSL_API long wolfSSL_CTX_sess_misses(WOLFSSL_CTX*);
 544 WOLFSSL_API long wolfSSL_CTX_sess_timeouts(WOLFSSL_CTX*);
 545 WOLFSSL_API long wolfSSL_CTX_sess_number(WOLFSSL_CTX*);
 546 WOLFSSL_API long wolfSSL_CTX_sess_get_cache_size(WOLFSSL_CTX*);
 547
 548 #define WOLFSSL_DEFAULT_CIPHER_LIST ""   /* default all */
 549 #define WOLFSSL_RSA_F4 0x10001L
 550
 551 enum {
 552     OCSP_NOCERTS     = 1,
 553     OCSP_NOINTERN    = 2,
 554     OCSP_NOSIGS      = 4,
 555     OCSP_NOCHAIN     = 8,
 556     OCSP_NOVERIFY    = 16,
 557     OCSP_NOEXPLICIT  = 32,
 558     OCSP_NOCASIGN    = 64,
 559     OCSP_NODELEGATED = 128,
 560     OCSP_NOCHECKS    = 256,
 561     OCSP_TRUSTOTHER  = 512,
 562     OCSP_RESPID_KEY  = 1024,
 563     OCSP_NOTIME      = 2048,
 564
 565     OCSP_CERTID   = 2,
 566     OCSP_REQUEST  = 4,
 567     OCSP_RESPONSE = 8,
 568     OCSP_BASICRESP = 16,
 569
 570     WOLFSSL_OCSP_URL_OVERRIDE = 1,
 571     WOLFSSL_OCSP_NO_NONCE     = 2,
 572     WOLFSSL_OCSP_CHECKALL     = 4,
 573
 574     WOLFSSL_CRL_CHECKALL = 1,
 575
 576     ASN1_GENERALIZEDTIME = 4,
 577
 578     SSL_OP_MICROSOFT_SESS_ID_BUG = 1,
 579     SSL_OP_NETSCAPE_CHALLENGE_BUG = 2,
 580     SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG = 3,
 581     SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG = 4,
 582     SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER = 5,
 583     SSL_OP_MSIE_SSLV2_RSA_PADDING = 6,
 584     SSL_OP_SSLEAY_080_CLIENT_DH_BUG = 7,
 585     SSL_OP_TLS_D5_BUG = 8,
 586     SSL_OP_TLS_BLOCK_PADDING_BUG = 9,
 587     SSL_OP_TLS_ROLLBACK_BUG = 10,
 588     SSL_OP_ALL = 11,
 589     SSL_OP_EPHEMERAL_RSA = 12,
 590     SSL_OP_NO_SSLv3 = 13,
 591     SSL_OP_NO_TLSv1 = 14,
 592     SSL_OP_PKCS1_CHECK_1 = 15,
 593     SSL_OP_PKCS1_CHECK_2 = 16,
 594     SSL_OP_NETSCAPE_CA_DN_BUG = 17,
 595     SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG = 18,
 596     SSL_OP_SINGLE_DH_USE = 19,
 597     SSL_OP_NO_TICKET = 20,
 598     SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS = 21,
 599     SSL_OP_NO_QUERY_MTU = 22,
 600     SSL_OP_COOKIE_EXCHANGE = 23,
 601     SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION = 24,
 602     SSL_OP_SINGLE_ECDH_USE = 25,
 603     SSL_OP_CIPHER_SERVER_PREFERENCE = 26,
 604
 605     SSL_MAX_SSL_SESSION_ID_LENGTH = 32,
 606
 607     EVP_R_BAD_DECRYPT = 2,
 608
 609     SSL_CB_LOOP = 4,
 610     SSL_ST_CONNECT = 5,
 611     SSL_ST_ACCEPT  = 6,
 612     SSL_CB_ALERT   = 7,
 613     SSL_CB_READ    = 8,
 614     SSL_CB_HANDSHAKE_DONE = 9,
 615
 616     SSL_MODE_ENABLE_PARTIAL_WRITE = 2,
 617
 618     BIO_FLAGS_BASE64_NO_NL = 1,
 619     BIO_CLOSE   = 1,
 620     BIO_NOCLOSE = 0,
 621
 622     NID_undef = 0,
 623
 624     X509_FILETYPE_PEM = 8,
 625     X509_LU_X509      = 9,
 626     X509_LU_CRL       = 12,
 627
 628     X509_V_ERR_CRL_SIGNATURE_FAILURE = 13,
 629     X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD = 14,
 630     X509_V_ERR_CRL_HAS_EXPIRED                = 15,
 631     X509_V_ERR_CERT_REVOKED                   = 16,
 632     X509_V_ERR_CERT_CHAIN_TOO_LONG            = 17,
 633     X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT      = 18,
 634     X509_V_ERR_CERT_NOT_YET_VALID             = 19,
 635     X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD = 20,
 636     X509_V_ERR_CERT_HAS_EXPIRED               = 21,
 637     X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD  = 22,
 638
 639     X509_V_OK = 0,
 640
 641     CRYPTO_LOCK = 1,
 642     CRYPTO_NUM_LOCKS = 10
 643 };
 644
 645 /* extras end */
 646
 647 #if !defined(NO_FILESYSTEM) && !defined(NO_STDIO_FILESYSTEM)
 648 /* wolfSSL extension, provide last error from SSL_get_error
 649    since not using thread storage error queue */
 650 WOLFSSL_API void  wolfSSL_ERR_print_errors_fp(FILE*, int err);
 651 #endif
 652
 653 enum { /* ssl Constants */
 654     SSL_ERROR_NONE      =  0,   /* for most functions */
 655     SSL_FAILURE         =  0,   /* for some functions */
 656     SSL_SUCCESS         =  1,
 657     SSL_SHUTDOWN_NOT_DONE =  2,  /* call wolfSSL_shutdown again to complete */
 658
 659     SSL_BAD_CERTTYPE    = -8,
 660     SSL_BAD_STAT        = -7,
 661     SSL_BAD_PATH        = -6,
 662     SSL_BAD_FILETYPE    = -5,
 663     SSL_BAD_FILE        = -4,
 664     SSL_NOT_IMPLEMENTED = -3,
 665     SSL_UNKNOWN         = -2,
 666     SSL_FATAL_ERROR     = -1,
 667
 668     SSL_FILETYPE_ASN1    = 2,
 669     SSL_FILETYPE_PEM     = 1,
 670     SSL_FILETYPE_DEFAULT = 2, /* ASN1 */
 671     SSL_FILETYPE_RAW     = 3, /* NTRU raw key blob */
 672
 673     SSL_VERIFY_NONE                 = 0,
 674     SSL_VERIFY_PEER                 = 1,
 675     SSL_VERIFY_FAIL_IF_NO_PEER_CERT = 2,
 676     SSL_VERIFY_CLIENT_ONCE          = 4,
 677
 678     SSL_SESS_CACHE_OFF                = 30,
 679     SSL_SESS_CACHE_CLIENT             = 31,
 680     SSL_SESS_CACHE_SERVER             = 32,
 681     SSL_SESS_CACHE_BOTH               = 33,
 682     SSL_SESS_CACHE_NO_AUTO_CLEAR      = 34,
 683     SSL_SESS_CACHE_NO_INTERNAL_LOOKUP = 35,
 684
 685     SSL_ERROR_WANT_READ        =  2,
 686     SSL_ERROR_WANT_WRITE       =  3,
 687     SSL_ERROR_WANT_CONNECT     =  7,
 688     SSL_ERROR_WANT_ACCEPT      =  8,
 689     SSL_ERROR_SYSCALL          =  5,
 690     SSL_ERROR_WANT_X509_LOOKUP = 83,
 691     SSL_ERROR_ZERO_RETURN      =  6,
 692     SSL_ERROR_SSL              = 85,
 693
 694     SSL_SENT_SHUTDOWN     = 1,
 695     SSL_RECEIVED_SHUTDOWN = 2,
 696     SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER = 4,
 697     SSL_OP_NO_SSLv2       = 8,
 698
 699     SSL_R_SSL_HANDSHAKE_FAILURE           = 101,
 700     SSL_R_TLSV1_ALERT_UNKNOWN_CA          = 102,
 701     SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN = 103,
 702     SSL_R_SSLV3_ALERT_BAD_CERTIFICATE     = 104,
 703
 704     PEM_BUFSIZE = 1024
 705 };
 706
 707
 708 #ifndef NO_PSK
 709     typedef unsigned int (*psk_client_callback)(WOLFSSL*, const char*, char*,
 710                                     unsigned int, unsigned char*, unsigned int);
 711     WOLFSSL_API void wolfSSL_CTX_set_psk_client_callback(WOLFSSL_CTX*,
 712                                                     psk_client_callback);
 713     WOLFSSL_API void wolfSSL_set_psk_client_callback(WOLFSSL*,psk_client_callback);
 714
 715     WOLFSSL_API const char* wolfSSL_get_psk_identity_hint(const WOLFSSL*);
 716     WOLFSSL_API const char* wolfSSL_get_psk_identity(const WOLFSSL*);
 717
 718     WOLFSSL_API int wolfSSL_CTX_use_psk_identity_hint(WOLFSSL_CTX*, const char*);
 719     WOLFSSL_API int wolfSSL_use_psk_identity_hint(WOLFSSL*, const char*);
 720
 721     typedef unsigned int (*psk_server_callback)(WOLFSSL*, const char*,
 722                           unsigned char*, unsigned int);
 723     WOLFSSL_API void wolfSSL_CTX_set_psk_server_callback(WOLFSSL_CTX*,
 724                                                     psk_server_callback);
 725     WOLFSSL_API void wolfSSL_set_psk_server_callback(WOLFSSL*,psk_server_callback);
 726
 727     #define PSK_TYPES_DEFINED
 728 #endif /* NO_PSK */
 729
 730
 731 #ifdef HAVE_ANON
 732     WOLFSSL_API int wolfSSL_CTX_allow_anon_cipher(WOLFSSL_CTX*);
 733 #endif /* HAVE_ANON */
 734
 735
 736 /* extra begins */
 737
 738 enum {  /* ERR Constants */
 739     ERR_TXT_STRING = 1
 740 };
 741
 742 WOLFSSL_API unsigned long wolfSSL_ERR_get_error_line_data(const char**, int*,
 743                                                  const char**, int *);
 744
 745 WOLFSSL_API unsigned long wolfSSL_ERR_get_error(void);
 746 WOLFSSL_API void          wolfSSL_ERR_clear_error(void);
 747
 748
 749 WOLFSSL_API int  wolfSSL_RAND_status(void);
 750 WOLFSSL_API int  wolfSSL_RAND_bytes(unsigned char* buf, int num);
 751 WOLFSSL_API WOLFSSL_METHOD *wolfSSLv23_server_method(void);
 752 WOLFSSL_API long wolfSSL_CTX_set_options(WOLFSSL_CTX*, long);
 753 #ifndef NO_CERTS
 754   WOLFSSL_API int  wolfSSL_CTX_check_private_key(WOLFSSL_CTX*);
 755 #endif /* !NO_CERTS */
 756
 757 WOLFSSL_API void wolfSSL_ERR_free_strings(void);
 758 WOLFSSL_API void wolfSSL_ERR_remove_state(unsigned long);
 759 WOLFSSL_API void wolfSSL_EVP_cleanup(void);
 760 WOLFSSL_API int  wolfSSL_clear(WOLFSSL* ssl);
 761
 762 WOLFSSL_API void wolfSSL_cleanup_all_ex_data(void);
 763 WOLFSSL_API long wolfSSL_CTX_set_mode(WOLFSSL_CTX* ctx, long mode);
 764 WOLFSSL_API long wolfSSL_CTX_get_mode(WOLFSSL_CTX* ctx);
 765 WOLFSSL_API void wolfSSL_CTX_set_default_read_ahead(WOLFSSL_CTX* ctx, int m);
 766 WOLFSSL_API long wolfSSL_SSL_get_mode(WOLFSSL* ssl);
 767
 768 WOLFSSL_API long wolfSSL_CTX_sess_set_cache_size(WOLFSSL_CTX*, long);
 769
 770 WOLFSSL_API int  wolfSSL_CTX_set_default_verify_paths(WOLFSSL_CTX*);
 771 WOLFSSL_API int  wolfSSL_CTX_set_session_id_context(WOLFSSL_CTX*,
 772                                             const unsigned char*, unsigned int);
 773 WOLFSSL_API WOLFSSL_X509* wolfSSL_get_peer_certificate(WOLFSSL* ssl);
 774
 775 WOLFSSL_API int wolfSSL_want_read(WOLFSSL*);
 776 WOLFSSL_API int wolfSSL_want_write(WOLFSSL*);
 777
 778 WOLFSSL_API int wolfSSL_BIO_printf(WOLFSSL_BIO*, const char*, ...);
 779 WOLFSSL_API int wolfSSL_ASN1_UTCTIME_print(WOLFSSL_BIO*,
 780                                          const WOLFSSL_ASN1_UTCTIME*);
 781 WOLFSSL_API int   wolfSSL_sk_num(WOLFSSL_X509_REVOKED*);
 782 WOLFSSL_API void* wolfSSL_sk_value(WOLFSSL_X509_REVOKED*, int);
 783
 784 /* stunnel 4.28 needs */
 785 WOLFSSL_API void* wolfSSL_CTX_get_ex_data(const WOLFSSL_CTX*, int);
 786 WOLFSSL_API int   wolfSSL_CTX_set_ex_data(WOLFSSL_CTX*, int, void*);
 787 WOLFSSL_API void  wolfSSL_CTX_sess_set_get_cb(WOLFSSL_CTX*,
 788                        WOLFSSL_SESSION*(*f)(WOLFSSL*, unsigned char*, int, int*));
 789 WOLFSSL_API void  wolfSSL_CTX_sess_set_new_cb(WOLFSSL_CTX*,
 790                                             int (*f)(WOLFSSL*, WOLFSSL_SESSION*));
 791 WOLFSSL_API void  wolfSSL_CTX_sess_set_remove_cb(WOLFSSL_CTX*,
 792                                        void (*f)(WOLFSSL_CTX*, WOLFSSL_SESSION*));
 793
 794 WOLFSSL_API int          wolfSSL_i2d_SSL_SESSION(WOLFSSL_SESSION*,unsigned char**);
 795 WOLFSSL_API WOLFSSL_SESSION* wolfSSL_d2i_SSL_SESSION(WOLFSSL_SESSION**,
 796                                                    const unsigned char**, long);
 797
 798 WOLFSSL_API long wolfSSL_SESSION_get_timeout(const WOLFSSL_SESSION*);
 799 WOLFSSL_API long wolfSSL_SESSION_get_time(const WOLFSSL_SESSION*);
 800 WOLFSSL_API int  wolfSSL_CTX_get_ex_new_index(long, void*, void*, void*, void*);
 801
 802 /* extra ends */
 803
 804
 805 /* wolfSSL extensions */
 806
 807 /* call before SSL_connect, if verifying will add name check to
 808    date check and signature check */
 809 WOLFSSL_API int wolfSSL_check_domain_name(WOLFSSL* ssl, const char* dn);
 810
 811 /* need to call once to load library (session cache) */
 812 WOLFSSL_API int wolfSSL_Init(void);
 813 /* call when done to cleanup/free session cache mutex / resources  */
 814 WOLFSSL_API int wolfSSL_Cleanup(void);
 815
 816 /* which library version do we have */
 817 WOLFSSL_API const char* wolfSSL_lib_version(void);
 818 /* which library version do we have in hex */
 819 WOLFSSL_API unsigned int wolfSSL_lib_version_hex(void);
 820
 821 /* turn logging on, only if compiled in */
 822 WOLFSSL_API int  wolfSSL_Debugging_ON(void);
 823 /* turn logging off */
 824 WOLFSSL_API void wolfSSL_Debugging_OFF(void);
 825
 826 /* do accept or connect depedning on side */
 827 WOLFSSL_API int wolfSSL_negotiate(WOLFSSL* ssl);
 828 /* turn on wolfSSL data compression */
 829 WOLFSSL_API int wolfSSL_set_compression(WOLFSSL* ssl);
 830
 831 WOLFSSL_API int wolfSSL_set_timeout(WOLFSSL*, unsigned int);
 832 WOLFSSL_API int wolfSSL_CTX_set_timeout(WOLFSSL_CTX*, unsigned int);
 833
 834 /* get wolfSSL peer X509_CHAIN */
 835 WOLFSSL_API WOLFSSL_X509_CHAIN* wolfSSL_get_peer_chain(WOLFSSL* ssl);
 836 /* peer chain count */
 837 WOLFSSL_API int  wolfSSL_get_chain_count(WOLFSSL_X509_CHAIN* chain);
 838 /* index cert length */
 839 WOLFSSL_API int  wolfSSL_get_chain_length(WOLFSSL_X509_CHAIN*, int idx);
 840 /* index cert */
 841 WOLFSSL_API unsigned char* wolfSSL_get_chain_cert(WOLFSSL_X509_CHAIN*, int idx);
 842 /* index cert in X509 */
 843 WOLFSSL_API WOLFSSL_X509* wolfSSL_get_chain_X509(WOLFSSL_X509_CHAIN*, int idx);
 844 /* free X509 */
 845 WOLFSSL_API void wolfSSL_FreeX509(WOLFSSL_X509*);
 846 /* get index cert in PEM */
 847 WOLFSSL_API int  wolfSSL_get_chain_cert_pem(WOLFSSL_X509_CHAIN*, int idx,
 848                                 unsigned char* buffer, int inLen, int* outLen);
 849 WOLFSSL_API const unsigned char* wolfSSL_get_sessionID(const WOLFSSL_SESSION* s);
 850 WOLFSSL_API int  wolfSSL_X509_get_serial_number(WOLFSSL_X509*,unsigned char*,int*);
 851 WOLFSSL_API char*  wolfSSL_X509_get_subjectCN(WOLFSSL_X509*);
 852 WOLFSSL_API const unsigned char* wolfSSL_X509_get_der(WOLFSSL_X509*, int*);
 853 WOLFSSL_API const unsigned char* wolfSSL_X509_notBefore(WOLFSSL_X509*);
 854 WOLFSSL_API const unsigned char* wolfSSL_X509_notAfter(WOLFSSL_X509*);
 855 WOLFSSL_API int wolfSSL_X509_version(WOLFSSL_X509*);
 856
 857 WOLFSSL_API int wolfSSL_cmp_peer_cert_to_file(WOLFSSL*, const char*);
 858
 859 WOLFSSL_API char* wolfSSL_X509_get_next_altname(WOLFSSL_X509*);
 860
 861 WOLFSSL_API WOLFSSL_X509*
 862     wolfSSL_X509_d2i(WOLFSSL_X509** x509, const unsigned char* in, int len);
 863 #ifndef NO_FILESYSTEM
 864     #ifndef NO_STDIO_FILESYSTEM
 865     WOLFSSL_API WOLFSSL_X509*
 866         wolfSSL_X509_d2i_fp(WOLFSSL_X509** x509, FILE* file);
 867     #endif
 868 WOLFSSL_API WOLFSSL_X509*
 869     wolfSSL_X509_load_certificate_file(const char* fname, int format);
 870 #endif
 871
 872 #ifdef WOLFSSL_SEP
 873     WOLFSSL_API unsigned char*
 874            wolfSSL_X509_get_device_type(WOLFSSL_X509*, unsigned char*, int*);
 875     WOLFSSL_API unsigned char*
 876            wolfSSL_X509_get_hw_type(WOLFSSL_X509*, unsigned char*, int*);
 877     WOLFSSL_API unsigned char*
 878            wolfSSL_X509_get_hw_serial_number(WOLFSSL_X509*, unsigned char*, int*);
 879 #endif
 880
 881 /* connect enough to get peer cert */
 882 WOLFSSL_API int  wolfSSL_connect_cert(WOLFSSL* ssl);
 883
 884 #ifndef NO_DH
 885 /* server Diffie-Hellman parameters */
 886 WOLFSSL_API int  wolfSSL_SetTmpDH(WOLFSSL*, const unsigned char* p, int pSz,
 887                                 const unsigned char* g, int gSz);
 888 WOLFSSL_API int  wolfSSL_SetTmpDH_buffer(WOLFSSL*, const unsigned char* b, long sz,
 889                                        int format);
 890 #ifndef NO_FILESYSTEM
 891     WOLFSSL_API int  wolfSSL_SetTmpDH_file(WOLFSSL*, const char* f, int format);
 892 #endif
 893
 894 /* server ctx Diffie-Hellman parameters */
 895 WOLFSSL_API int  wolfSSL_CTX_SetTmpDH(WOLFSSL_CTX*, const unsigned char* p,
 896                                     int pSz, const unsigned char* g, int gSz);
 897 WOLFSSL_API int  wolfSSL_CTX_SetTmpDH_buffer(WOLFSSL_CTX*, const unsigned char* b,
 898                                            long sz, int format);
 899
 900 #ifndef NO_FILESYSTEM
 901     WOLFSSL_API int  wolfSSL_CTX_SetTmpDH_file(WOLFSSL_CTX*, const char* f,
 902                                              int format);
 903 #endif
 904
 905 WOLFSSL_API int wolfSSL_CTX_SetMinDhKey_Sz(WOLFSSL_CTX*, unsigned short);
 906 WOLFSSL_API int wolfSSL_SetMinDhKey_Sz(WOLFSSL*, unsigned short);
 907 WOLFSSL_API int wolfSSL_GetDhKey_Sz(WOLFSSL*);
 908 #endif /* NO_DH */
 909
 910 WOLFSSL_API int  wolfSSL_SetTmpEC_DHE_Sz(WOLFSSL*, unsigned short);
 911 WOLFSSL_API int  wolfSSL_CTX_SetTmpEC_DHE_Sz(WOLFSSL_CTX*, unsigned short);
 912
 913 /* keyblock size in bytes or -1 */
 914 /* need to call wolfSSL_KeepArrays before handshake to save keys */
 915 WOLFSSL_API int wolfSSL_get_keyblock_size(WOLFSSL*);
 916 WOLFSSL_API int wolfSSL_get_keys(WOLFSSL*,unsigned char** ms, unsigned int* msLen,
 917                                        unsigned char** sr, unsigned int* srLen,
 918                                        unsigned char** cr, unsigned int* crLen);
 919
 920 /* Computes EAP-TLS and EAP-TTLS keying material from the master_secret. */
 921 WOLFSSL_API int wolfSSL_make_eap_keys(WOLFSSL*, void* key, unsigned int len,
 922                                                              const char* label);
 923
 924
 925 #ifndef _WIN32
 926     #ifndef NO_WRITEV
 927         #ifdef __PPU
 928             #include <sys/types.h>
 929             #include <sys/socket.h>
 930         #elif !defined(WOLFSSL_MDK_ARM) && !defined(WOLFSSL_IAR_ARM) && !defined(WOLFSSL_PICOTCP)
 931             #include <sys/uio.h>
 932         #endif
 933         /* allow writev style writing */
 934         WOLFSSL_API int wolfSSL_writev(WOLFSSL* ssl, const struct iovec* iov,
 935                                      int iovcnt);
 936     #endif
 937 #endif
 938
 939
 940 #ifndef NO_CERTS
 941     /* SSL_CTX versions */
 942     WOLFSSL_API int wolfSSL_CTX_UnloadCAs(WOLFSSL_CTX*);
 943     WOLFSSL_API int wolfSSL_CTX_load_verify_buffer(WOLFSSL_CTX*,
 944                                                const unsigned char*, long, int);
 945     WOLFSSL_API int wolfSSL_CTX_use_certificate_buffer(WOLFSSL_CTX*,
 946                                                const unsigned char*, long, int);
 947     WOLFSSL_API int wolfSSL_CTX_use_PrivateKey_buffer(WOLFSSL_CTX*,
 948                                                const unsigned char*, long, int);
 949     WOLFSSL_API int wolfSSL_CTX_use_certificate_chain_buffer(WOLFSSL_CTX*,
 950                                                     const unsigned char*, long);
 951
 952     /* SSL versions */
 953     WOLFSSL_API int wolfSSL_use_certificate_buffer(WOLFSSL*, const unsigned char*,
 954                                                long, int);
 955     WOLFSSL_API int wolfSSL_use_PrivateKey_buffer(WOLFSSL*, const unsigned char*,
 956                                                long, int);
 957     WOLFSSL_API int wolfSSL_use_certificate_chain_buffer(WOLFSSL*,
 958                                                const unsigned char*, long);
 959     WOLFSSL_API int wolfSSL_UnloadCertsKeys(WOLFSSL*);
 960 #endif
 961
 962 WOLFSSL_API int wolfSSL_CTX_set_group_messages(WOLFSSL_CTX*);
 963 WOLFSSL_API int wolfSSL_set_group_messages(WOLFSSL*);
 964
 965 /* I/O callbacks */
 966 typedef int (*CallbackIORecv)(WOLFSSL *ssl, char *buf, int sz, void *ctx);
 967 typedef int (*CallbackIOSend)(WOLFSSL *ssl, char *buf, int sz, void *ctx);
 968
 969 #ifdef HAVE_FUZZER
 970 enum fuzzer_type {
 971     FUZZ_HMAC      = 0,
 972     FUZZ_ENCRYPT   = 1,
 973     FUZZ_SIGNATURE = 2,
 974     FUZZ_HASH      = 3,
 975     FUZZ_HEAD      = 4
 976 };
 977
 978 typedef int (*CallbackFuzzer)(WOLFSSL* ssl, const unsigned char* buf, int sz,
 979         int type, void* fuzzCtx);
 980
 981 WOLFSSL_API void wolfSSL_SetFuzzerCb(WOLFSSL* ssl, CallbackFuzzer cbf, void* fCtx);
 982 #endif
 983
 984 WOLFSSL_API void wolfSSL_SetIORecv(WOLFSSL_CTX*, CallbackIORecv);
 985 WOLFSSL_API void wolfSSL_SetIOSend(WOLFSSL_CTX*, CallbackIOSend);
 986
 987 WOLFSSL_API void wolfSSL_SetIOReadCtx( WOLFSSL* ssl, void *ctx);
 988 WOLFSSL_API void wolfSSL_SetIOWriteCtx(WOLFSSL* ssl, void *ctx);
 989
 990 WOLFSSL_API void* wolfSSL_GetIOReadCtx( WOLFSSL* ssl);
 991 WOLFSSL_API void* wolfSSL_GetIOWriteCtx(WOLFSSL* ssl);
 992
 993 WOLFSSL_API void wolfSSL_SetIOReadFlags( WOLFSSL* ssl, int flags);
 994 WOLFSSL_API void wolfSSL_SetIOWriteFlags(WOLFSSL* ssl, int flags);
 995
 996
 997 #ifndef WOLFSSL_USER_IO
 998     /* default IO callbacks */
 999     WOLFSSL_API int EmbedReceive(WOLFSSL* ssl, char* buf, int sz, void* ctx);
1000     WOLFSSL_API int EmbedSend(WOLFSSL* ssl, char* buf, int sz, void* ctx);
1001
1002     #ifdef HAVE_OCSP
1003         WOLFSSL_API int EmbedOcspLookup(void*, const char*, int, unsigned char*,
1004                                        int, unsigned char**);
1005         WOLFSSL_API void EmbedOcspRespFree(void*, unsigned char*);
1006     #endif
1007
1008     #ifdef WOLFSSL_DTLS
1009         WOLFSSL_API int EmbedReceiveFrom(WOLFSSL* ssl, char* buf, int sz, void*);
1010         WOLFSSL_API int EmbedSendTo(WOLFSSL* ssl, char* buf, int sz, void* ctx);
1011         WOLFSSL_API int EmbedGenerateCookie(WOLFSSL* ssl, unsigned char* buf,
1012                                            int sz, void*);
1013     #endif /* WOLFSSL_DTLS */
1014 #endif /* WOLFSSL_USER_IO */
1015
1016
1017 #ifdef HAVE_NETX
1018     WOLFSSL_API void wolfSSL_SetIO_NetX(WOLFSSL* ssl, NX_TCP_SOCKET* nxsocket,
1019                                       ULONG waitoption);
1020 #endif
1021
1022 typedef int (*CallbackGenCookie)(WOLFSSL* ssl, unsigned char* buf, int sz,
1023                                  void* ctx);
1024 WOLFSSL_API void  wolfSSL_CTX_SetGenCookie(WOLFSSL_CTX*, CallbackGenCookie);
1025 WOLFSSL_API void  wolfSSL_SetCookieCtx(WOLFSSL* ssl, void *ctx);
1026 WOLFSSL_API void* wolfSSL_GetCookieCtx(WOLFSSL* ssl);
1027
1028
1029 /* I/O Callback default errors */
1030 enum IOerrors {
1031     WOLFSSL_CBIO_ERR_GENERAL    = -1,     /* general unexpected err */
1032     WOLFSSL_CBIO_ERR_WANT_READ  = -2,     /* need to call read  again */
1033     WOLFSSL_CBIO_ERR_WANT_WRITE = -2,     /* need to call write again */
1034     WOLFSSL_CBIO_ERR_CONN_RST   = -3,     /* connection reset */
1035     WOLFSSL_CBIO_ERR_ISR        = -4,     /* interrupt */
1036     WOLFSSL_CBIO_ERR_CONN_CLOSE = -5,     /* connection closed or epipe */
1037     WOLFSSL_CBIO_ERR_TIMEOUT    = -6      /* socket timeout */
1038 };
1039
1040
1041 /* CA cache callbacks */
1042 enum {
1043     WOLFSSL_SSLV3    = 0,
1044     WOLFSSL_TLSV1    = 1,
1045     WOLFSSL_TLSV1_1  = 2,
1046     WOLFSSL_TLSV1_2  = 3,
1047     WOLFSSL_USER_CA  = 1,          /* user added as trusted */
1048     WOLFSSL_CHAIN_CA = 2           /* added to cache from trusted chain */
1049 };
1050
1051 WOLFSSL_API int wolfSSL_CTX_SetMinVersion(WOLFSSL_CTX* ctx, int version);
1052 WOLFSSL_API int wolfSSL_SetMinVersion(WOLFSSL* ssl, int version);
1053 WOLFSSL_API int wolfSSL_GetObjectSize(void);  /* object size based on build */
1054 WOLFSSL_API int wolfSSL_SetVersion(WOLFSSL* ssl, int version);
1055 WOLFSSL_API int wolfSSL_KeyPemToDer(const unsigned char*, int sz, unsigned char*,
1056                                   int, const char*);
1057 WOLFSSL_API int wolfSSL_CertPemToDer(const unsigned char*, int sz, unsigned char*,
1058                                    int, int);
1059
1060 typedef void (*CallbackCACache)(unsigned char* der, int sz, int type);
1061 typedef void (*CbMissingCRL)(const char* url);
1062 typedef int  (*CbOCSPIO)(void*, const char*, int,
1063                                          unsigned char*, int, unsigned char**);
1064 typedef void (*CbOCSPRespFree)(void*,unsigned char*);
1065
1066 /* User Atomic Record Layer CallBacks */
1067 typedef int (*CallbackMacEncrypt)(WOLFSSL* ssl, unsigned char* macOut,
1068        const unsigned char* macIn, unsigned int macInSz, int macContent,
1069        int macVerify, unsigned char* encOut, const unsigned char* encIn,
1070        unsigned int encSz, void* ctx);
1071 WOLFSSL_API void  wolfSSL_CTX_SetMacEncryptCb(WOLFSSL_CTX*, CallbackMacEncrypt);
1072 WOLFSSL_API void  wolfSSL_SetMacEncryptCtx(WOLFSSL* ssl, void *ctx);
1073 WOLFSSL_API void* wolfSSL_GetMacEncryptCtx(WOLFSSL* ssl);
1074
1075 typedef int (*CallbackDecryptVerify)(WOLFSSL* ssl,
1076        unsigned char* decOut, const unsigned char* decIn,
1077        unsigned int decSz, int content, int verify, unsigned int* padSz,
1078        void* ctx);
1079 WOLFSSL_API void  wolfSSL_CTX_SetDecryptVerifyCb(WOLFSSL_CTX*,
1080                                                CallbackDecryptVerify);
1081 WOLFSSL_API void  wolfSSL_SetDecryptVerifyCtx(WOLFSSL* ssl, void *ctx);
1082 WOLFSSL_API void* wolfSSL_GetDecryptVerifyCtx(WOLFSSL* ssl);
1083
1084 WOLFSSL_API const unsigned char* wolfSSL_GetMacSecret(WOLFSSL*, int);
1085 WOLFSSL_API const unsigned char* wolfSSL_GetClientWriteKey(WOLFSSL*);
1086 WOLFSSL_API const unsigned char* wolfSSL_GetClientWriteIV(WOLFSSL*);
1087 WOLFSSL_API const unsigned char* wolfSSL_GetServerWriteKey(WOLFSSL*);
1088 WOLFSSL_API const unsigned char* wolfSSL_GetServerWriteIV(WOLFSSL*);
1089 WOLFSSL_API int                  wolfSSL_GetKeySize(WOLFSSL*);
1090 WOLFSSL_API int                  wolfSSL_GetIVSize(WOLFSSL*);
1091 WOLFSSL_API int                  wolfSSL_GetSide(WOLFSSL*);
1092 WOLFSSL_API int                  wolfSSL_IsTLSv1_1(WOLFSSL*);
1093 WOLFSSL_API int                  wolfSSL_GetBulkCipher(WOLFSSL*);
1094 WOLFSSL_API int                  wolfSSL_GetCipherBlockSize(WOLFSSL*);
1095 WOLFSSL_API int                  wolfSSL_GetAeadMacSize(WOLFSSL*);
1096 WOLFSSL_API int                  wolfSSL_GetHmacSize(WOLFSSL*);
1097 WOLFSSL_API int                  wolfSSL_GetHmacType(WOLFSSL*);
1098 WOLFSSL_API int                  wolfSSL_GetCipherType(WOLFSSL*);
1099 WOLFSSL_API int                  wolfSSL_SetTlsHmacInner(WOLFSSL*, unsigned char*,
1100                                                        unsigned int, int, int);
1101
1102 /* Atomic User Needs */
1103 enum {
1104     WOLFSSL_SERVER_END = 0,
1105     WOLFSSL_CLIENT_END = 1,
1106     WOLFSSL_BLOCK_TYPE = 2,
1107     WOLFSSL_STREAM_TYPE = 3,
1108     WOLFSSL_AEAD_TYPE = 4,
1109     WOLFSSL_TLS_HMAC_INNER_SZ = 13      /* SEQ_SZ + ENUM + VERSION_SZ + LEN_SZ */
1110 };
1111
1112 /* for GetBulkCipher and internal use */
1113 enum BulkCipherAlgorithm {
1114     wolfssl_cipher_null,
1115     wolfssl_rc4,
1116     wolfssl_rc2,
1117     wolfssl_des,
1118     wolfssl_triple_des,             /* leading 3 (3des) not valid identifier */
1119     wolfssl_des40,
1120     wolfssl_idea,
1121     wolfssl_aes,
1122     wolfssl_aes_gcm,
1123     wolfssl_aes_ccm,
1124     wolfssl_chacha,
1125     wolfssl_camellia,
1126     wolfssl_hc128,                  /* wolfSSL extensions */
1127     wolfssl_rabbit
1128 };
1129
1130
1131 /* for KDF TLS 1.2 mac types */
1132 enum KDF_MacAlgorithm {
1133     wolfssl_sha256 = 4,     /* needs to match internal MACAlgorithm */
1134     wolfssl_sha384,
1135     wolfssl_sha512
1136 };
1137
1138
1139 /* Public Key Callback support */
1140 typedef int (*CallbackEccSign)(WOLFSSL* ssl,
1141        const unsigned char* in, unsigned int inSz,
1142        unsigned char* out, unsigned int* outSz,
1143        const unsigned char* keyDer, unsigned int keySz,
1144        void* ctx);
1145 WOLFSSL_API void  wolfSSL_CTX_SetEccSignCb(WOLFSSL_CTX*, CallbackEccSign);
1146 WOLFSSL_API void  wolfSSL_SetEccSignCtx(WOLFSSL* ssl, void *ctx);
1147 WOLFSSL_API void* wolfSSL_GetEccSignCtx(WOLFSSL* ssl);
1148
1149 typedef int (*CallbackEccVerify)(WOLFSSL* ssl,
1150        const unsigned char* sig, unsigned int sigSz,
1151        const unsigned char* hash, unsigned int hashSz,
1152        const unsigned char* keyDer, unsigned int keySz,
1153        int* result, void* ctx);
1154 WOLFSSL_API void  wolfSSL_CTX_SetEccVerifyCb(WOLFSSL_CTX*, CallbackEccVerify);
1155 WOLFSSL_API void  wolfSSL_SetEccVerifyCtx(WOLFSSL* ssl, void *ctx);
1156 WOLFSSL_API void* wolfSSL_GetEccVerifyCtx(WOLFSSL* ssl);
1157
1158 typedef int (*CallbackRsaSign)(WOLFSSL* ssl,
1159        const unsigned char* in, unsigned int inSz,
1160        unsigned char* out, unsigned int* outSz,
1161        const unsigned char* keyDer, unsigned int keySz,
1162        void* ctx);
1163 WOLFSSL_API void  wolfSSL_CTX_SetRsaSignCb(WOLFSSL_CTX*, CallbackRsaSign);
1164 WOLFSSL_API void  wolfSSL_SetRsaSignCtx(WOLFSSL* ssl, void *ctx);
1165 WOLFSSL_API void* wolfSSL_GetRsaSignCtx(WOLFSSL* ssl);
1166
1167 typedef int (*CallbackRsaVerify)(WOLFSSL* ssl,
1168        unsigned char* sig, unsigned int sigSz,
1169        unsigned char** out,
1170        const unsigned char* keyDer, unsigned int keySz,
1171        void* ctx);
1172 WOLFSSL_API void  wolfSSL_CTX_SetRsaVerifyCb(WOLFSSL_CTX*, CallbackRsaVerify);
1173 WOLFSSL_API void  wolfSSL_SetRsaVerifyCtx(WOLFSSL* ssl, void *ctx);
1174 WOLFSSL_API void* wolfSSL_GetRsaVerifyCtx(WOLFSSL* ssl);
1175
1176 /* RSA Public Encrypt cb */
1177 typedef int (*CallbackRsaEnc)(WOLFSSL* ssl,
1178        const unsigned char* in, unsigned int inSz,
1179        unsigned char* out, unsigned int* outSz,
1180        const unsigned char* keyDer, unsigned int keySz,
1181        void* ctx);
1182 WOLFSSL_API void  wolfSSL_CTX_SetRsaEncCb(WOLFSSL_CTX*, CallbackRsaEnc);
1183 WOLFSSL_API void  wolfSSL_SetRsaEncCtx(WOLFSSL* ssl, void *ctx);
1184 WOLFSSL_API void* wolfSSL_GetRsaEncCtx(WOLFSSL* ssl);
1185
1186 /* RSA Private Decrypt cb */
1187 typedef int (*CallbackRsaDec)(WOLFSSL* ssl,
1188        unsigned char* in, unsigned int inSz,
1189        unsigned char** out,
1190        const unsigned char* keyDer, unsigned int keySz,
1191        void* ctx);
1192 WOLFSSL_API void  wolfSSL_CTX_SetRsaDecCb(WOLFSSL_CTX*, CallbackRsaDec);
1193 WOLFSSL_API void  wolfSSL_SetRsaDecCtx(WOLFSSL* ssl, void *ctx);
1194 WOLFSSL_API void* wolfSSL_GetRsaDecCtx(WOLFSSL* ssl);
1195
1196
1197 #ifndef NO_CERTS
1198         WOLFSSL_API void wolfSSL_CTX_SetCACb(WOLFSSL_CTX*, CallbackCACache);
1199
1200     WOLFSSL_API WOLFSSL_CERT_MANAGER* wolfSSL_CertManagerNew(void);
1201     WOLFSSL_API void wolfSSL_CertManagerFree(WOLFSSL_CERT_MANAGER*);
1202
1203     WOLFSSL_API int wolfSSL_CertManagerLoadCA(WOLFSSL_CERT_MANAGER*, const char* f,
1204                                                                  const char* d);
1205     WOLFSSL_API int wolfSSL_CertManagerUnloadCAs(WOLFSSL_CERT_MANAGER* cm);
1206     WOLFSSL_API int wolfSSL_CertManagerVerify(WOLFSSL_CERT_MANAGER*, const char* f,
1207                                                                     int format);
1208     WOLFSSL_API int wolfSSL_CertManagerVerifyBuffer(WOLFSSL_CERT_MANAGER* cm,
1209                                 const unsigned char* buff, long sz, int format);
1210     WOLFSSL_API int wolfSSL_CertManagerCheckCRL(WOLFSSL_CERT_MANAGER*,
1211                                                         unsigned char*, int sz);
1212     WOLFSSL_API int wolfSSL_CertManagerEnableCRL(WOLFSSL_CERT_MANAGER*,
1213                                                                    int options);
1214     WOLFSSL_API int wolfSSL_CertManagerDisableCRL(WOLFSSL_CERT_MANAGER*);
1215     WOLFSSL_API int wolfSSL_CertManagerLoadCRL(WOLFSSL_CERT_MANAGER*, const char*,
1216                                                                       int, int);
1217     WOLFSSL_API int wolfSSL_CertManagerSetCRL_Cb(WOLFSSL_CERT_MANAGER*,
1218                                                                   CbMissingCRL);
1219     WOLFSSL_API int wolfSSL_CertManagerCheckOCSP(WOLFSSL_CERT_MANAGER*,
1220                                                         unsigned char*, int sz);
1221     WOLFSSL_API int wolfSSL_CertManagerEnableOCSP(WOLFSSL_CERT_MANAGER*,
1222                                                                    int options);
1223     WOLFSSL_API int wolfSSL_CertManagerDisableOCSP(WOLFSSL_CERT_MANAGER*);
1224     WOLFSSL_API int wolfSSL_CertManagerSetOCSPOverrideURL(WOLFSSL_CERT_MANAGER*,
1225                                                                    const char*);
1226     WOLFSSL_API int wolfSSL_CertManagerSetOCSP_Cb(WOLFSSL_CERT_MANAGER*,
1227                                                CbOCSPIO, CbOCSPRespFree, void*);
1228
1229     WOLFSSL_API int wolfSSL_EnableCRL(WOLFSSL* ssl, int options);
1230     WOLFSSL_API int wolfSSL_DisableCRL(WOLFSSL* ssl);
1231     WOLFSSL_API int wolfSSL_LoadCRL(WOLFSSL*, const char*, int, int);
1232     WOLFSSL_API int wolfSSL_SetCRL_Cb(WOLFSSL*, CbMissingCRL);
1233     WOLFSSL_API int wolfSSL_EnableOCSP(WOLFSSL*, int options);
1234     WOLFSSL_API int wolfSSL_DisableOCSP(WOLFSSL*);
1235     WOLFSSL_API int wolfSSL_SetOCSP_OverrideURL(WOLFSSL*, const char*);
1236     WOLFSSL_API int wolfSSL_SetOCSP_Cb(WOLFSSL*, CbOCSPIO, CbOCSPRespFree, void*);
1237
1238     WOLFSSL_API int wolfSSL_CTX_EnableCRL(WOLFSSL_CTX* ctx, int options);
1239     WOLFSSL_API int wolfSSL_CTX_DisableCRL(WOLFSSL_CTX* ctx);
1240     WOLFSSL_API int wolfSSL_CTX_LoadCRL(WOLFSSL_CTX*, const char*, int, int);
1241     WOLFSSL_API int wolfSSL_CTX_SetCRL_Cb(WOLFSSL_CTX*, CbMissingCRL);
1242     WOLFSSL_API int wolfSSL_CTX_EnableOCSP(WOLFSSL_CTX*, int options);
1243     WOLFSSL_API int wolfSSL_CTX_DisableOCSP(WOLFSSL_CTX*);
1244     WOLFSSL_API int wolfSSL_CTX_SetOCSP_OverrideURL(WOLFSSL_CTX*, const char*);
1245     WOLFSSL_API int wolfSSL_CTX_SetOCSP_Cb(WOLFSSL_CTX*,
1246                                                CbOCSPIO, CbOCSPRespFree, void*);
1247 #endif /* !NO_CERTS */
1248
1249 /* end of handshake frees temporary arrays, if user needs for get_keys or
1250    psk hints, call KeepArrays before handshake and then FreeArrays when done
1251    if don't want to wait for object free */
1252 WOLFSSL_API void wolfSSL_KeepArrays(WOLFSSL*);
1253 WOLFSSL_API void wolfSSL_FreeArrays(WOLFSSL*);
1254
1255
1256 /* cavium additions */
1257 WOLFSSL_API int wolfSSL_UseCavium(WOLFSSL*, int devId);
1258 WOLFSSL_API int wolfSSL_CTX_UseCavium(WOLFSSL_CTX*, int devId);
1259
1260 /* TLS Extensions */
1261
1262 /* Server Name Indication */
1263 #ifdef HAVE_SNI
1264
1265 /* SNI types */
1266 enum {
1267     WOLFSSL_SNI_HOST_NAME = 0
1268 };
1269
1270 WOLFSSL_API int wolfSSL_UseSNI(WOLFSSL* ssl, unsigned char type, const void* data,
1271                                                            unsigned short size);
1272 WOLFSSL_API int wolfSSL_CTX_UseSNI(WOLFSSL_CTX* ctx, unsigned char type,
1273                                          const void* data, unsigned short size);
1274
1275 #ifndef NO_WOLFSSL_SERVER
1276
1277 /* SNI options */
1278 enum {
1279     WOLFSSL_SNI_CONTINUE_ON_MISMATCH = 0x01, /* do not abort on mismatch flag */
1280     WOLFSSL_SNI_ANSWER_ON_MISMATCH   = 0x02  /* fake match on mismatch flag */
1281 };
1282
1283 WOLFSSL_API void wolfSSL_SNI_SetOptions(WOLFSSL* ssl, unsigned char type,
1284                                                          unsigned char options);
1285 WOLFSSL_API void wolfSSL_CTX_SNI_SetOptions(WOLFSSL_CTX* ctx, unsigned char type,
1286                                                          unsigned char options);
1287
1288 /* SNI status */
1289 enum {
1290     WOLFSSL_SNI_NO_MATCH   = 0,
1291     WOLFSSL_SNI_FAKE_MATCH = 1, /* if WOLFSSL_SNI_ANSWER_ON_MISMATCH is enabled */
1292     WOLFSSL_SNI_REAL_MATCH = 2
1293 };
1294
1295 WOLFSSL_API unsigned char wolfSSL_SNI_Status(WOLFSSL* ssl, unsigned char type);
1296
1297 WOLFSSL_API unsigned short wolfSSL_SNI_GetRequest(WOLFSSL *ssl, unsigned char type,
1298                                                                    void** data);
1299 WOLFSSL_API int wolfSSL_SNI_GetFromBuffer(
1300                  const unsigned char* clientHello, unsigned int helloSz,
1301                  unsigned char type, unsigned char* sni, unsigned int* inOutSz);
1302
1303 #endif
1304 #endif
1305
1306 /* Maximum Fragment Length */
1307 #ifdef HAVE_MAX_FRAGMENT
1308
1309 /* Fragment lengths */
1310 enum {
1311     WOLFSSL_MFL_2_9  = 1, /*  512 bytes */
1312     WOLFSSL_MFL_2_10 = 2, /* 1024 bytes */
1313     WOLFSSL_MFL_2_11 = 3, /* 2048 bytes */
1314     WOLFSSL_MFL_2_12 = 4, /* 4096 bytes */
1315     WOLFSSL_MFL_2_13 = 5  /* 8192 bytes *//* wolfSSL ONLY!!! */
1316 };
1317
1318 #ifndef NO_WOLFSSL_CLIENT
1319
1320 WOLFSSL_API int wolfSSL_UseMaxFragment(WOLFSSL* ssl, unsigned char mfl);
1321 WOLFSSL_API int wolfSSL_CTX_UseMaxFragment(WOLFSSL_CTX* ctx, unsigned char mfl);
1322
1323 #endif
1324 #endif
1325
1326 /* Truncated HMAC */
1327 #ifdef HAVE_TRUNCATED_HMAC
1328 #ifndef NO_WOLFSSL_CLIENT
1329
1330 WOLFSSL_API int wolfSSL_UseTruncatedHMAC(WOLFSSL* ssl);
1331 WOLFSSL_API int wolfSSL_CTX_UseTruncatedHMAC(WOLFSSL_CTX* ctx);
1332
1333 #endif
1334 #endif
1335
1336 /* Elliptic Curves */
1337 enum {
1338     WOLFSSL_ECC_SECP160R1 = 0x10,
1339     WOLFSSL_ECC_SECP192R1 = 0x13,
1340     WOLFSSL_ECC_SECP224R1 = 0x15,
1341     WOLFSSL_ECC_SECP256R1 = 0x17,
1342     WOLFSSL_ECC_SECP384R1 = 0x18,
1343     WOLFSSL_ECC_SECP521R1 = 0x19
1344 };
1345
1346 #ifdef HAVE_SUPPORTED_CURVES
1347 #ifndef NO_WOLFSSL_CLIENT
1348
1349 WOLFSSL_API int wolfSSL_UseSupportedCurve(WOLFSSL* ssl, unsigned short name);
1350 WOLFSSL_API int wolfSSL_CTX_UseSupportedCurve(WOLFSSL_CTX* ctx,
1351                                                            unsigned short name);
1352
1353 #endif
1354 #endif
1355
1356 /* Secure Renegotiation */
1357 #ifdef HAVE_SECURE_RENEGOTIATION
1358
1359 WOLFSSL_API int wolfSSL_UseSecureRenegotiation(WOLFSSL* ssl);
1360 WOLFSSL_API int wolfSSL_Rehandshake(WOLFSSL* ssl);
1361
1362 #endif
1363
1364 /* Session Ticket */
1365 #ifdef HAVE_SESSION_TICKET
1366
1367 #ifndef NO_WOLFSSL_CLIENT
1368 WOLFSSL_API int wolfSSL_UseSessionTicket(WOLFSSL* ssl);
1369 WOLFSSL_API int wolfSSL_CTX_UseSessionTicket(WOLFSSL_CTX* ctx);
1370 WOLFSSL_API int wolfSSL_get_SessionTicket(WOLFSSL*, unsigned char*, unsigned int*);
1371 WOLFSSL_API int wolfSSL_set_SessionTicket(WOLFSSL*, unsigned char*, unsigned int);
1372 typedef int (*CallbackSessionTicket)(WOLFSSL*, const unsigned char*, int, void*);
1373 WOLFSSL_API int wolfSSL_set_SessionTicket_cb(WOLFSSL*,
1374                                                   CallbackSessionTicket, void*);
1375 #endif /* NO_WOLFSSL_CLIENT */
1376
1377 #ifndef NO_WOLFSSL_SERVER
1378
1379 #define WOLFSSL_TICKET_NAME_SZ 16
1380 #define WOLFSSL_TICKET_IV_SZ   16
1381 #define WOLFSSL_TICKET_MAC_SZ  32
1382
1383 enum TicketEncRet {
1384     WOLFSSL_TICKET_RET_FATAL  = -1,  /* fatal error, don't use ticket */
1385     WOLFSSL_TICKET_RET_OK     =  0,  /* ok, use ticket */
1386     WOLFSSL_TICKET_RET_REJECT,       /* don't use ticket, but not fatal */
1387     WOLFSSL_TICKET_RET_CREATE        /* existing ticket ok and create new one */
1388 };
1389
1390 typedef int (*SessionTicketEncCb)(WOLFSSL*,
1391                                  unsigned char key_name[WOLFSSL_TICKET_NAME_SZ],
1392                                  unsigned char iv[WOLFSSL_TICKET_IV_SZ],
1393                                  unsigned char mac[WOLFSSL_TICKET_MAC_SZ],
1394                                  int enc, unsigned char*, int, int*, void*);
1395 WOLFSSL_API int wolfSSL_CTX_set_TicketEncCb(WOLFSSL_CTX* ctx,
1396                                             SessionTicketEncCb);
1397 WOLFSSL_API int wolfSSL_CTX_set_TicketHint(WOLFSSL_CTX* ctx, int);
1398 WOLFSSL_API int wolfSSL_CTX_set_TicketEncCtx(WOLFSSL_CTX* ctx, void*);
1399
1400 #endif /* NO_WOLFSSL_SERVER */
1401
1402 #endif /* HAVE_SESSION_TICKET */
1403
1404 #define WOLFSSL_CRL_MONITOR   0x01   /* monitor this dir flag */
1405 #define WOLFSSL_CRL_START_MON 0x02   /* start monitoring flag */
1406
1407
1408 /* notify user the hanshake is done */
1409 typedef int (*HandShakeDoneCb)(WOLFSSL*, void*);
1410 WOLFSSL_API int wolfSSL_SetHsDoneCb(WOLFSSL*, HandShakeDoneCb, void*);
1411
1412
1413 WOLFSSL_API int wolfSSL_PrintSessionStats(void);
1414 WOLFSSL_API int wolfSSL_get_session_stats(unsigned int* active,
1415                                           unsigned int* total,
1416                                           unsigned int* peak,
1417                                           unsigned int* maxSessions);
1418 /* External facing KDF */
1419 WOLFSSL_API
1420 int wolfSSL_MakeTlsMasterSecret(unsigned char* ms, unsigned int msLen,
1421                                const unsigned char* pms, unsigned int pmsLen,
1422                                const unsigned char* cr, const unsigned char* sr,
1423                                int tls1_2, int hash_type);
1424
1425 WOLFSSL_API
1426 int wolfSSL_DeriveTlsKeys(unsigned char* key_data, unsigned int keyLen,
1427                                const unsigned char* ms, unsigned int msLen,
1428                                const unsigned char* sr, const unsigned char* cr,
1429                                int tls1_2, int hash_type);
1430
1431 #ifdef WOLFSSL_CALLBACKS
1432
1433 /* used internally by wolfSSL while OpenSSL types aren't */
1434 #include <wolfssl/callbacks.h>
1435
1436 typedef int (*HandShakeCallBack)(HandShakeInfo*);
1437 typedef int (*TimeoutCallBack)(TimeoutInfo*);
1438
1439 /* wolfSSL connect extension allowing HandShakeCallBack and/or TimeoutCallBack
1440    for diagnostics */
1441 WOLFSSL_API int wolfSSL_connect_ex(WOLFSSL*, HandShakeCallBack, TimeoutCallBack,
1442                                  Timeval);
1443 WOLFSSL_API int wolfSSL_accept_ex(WOLFSSL*, HandShakeCallBack, TimeoutCallBack,
1444                                 Timeval);
1445
1446 #endif /* WOLFSSL_CALLBACKS */
1447
1448
1449 #ifdef WOLFSSL_HAVE_WOLFSCEP
1450     WOLFSSL_API void wolfSSL_wolfSCEP(void);
1451 #endif /* WOLFSSL_HAVE_WOLFSCEP */
1452
1453 #ifdef WOLFSSL_HAVE_CERT_SERVICE
1454     WOLFSSL_API void wolfSSL_cert_service(void);
1455 #endif
1456
1457
1458 #ifdef __cplusplus
1459     }  /* extern "C" */
1460 #endif
1461
1462
1463 #endif /* WOLFSSL_SSL_H */
1464