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

   1 /* ssl.h
   2  *
   3  * Copyright (C) 2006-2014 wolfSSL Inc.
   4  *
   5  * This file is part of CyaSSL.
   6  *
   7  * CyaSSL 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  * CyaSSL 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 /* CyaSSL API */
  24
  25 #ifndef CYASSL_SSL_H
  26 #define CYASSL_SSL_H
  27
  28
  29 /* for users not using preprocessor flags*/
  30 #include <cyassl/ctaocrypt/settings.h>
  31 #include <cyassl/version.h>
  32
  33
  34 #ifndef NO_FILESYSTEM
  35     #ifdef FREESCALE_MQX
  36         #include <fio.h>
  37     #else
  38         #include <stdio.h>   /* ERR_printf */
  39     #endif
  40 #endif
  41
  42 #ifdef YASSL_PREFIX
  43     #include "prefix_ssl.h"
  44 #endif
  45
  46 #ifdef LIBCYASSL_VERSION_STRING
  47     #define CYASSL_VERSION LIBCYASSL_VERSION_STRING
  48 #endif
  49
  50 #ifdef _WIN32
  51     /* wincrypt.h clashes */
  52     #undef OCSP_REQUEST
  53     #undef OCSP_RESPONSE
  54 #endif
  55
  56
  57
  58 #ifdef __cplusplus
  59     extern "C" {
  60 #endif
  61
  62 typedef struct CYASSL          CYASSL;
  63 typedef struct CYASSL_SESSION  CYASSL_SESSION;
  64 typedef struct CYASSL_METHOD   CYASSL_METHOD;
  65 typedef struct CYASSL_CTX      CYASSL_CTX;
  66
  67 typedef struct CYASSL_X509       CYASSL_X509;
  68 typedef struct CYASSL_X509_NAME  CYASSL_X509_NAME;
  69 typedef struct CYASSL_X509_CHAIN CYASSL_X509_CHAIN;
  70
  71 typedef struct CYASSL_CERT_MANAGER CYASSL_CERT_MANAGER;
  72 typedef struct CYASSL_SOCKADDR     CYASSL_SOCKADDR;
  73
  74 /* redeclare guard */
  75 #define CYASSL_TYPES_DEFINED
  76
  77
  78 typedef struct CYASSL_RSA            CYASSL_RSA;
  79 typedef struct CYASSL_DSA            CYASSL_DSA;
  80 typedef struct CYASSL_CIPHER         CYASSL_CIPHER;
  81 typedef struct CYASSL_X509_LOOKUP    CYASSL_X509_LOOKUP;
  82 typedef struct CYASSL_X509_LOOKUP_METHOD CYASSL_X509_LOOKUP_METHOD;
  83 typedef struct CYASSL_X509_CRL       CYASSL_X509_CRL;
  84 typedef struct CYASSL_BIO            CYASSL_BIO;
  85 typedef struct CYASSL_BIO_METHOD     CYASSL_BIO_METHOD;
  86 typedef struct CYASSL_X509_EXTENSION CYASSL_X509_EXTENSION;
  87 typedef struct CYASSL_ASN1_TIME      CYASSL_ASN1_TIME;
  88 typedef struct CYASSL_ASN1_INTEGER   CYASSL_ASN1_INTEGER;
  89 typedef struct CYASSL_ASN1_OBJECT    CYASSL_ASN1_OBJECT;
  90 typedef struct CYASSL_ASN1_STRING    CYASSL_ASN1_STRING;
  91 typedef struct CYASSL_dynlock_value  CYASSL_dynlock_value;
  92
  93 #define CYASSL_ASN1_UTCTIME CYASSL_ASN1_TIME
  94
  95 typedef struct CYASSL_EVP_PKEY {
  96     int type;         /* openssh dereference */
  97     int save_type;    /* openssh dereference */
  98     int pkey_sz;
  99     union {
 100         char* ptr;
 101     } pkey;
 102     #ifdef HAVE_ECC
 103         int pkey_curve;
 104     #endif
 105 } CYASSL_EVP_PKEY;
 106
 107 typedef struct CYASSL_MD4_CTX {
 108     int buffer[32];      /* big enough to hold, check size in Init */
 109 } CYASSL_MD4_CTX;
 110
 111
 112 typedef struct CYASSL_COMP_METHOD {
 113     int type;            /* stunnel dereference */
 114 } CYASSL_COMP_METHOD;
 115
 116
 117 typedef struct CYASSL_X509_STORE {
 118     int                  cache;          /* stunnel dereference */
 119     CYASSL_CERT_MANAGER* cm;
 120 } CYASSL_X509_STORE;
 121
 122 typedef struct CYASSL_ALERT {
 123     int code;
 124     int level;
 125 } CYASSL_ALERT;
 126
 127 typedef struct CYASSL_ALERT_HISTORY {
 128     CYASSL_ALERT last_rx;
 129     CYASSL_ALERT last_tx;
 130 } CYASSL_ALERT_HISTORY;
 131
 132 typedef struct CYASSL_X509_REVOKED {
 133     CYASSL_ASN1_INTEGER* serialNumber;          /* stunnel dereference */
 134 } CYASSL_X509_REVOKED;
 135
 136
 137 typedef struct CYASSL_X509_OBJECT {
 138     union {
 139         char* ptr;
 140         CYASSL_X509_CRL* crl;           /* stunnel dereference */
 141     } data;
 142 } CYASSL_X509_OBJECT;
 143
 144
 145 typedef struct CYASSL_X509_STORE_CTX {
 146     CYASSL_X509_STORE* store;    /* Store full of a CA cert chain */
 147     CYASSL_X509* current_cert;   /* stunnel dereference */
 148     char* domain;                /* subject CN domain name */
 149     void* ex_data;               /* external data, for fortress build */
 150     void* userCtx;               /* user ctx */
 151     int   error;                 /* current error */
 152     int   error_depth;           /* cert depth for this error */
 153     int   discardSessionCerts;   /* so verify callback can flag for discard */
 154 } CYASSL_X509_STORE_CTX;
 155
 156
 157 /* Valid Alert types from page 16/17 */
 158 enum AlertDescription {
 159     close_notify            = 0,
 160     unexpected_message      = 10,
 161     bad_record_mac          = 20,
 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     protocol_version        = 70,
 173     no_renegotiation        = 100,
 174     unrecognized_name       = 112
 175 };
 176
 177
 178 enum AlertLevel {
 179     alert_warning = 1,
 180     alert_fatal = 2
 181 };
 182
 183
 184 CYASSL_API CYASSL_METHOD *CyaSSLv3_server_method(void);
 185 CYASSL_API CYASSL_METHOD *CyaSSLv3_client_method(void);
 186 CYASSL_API CYASSL_METHOD *CyaTLSv1_server_method(void);
 187 CYASSL_API CYASSL_METHOD *CyaTLSv1_client_method(void);
 188 CYASSL_API CYASSL_METHOD *CyaTLSv1_1_server_method(void);
 189 CYASSL_API CYASSL_METHOD *CyaTLSv1_1_client_method(void);
 190 CYASSL_API CYASSL_METHOD *CyaTLSv1_2_server_method(void);
 191 CYASSL_API CYASSL_METHOD *CyaTLSv1_2_client_method(void);
 192
 193 #ifdef CYASSL_DTLS
 194     CYASSL_API CYASSL_METHOD *CyaDTLSv1_client_method(void);
 195     CYASSL_API CYASSL_METHOD *CyaDTLSv1_server_method(void);
 196     CYASSL_API CYASSL_METHOD *CyaDTLSv1_2_client_method(void);
 197     CYASSL_API CYASSL_METHOD *CyaDTLSv1_2_server_method(void);
 198 #endif
 199
 200 #if !defined(NO_FILESYSTEM) && !defined(NO_CERTS)
 201
 202 CYASSL_API int CyaSSL_CTX_use_certificate_file(CYASSL_CTX*, const char*, int);
 203 CYASSL_API int CyaSSL_CTX_use_PrivateKey_file(CYASSL_CTX*, const char*, int);
 204 CYASSL_API int CyaSSL_CTX_load_verify_locations(CYASSL_CTX*, const char*,
 205                                                 const char*);
 206 CYASSL_API int CyaSSL_CTX_use_certificate_chain_file(CYASSL_CTX *,
 207                                                      const char *file);
 208 CYASSL_API int CyaSSL_CTX_use_RSAPrivateKey_file(CYASSL_CTX*, const char*, int);
 209
 210 CYASSL_API int CyaSSL_use_certificate_file(CYASSL*, const char*, int);
 211 CYASSL_API int CyaSSL_use_PrivateKey_file(CYASSL*, const char*, int);
 212 CYASSL_API int CyaSSL_use_certificate_chain_file(CYASSL*, const char *file);
 213 CYASSL_API int CyaSSL_use_RSAPrivateKey_file(CYASSL*, const char*, int);
 214
 215 #ifdef CYASSL_DER_LOAD
 216     CYASSL_API int CyaSSL_CTX_der_load_verify_locations(CYASSL_CTX*,
 217                                                     const char*, int);
 218 #endif
 219
 220 #ifdef HAVE_NTRU
 221     CYASSL_API int CyaSSL_CTX_use_NTRUPrivateKey_file(CYASSL_CTX*, const char*);
 222     /* load NTRU private key blob */
 223 #endif
 224
 225 CYASSL_API int CyaSSL_PemCertToDer(const char*, unsigned char*, int);
 226
 227 #endif /* !NO_FILESYSTEM && !NO_CERTS */
 228
 229 CYASSL_API CYASSL_CTX* CyaSSL_CTX_new(CYASSL_METHOD*);
 230 CYASSL_API CYASSL* CyaSSL_new(CYASSL_CTX*);
 231 CYASSL_API int  CyaSSL_set_fd (CYASSL*, int);
 232 CYASSL_API int  CyaSSL_get_fd(const CYASSL*);
 233 CYASSL_API void CyaSSL_set_using_nonblock(CYASSL*, int);
 234 CYASSL_API int  CyaSSL_get_using_nonblock(CYASSL*);
 235 CYASSL_API int  CyaSSL_connect(CYASSL*);     /* please see note at top of README
 236                                              if you get an error from connect */
 237 CYASSL_API int  CyaSSL_write(CYASSL*, const void*, int);
 238 CYASSL_API int  CyaSSL_read(CYASSL*, void*, int);
 239 CYASSL_API int  CyaSSL_peek(CYASSL*, void*, int);
 240 CYASSL_API int  CyaSSL_accept(CYASSL*);
 241 CYASSL_API void CyaSSL_CTX_free(CYASSL_CTX*);
 242 CYASSL_API void CyaSSL_free(CYASSL*);
 243 CYASSL_API int  CyaSSL_shutdown(CYASSL*);
 244 CYASSL_API int  CyaSSL_send(CYASSL*, const void*, int sz, int flags);
 245 CYASSL_API int  CyaSSL_recv(CYASSL*, void*, int sz, int flags);
 246
 247 CYASSL_API void CyaSSL_CTX_set_quiet_shutdown(CYASSL_CTX*, int);
 248 CYASSL_API void CyaSSL_set_quiet_shutdown(CYASSL*, int);
 249
 250 CYASSL_API int  CyaSSL_get_error(CYASSL*, int);
 251 CYASSL_API int  CyaSSL_get_alert_history(CYASSL*, CYASSL_ALERT_HISTORY *);
 252
 253 CYASSL_API int        CyaSSL_set_session(CYASSL* ssl,CYASSL_SESSION* session);
 254 CYASSL_API CYASSL_SESSION* CyaSSL_get_session(CYASSL* ssl);
 255 CYASSL_API void       CyaSSL_flush_sessions(CYASSL_CTX *ctx, long tm);
 256 CYASSL_API int        CyaSSL_SetServerID(CYASSL* ssl, const unsigned char*,
 257                                          int, int);
 258
 259 #ifdef SESSION_INDEX
 260 CYASSL_API int CyaSSL_GetSessionIndex(CYASSL* ssl);
 261 CYASSL_API int CyaSSL_GetSessionAtIndex(int index, CYASSL_SESSION* session);
 262 #endif /* SESSION_INDEX */
 263
 264 #if defined(SESSION_INDEX) && defined(SESSION_CERTS)
 265 CYASSL_API
 266     CYASSL_X509_CHAIN* CyaSSL_SESSION_get_peer_chain(CYASSL_SESSION* session);
 267 #endif /* SESSION_INDEX && SESSION_CERTS */
 268
 269 typedef int (*VerifyCallback)(int, CYASSL_X509_STORE_CTX*);
 270 typedef int (*pem_password_cb)(char*, int, int, void*);
 271
 272 CYASSL_API void CyaSSL_CTX_set_verify(CYASSL_CTX*, int,
 273                                       VerifyCallback verify_callback);
 274 CYASSL_API void CyaSSL_set_verify(CYASSL*, int, VerifyCallback verify_callback);
 275 CYASSL_API void CyaSSL_SetCertCbCtx(CYASSL*, void*);
 276
 277 CYASSL_API int  CyaSSL_pending(CYASSL*);
 278
 279 CYASSL_API void CyaSSL_load_error_strings(void);
 280 CYASSL_API int  CyaSSL_library_init(void);
 281 CYASSL_API long CyaSSL_CTX_set_session_cache_mode(CYASSL_CTX*, long);
 282
 283 /* session cache persistence */
 284 CYASSL_API int  CyaSSL_save_session_cache(const char*);
 285 CYASSL_API int  CyaSSL_restore_session_cache(const char*);
 286 CYASSL_API int  CyaSSL_memsave_session_cache(void*, int);
 287 CYASSL_API int  CyaSSL_memrestore_session_cache(const void*, int);
 288 CYASSL_API int  CyaSSL_get_session_cache_memsize(void);
 289
 290 /* certificate cache persistence, uses ctx since certs are per ctx */
 291 CYASSL_API int  CyaSSL_CTX_save_cert_cache(CYASSL_CTX*, const char*);
 292 CYASSL_API int  CyaSSL_CTX_restore_cert_cache(CYASSL_CTX*, const char*);
 293 CYASSL_API int  CyaSSL_CTX_memsave_cert_cache(CYASSL_CTX*, void*, int, int*);
 294 CYASSL_API int  CyaSSL_CTX_memrestore_cert_cache(CYASSL_CTX*, const void*, int);
 295 CYASSL_API int  CyaSSL_CTX_get_cert_cache_memsize(CYASSL_CTX*);
 296
 297 /* only supports full name from cipher_name[] delimited by : */
 298 CYASSL_API int  CyaSSL_CTX_set_cipher_list(CYASSL_CTX*, const char*);
 299 CYASSL_API int  CyaSSL_set_cipher_list(CYASSL*, const char*);
 300
 301 /* Nonblocking DTLS helper functions */
 302 CYASSL_API int  CyaSSL_dtls_get_current_timeout(CYASSL* ssl);
 303 CYASSL_API int  CyaSSL_dtls_set_timeout_init(CYASSL* ssl, int);
 304 CYASSL_API int  CyaSSL_dtls_set_timeout_max(CYASSL* ssl, int);
 305 CYASSL_API int  CyaSSL_dtls_got_timeout(CYASSL* ssl);
 306 CYASSL_API int  CyaSSL_dtls(CYASSL* ssl);
 307
 308 CYASSL_API int  CyaSSL_dtls_set_peer(CYASSL*, void*, unsigned int);
 309 CYASSL_API int  CyaSSL_dtls_get_peer(CYASSL*, void*, unsigned int*);
 310
 311 CYASSL_API int   CyaSSL_ERR_GET_REASON(int err);
 312 CYASSL_API char* CyaSSL_ERR_error_string(unsigned long,char*);
 313 CYASSL_API void  CyaSSL_ERR_error_string_n(unsigned long e, char* buf,
 314                                            unsigned long sz);
 315 CYASSL_API const char* CyaSSL_ERR_reason_error_string(unsigned long);
 316
 317 /* extras */
 318
 319 #define STACK_OF(x) x
 320
 321 CYASSL_API int  CyaSSL_set_ex_data(CYASSL*, int, void*);
 322 CYASSL_API int  CyaSSL_get_shutdown(const CYASSL*);
 323 CYASSL_API int  CyaSSL_set_rfd(CYASSL*, int);
 324 CYASSL_API int  CyaSSL_set_wfd(CYASSL*, int);
 325 CYASSL_API void CyaSSL_set_shutdown(CYASSL*, int);
 326 CYASSL_API int  CyaSSL_set_session_id_context(CYASSL*, const unsigned char*,
 327                                            unsigned int);
 328 CYASSL_API void CyaSSL_set_connect_state(CYASSL*);
 329 CYASSL_API void CyaSSL_set_accept_state(CYASSL*);
 330 CYASSL_API int  CyaSSL_session_reused(CYASSL*);
 331 CYASSL_API void CyaSSL_SESSION_free(CYASSL_SESSION* session);
 332 CYASSL_API int  CyaSSL_is_init_finished(CYASSL*);
 333
 334 CYASSL_API const char*  CyaSSL_get_version(CYASSL*);
 335 CYASSL_API int  CyaSSL_get_current_cipher_suite(CYASSL* ssl);
 336 CYASSL_API CYASSL_CIPHER*  CyaSSL_get_current_cipher(CYASSL*);
 337 CYASSL_API char*        CyaSSL_CIPHER_description(CYASSL_CIPHER*, char*, int);
 338 CYASSL_API const char*  CyaSSL_CIPHER_get_name(const CYASSL_CIPHER* cipher);
 339 CYASSL_API const char*  CyaSSL_get_cipher(CYASSL*);
 340 CYASSL_API CYASSL_SESSION* CyaSSL_get1_session(CYASSL* ssl);
 341                            /* what's ref count */
 342
 343 CYASSL_API void CyaSSL_X509_free(CYASSL_X509*);
 344 CYASSL_API void CyaSSL_OPENSSL_free(void*);
 345
 346 CYASSL_API int CyaSSL_OCSP_parse_url(char* url, char** host, char** port,
 347                                      char** path, int* ssl);
 348
 349 CYASSL_API CYASSL_METHOD* CyaSSLv23_client_method(void);
 350 CYASSL_API CYASSL_METHOD* CyaSSLv2_client_method(void);
 351 CYASSL_API CYASSL_METHOD* CyaSSLv2_server_method(void);
 352
 353 CYASSL_API void CyaSSL_MD4_Init(CYASSL_MD4_CTX*);
 354 CYASSL_API void CyaSSL_MD4_Update(CYASSL_MD4_CTX*, const void*, unsigned long);
 355 CYASSL_API void CyaSSL_MD4_Final(unsigned char*, CYASSL_MD4_CTX*);
 356
 357
 358 CYASSL_API CYASSL_BIO* CyaSSL_BIO_new(CYASSL_BIO_METHOD*);
 359 CYASSL_API int  CyaSSL_BIO_free(CYASSL_BIO*);
 360 CYASSL_API int  CyaSSL_BIO_free_all(CYASSL_BIO*);
 361 CYASSL_API int  CyaSSL_BIO_read(CYASSL_BIO*, void*, int);
 362 CYASSL_API int  CyaSSL_BIO_write(CYASSL_BIO*, const void*, int);
 363 CYASSL_API CYASSL_BIO* CyaSSL_BIO_push(CYASSL_BIO*, CYASSL_BIO* append);
 364 CYASSL_API CYASSL_BIO* CyaSSL_BIO_pop(CYASSL_BIO*);
 365 CYASSL_API int  CyaSSL_BIO_flush(CYASSL_BIO*);
 366 CYASSL_API int  CyaSSL_BIO_pending(CYASSL_BIO*);
 367
 368 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_f_buffer(void);
 369 CYASSL_API long CyaSSL_BIO_set_write_buffer_size(CYASSL_BIO*, long size);
 370 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_f_ssl(void);
 371 CYASSL_API CYASSL_BIO*        CyaSSL_BIO_new_socket(int sfd, int flag);
 372 CYASSL_API int         CyaSSL_BIO_eof(CYASSL_BIO*);
 373
 374 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_s_mem(void);
 375 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_f_base64(void);
 376 CYASSL_API void CyaSSL_BIO_set_flags(CYASSL_BIO*, int);
 377
 378 CYASSL_API int CyaSSL_BIO_get_mem_data(CYASSL_BIO* bio,const unsigned char** p);
 379 CYASSL_API CYASSL_BIO* CyaSSL_BIO_new_mem_buf(void* buf, int len);
 380
 381
 382 CYASSL_API long        CyaSSL_BIO_set_ssl(CYASSL_BIO*, CYASSL*, int flag);
 383 CYASSL_API void        CyaSSL_set_bio(CYASSL*, CYASSL_BIO* rd, CYASSL_BIO* wr);
 384
 385 CYASSL_API int  CyaSSL_add_all_algorithms(void);
 386
 387 CYASSL_API void        CyaSSL_RAND_screen(void);
 388 CYASSL_API const char* CyaSSL_RAND_file_name(char*, unsigned long);
 389 CYASSL_API int         CyaSSL_RAND_write_file(const char*);
 390 CYASSL_API int         CyaSSL_RAND_load_file(const char*, long);
 391 CYASSL_API int         CyaSSL_RAND_egd(const char*);
 392 CYASSL_API int         CyaSSL_RAND_seed(const void*, int);
 393 CYASSL_API void        CyaSSL_RAND_add(const void*, int, double);
 394
 395 CYASSL_API CYASSL_COMP_METHOD* CyaSSL_COMP_zlib(void);
 396 CYASSL_API CYASSL_COMP_METHOD* CyaSSL_COMP_rle(void);
 397 CYASSL_API int CyaSSL_COMP_add_compression_method(int, void*);
 398
 399 CYASSL_API int CyaSSL_get_ex_new_index(long, void*, void*, void*, void*);
 400
 401 CYASSL_API void CyaSSL_set_id_callback(unsigned long (*f)(void));
 402 CYASSL_API void CyaSSL_set_locking_callback(void (*f)(int, int, const char*,
 403                                                       int));
 404 CYASSL_API void CyaSSL_set_dynlock_create_callback(CYASSL_dynlock_value* (*f)
 405                                                    (const char*, int));
 406 CYASSL_API void CyaSSL_set_dynlock_lock_callback(void (*f)(int,
 407                                       CYASSL_dynlock_value*, const char*, int));
 408 CYASSL_API void CyaSSL_set_dynlock_destroy_callback(void (*f)
 409                                      (CYASSL_dynlock_value*, const char*, int));
 410 CYASSL_API int  CyaSSL_num_locks(void);
 411
 412 CYASSL_API CYASSL_X509* CyaSSL_X509_STORE_CTX_get_current_cert(
 413                                                         CYASSL_X509_STORE_CTX*);
 414 CYASSL_API int   CyaSSL_X509_STORE_CTX_get_error(CYASSL_X509_STORE_CTX*);
 415 CYASSL_API int   CyaSSL_X509_STORE_CTX_get_error_depth(CYASSL_X509_STORE_CTX*);
 416
 417 CYASSL_API char*       CyaSSL_X509_NAME_oneline(CYASSL_X509_NAME*, char*, int);
 418 CYASSL_API CYASSL_X509_NAME*  CyaSSL_X509_get_issuer_name(CYASSL_X509*);
 419 CYASSL_API CYASSL_X509_NAME*  CyaSSL_X509_get_subject_name(CYASSL_X509*);
 420 CYASSL_API int  CyaSSL_X509_ext_isSet_by_NID(CYASSL_X509*, int);
 421 CYASSL_API int  CyaSSL_X509_ext_get_critical_by_NID(CYASSL_X509*, int);
 422 CYASSL_API int  CyaSSL_X509_get_isCA(CYASSL_X509*);
 423 CYASSL_API int  CyaSSL_X509_get_isSet_pathLength(CYASSL_X509*);
 424 CYASSL_API unsigned int CyaSSL_X509_get_pathLength(CYASSL_X509*);
 425 CYASSL_API unsigned int CyaSSL_X509_get_keyUsage(CYASSL_X509*);
 426 CYASSL_API unsigned char* CyaSSL_X509_get_authorityKeyID(
 427                                             CYASSL_X509*, unsigned char*, int*);
 428 CYASSL_API unsigned char* CyaSSL_X509_get_subjectKeyID(
 429                                             CYASSL_X509*, unsigned char*, int*);
 430 CYASSL_API int CyaSSL_X509_NAME_entry_count(CYASSL_X509_NAME*);
 431 CYASSL_API int CyaSSL_X509_NAME_get_text_by_NID(
 432                                             CYASSL_X509_NAME*, int, char*, int);
 433 CYASSL_API int         CyaSSL_X509_verify_cert(CYASSL_X509_STORE_CTX*);
 434 CYASSL_API const char* CyaSSL_X509_verify_cert_error_string(long);
 435 CYASSL_API int CyaSSL_X509_get_signature_type(CYASSL_X509*);
 436 CYASSL_API int CyaSSL_X509_get_signature(CYASSL_X509*, unsigned char*, int*);
 437
 438 CYASSL_API int CyaSSL_X509_LOOKUP_add_dir(CYASSL_X509_LOOKUP*,const char*,long);
 439 CYASSL_API int CyaSSL_X509_LOOKUP_load_file(CYASSL_X509_LOOKUP*, const char*,
 440                                             long);
 441 CYASSL_API CYASSL_X509_LOOKUP_METHOD* CyaSSL_X509_LOOKUP_hash_dir(void);
 442 CYASSL_API CYASSL_X509_LOOKUP_METHOD* CyaSSL_X509_LOOKUP_file(void);
 443
 444 CYASSL_API CYASSL_X509_LOOKUP* CyaSSL_X509_STORE_add_lookup(CYASSL_X509_STORE*,
 445                                                     CYASSL_X509_LOOKUP_METHOD*);
 446 CYASSL_API CYASSL_X509_STORE*  CyaSSL_X509_STORE_new(void);
 447 CYASSL_API void         CyaSSL_X509_STORE_free(CYASSL_X509_STORE*);
 448 CYASSL_API int          CyaSSL_X509_STORE_add_cert(
 449                                               CYASSL_X509_STORE*, CYASSL_X509*);
 450 CYASSL_API int          CyaSSL_X509_STORE_set_default_paths(CYASSL_X509_STORE*);
 451 CYASSL_API int          CyaSSL_X509_STORE_get_by_subject(CYASSL_X509_STORE_CTX*,
 452                                    int, CYASSL_X509_NAME*, CYASSL_X509_OBJECT*);
 453 CYASSL_API CYASSL_X509_STORE_CTX* CyaSSL_X509_STORE_CTX_new(void);
 454 CYASSL_API int  CyaSSL_X509_STORE_CTX_init(CYASSL_X509_STORE_CTX*,
 455                       CYASSL_X509_STORE*, CYASSL_X509*, STACK_OF(CYASSL_X509)*);
 456 CYASSL_API void CyaSSL_X509_STORE_CTX_free(CYASSL_X509_STORE_CTX*);
 457 CYASSL_API void CyaSSL_X509_STORE_CTX_cleanup(CYASSL_X509_STORE_CTX*);
 458
 459 CYASSL_API CYASSL_ASN1_TIME* CyaSSL_X509_CRL_get_lastUpdate(CYASSL_X509_CRL*);
 460 CYASSL_API CYASSL_ASN1_TIME* CyaSSL_X509_CRL_get_nextUpdate(CYASSL_X509_CRL*);
 461
 462 CYASSL_API CYASSL_EVP_PKEY* CyaSSL_X509_get_pubkey(CYASSL_X509*);
 463 CYASSL_API int       CyaSSL_X509_CRL_verify(CYASSL_X509_CRL*, CYASSL_EVP_PKEY*);
 464 CYASSL_API void      CyaSSL_X509_STORE_CTX_set_error(CYASSL_X509_STORE_CTX*,
 465                                                      int);
 466 CYASSL_API void      CyaSSL_X509_OBJECT_free_contents(CYASSL_X509_OBJECT*);
 467 CYASSL_API void      CyaSSL_EVP_PKEY_free(CYASSL_EVP_PKEY*);
 468 CYASSL_API int       CyaSSL_X509_cmp_current_time(const CYASSL_ASN1_TIME*);
 469 CYASSL_API int       CyaSSL_sk_X509_REVOKED_num(CYASSL_X509_REVOKED*);
 470
 471 CYASSL_API CYASSL_X509_REVOKED* CyaSSL_X509_CRL_get_REVOKED(CYASSL_X509_CRL*);
 472 CYASSL_API CYASSL_X509_REVOKED* CyaSSL_sk_X509_REVOKED_value(
 473                                                       CYASSL_X509_REVOKED*,int);
 474 CYASSL_API CYASSL_ASN1_INTEGER* CyaSSL_X509_get_serialNumber(CYASSL_X509*);
 475
 476 CYASSL_API int CyaSSL_ASN1_TIME_print(CYASSL_BIO*, const CYASSL_ASN1_TIME*);
 477
 478 CYASSL_API int  CyaSSL_ASN1_INTEGER_cmp(const CYASSL_ASN1_INTEGER*,
 479                                        const CYASSL_ASN1_INTEGER*);
 480 CYASSL_API long CyaSSL_ASN1_INTEGER_get(const CYASSL_ASN1_INTEGER*);
 481
 482 CYASSL_API STACK_OF(CYASSL_X509_NAME)* CyaSSL_load_client_CA_file(const char*);
 483
 484 CYASSL_API void  CyaSSL_CTX_set_client_CA_list(CYASSL_CTX*,
 485                                                STACK_OF(CYASSL_X509_NAME)*);
 486 CYASSL_API void* CyaSSL_X509_STORE_CTX_get_ex_data(CYASSL_X509_STORE_CTX*, int);
 487 CYASSL_API int   CyaSSL_get_ex_data_X509_STORE_CTX_idx(void);
 488 CYASSL_API void* CyaSSL_get_ex_data(const CYASSL*, int);
 489
 490 CYASSL_API void CyaSSL_CTX_set_default_passwd_cb_userdata(CYASSL_CTX*,
 491                                                           void* userdata);
 492 CYASSL_API void CyaSSL_CTX_set_default_passwd_cb(CYASSL_CTX*, pem_password_cb);
 493
 494
 495 CYASSL_API void CyaSSL_CTX_set_info_callback(CYASSL_CTX*, void (*)(void));
 496
 497 CYASSL_API unsigned long CyaSSL_ERR_peek_error(void);
 498 CYASSL_API int           CyaSSL_GET_REASON(int);
 499
 500 CYASSL_API char* CyaSSL_alert_type_string_long(int);
 501 CYASSL_API char* CyaSSL_alert_desc_string_long(int);
 502 CYASSL_API char* CyaSSL_state_string_long(CYASSL*);
 503
 504 CYASSL_API CYASSL_RSA* CyaSSL_RSA_generate_key(int, unsigned long,
 505                                                void(*)(int, int, void*), void*);
 506 CYASSL_API void CyaSSL_CTX_set_tmp_rsa_callback(CYASSL_CTX*,
 507                                              CYASSL_RSA*(*)(CYASSL*, int, int));
 508
 509 CYASSL_API int CyaSSL_PEM_def_callback(char*, int num, int w, void* key);
 510
 511 CYASSL_API long CyaSSL_CTX_sess_accept(CYASSL_CTX*);
 512 CYASSL_API long CyaSSL_CTX_sess_connect(CYASSL_CTX*);
 513 CYASSL_API long CyaSSL_CTX_sess_accept_good(CYASSL_CTX*);
 514 CYASSL_API long CyaSSL_CTX_sess_connect_good(CYASSL_CTX*);
 515 CYASSL_API long CyaSSL_CTX_sess_accept_renegotiate(CYASSL_CTX*);
 516 CYASSL_API long CyaSSL_CTX_sess_connect_renegotiate(CYASSL_CTX*);
 517 CYASSL_API long CyaSSL_CTX_sess_hits(CYASSL_CTX*);
 518 CYASSL_API long CyaSSL_CTX_sess_cb_hits(CYASSL_CTX*);
 519 CYASSL_API long CyaSSL_CTX_sess_cache_full(CYASSL_CTX*);
 520 CYASSL_API long CyaSSL_CTX_sess_misses(CYASSL_CTX*);
 521 CYASSL_API long CyaSSL_CTX_sess_timeouts(CYASSL_CTX*);
 522 CYASSL_API long CyaSSL_CTX_sess_number(CYASSL_CTX*);
 523 CYASSL_API long CyaSSL_CTX_sess_get_cache_size(CYASSL_CTX*);
 524
 525 #define CYASSL_DEFAULT_CIPHER_LIST ""   /* default all */
 526 #define CYASSL_RSA_F4 0x10001L
 527
 528 enum {
 529     OCSP_NOCERTS     = 1,
 530     OCSP_NOINTERN    = 2,
 531     OCSP_NOSIGS      = 4,
 532     OCSP_NOCHAIN     = 8,
 533     OCSP_NOVERIFY    = 16,
 534     OCSP_NOEXPLICIT  = 32,
 535     OCSP_NOCASIGN    = 64,
 536     OCSP_NODELEGATED = 128,
 537     OCSP_NOCHECKS    = 256,
 538     OCSP_TRUSTOTHER  = 512,
 539     OCSP_RESPID_KEY  = 1024,
 540     OCSP_NOTIME      = 2048,
 541
 542     OCSP_CERTID   = 2,
 543     OCSP_REQUEST  = 4,
 544     OCSP_RESPONSE = 8,
 545     OCSP_BASICRESP = 16,
 546
 547     CYASSL_OCSP_URL_OVERRIDE = 1,
 548     CYASSL_OCSP_NO_NONCE     = 2,
 549
 550     CYASSL_CRL_CHECKALL = 1,
 551
 552     ASN1_GENERALIZEDTIME = 4,
 553
 554     SSL_OP_MICROSOFT_SESS_ID_BUG = 1,
 555     SSL_OP_NETSCAPE_CHALLENGE_BUG = 2,
 556     SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG = 3,
 557     SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG = 4,
 558     SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER = 5,
 559     SSL_OP_MSIE_SSLV2_RSA_PADDING = 6,
 560     SSL_OP_SSLEAY_080_CLIENT_DH_BUG = 7,
 561     SSL_OP_TLS_D5_BUG = 8,
 562     SSL_OP_TLS_BLOCK_PADDING_BUG = 9,
 563     SSL_OP_TLS_ROLLBACK_BUG = 10,
 564     SSL_OP_ALL = 11,
 565     SSL_OP_EPHEMERAL_RSA = 12,
 566     SSL_OP_NO_SSLv3 = 13,
 567     SSL_OP_NO_TLSv1 = 14,
 568     SSL_OP_PKCS1_CHECK_1 = 15,
 569     SSL_OP_PKCS1_CHECK_2 = 16,
 570     SSL_OP_NETSCAPE_CA_DN_BUG = 17,
 571     SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG = 18,
 572     SSL_OP_SINGLE_DH_USE = 19,
 573     SSL_OP_NO_TICKET = 20,
 574     SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS = 21,
 575     SSL_OP_NO_QUERY_MTU = 22,
 576     SSL_OP_COOKIE_EXCHANGE = 23,
 577     SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION = 24,
 578     SSL_OP_SINGLE_ECDH_USE = 25,
 579     SSL_OP_CIPHER_SERVER_PREFERENCE = 26,
 580
 581     SSL_MAX_SSL_SESSION_ID_LENGTH = 32,
 582
 583     EVP_R_BAD_DECRYPT = 2,
 584
 585     SSL_CB_LOOP = 4,
 586     SSL_ST_CONNECT = 5,
 587     SSL_ST_ACCEPT  = 6,
 588     SSL_CB_ALERT   = 7,
 589     SSL_CB_READ    = 8,
 590     SSL_CB_HANDSHAKE_DONE = 9,
 591
 592     SSL_MODE_ENABLE_PARTIAL_WRITE = 2,
 593
 594     BIO_FLAGS_BASE64_NO_NL = 1,
 595     BIO_CLOSE   = 1,
 596     BIO_NOCLOSE = 0,
 597
 598     NID_undef = 0,
 599
 600     X509_FILETYPE_PEM = 8,
 601     X509_LU_X509      = 9,
 602     X509_LU_CRL       = 12,
 603
 604     X509_V_ERR_CRL_SIGNATURE_FAILURE = 13,
 605     X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD = 14,
 606     X509_V_ERR_CRL_HAS_EXPIRED                = 15,
 607     X509_V_ERR_CERT_REVOKED                   = 16,
 608     X509_V_ERR_CERT_CHAIN_TOO_LONG            = 17,
 609     X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT      = 18,
 610     X509_V_ERR_CERT_NOT_YET_VALID             = 19,
 611     X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD = 20,
 612     X509_V_ERR_CERT_HAS_EXPIRED               = 21,
 613     X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD  = 22,
 614
 615     X509_V_OK = 0,
 616
 617     CRYPTO_LOCK = 1,
 618     CRYPTO_NUM_LOCKS = 10
 619 };
 620
 621 /* extras end */
 622
 623 #if !defined(NO_FILESYSTEM) && !defined(NO_STDIO_FILESYSTEM)
 624 /* CyaSSL extension, provide last error from SSL_get_error
 625    since not using thread storage error queue */
 626 CYASSL_API void  CyaSSL_ERR_print_errors_fp(FILE*, int err);
 627 #endif
 628
 629 enum { /* ssl Constants */
 630     SSL_ERROR_NONE      =  0,   /* for most functions */
 631     SSL_FAILURE         =  0,   /* for some functions */
 632     SSL_SUCCESS         =  1,
 633
 634     SSL_BAD_CERTTYPE    = -8,
 635     SSL_BAD_STAT        = -7,
 636     SSL_BAD_PATH        = -6,
 637     SSL_BAD_FILETYPE    = -5,
 638     SSL_BAD_FILE        = -4,
 639     SSL_NOT_IMPLEMENTED = -3,
 640     SSL_UNKNOWN         = -2,
 641     SSL_FATAL_ERROR     = -1,
 642
 643     SSL_FILETYPE_ASN1    = 2,
 644     SSL_FILETYPE_PEM     = 1,
 645     SSL_FILETYPE_DEFAULT = 2, /* ASN1 */
 646     SSL_FILETYPE_RAW     = 3, /* NTRU raw key blob */
 647
 648     SSL_VERIFY_NONE                 = 0,
 649     SSL_VERIFY_PEER                 = 1,
 650     SSL_VERIFY_FAIL_IF_NO_PEER_CERT = 2,
 651     SSL_VERIFY_CLIENT_ONCE          = 4,
 652
 653     SSL_SESS_CACHE_OFF                = 30,
 654     SSL_SESS_CACHE_CLIENT             = 31,
 655     SSL_SESS_CACHE_SERVER             = 32,
 656     SSL_SESS_CACHE_BOTH               = 33,
 657     SSL_SESS_CACHE_NO_AUTO_CLEAR      = 34,
 658     SSL_SESS_CACHE_NO_INTERNAL_LOOKUP = 35,
 659
 660     SSL_ERROR_WANT_READ        =  2,
 661     SSL_ERROR_WANT_WRITE       =  3,
 662     SSL_ERROR_WANT_CONNECT     =  7,
 663     SSL_ERROR_WANT_ACCEPT      =  8,
 664     SSL_ERROR_SYSCALL          =  5,
 665     SSL_ERROR_WANT_X509_LOOKUP = 83,
 666     SSL_ERROR_ZERO_RETURN      =  6,
 667     SSL_ERROR_SSL              = 85,
 668
 669     SSL_SENT_SHUTDOWN     = 1,
 670     SSL_RECEIVED_SHUTDOWN = 2,
 671     SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER = 4,
 672     SSL_OP_NO_SSLv2       = 8,
 673
 674     SSL_R_SSL_HANDSHAKE_FAILURE           = 101,
 675     SSL_R_TLSV1_ALERT_UNKNOWN_CA          = 102,
 676     SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN = 103,
 677     SSL_R_SSLV3_ALERT_BAD_CERTIFICATE     = 104,
 678
 679     PEM_BUFSIZE = 1024
 680 };
 681
 682
 683 #ifndef NO_PSK
 684     typedef unsigned int (*psk_client_callback)(CYASSL*, const char*, char*,
 685                                     unsigned int, unsigned char*, unsigned int);
 686     CYASSL_API void CyaSSL_CTX_set_psk_client_callback(CYASSL_CTX*,
 687                                                     psk_client_callback);
 688     CYASSL_API void CyaSSL_set_psk_client_callback(CYASSL*,psk_client_callback);
 689
 690     CYASSL_API const char* CyaSSL_get_psk_identity_hint(const CYASSL*);
 691     CYASSL_API const char* CyaSSL_get_psk_identity(const CYASSL*);
 692
 693     CYASSL_API int CyaSSL_CTX_use_psk_identity_hint(CYASSL_CTX*, const char*);
 694     CYASSL_API int CyaSSL_use_psk_identity_hint(CYASSL*, const char*);
 695
 696     typedef unsigned int (*psk_server_callback)(CYASSL*, const char*,
 697                           unsigned char*, unsigned int);
 698     CYASSL_API void CyaSSL_CTX_set_psk_server_callback(CYASSL_CTX*,
 699                                                     psk_server_callback);
 700     CYASSL_API void CyaSSL_set_psk_server_callback(CYASSL*,psk_server_callback);
 701
 702     #define PSK_TYPES_DEFINED
 703 #endif /* NO_PSK */
 704
 705
 706 /* extra begins */
 707
 708 enum {  /* ERR Constants */
 709     ERR_TXT_STRING = 1
 710 };
 711
 712 CYASSL_API unsigned long CyaSSL_ERR_get_error_line_data(const char**, int*,
 713                                                  const char**, int *);
 714
 715 CYASSL_API unsigned long CyaSSL_ERR_get_error(void);
 716 CYASSL_API void          CyaSSL_ERR_clear_error(void);
 717
 718
 719 CYASSL_API int  CyaSSL_RAND_status(void);
 720 CYASSL_API int  CyaSSL_RAND_bytes(unsigned char* buf, int num);
 721 CYASSL_API CYASSL_METHOD *CyaSSLv23_server_method(void);
 722 CYASSL_API long CyaSSL_CTX_set_options(CYASSL_CTX*, long);
 723 #ifndef NO_CERTS
 724   CYASSL_API int  CyaSSL_CTX_check_private_key(CYASSL_CTX*);
 725 #endif /* !NO_CERTS */
 726
 727 CYASSL_API void CyaSSL_ERR_free_strings(void);
 728 CYASSL_API void CyaSSL_ERR_remove_state(unsigned long);
 729 CYASSL_API void CyaSSL_EVP_cleanup(void);
 730
 731 CYASSL_API void CyaSSL_cleanup_all_ex_data(void);
 732 CYASSL_API long CyaSSL_CTX_set_mode(CYASSL_CTX* ctx, long mode);
 733 CYASSL_API long CyaSSL_CTX_get_mode(CYASSL_CTX* ctx);
 734 CYASSL_API void CyaSSL_CTX_set_default_read_ahead(CYASSL_CTX* ctx, int m);
 735
 736 CYASSL_API long CyaSSL_CTX_sess_set_cache_size(CYASSL_CTX*, long);
 737
 738 CYASSL_API int  CyaSSL_CTX_set_default_verify_paths(CYASSL_CTX*);
 739 CYASSL_API int  CyaSSL_CTX_set_session_id_context(CYASSL_CTX*,
 740                                             const unsigned char*, unsigned int);
 741 CYASSL_API CYASSL_X509* CyaSSL_get_peer_certificate(CYASSL* ssl);
 742
 743 CYASSL_API int CyaSSL_want_read(CYASSL*);
 744 CYASSL_API int CyaSSL_want_write(CYASSL*);
 745
 746 CYASSL_API int CyaSSL_BIO_printf(CYASSL_BIO*, const char*, ...);
 747 CYASSL_API int CyaSSL_ASN1_UTCTIME_print(CYASSL_BIO*,
 748                                          const CYASSL_ASN1_UTCTIME*);
 749 CYASSL_API int   CyaSSL_sk_num(CYASSL_X509_REVOKED*);
 750 CYASSL_API void* CyaSSL_sk_value(CYASSL_X509_REVOKED*, int);
 751
 752 /* stunnel 4.28 needs */
 753 CYASSL_API void* CyaSSL_CTX_get_ex_data(const CYASSL_CTX*, int);
 754 CYASSL_API int   CyaSSL_CTX_set_ex_data(CYASSL_CTX*, int, void*);
 755 CYASSL_API void  CyaSSL_CTX_sess_set_get_cb(CYASSL_CTX*,
 756                        CYASSL_SESSION*(*f)(CYASSL*, unsigned char*, int, int*));
 757 CYASSL_API void  CyaSSL_CTX_sess_set_new_cb(CYASSL_CTX*,
 758                                             int (*f)(CYASSL*, CYASSL_SESSION*));
 759 CYASSL_API void  CyaSSL_CTX_sess_set_remove_cb(CYASSL_CTX*,
 760                                        void (*f)(CYASSL_CTX*, CYASSL_SESSION*));
 761
 762 CYASSL_API int          CyaSSL_i2d_SSL_SESSION(CYASSL_SESSION*,unsigned char**);
 763 CYASSL_API CYASSL_SESSION* CyaSSL_d2i_SSL_SESSION(CYASSL_SESSION**,
 764                                                    const unsigned char**, long);
 765
 766 CYASSL_API long CyaSSL_SESSION_get_timeout(const CYASSL_SESSION*);
 767 CYASSL_API long CyaSSL_SESSION_get_time(const CYASSL_SESSION*);
 768 CYASSL_API int  CyaSSL_CTX_get_ex_new_index(long, void*, void*, void*, void*);
 769
 770 /* extra ends */
 771
 772
 773 /* CyaSSL extensions */
 774
 775 /* call before SSL_connect, if verifying will add name check to
 776    date check and signature check */
 777 CYASSL_API int CyaSSL_check_domain_name(CYASSL* ssl, const char* dn);
 778
 779 /* need to call once to load library (session cache) */
 780 CYASSL_API int CyaSSL_Init(void);
 781 /* call when done to cleanup/free session cache mutex / resources  */
 782 CYASSL_API int CyaSSL_Cleanup(void);
 783
 784 /* turn logging on, only if compiled in */
 785 CYASSL_API int  CyaSSL_Debugging_ON(void);
 786 /* turn logging off */
 787 CYASSL_API void CyaSSL_Debugging_OFF(void);
 788
 789 /* do accept or connect depedning on side */
 790 CYASSL_API int CyaSSL_negotiate(CYASSL* ssl);
 791 /* turn on CyaSSL data compression */
 792 CYASSL_API int CyaSSL_set_compression(CYASSL* ssl);
 793
 794 CYASSL_API int CyaSSL_set_timeout(CYASSL*, unsigned int);
 795 CYASSL_API int CyaSSL_CTX_set_timeout(CYASSL_CTX*, unsigned int);
 796
 797 /* get CyaSSL peer X509_CHAIN */
 798 CYASSL_API CYASSL_X509_CHAIN* CyaSSL_get_peer_chain(CYASSL* ssl);
 799 /* peer chain count */
 800 CYASSL_API int  CyaSSL_get_chain_count(CYASSL_X509_CHAIN* chain);
 801 /* index cert length */
 802 CYASSL_API int  CyaSSL_get_chain_length(CYASSL_X509_CHAIN*, int idx);
 803 /* index cert */
 804 CYASSL_API unsigned char* CyaSSL_get_chain_cert(CYASSL_X509_CHAIN*, int idx);
 805 /* index cert in X509 */
 806 CYASSL_API CYASSL_X509* CyaSSL_get_chain_X509(CYASSL_X509_CHAIN*, int idx);
 807 /* free X509 */
 808 CYASSL_API void CyaSSL_FreeX509(CYASSL_X509*);
 809 /* get index cert in PEM */
 810 CYASSL_API int  CyaSSL_get_chain_cert_pem(CYASSL_X509_CHAIN*, int idx,
 811                                 unsigned char* buffer, int inLen, int* outLen);
 812 CYASSL_API const unsigned char* CyaSSL_get_sessionID(const CYASSL_SESSION* s);
 813 CYASSL_API int  CyaSSL_X509_get_serial_number(CYASSL_X509*,unsigned char*,int*);
 814 CYASSL_API char*  CyaSSL_X509_get_subjectCN(CYASSL_X509*);
 815 CYASSL_API const unsigned char* CyaSSL_X509_get_der(CYASSL_X509*, int*);
 816 CYASSL_API const unsigned char* CyaSSL_X509_notBefore(CYASSL_X509*);
 817 CYASSL_API const unsigned char* CyaSSL_X509_notAfter(CYASSL_X509*);
 818 CYASSL_API int CyaSSL_X509_version(CYASSL_X509*);
 819 CYASSL_API
 820
 821 CYASSL_API int CyaSSL_cmp_peer_cert_to_file(CYASSL*, const char*);
 822
 823 CYASSL_API char* CyaSSL_X509_get_next_altname(CYASSL_X509*);
 824
 825 CYASSL_API CYASSL_X509*
 826     CyaSSL_X509_d2i(CYASSL_X509** x509, const unsigned char* in, int len);
 827 #ifndef NO_FILESYSTEM
 828     #ifndef NO_STDIO_FILESYSTEM
 829     CYASSL_API CYASSL_X509*
 830         CyaSSL_X509_d2i_fp(CYASSL_X509** x509, FILE* file);
 831     #endif
 832 CYASSL_API CYASSL_X509*
 833     CyaSSL_X509_load_certificate_file(const char* fname, int format);
 834 #endif
 835
 836 #ifdef CYASSL_SEP
 837     CYASSL_API unsigned char*
 838            CyaSSL_X509_get_device_type(CYASSL_X509*, unsigned char*, int*);
 839     CYASSL_API unsigned char*
 840            CyaSSL_X509_get_hw_type(CYASSL_X509*, unsigned char*, int*);
 841     CYASSL_API unsigned char*
 842            CyaSSL_X509_get_hw_serial_number(CYASSL_X509*, unsigned char*, int*);
 843 #endif
 844
 845 /* connect enough to get peer cert */
 846 CYASSL_API int  CyaSSL_connect_cert(CYASSL* ssl);
 847
 848 /* XXX This should be #ifndef NO_DH */
 849 #ifndef NO_CERTS
 850 /* server Diffie-Hellman parameters */
 851 CYASSL_API int  CyaSSL_SetTmpDH(CYASSL*, const unsigned char* p, int pSz,
 852                                 const unsigned char* g, int gSz);
 853 CYASSL_API int  CyaSSL_SetTmpDH_buffer(CYASSL*, const unsigned char* b, long sz,
 854                                        int format);
 855 CYASSL_API int  CyaSSL_SetTmpEC_DHE_Sz(CYASSL*, unsigned short);
 856 #ifndef NO_FILESYSTEM
 857     CYASSL_API int  CyaSSL_SetTmpDH_file(CYASSL*, const char* f, int format);
 858 #endif
 859
 860 /* server ctx Diffie-Hellman parameters */
 861 CYASSL_API int  CyaSSL_CTX_SetTmpDH(CYASSL_CTX*, const unsigned char* p,
 862                                     int pSz, const unsigned char* g, int gSz);
 863 CYASSL_API int  CyaSSL_CTX_SetTmpDH_buffer(CYASSL_CTX*, const unsigned char* b,
 864                                            long sz, int format);
 865 CYASSL_API int  CyaSSL_CTX_SetTmpEC_DHE_Sz(CYASSL_CTX*, unsigned short);
 866
 867 #ifndef NO_FILESYSTEM
 868     CYASSL_API int  CyaSSL_CTX_SetTmpDH_file(CYASSL_CTX*, const char* f,
 869                                              int format);
 870 #endif
 871 #endif
 872
 873 /* keyblock size in bytes or -1 */
 874 /* need to call CyaSSL_KeepArrays before handshake to save keys */
 875 CYASSL_API int CyaSSL_get_keyblock_size(CYASSL*);
 876 CYASSL_API int CyaSSL_get_keys(CYASSL*,unsigned char** ms, unsigned int* msLen,
 877                                        unsigned char** sr, unsigned int* srLen,
 878                                        unsigned char** cr, unsigned int* crLen);
 879
 880 /* Computes EAP-TLS and EAP-TTLS keying material from the master_secret. */
 881 CYASSL_API int CyaSSL_make_eap_keys(CYASSL*, void* key, unsigned int len,
 882                                                              const char* label);
 883
 884
 885 #ifndef _WIN32
 886     #ifndef NO_WRITEV
 887         #ifdef __PPU
 888             #include <sys/types.h>
 889             #include <sys/socket.h>
 890         #elif !defined(CYASSL_MDK_ARM) && !defined(CYASSL_IAR_ARM)
 891             #include <sys/uio.h>
 892         #endif
 893         /* allow writev style writing */
 894         CYASSL_API int CyaSSL_writev(CYASSL* ssl, const struct iovec* iov,
 895                                      int iovcnt);
 896     #endif
 897 #endif
 898
 899
 900 #ifndef NO_CERTS
 901     /* SSL_CTX versions */
 902     CYASSL_API int CyaSSL_CTX_UnloadCAs(CYASSL_CTX*);
 903     CYASSL_API int CyaSSL_CTX_load_verify_buffer(CYASSL_CTX*,
 904                                                const unsigned char*, long, int);
 905     CYASSL_API int CyaSSL_CTX_use_certificate_buffer(CYASSL_CTX*,
 906                                                const unsigned char*, long, int);
 907     CYASSL_API int CyaSSL_CTX_use_PrivateKey_buffer(CYASSL_CTX*,
 908                                                const unsigned char*, long, int);
 909     CYASSL_API int CyaSSL_CTX_use_certificate_chain_buffer(CYASSL_CTX*,
 910                                                     const unsigned char*, long);
 911
 912     /* SSL versions */
 913     CYASSL_API int CyaSSL_use_certificate_buffer(CYASSL*, const unsigned char*,
 914                                                long, int);
 915     CYASSL_API int CyaSSL_use_PrivateKey_buffer(CYASSL*, const unsigned char*,
 916                                                long, int);
 917     CYASSL_API int CyaSSL_use_certificate_chain_buffer(CYASSL*,
 918                                                const unsigned char*, long);
 919     CYASSL_API int CyaSSL_UnloadCertsKeys(CYASSL*);
 920 #endif
 921
 922 CYASSL_API int CyaSSL_CTX_set_group_messages(CYASSL_CTX*);
 923 CYASSL_API int CyaSSL_set_group_messages(CYASSL*);
 924
 925 /* I/O callbacks */
 926 typedef int (*CallbackIORecv)(CYASSL *ssl, char *buf, int sz, void *ctx);
 927 typedef int (*CallbackIOSend)(CYASSL *ssl, char *buf, int sz, void *ctx);
 928
 929 CYASSL_API void CyaSSL_SetIORecv(CYASSL_CTX*, CallbackIORecv);
 930 CYASSL_API void CyaSSL_SetIOSend(CYASSL_CTX*, CallbackIOSend);
 931
 932 CYASSL_API void CyaSSL_SetIOReadCtx( CYASSL* ssl, void *ctx);
 933 CYASSL_API void CyaSSL_SetIOWriteCtx(CYASSL* ssl, void *ctx);
 934
 935 CYASSL_API void* CyaSSL_GetIOReadCtx( CYASSL* ssl);
 936 CYASSL_API void* CyaSSL_GetIOWriteCtx(CYASSL* ssl);
 937
 938 CYASSL_API void CyaSSL_SetIOReadFlags( CYASSL* ssl, int flags);
 939 CYASSL_API void CyaSSL_SetIOWriteFlags(CYASSL* ssl, int flags);
 940
 941
 942 #ifndef CYASSL_USER_IO
 943     /* default IO callbacks */
 944     CYASSL_API int EmbedReceive(CYASSL* ssl, char* buf, int sz, void* ctx);
 945     CYASSL_API int EmbedSend(CYASSL* ssl, char* buf, int sz, void* ctx);
 946
 947     #ifdef HAVE_OCSP
 948         CYASSL_API int EmbedOcspLookup(void*, const char*, int, unsigned char*,
 949                                        int, unsigned char**);
 950         CYASSL_API void EmbedOcspRespFree(void*, unsigned char*);
 951     #endif
 952
 953     #ifdef CYASSL_DTLS
 954         CYASSL_API int EmbedReceiveFrom(CYASSL* ssl, char* buf, int sz, void*);
 955         CYASSL_API int EmbedSendTo(CYASSL* ssl, char* buf, int sz, void* ctx);
 956         CYASSL_API int EmbedGenerateCookie(CYASSL* ssl, unsigned char* buf,
 957                                            int sz, void*);
 958     #endif /* CYASSL_DTLS */
 959 #endif /* CYASSL_USER_IO */
 960
 961
 962 #ifdef HAVE_NETX
 963     CYASSL_API void CyaSSL_SetIO_NetX(CYASSL* ssl, NX_TCP_SOCKET* nxsocket,
 964                                       ULONG waitoption);
 965 #endif
 966
 967 typedef int (*CallbackGenCookie)(CYASSL* ssl, unsigned char* buf, int sz,
 968                                  void* ctx);
 969 CYASSL_API void  CyaSSL_CTX_SetGenCookie(CYASSL_CTX*, CallbackGenCookie);
 970 CYASSL_API void  CyaSSL_SetCookieCtx(CYASSL* ssl, void *ctx);
 971 CYASSL_API void* CyaSSL_GetCookieCtx(CYASSL* ssl);
 972
 973
 974 /* I/O Callback default errors */
 975 enum IOerrors {
 976     CYASSL_CBIO_ERR_GENERAL    = -1,     /* general unexpected err */
 977     CYASSL_CBIO_ERR_WANT_READ  = -2,     /* need to call read  again */
 978     CYASSL_CBIO_ERR_WANT_WRITE = -2,     /* need to call write again */
 979     CYASSL_CBIO_ERR_CONN_RST   = -3,     /* connection reset */
 980     CYASSL_CBIO_ERR_ISR        = -4,     /* interrupt */
 981     CYASSL_CBIO_ERR_CONN_CLOSE = -5,     /* connection closed or epipe */
 982     CYASSL_CBIO_ERR_TIMEOUT    = -6      /* socket timeout */
 983 };
 984
 985
 986 /* CA cache callbacks */
 987 enum {
 988     CYASSL_SSLV3    = 0,
 989     CYASSL_TLSV1    = 1,
 990     CYASSL_TLSV1_1  = 2,
 991     CYASSL_TLSV1_2  = 3,
 992     CYASSL_USER_CA  = 1,          /* user added as trusted */
 993     CYASSL_CHAIN_CA = 2           /* added to cache from trusted chain */
 994 };
 995
 996 CYASSL_API int CyaSSL_GetObjectSize(void);  /* object size based on build */
 997 CYASSL_API int CyaSSL_SetVersion(CYASSL* ssl, int version);
 998 CYASSL_API int CyaSSL_KeyPemToDer(const unsigned char*, int sz, unsigned char*,
 999                                   int, const char*);
1000 CYASSL_API int CyaSSL_CertPemToDer(const unsigned char*, int sz, unsigned char*,
1001                                    int, int);
1002
1003 typedef void (*CallbackCACache)(unsigned char* der, int sz, int type);
1004 typedef void (*CbMissingCRL)(const char* url);
1005 typedef int  (*CbOCSPIO)(void*, const char*, int,
1006                                          unsigned char*, int, unsigned char**);
1007 typedef void (*CbOCSPRespFree)(void*,unsigned char*);
1008
1009 /* User Atomic Record Layer CallBacks */
1010 typedef int (*CallbackMacEncrypt)(CYASSL* ssl, unsigned char* macOut,
1011        const unsigned char* macIn, unsigned int macInSz, int macContent,
1012        int macVerify, unsigned char* encOut, const unsigned char* encIn,
1013        unsigned int encSz, void* ctx);
1014 CYASSL_API void  CyaSSL_CTX_SetMacEncryptCb(CYASSL_CTX*, CallbackMacEncrypt);
1015 CYASSL_API void  CyaSSL_SetMacEncryptCtx(CYASSL* ssl, void *ctx);
1016 CYASSL_API void* CyaSSL_GetMacEncryptCtx(CYASSL* ssl);
1017
1018 typedef int (*CallbackDecryptVerify)(CYASSL* ssl,
1019        unsigned char* decOut, const unsigned char* decIn,
1020        unsigned int decSz, int content, int verify, unsigned int* padSz,
1021        void* ctx);
1022 CYASSL_API void  CyaSSL_CTX_SetDecryptVerifyCb(CYASSL_CTX*,
1023                                                CallbackDecryptVerify);
1024 CYASSL_API void  CyaSSL_SetDecryptVerifyCtx(CYASSL* ssl, void *ctx);
1025 CYASSL_API void* CyaSSL_GetDecryptVerifyCtx(CYASSL* ssl);
1026
1027 CYASSL_API const unsigned char* CyaSSL_GetMacSecret(CYASSL*, int);
1028 CYASSL_API const unsigned char* CyaSSL_GetClientWriteKey(CYASSL*);
1029 CYASSL_API const unsigned char* CyaSSL_GetClientWriteIV(CYASSL*);
1030 CYASSL_API const unsigned char* CyaSSL_GetServerWriteKey(CYASSL*);
1031 CYASSL_API const unsigned char* CyaSSL_GetServerWriteIV(CYASSL*);
1032 CYASSL_API int                  CyaSSL_GetKeySize(CYASSL*);
1033 CYASSL_API int                  CyaSSL_GetIVSize(CYASSL*);
1034 CYASSL_API int                  CyaSSL_GetSide(CYASSL*);
1035 CYASSL_API int                  CyaSSL_IsTLSv1_1(CYASSL*);
1036 CYASSL_API int                  CyaSSL_GetBulkCipher(CYASSL*);
1037 CYASSL_API int                  CyaSSL_GetCipherBlockSize(CYASSL*);
1038 CYASSL_API int                  CyaSSL_GetAeadMacSize(CYASSL*);
1039 CYASSL_API int                  CyaSSL_GetHmacSize(CYASSL*);
1040 CYASSL_API int                  CyaSSL_GetHmacType(CYASSL*);
1041 CYASSL_API int                  CyaSSL_GetCipherType(CYASSL*);
1042 CYASSL_API int                  CyaSSL_SetTlsHmacInner(CYASSL*, unsigned char*,
1043                                                        unsigned int, int, int);
1044
1045 /* Atomic User Needs */
1046 enum {
1047     CYASSL_SERVER_END = 0,
1048     CYASSL_CLIENT_END = 1,
1049     CYASSL_BLOCK_TYPE = 2,
1050     CYASSL_STREAM_TYPE = 3,
1051     CYASSL_AEAD_TYPE = 4,
1052     CYASSL_TLS_HMAC_INNER_SZ = 13      /* SEQ_SZ + ENUM + VERSION_SZ + LEN_SZ */
1053 };
1054
1055 /* for GetBulkCipher and internal use */
1056 enum BulkCipherAlgorithm {
1057     cyassl_cipher_null,
1058     cyassl_rc4,
1059     cyassl_rc2,
1060     cyassl_des,
1061     cyassl_triple_des,             /* leading 3 (3des) not valid identifier */
1062     cyassl_des40,
1063     cyassl_idea,
1064     cyassl_aes,
1065     cyassl_aes_gcm,
1066     cyassl_aes_ccm,
1067     cyassl_camellia,
1068     cyassl_hc128,                  /* CyaSSL extensions */
1069     cyassl_rabbit
1070 };
1071
1072
1073 /* Public Key Callback support */
1074 typedef int (*CallbackEccSign)(CYASSL* ssl,
1075        const unsigned char* in, unsigned int inSz,
1076        unsigned char* out, unsigned int* outSz,
1077        const unsigned char* keyDer, unsigned int keySz,
1078        void* ctx);
1079 CYASSL_API void  CyaSSL_CTX_SetEccSignCb(CYASSL_CTX*, CallbackEccSign);
1080 CYASSL_API void  CyaSSL_SetEccSignCtx(CYASSL* ssl, void *ctx);
1081 CYASSL_API void* CyaSSL_GetEccSignCtx(CYASSL* ssl);
1082
1083 typedef int (*CallbackEccVerify)(CYASSL* ssl,
1084        const unsigned char* sig, unsigned int sigSz,
1085        const unsigned char* hash, unsigned int hashSz,
1086        const unsigned char* keyDer, unsigned int keySz,
1087        int* result, void* ctx);
1088 CYASSL_API void  CyaSSL_CTX_SetEccVerifyCb(CYASSL_CTX*, CallbackEccVerify);
1089 CYASSL_API void  CyaSSL_SetEccVerifyCtx(CYASSL* ssl, void *ctx);
1090 CYASSL_API void* CyaSSL_GetEccVerifyCtx(CYASSL* ssl);
1091
1092 typedef int (*CallbackRsaSign)(CYASSL* ssl,
1093        const unsigned char* in, unsigned int inSz,
1094        unsigned char* out, unsigned int* outSz,
1095        const unsigned char* keyDer, unsigned int keySz,
1096        void* ctx);
1097 CYASSL_API void  CyaSSL_CTX_SetRsaSignCb(CYASSL_CTX*, CallbackRsaSign);
1098 CYASSL_API void  CyaSSL_SetRsaSignCtx(CYASSL* ssl, void *ctx);
1099 CYASSL_API void* CyaSSL_GetRsaSignCtx(CYASSL* ssl);
1100
1101 typedef int (*CallbackRsaVerify)(CYASSL* ssl,
1102        unsigned char* sig, unsigned int sigSz,
1103        unsigned char** out,
1104        const unsigned char* keyDer, unsigned int keySz,
1105        void* ctx);
1106 CYASSL_API void  CyaSSL_CTX_SetRsaVerifyCb(CYASSL_CTX*, CallbackRsaVerify);
1107 CYASSL_API void  CyaSSL_SetRsaVerifyCtx(CYASSL* ssl, void *ctx);
1108 CYASSL_API void* CyaSSL_GetRsaVerifyCtx(CYASSL* ssl);
1109
1110 /* RSA Public Encrypt cb */
1111 typedef int (*CallbackRsaEnc)(CYASSL* ssl,
1112        const unsigned char* in, unsigned int inSz,
1113        unsigned char* out, unsigned int* outSz,
1114        const unsigned char* keyDer, unsigned int keySz,
1115        void* ctx);
1116 CYASSL_API void  CyaSSL_CTX_SetRsaEncCb(CYASSL_CTX*, CallbackRsaEnc);
1117 CYASSL_API void  CyaSSL_SetRsaEncCtx(CYASSL* ssl, void *ctx);
1118 CYASSL_API void* CyaSSL_GetRsaEncCtx(CYASSL* ssl);
1119
1120 /* RSA Private Decrypt cb */
1121 typedef int (*CallbackRsaDec)(CYASSL* ssl,
1122        unsigned char* in, unsigned int inSz,
1123        unsigned char** out,
1124        const unsigned char* keyDer, unsigned int keySz,
1125        void* ctx);
1126 CYASSL_API void  CyaSSL_CTX_SetRsaDecCb(CYASSL_CTX*, CallbackRsaDec);
1127 CYASSL_API void  CyaSSL_SetRsaDecCtx(CYASSL* ssl, void *ctx);
1128 CYASSL_API void* CyaSSL_GetRsaDecCtx(CYASSL* ssl);
1129
1130
1131 #ifndef NO_CERTS
1132         CYASSL_API void CyaSSL_CTX_SetCACb(CYASSL_CTX*, CallbackCACache);
1133
1134     CYASSL_API CYASSL_CERT_MANAGER* CyaSSL_CertManagerNew(void);
1135     CYASSL_API void CyaSSL_CertManagerFree(CYASSL_CERT_MANAGER*);
1136
1137     CYASSL_API int CyaSSL_CertManagerLoadCA(CYASSL_CERT_MANAGER*, const char* f,
1138                                                                  const char* d);
1139     CYASSL_API int CyaSSL_CertManagerUnloadCAs(CYASSL_CERT_MANAGER* cm);
1140     CYASSL_API int CyaSSL_CertManagerVerify(CYASSL_CERT_MANAGER*, const char* f,
1141                                                                     int format);
1142     CYASSL_API int CyaSSL_CertManagerVerifyBuffer(CYASSL_CERT_MANAGER* cm,
1143                                 const unsigned char* buff, long sz, int format);
1144     CYASSL_API int CyaSSL_CertManagerCheckCRL(CYASSL_CERT_MANAGER*,
1145                                                         unsigned char*, int sz);
1146     CYASSL_API int CyaSSL_CertManagerEnableCRL(CYASSL_CERT_MANAGER*,
1147                                                                    int options);
1148     CYASSL_API int CyaSSL_CertManagerDisableCRL(CYASSL_CERT_MANAGER*);
1149     CYASSL_API int CyaSSL_CertManagerLoadCRL(CYASSL_CERT_MANAGER*, const char*,
1150                                                                       int, int);
1151     CYASSL_API int CyaSSL_CertManagerSetCRL_Cb(CYASSL_CERT_MANAGER*,
1152                                                                   CbMissingCRL);
1153     CYASSL_API int CyaSSL_CertManagerCheckOCSP(CYASSL_CERT_MANAGER*,
1154                                                         unsigned char*, int sz);
1155     CYASSL_API int CyaSSL_CertManagerEnableOCSP(CYASSL_CERT_MANAGER*,
1156                                                                    int options);
1157     CYASSL_API int CyaSSL_CertManagerDisableOCSP(CYASSL_CERT_MANAGER*);
1158     CYASSL_API int CyaSSL_CertManagerSetOCSPOverrideURL(CYASSL_CERT_MANAGER*,
1159                                                                    const char*);
1160     CYASSL_API int CyaSSL_CertManagerSetOCSP_Cb(CYASSL_CERT_MANAGER*,
1161                                                CbOCSPIO, CbOCSPRespFree, void*);
1162
1163     CYASSL_API int CyaSSL_EnableCRL(CYASSL* ssl, int options);
1164     CYASSL_API int CyaSSL_DisableCRL(CYASSL* ssl);
1165     CYASSL_API int CyaSSL_LoadCRL(CYASSL*, const char*, int, int);
1166     CYASSL_API int CyaSSL_SetCRL_Cb(CYASSL*, CbMissingCRL);
1167     CYASSL_API int CyaSSL_EnableOCSP(CYASSL*, int options);
1168     CYASSL_API int CyaSSL_DisableOCSP(CYASSL*);
1169     CYASSL_API int CyaSSL_SetOCSP_OverrideURL(CYASSL*, const char*);
1170     CYASSL_API int CyaSSL_SetOCSP_Cb(CYASSL*, CbOCSPIO, CbOCSPRespFree, void*);
1171
1172     CYASSL_API int CyaSSL_CTX_EnableCRL(CYASSL_CTX* ctx, int options);
1173     CYASSL_API int CyaSSL_CTX_DisableCRL(CYASSL_CTX* ctx);
1174     CYASSL_API int CyaSSL_CTX_LoadCRL(CYASSL_CTX*, const char*, int, int);
1175     CYASSL_API int CyaSSL_CTX_SetCRL_Cb(CYASSL_CTX*, CbMissingCRL);
1176     CYASSL_API int CyaSSL_CTX_EnableOCSP(CYASSL_CTX*, int options);
1177     CYASSL_API int CyaSSL_CTX_DisableOCSP(CYASSL_CTX*);
1178     CYASSL_API int CyaSSL_CTX_SetOCSP_OverrideURL(CYASSL_CTX*, const char*);
1179     CYASSL_API int CyaSSL_CTX_SetOCSP_Cb(CYASSL_CTX*,
1180                                                CbOCSPIO, CbOCSPRespFree, void*);
1181 #endif /* !NO_CERTS */
1182
1183 /* end of handshake frees temporary arrays, if user needs for get_keys or
1184    psk hints, call KeepArrays before handshake and then FreeArrays when done
1185    if don't want to wait for object free */
1186 CYASSL_API void CyaSSL_KeepArrays(CYASSL*);
1187 CYASSL_API void CyaSSL_FreeArrays(CYASSL*);
1188
1189
1190 /* cavium additions */
1191 CYASSL_API int CyaSSL_UseCavium(CYASSL*, int devId);
1192 CYASSL_API int CyaSSL_CTX_UseCavium(CYASSL_CTX*, int devId);
1193
1194 /* TLS Extensions */
1195
1196 /* Server Name Indication */
1197 #ifdef HAVE_SNI
1198 /* SNI types */
1199 enum {
1200     CYASSL_SNI_HOST_NAME = 0
1201 };
1202
1203 CYASSL_API int CyaSSL_UseSNI(CYASSL* ssl, unsigned char type, const void* data,
1204                                                            unsigned short size);
1205 CYASSL_API int CyaSSL_CTX_UseSNI(CYASSL_CTX* ctx, unsigned char type,
1206                                          const void* data, unsigned short size);
1207
1208 #ifndef NO_CYASSL_SERVER
1209 /* SNI options */
1210 enum {
1211     CYASSL_SNI_CONTINUE_ON_MISMATCH = 0x01, /* do not abort on mismatch flag */
1212     CYASSL_SNI_ANSWER_ON_MISMATCH   = 0x02  /* fake match on mismatch flag */
1213 };
1214
1215 CYASSL_API void CyaSSL_SNI_SetOptions(CYASSL* ssl, unsigned char type,
1216                                                          unsigned char options);
1217 CYASSL_API void CyaSSL_CTX_SNI_SetOptions(CYASSL_CTX* ctx, unsigned char type,
1218                                                          unsigned char options);
1219
1220 /* SNI status */
1221 enum {
1222     CYASSL_SNI_NO_MATCH   = 0,
1223     CYASSL_SNI_FAKE_MATCH = 1, /* if CYASSL_SNI_ANSWER_ON_MISMATCH is enabled */
1224     CYASSL_SNI_REAL_MATCH = 2
1225 };
1226
1227 CYASSL_API unsigned char CyaSSL_SNI_Status(CYASSL* ssl, unsigned char type);
1228
1229 CYASSL_API unsigned short CyaSSL_SNI_GetRequest(CYASSL *ssl, unsigned char type,
1230                                                                    void** data);
1231
1232 CYASSL_API int CyaSSL_SNI_GetFromBuffer(
1233                  const unsigned char* clientHello, unsigned int helloSz,
1234                  unsigned char type, unsigned char* sni, unsigned int* inOutSz);
1235
1236 #endif /* NO_CYASSL_SERVER */
1237 #endif /* HAVE_SNI */
1238
1239 /* Maximum Fragment Length */
1240 #ifdef HAVE_MAX_FRAGMENT
1241 /* Fragment lengths */
1242 enum {
1243     CYASSL_MFL_2_9  = 1, /*  512 bytes */
1244     CYASSL_MFL_2_10 = 2, /* 1024 bytes */
1245     CYASSL_MFL_2_11 = 3, /* 2048 bytes */
1246     CYASSL_MFL_2_12 = 4, /* 4096 bytes */
1247     CYASSL_MFL_2_13 = 5  /* 8192 bytes *//* CyaSSL ONLY!!! */
1248 };
1249
1250 #ifndef NO_CYASSL_CLIENT
1251
1252 CYASSL_API int CyaSSL_UseMaxFragment(CYASSL* ssl, unsigned char mfl);
1253 CYASSL_API int CyaSSL_CTX_UseMaxFragment(CYASSL_CTX* ctx, unsigned char mfl);
1254
1255 #endif /* NO_CYASSL_CLIENT */
1256 #endif /* HAVE_MAX_FRAGMENT */
1257
1258 /* Truncated HMAC */
1259 #ifdef HAVE_TRUNCATED_HMAC
1260 #ifndef NO_CYASSL_CLIENT
1261
1262 CYASSL_API int CyaSSL_UseTruncatedHMAC(CYASSL* ssl);
1263 CYASSL_API int CyaSSL_CTX_UseTruncatedHMAC(CYASSL_CTX* ctx);
1264
1265 #endif /* NO_CYASSL_CLIENT */
1266 #endif /* HAVE_TRUNCATED_HMAC */
1267
1268 /* Elliptic Curves */
1269 #ifdef HAVE_SUPPORTED_CURVES
1270
1271 enum {
1272     CYASSL_ECC_SECP160R1 = 0x10,
1273     CYASSL_ECC_SECP192R1 = 0x13,
1274     CYASSL_ECC_SECP224R1 = 0x15,
1275     CYASSL_ECC_SECP256R1 = 0x17,
1276     CYASSL_ECC_SECP384R1 = 0x18,
1277     CYASSL_ECC_SECP521R1 = 0x19
1278 };
1279
1280 #ifndef NO_CYASSL_CLIENT
1281
1282 CYASSL_API int CyaSSL_UseSupportedCurve(CYASSL* ssl, unsigned short name);
1283 CYASSL_API int CyaSSL_CTX_UseSupportedCurve(CYASSL_CTX* ctx,
1284                                                           unsigned short name);
1285
1286 #endif /* NO_CYASSL_CLIENT */
1287 #endif /* HAVE_SUPPORTED_CURVES */
1288
1289
1290 #define CYASSL_CRL_MONITOR   0x01   /* monitor this dir flag */
1291 #define CYASSL_CRL_START_MON 0x02   /* start monitoring flag */
1292
1293 #ifdef CYASSL_CALLBACKS
1294
1295 /* used internally by CyaSSL while OpenSSL types aren't */
1296 #include <cyassl/callbacks.h>
1297
1298 typedef int (*HandShakeCallBack)(HandShakeInfo*);
1299 typedef int (*TimeoutCallBack)(TimeoutInfo*);
1300
1301 /* CyaSSL connect extension allowing HandShakeCallBack and/or TimeoutCallBack
1302    for diagnostics */
1303 CYASSL_API int CyaSSL_connect_ex(CYASSL*, HandShakeCallBack, TimeoutCallBack,
1304                                  Timeval);
1305 CYASSL_API int CyaSSL_accept_ex(CYASSL*, HandShakeCallBack, TimeoutCallBack,
1306                                 Timeval);
1307
1308 #endif /* CYASSL_CALLBACKS */
1309
1310
1311 #ifdef CYASSL_HAVE_WOLFSCEP
1312     CYASSL_API void CyaSSL_wolfSCEP(void);
1313 #endif /* CYASSL_HAVE_WOLFSCEP */
1314
1315 #ifdef CYASSL_HAVE_CERT_SERVICE
1316     CYASSL_API void CyaSSL_cert_service(void);
1317 #endif
1318
1319
1320 #ifdef __cplusplus
1321     }  /* extern "C" */
1322 #endif
1323
1324
1325 #endif /* CYASSL_SSL_H */
1326