ssl.h

00001 /* ssl.h
00002  *
00003  * Copyright (C) 2006-2014 wolfSSL Inc.
00004  *
00005  * This file is part of CyaSSL.
00006  *
00007  * CyaSSL is free software; you can redistribute it and/or modify
00008  * it under the terms of the GNU General Public License as published by
00009  * the Free Software Foundation; either version 2 of the License, or
00010  * (at your option) any later version.
00011  *
00012  * CyaSSL is distributed in the hope that it will be useful,
00013  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00014  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00015  * GNU General Public License for more details.
00016  *
00017  * You should have received a copy of the GNU General Public License
00018  * along with this program; if not, write to the Free Software
00019  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
00020  */
00021 
00022 
00023 /* CyaSSL API */
00024 
00025 #ifndef CYASSL_SSL_H
00026 #define CYASSL_SSL_H
00027 
00028 
00029 /* for users not using preprocessor flags*/
00030 #include <cyassl/ctaocrypt/settings.h>
00031 #include <cyassl/version.h>
00032 
00033 
00034 #ifndef NO_FILESYSTEM
00035     #ifdef FREESCALE_MQX
00036         #include <fio.h>
00037     #else
00038         #include <stdio.h>   /* ERR_printf */
00039     #endif
00040 #endif
00041 
00042 #ifdef YASSL_PREFIX
00043     #include "prefix_ssl.h"
00044 #endif
00045 
00046 #ifdef LIBCYASSL_VERSION_STRING
00047     #define CYASSL_VERSION LIBCYASSL_VERSION_STRING
00048 #endif
00049 
00050 #ifdef _WIN32
00051     /* wincrypt.h clashes */
00052     #undef OCSP_REQUEST
00053     #undef OCSP_RESPONSE
00054 #endif
00055 
00056 
00057 
00058 #ifdef __cplusplus
00059     extern "C" {
00060 #endif
00061 
00062 typedef struct CYASSL          CYASSL;          
00063 typedef struct CYASSL_SESSION  CYASSL_SESSION;
00064 typedef struct CYASSL_METHOD   CYASSL_METHOD;
00065 typedef struct CYASSL_CTX      CYASSL_CTX;
00066 
00067 typedef struct CYASSL_X509       CYASSL_X509;
00068 typedef struct CYASSL_X509_NAME  CYASSL_X509_NAME;
00069 typedef struct CYASSL_X509_CHAIN CYASSL_X509_CHAIN;
00070 
00071 typedef struct CYASSL_CERT_MANAGER CYASSL_CERT_MANAGER;
00072 typedef struct CYASSL_SOCKADDR     CYASSL_SOCKADDR;
00073 
00074 /* redeclare guard */
00075 #define CYASSL_TYPES_DEFINED
00076 
00077 
00078 typedef struct CYASSL_RSA            CYASSL_RSA;
00079 typedef struct CYASSL_DSA            CYASSL_DSA;
00080 typedef struct CYASSL_CIPHER         CYASSL_CIPHER;
00081 typedef struct CYASSL_X509_LOOKUP    CYASSL_X509_LOOKUP;
00082 typedef struct CYASSL_X509_LOOKUP_METHOD CYASSL_X509_LOOKUP_METHOD;
00083 typedef struct CYASSL_X509_CRL       CYASSL_X509_CRL;
00084 typedef struct CYASSL_BIO            CYASSL_BIO;
00085 typedef struct CYASSL_BIO_METHOD     CYASSL_BIO_METHOD;
00086 typedef struct CYASSL_X509_EXTENSION CYASSL_X509_EXTENSION;
00087 typedef struct CYASSL_ASN1_TIME      CYASSL_ASN1_TIME;
00088 typedef struct CYASSL_ASN1_INTEGER   CYASSL_ASN1_INTEGER;
00089 typedef struct CYASSL_ASN1_OBJECT    CYASSL_ASN1_OBJECT;
00090 typedef struct CYASSL_ASN1_STRING    CYASSL_ASN1_STRING;
00091 typedef struct CYASSL_dynlock_value  CYASSL_dynlock_value;
00092 
00093 #define CYASSL_ASN1_UTCTIME CYASSL_ASN1_TIME
00094 
00095 typedef struct CYASSL_EVP_PKEY {
00096     int type;         /* openssh dereference */
00097     int save_type;    /* openssh dereference */
00098     int pkey_sz;
00099     union {
00100         char* ptr;
00101     } pkey;
00102     #ifdef HAVE_ECC
00103         int pkey_curve;
00104     #endif
00105 } CYASSL_EVP_PKEY;
00106 
00107 typedef struct CYASSL_MD4_CTX {
00108     int buffer[32];      /* big enough to hold, check size in Init */
00109 } CYASSL_MD4_CTX;
00110 
00111 
00112 typedef struct CYASSL_COMP_METHOD {
00113     int type;            /* stunnel dereference */
00114 } CYASSL_COMP_METHOD;
00115 
00116 
00117 typedef struct CYASSL_X509_STORE {
00118     int                  cache;          /* stunnel dereference */
00119     CYASSL_CERT_MANAGER* cm;
00120 } CYASSL_X509_STORE;
00121 
00122 typedef struct CYASSL_ALERT {
00123     int code;
00124     int level;
00125 } CYASSL_ALERT;
00126 
00127 typedef struct CYASSL_ALERT_HISTORY {
00128     CYASSL_ALERT last_rx;
00129     CYASSL_ALERT last_tx;
00130 } CYASSL_ALERT_HISTORY;
00131 
00132 typedef struct CYASSL_X509_REVOKED {
00133     CYASSL_ASN1_INTEGER* serialNumber;          /* stunnel dereference */
00134 } CYASSL_X509_REVOKED;
00135 
00136 
00137 typedef struct CYASSL_X509_OBJECT {
00138     union {
00139         char* ptr;
00140         CYASSL_X509_CRL* crl;           /* stunnel dereference */
00141     } data;
00142 } CYASSL_X509_OBJECT;
00143 
00144 
00145 typedef struct CYASSL_X509_STORE_CTX {
00146     CYASSL_X509_STORE* store;    /* Store full of a CA cert chain */
00147     CYASSL_X509* current_cert;   /* stunnel dereference */
00148     char* domain;                /* subject CN domain name */
00149     void* ex_data;               /* external data, for fortress build */
00150     void* userCtx;               /* user ctx */
00151     int   error;                 /* current error */
00152     int   error_depth;           /* cert depth for this error */
00153     int   discardSessionCerts;   /* so verify callback can flag for discard */ 
00154 } CYASSL_X509_STORE_CTX;
00155 
00156 
00157 /* Valid Alert types from page 16/17 */
00158 enum AlertDescription {
00159     close_notify            = 0,
00160     unexpected_message      = 10,
00161     bad_record_mac          = 20,
00162     record_overflow         = 22,
00163     decompression_failure   = 30,
00164     handshake_failure       = 40,
00165     no_certificate          = 41,
00166     bad_certificate         = 42,
00167     unsupported_certificate = 43,
00168     certificate_revoked     = 44,
00169     certificate_expired     = 45,
00170     certificate_unknown     = 46,
00171     illegal_parameter       = 47,
00172     decrypt_error           = 51,
00173     protocol_version        = 70,
00174     no_renegotiation        = 100,
00175     unrecognized_name       = 112
00176 };
00177 
00178 
00179 enum AlertLevel {
00180     alert_warning = 1,
00181     alert_fatal = 2
00182 };
00183 
00184 
00185 CYASSL_API CYASSL_METHOD *CyaSSLv3_server_method(void);
00186 CYASSL_API CYASSL_METHOD *CyaSSLv3_client_method(void);
00187 CYASSL_API CYASSL_METHOD *CyaTLSv1_server_method(void);  
00188 CYASSL_API CYASSL_METHOD *CyaTLSv1_client_method(void);
00189 CYASSL_API CYASSL_METHOD *CyaTLSv1_1_server_method(void);  
00190 CYASSL_API CYASSL_METHOD *CyaTLSv1_1_client_method(void);
00191 CYASSL_API CYASSL_METHOD *CyaTLSv1_2_server_method(void);  
00192 CYASSL_API CYASSL_METHOD *CyaTLSv1_2_client_method(void);
00193 
00194 #ifdef CYASSL_DTLS
00195     CYASSL_API CYASSL_METHOD *CyaDTLSv1_client_method(void);
00196     CYASSL_API CYASSL_METHOD *CyaDTLSv1_server_method(void);
00197     CYASSL_API CYASSL_METHOD *CyaDTLSv1_2_client_method(void);
00198     CYASSL_API CYASSL_METHOD *CyaDTLSv1_2_server_method(void);
00199 #endif
00200 
00201 #if !defined(NO_FILESYSTEM) && !defined(NO_CERTS)
00202 
00203 CYASSL_API int CyaSSL_CTX_use_certificate_file(CYASSL_CTX*, const char*, int);
00204 CYASSL_API int CyaSSL_CTX_use_PrivateKey_file(CYASSL_CTX*, const char*, int);
00205 CYASSL_API int CyaSSL_CTX_load_verify_locations(CYASSL_CTX*, const char*,
00206                                                 const char*);
00207 CYASSL_API int CyaSSL_CTX_use_certificate_chain_file(CYASSL_CTX *,
00208                                                      const char *file);
00209 CYASSL_API int CyaSSL_CTX_use_RSAPrivateKey_file(CYASSL_CTX*, const char*, int);
00210 
00211 CYASSL_API int CyaSSL_use_certificate_file(CYASSL*, const char*, int);
00212 CYASSL_API int CyaSSL_use_PrivateKey_file(CYASSL*, const char*, int);
00213 CYASSL_API int CyaSSL_use_certificate_chain_file(CYASSL*, const char *file);
00214 CYASSL_API int CyaSSL_use_RSAPrivateKey_file(CYASSL*, const char*, int);
00215 
00216 #ifdef CYASSL_DER_LOAD
00217     CYASSL_API int CyaSSL_CTX_der_load_verify_locations(CYASSL_CTX*,
00218                                                     const char*, int);
00219 #endif
00220 
00221 #ifdef HAVE_POLY1305
00222     CYASSL_API int CyaSSL_use_old_poly(CYASSL*, int);
00223 #endif
00224 
00225 #ifdef HAVE_NTRU
00226     CYASSL_API int CyaSSL_CTX_use_NTRUPrivateKey_file(CYASSL_CTX*, const char*);
00227     /* load NTRU private key blob */
00228 #endif
00229 
00230 #ifndef CYASSL_PEMCERT_TODER_DEFINED
00231     CYASSL_API int CyaSSL_PemCertToDer(const char*, unsigned char*, int);
00232     #define CYASSL_PEMCERT_TODER_DEFINED
00233 #endif
00234 
00235 #endif /* !NO_FILESYSTEM && !NO_CERTS */
00236 
00237 CYASSL_API CYASSL_CTX* CyaSSL_CTX_new(CYASSL_METHOD*);
00238 CYASSL_API CYASSL* CyaSSL_new(CYASSL_CTX*);
00239 CYASSL_API int  CyaSSL_set_fd (CYASSL*, int);
00240 CYASSL_API int  CyaSSL_get_ciphers(char*, int);
00241 CYASSL_API int  CyaSSL_get_fd(const CYASSL*);
00242 CYASSL_API void CyaSSL_set_using_nonblock(CYASSL*, int);
00243 CYASSL_API int  CyaSSL_get_using_nonblock(CYASSL*);
00244 CYASSL_API int  CyaSSL_connect(CYASSL*);     /* please see note at top of README
00245                                              if you get an error from connect */
00246 CYASSL_API int  CyaSSL_write(CYASSL*, const void*, int);
00247 CYASSL_API int  CyaSSL_read(CYASSL*, void*, int);
00248 CYASSL_API int  CyaSSL_peek(CYASSL*, void*, int);
00249 CYASSL_API int  CyaSSL_accept(CYASSL*);
00250 CYASSL_API void CyaSSL_CTX_free(CYASSL_CTX*);
00251 CYASSL_API void CyaSSL_free(CYASSL*);
00252 CYASSL_API int  CyaSSL_shutdown(CYASSL*);
00253 CYASSL_API int  CyaSSL_send(CYASSL*, const void*, int sz, int flags);
00254 CYASSL_API int  CyaSSL_recv(CYASSL*, void*, int sz, int flags);
00255 
00256 CYASSL_API void CyaSSL_CTX_set_quiet_shutdown(CYASSL_CTX*, int);
00257 CYASSL_API void CyaSSL_set_quiet_shutdown(CYASSL*, int);
00258 
00259 CYASSL_API int  CyaSSL_get_error(CYASSL*, int);
00260 CYASSL_API int  CyaSSL_get_alert_history(CYASSL*, CYASSL_ALERT_HISTORY *);
00261 
00262 CYASSL_API int        CyaSSL_set_session(CYASSL* ssl,CYASSL_SESSION* session);
00263 CYASSL_API CYASSL_SESSION* CyaSSL_get_session(CYASSL* ssl);
00264 CYASSL_API void       CyaSSL_flush_sessions(CYASSL_CTX *ctx, long tm);
00265 CYASSL_API int        CyaSSL_SetServerID(CYASSL* ssl, const unsigned char*, 
00266                                          int, int);
00267 
00268 #ifdef SESSION_INDEX
00269 CYASSL_API int CyaSSL_GetSessionIndex(CYASSL* ssl);
00270 CYASSL_API int CyaSSL_GetSessionAtIndex(int index, CYASSL_SESSION* session);
00271 #endif /* SESSION_INDEX */
00272 
00273 #if defined(SESSION_INDEX) && defined(SESSION_CERTS)
00274 CYASSL_API 
00275     CYASSL_X509_CHAIN* CyaSSL_SESSION_get_peer_chain(CYASSL_SESSION* session);
00276 #endif /* SESSION_INDEX && SESSION_CERTS */
00277 
00278 typedef int (*VerifyCallback)(int, CYASSL_X509_STORE_CTX*);
00279 typedef int (*pem_password_cb)(char*, int, int, void*);
00280 
00281 CYASSL_API void CyaSSL_CTX_set_verify(CYASSL_CTX*, int, 
00282                                       VerifyCallback verify_callback);
00283 CYASSL_API void CyaSSL_set_verify(CYASSL*, int, VerifyCallback verify_callback);
00284 CYASSL_API void CyaSSL_SetCertCbCtx(CYASSL*, void*);
00285 
00286 CYASSL_API int  CyaSSL_pending(CYASSL*);
00287 
00288 CYASSL_API void CyaSSL_load_error_strings(void);
00289 CYASSL_API int  CyaSSL_library_init(void);
00290 CYASSL_API long CyaSSL_CTX_set_session_cache_mode(CYASSL_CTX*, long);
00291 
00292 #ifdef HAVE_SECRET_CALLBACK
00293 typedef int (*SessionSecretCb)(CYASSL* ssl,
00294                                         void* secret, int* secretSz, void* ctx);
00295 CYASSL_API int  CyaSSL_set_session_secret_cb(CYASSL*, SessionSecretCb, void*);
00296 #endif /* HAVE_SECRET_CALLBACK */
00297 
00298 /* session cache persistence */
00299 CYASSL_API int  CyaSSL_save_session_cache(const char*);
00300 CYASSL_API int  CyaSSL_restore_session_cache(const char*);
00301 CYASSL_API int  CyaSSL_memsave_session_cache(void*, int);
00302 CYASSL_API int  CyaSSL_memrestore_session_cache(const void*, int);
00303 CYASSL_API int  CyaSSL_get_session_cache_memsize(void);
00304 
00305 /* certificate cache persistence, uses ctx since certs are per ctx */
00306 CYASSL_API int  CyaSSL_CTX_save_cert_cache(CYASSL_CTX*, const char*);
00307 CYASSL_API int  CyaSSL_CTX_restore_cert_cache(CYASSL_CTX*, const char*);
00308 CYASSL_API int  CyaSSL_CTX_memsave_cert_cache(CYASSL_CTX*, void*, int, int*);
00309 CYASSL_API int  CyaSSL_CTX_memrestore_cert_cache(CYASSL_CTX*, const void*, int);
00310 CYASSL_API int  CyaSSL_CTX_get_cert_cache_memsize(CYASSL_CTX*);
00311 
00312 /* only supports full name from cipher_name[] delimited by : */
00313 CYASSL_API int  CyaSSL_CTX_set_cipher_list(CYASSL_CTX*, const char*);
00314 CYASSL_API int  CyaSSL_set_cipher_list(CYASSL*, const char*);
00315 
00316 /* Nonblocking DTLS helper functions */
00317 CYASSL_API int  CyaSSL_dtls_get_current_timeout(CYASSL* ssl);
00318 CYASSL_API int  CyaSSL_dtls_set_timeout_init(CYASSL* ssl, int);
00319 CYASSL_API int  CyaSSL_dtls_set_timeout_max(CYASSL* ssl, int);
00320 CYASSL_API int  CyaSSL_dtls_got_timeout(CYASSL* ssl);
00321 CYASSL_API int  CyaSSL_dtls(CYASSL* ssl);
00322 
00323 CYASSL_API int  CyaSSL_dtls_set_peer(CYASSL*, void*, unsigned int);
00324 CYASSL_API int  CyaSSL_dtls_get_peer(CYASSL*, void*, unsigned int*);
00325 
00326 CYASSL_API int   CyaSSL_ERR_GET_REASON(int err);
00327 CYASSL_API char* CyaSSL_ERR_error_string(unsigned long,char*);
00328 CYASSL_API void  CyaSSL_ERR_error_string_n(unsigned long e, char* buf,
00329                                            unsigned long sz);
00330 CYASSL_API const char* CyaSSL_ERR_reason_error_string(unsigned long);
00331 
00332 /* extras */
00333 
00334 #define STACK_OF(x) x
00335 
00336 CYASSL_API int  CyaSSL_set_ex_data(CYASSL*, int, void*);
00337 CYASSL_API int  CyaSSL_get_shutdown(const CYASSL*);
00338 CYASSL_API int  CyaSSL_set_rfd(CYASSL*, int);
00339 CYASSL_API int  CyaSSL_set_wfd(CYASSL*, int);
00340 CYASSL_API void CyaSSL_set_shutdown(CYASSL*, int);
00341 CYASSL_API int  CyaSSL_set_session_id_context(CYASSL*, const unsigned char*,
00342                                            unsigned int);
00343 CYASSL_API void CyaSSL_set_connect_state(CYASSL*);
00344 CYASSL_API void CyaSSL_set_accept_state(CYASSL*);
00345 CYASSL_API int  CyaSSL_session_reused(CYASSL*);
00346 CYASSL_API void CyaSSL_SESSION_free(CYASSL_SESSION* session);
00347 CYASSL_API int  CyaSSL_is_init_finished(CYASSL*);
00348 
00349 CYASSL_API const char*  CyaSSL_get_version(CYASSL*);
00350 CYASSL_API int  CyaSSL_get_current_cipher_suite(CYASSL* ssl);
00351 CYASSL_API CYASSL_CIPHER*  CyaSSL_get_current_cipher(CYASSL*);
00352 CYASSL_API char*        CyaSSL_CIPHER_description(CYASSL_CIPHER*, char*, int);
00353 CYASSL_API const char*  CyaSSL_CIPHER_get_name(const CYASSL_CIPHER* cipher);
00354 CYASSL_API const char*  CyaSSL_get_cipher(CYASSL*);
00355 CYASSL_API CYASSL_SESSION* CyaSSL_get1_session(CYASSL* ssl);
00356                            /* what's ref count */
00357 
00358 CYASSL_API void CyaSSL_X509_free(CYASSL_X509*);
00359 CYASSL_API void CyaSSL_OPENSSL_free(void*);
00360 
00361 CYASSL_API int CyaSSL_OCSP_parse_url(char* url, char** host, char** port,
00362                                      char** path, int* ssl);
00363 
00364 CYASSL_API CYASSL_METHOD* CyaSSLv23_client_method(void);
00365 CYASSL_API CYASSL_METHOD* CyaSSLv2_client_method(void);
00366 CYASSL_API CYASSL_METHOD* CyaSSLv2_server_method(void);
00367 
00368 CYASSL_API void CyaSSL_MD4_Init(CYASSL_MD4_CTX*);
00369 CYASSL_API void CyaSSL_MD4_Update(CYASSL_MD4_CTX*, const void*, unsigned long);
00370 CYASSL_API void CyaSSL_MD4_Final(unsigned char*, CYASSL_MD4_CTX*);
00371 
00372 
00373 CYASSL_API CYASSL_BIO* CyaSSL_BIO_new(CYASSL_BIO_METHOD*);
00374 CYASSL_API int  CyaSSL_BIO_free(CYASSL_BIO*);
00375 CYASSL_API int  CyaSSL_BIO_free_all(CYASSL_BIO*);
00376 CYASSL_API int  CyaSSL_BIO_read(CYASSL_BIO*, void*, int);
00377 CYASSL_API int  CyaSSL_BIO_write(CYASSL_BIO*, const void*, int);
00378 CYASSL_API CYASSL_BIO* CyaSSL_BIO_push(CYASSL_BIO*, CYASSL_BIO* append);
00379 CYASSL_API CYASSL_BIO* CyaSSL_BIO_pop(CYASSL_BIO*);
00380 CYASSL_API int  CyaSSL_BIO_flush(CYASSL_BIO*);
00381 CYASSL_API int  CyaSSL_BIO_pending(CYASSL_BIO*);
00382 
00383 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_f_buffer(void);
00384 CYASSL_API long CyaSSL_BIO_set_write_buffer_size(CYASSL_BIO*, long size);
00385 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_f_ssl(void);
00386 CYASSL_API CYASSL_BIO*        CyaSSL_BIO_new_socket(int sfd, int flag);
00387 CYASSL_API int         CyaSSL_BIO_eof(CYASSL_BIO*);
00388 
00389 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_s_mem(void);
00390 CYASSL_API CYASSL_BIO_METHOD* CyaSSL_BIO_f_base64(void);
00391 CYASSL_API void CyaSSL_BIO_set_flags(CYASSL_BIO*, int);
00392 
00393 CYASSL_API int CyaSSL_BIO_get_mem_data(CYASSL_BIO* bio,const unsigned char** p);
00394 CYASSL_API CYASSL_BIO* CyaSSL_BIO_new_mem_buf(void* buf, int len);
00395 
00396 
00397 CYASSL_API long        CyaSSL_BIO_set_ssl(CYASSL_BIO*, CYASSL*, int flag);
00398 CYASSL_API void        CyaSSL_set_bio(CYASSL*, CYASSL_BIO* rd, CYASSL_BIO* wr);
00399 
00400 CYASSL_API int  CyaSSL_add_all_algorithms(void);
00401 
00402 CYASSL_API void        CyaSSL_RAND_screen(void);
00403 CYASSL_API const char* CyaSSL_RAND_file_name(char*, unsigned long);
00404 CYASSL_API int         CyaSSL_RAND_write_file(const char*);
00405 CYASSL_API int         CyaSSL_RAND_load_file(const char*, long);
00406 CYASSL_API int         CyaSSL_RAND_egd(const char*);
00407 CYASSL_API int         CyaSSL_RAND_seed(const void*, int);
00408 CYASSL_API void        CyaSSL_RAND_add(const void*, int, double);
00409 
00410 CYASSL_API CYASSL_COMP_METHOD* CyaSSL_COMP_zlib(void);
00411 CYASSL_API CYASSL_COMP_METHOD* CyaSSL_COMP_rle(void);
00412 CYASSL_API int CyaSSL_COMP_add_compression_method(int, void*);
00413 
00414 CYASSL_API int CyaSSL_get_ex_new_index(long, void*, void*, void*, void*);
00415 
00416 CYASSL_API void CyaSSL_set_id_callback(unsigned long (*f)(void));
00417 CYASSL_API void CyaSSL_set_locking_callback(void (*f)(int, int, const char*,
00418                                                       int));
00419 CYASSL_API void CyaSSL_set_dynlock_create_callback(CYASSL_dynlock_value* (*f)
00420                                                    (const char*, int));
00421 CYASSL_API void CyaSSL_set_dynlock_lock_callback(void (*f)(int,
00422                                       CYASSL_dynlock_value*, const char*, int));
00423 CYASSL_API void CyaSSL_set_dynlock_destroy_callback(void (*f)
00424                                      (CYASSL_dynlock_value*, const char*, int));
00425 CYASSL_API int  CyaSSL_num_locks(void);
00426 
00427 CYASSL_API CYASSL_X509* CyaSSL_X509_STORE_CTX_get_current_cert(
00428                                                         CYASSL_X509_STORE_CTX*);
00429 CYASSL_API int   CyaSSL_X509_STORE_CTX_get_error(CYASSL_X509_STORE_CTX*);
00430 CYASSL_API int   CyaSSL_X509_STORE_CTX_get_error_depth(CYASSL_X509_STORE_CTX*);
00431 
00432 CYASSL_API char*       CyaSSL_X509_NAME_oneline(CYASSL_X509_NAME*, char*, int);
00433 CYASSL_API CYASSL_X509_NAME*  CyaSSL_X509_get_issuer_name(CYASSL_X509*);
00434 CYASSL_API CYASSL_X509_NAME*  CyaSSL_X509_get_subject_name(CYASSL_X509*);
00435 CYASSL_API int  CyaSSL_X509_ext_isSet_by_NID(CYASSL_X509*, int);
00436 CYASSL_API int  CyaSSL_X509_ext_get_critical_by_NID(CYASSL_X509*, int);
00437 CYASSL_API int  CyaSSL_X509_get_isCA(CYASSL_X509*);
00438 CYASSL_API int  CyaSSL_X509_get_isSet_pathLength(CYASSL_X509*);
00439 CYASSL_API unsigned int CyaSSL_X509_get_pathLength(CYASSL_X509*);
00440 CYASSL_API unsigned int CyaSSL_X509_get_keyUsage(CYASSL_X509*);
00441 CYASSL_API unsigned char* CyaSSL_X509_get_authorityKeyID(
00442                                             CYASSL_X509*, unsigned char*, int*);
00443 CYASSL_API unsigned char* CyaSSL_X509_get_subjectKeyID(
00444                                             CYASSL_X509*, unsigned char*, int*);
00445 CYASSL_API int CyaSSL_X509_NAME_entry_count(CYASSL_X509_NAME*);
00446 CYASSL_API int CyaSSL_X509_NAME_get_text_by_NID(
00447                                             CYASSL_X509_NAME*, int, char*, int);
00448 CYASSL_API int         CyaSSL_X509_verify_cert(CYASSL_X509_STORE_CTX*);
00449 CYASSL_API const char* CyaSSL_X509_verify_cert_error_string(long);
00450 CYASSL_API int CyaSSL_X509_get_signature_type(CYASSL_X509*);
00451 CYASSL_API int CyaSSL_X509_get_signature(CYASSL_X509*, unsigned char*, int*);
00452 
00453 CYASSL_API int CyaSSL_X509_LOOKUP_add_dir(CYASSL_X509_LOOKUP*,const char*,long);
00454 CYASSL_API int CyaSSL_X509_LOOKUP_load_file(CYASSL_X509_LOOKUP*, const char*,
00455                                             long);
00456 CYASSL_API CYASSL_X509_LOOKUP_METHOD* CyaSSL_X509_LOOKUP_hash_dir(void);
00457 CYASSL_API CYASSL_X509_LOOKUP_METHOD* CyaSSL_X509_LOOKUP_file(void);
00458 
00459 CYASSL_API CYASSL_X509_LOOKUP* CyaSSL_X509_STORE_add_lookup(CYASSL_X509_STORE*,
00460                                                     CYASSL_X509_LOOKUP_METHOD*);
00461 CYASSL_API CYASSL_X509_STORE*  CyaSSL_X509_STORE_new(void);
00462 CYASSL_API void         CyaSSL_X509_STORE_free(CYASSL_X509_STORE*);
00463 CYASSL_API int          CyaSSL_X509_STORE_add_cert(
00464                                               CYASSL_X509_STORE*, CYASSL_X509*);
00465 CYASSL_API int          CyaSSL_X509_STORE_set_default_paths(CYASSL_X509_STORE*);
00466 CYASSL_API int          CyaSSL_X509_STORE_get_by_subject(CYASSL_X509_STORE_CTX*,
00467                                    int, CYASSL_X509_NAME*, CYASSL_X509_OBJECT*);
00468 CYASSL_API CYASSL_X509_STORE_CTX* CyaSSL_X509_STORE_CTX_new(void);
00469 CYASSL_API int  CyaSSL_X509_STORE_CTX_init(CYASSL_X509_STORE_CTX*,
00470                       CYASSL_X509_STORE*, CYASSL_X509*, STACK_OF(CYASSL_X509)*);
00471 CYASSL_API void CyaSSL_X509_STORE_CTX_free(CYASSL_X509_STORE_CTX*);
00472 CYASSL_API void CyaSSL_X509_STORE_CTX_cleanup(CYASSL_X509_STORE_CTX*);
00473 
00474 CYASSL_API CYASSL_ASN1_TIME* CyaSSL_X509_CRL_get_lastUpdate(CYASSL_X509_CRL*);
00475 CYASSL_API CYASSL_ASN1_TIME* CyaSSL_X509_CRL_get_nextUpdate(CYASSL_X509_CRL*);
00476 
00477 CYASSL_API CYASSL_EVP_PKEY* CyaSSL_X509_get_pubkey(CYASSL_X509*);
00478 CYASSL_API int       CyaSSL_X509_CRL_verify(CYASSL_X509_CRL*, CYASSL_EVP_PKEY*);
00479 CYASSL_API void      CyaSSL_X509_STORE_CTX_set_error(CYASSL_X509_STORE_CTX*,
00480                                                      int);
00481 CYASSL_API void      CyaSSL_X509_OBJECT_free_contents(CYASSL_X509_OBJECT*);
00482 CYASSL_API void      CyaSSL_EVP_PKEY_free(CYASSL_EVP_PKEY*);
00483 CYASSL_API int       CyaSSL_X509_cmp_current_time(const CYASSL_ASN1_TIME*);
00484 CYASSL_API int       CyaSSL_sk_X509_REVOKED_num(CYASSL_X509_REVOKED*);
00485 
00486 CYASSL_API CYASSL_X509_REVOKED* CyaSSL_X509_CRL_get_REVOKED(CYASSL_X509_CRL*);
00487 CYASSL_API CYASSL_X509_REVOKED* CyaSSL_sk_X509_REVOKED_value(
00488                                                       CYASSL_X509_REVOKED*,int);
00489 CYASSL_API CYASSL_ASN1_INTEGER* CyaSSL_X509_get_serialNumber(CYASSL_X509*);
00490 
00491 CYASSL_API int CyaSSL_ASN1_TIME_print(CYASSL_BIO*, const CYASSL_ASN1_TIME*);
00492 
00493 CYASSL_API int  CyaSSL_ASN1_INTEGER_cmp(const CYASSL_ASN1_INTEGER*,
00494                                        const CYASSL_ASN1_INTEGER*);
00495 CYASSL_API long CyaSSL_ASN1_INTEGER_get(const CYASSL_ASN1_INTEGER*);
00496 
00497 CYASSL_API STACK_OF(CYASSL_X509_NAME)* CyaSSL_load_client_CA_file(const char*);
00498 
00499 CYASSL_API void  CyaSSL_CTX_set_client_CA_list(CYASSL_CTX*,
00500                                                STACK_OF(CYASSL_X509_NAME)*);
00501 CYASSL_API void* CyaSSL_X509_STORE_CTX_get_ex_data(CYASSL_X509_STORE_CTX*, int);
00502 CYASSL_API int   CyaSSL_get_ex_data_X509_STORE_CTX_idx(void);
00503 CYASSL_API void* CyaSSL_get_ex_data(const CYASSL*, int);
00504 
00505 CYASSL_API void CyaSSL_CTX_set_default_passwd_cb_userdata(CYASSL_CTX*,
00506                                                           void* userdata);
00507 CYASSL_API void CyaSSL_CTX_set_default_passwd_cb(CYASSL_CTX*, pem_password_cb);
00508 
00509 
00510 CYASSL_API void CyaSSL_CTX_set_info_callback(CYASSL_CTX*, void (*)(void));
00511 
00512 CYASSL_API unsigned long CyaSSL_ERR_peek_error(void);
00513 CYASSL_API int           CyaSSL_GET_REASON(int);
00514 
00515 CYASSL_API char* CyaSSL_alert_type_string_long(int);
00516 CYASSL_API char* CyaSSL_alert_desc_string_long(int);
00517 CYASSL_API char* CyaSSL_state_string_long(CYASSL*);
00518 
00519 CYASSL_API CYASSL_RSA* CyaSSL_RSA_generate_key(int, unsigned long,
00520                                                void(*)(int, int, void*), void*);
00521 CYASSL_API void CyaSSL_CTX_set_tmp_rsa_callback(CYASSL_CTX*,
00522                                              CYASSL_RSA*(*)(CYASSL*, int, int));
00523 
00524 CYASSL_API int CyaSSL_PEM_def_callback(char*, int num, int w, void* key);
00525 
00526 CYASSL_API long CyaSSL_CTX_sess_accept(CYASSL_CTX*);
00527 CYASSL_API long CyaSSL_CTX_sess_connect(CYASSL_CTX*);
00528 CYASSL_API long CyaSSL_CTX_sess_accept_good(CYASSL_CTX*);
00529 CYASSL_API long CyaSSL_CTX_sess_connect_good(CYASSL_CTX*);
00530 CYASSL_API long CyaSSL_CTX_sess_accept_renegotiate(CYASSL_CTX*);
00531 CYASSL_API long CyaSSL_CTX_sess_connect_renegotiate(CYASSL_CTX*);
00532 CYASSL_API long CyaSSL_CTX_sess_hits(CYASSL_CTX*);
00533 CYASSL_API long CyaSSL_CTX_sess_cb_hits(CYASSL_CTX*);
00534 CYASSL_API long CyaSSL_CTX_sess_cache_full(CYASSL_CTX*);
00535 CYASSL_API long CyaSSL_CTX_sess_misses(CYASSL_CTX*);
00536 CYASSL_API long CyaSSL_CTX_sess_timeouts(CYASSL_CTX*);
00537 CYASSL_API long CyaSSL_CTX_sess_number(CYASSL_CTX*);
00538 CYASSL_API long CyaSSL_CTX_sess_get_cache_size(CYASSL_CTX*);
00539 
00540 #define CYASSL_DEFAULT_CIPHER_LIST ""   /* default all */
00541 #define CYASSL_RSA_F4 0x10001L
00542 
00543 enum {
00544     OCSP_NOCERTS     = 1,
00545     OCSP_NOINTERN    = 2,
00546     OCSP_NOSIGS      = 4,
00547     OCSP_NOCHAIN     = 8,
00548     OCSP_NOVERIFY    = 16,
00549     OCSP_NOEXPLICIT  = 32,
00550     OCSP_NOCASIGN    = 64,
00551     OCSP_NODELEGATED = 128,
00552     OCSP_NOCHECKS    = 256,
00553     OCSP_TRUSTOTHER  = 512,
00554     OCSP_RESPID_KEY  = 1024,
00555     OCSP_NOTIME      = 2048,
00556 
00557     OCSP_CERTID   = 2,
00558     OCSP_REQUEST  = 4,
00559     OCSP_RESPONSE = 8,
00560     OCSP_BASICRESP = 16,
00561 
00562     CYASSL_OCSP_URL_OVERRIDE = 1,
00563     CYASSL_OCSP_NO_NONCE     = 2,
00564 
00565     CYASSL_CRL_CHECKALL = 1,
00566 
00567     ASN1_GENERALIZEDTIME = 4,
00568 
00569     SSL_OP_MICROSOFT_SESS_ID_BUG = 1,
00570     SSL_OP_NETSCAPE_CHALLENGE_BUG = 2,
00571     SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG = 3,
00572     SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG = 4,
00573     SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER = 5,
00574     SSL_OP_MSIE_SSLV2_RSA_PADDING = 6,
00575     SSL_OP_SSLEAY_080_CLIENT_DH_BUG = 7,
00576     SSL_OP_TLS_D5_BUG = 8,
00577     SSL_OP_TLS_BLOCK_PADDING_BUG = 9,
00578     SSL_OP_TLS_ROLLBACK_BUG = 10,
00579     SSL_OP_ALL = 11,
00580     SSL_OP_EPHEMERAL_RSA = 12,
00581     SSL_OP_NO_SSLv3 = 13,
00582     SSL_OP_NO_TLSv1 = 14,
00583     SSL_OP_PKCS1_CHECK_1 = 15,
00584     SSL_OP_PKCS1_CHECK_2 = 16,
00585     SSL_OP_NETSCAPE_CA_DN_BUG = 17,
00586     SSL_OP_NETSCAPE_DEMO_CIPHER_CHANGE_BUG = 18,
00587     SSL_OP_SINGLE_DH_USE = 19,
00588     SSL_OP_NO_TICKET = 20,
00589     SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS = 21,
00590     SSL_OP_NO_QUERY_MTU = 22,
00591     SSL_OP_COOKIE_EXCHANGE = 23,
00592     SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION = 24,
00593     SSL_OP_SINGLE_ECDH_USE = 25,
00594     SSL_OP_CIPHER_SERVER_PREFERENCE = 26,
00595 
00596     SSL_MAX_SSL_SESSION_ID_LENGTH = 32,
00597 
00598     EVP_R_BAD_DECRYPT = 2,
00599 
00600     SSL_CB_LOOP = 4,
00601     SSL_ST_CONNECT = 5,
00602     SSL_ST_ACCEPT  = 6,
00603     SSL_CB_ALERT   = 7,
00604     SSL_CB_READ    = 8,
00605     SSL_CB_HANDSHAKE_DONE = 9,
00606 
00607     SSL_MODE_ENABLE_PARTIAL_WRITE = 2,
00608 
00609     BIO_FLAGS_BASE64_NO_NL = 1,
00610     BIO_CLOSE   = 1,
00611     BIO_NOCLOSE = 0,
00612 
00613     NID_undef = 0,
00614 
00615     X509_FILETYPE_PEM = 8,
00616     X509_LU_X509      = 9,
00617     X509_LU_CRL       = 12,
00618     
00619     X509_V_ERR_CRL_SIGNATURE_FAILURE = 13,
00620     X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD = 14,
00621     X509_V_ERR_CRL_HAS_EXPIRED                = 15,
00622     X509_V_ERR_CERT_REVOKED                   = 16,
00623     X509_V_ERR_CERT_CHAIN_TOO_LONG            = 17,
00624     X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT      = 18,
00625     X509_V_ERR_CERT_NOT_YET_VALID             = 19,
00626     X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD = 20,
00627     X509_V_ERR_CERT_HAS_EXPIRED               = 21,
00628     X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD  = 22,
00629 
00630     X509_V_OK = 0,
00631 
00632     CRYPTO_LOCK = 1,
00633     CRYPTO_NUM_LOCKS = 10
00634 };
00635 
00636 /* extras end */
00637 
00638 #if !defined(NO_FILESYSTEM) && !defined(NO_STDIO_FILESYSTEM)
00639 /* CyaSSL extension, provide last error from SSL_get_error
00640    since not using thread storage error queue */
00641 CYASSL_API void  CyaSSL_ERR_print_errors_fp(FILE*, int err);
00642 #endif
00643 
00644 enum { /* ssl Constants */
00645     SSL_ERROR_NONE      =  0,   /* for most functions */
00646     SSL_FAILURE         =  0,   /* for some functions */
00647     SSL_SUCCESS         =  1,
00648 
00649     SSL_BAD_CERTTYPE    = -8,
00650     SSL_BAD_STAT        = -7,
00651     SSL_BAD_PATH        = -6,
00652     SSL_BAD_FILETYPE    = -5,
00653     SSL_BAD_FILE        = -4,
00654     SSL_NOT_IMPLEMENTED = -3,
00655     SSL_UNKNOWN         = -2,
00656     SSL_FATAL_ERROR     = -1,
00657 
00658     SSL_FILETYPE_ASN1    = 2,
00659     SSL_FILETYPE_PEM     = 1,
00660     SSL_FILETYPE_DEFAULT = 2, /* ASN1 */
00661     SSL_FILETYPE_RAW     = 3, /* NTRU raw key blob */
00662 
00663     SSL_VERIFY_NONE                 = 0,
00664     SSL_VERIFY_PEER                 = 1,
00665     SSL_VERIFY_FAIL_IF_NO_PEER_CERT = 2,
00666     SSL_VERIFY_CLIENT_ONCE          = 4,
00667 
00668     SSL_SESS_CACHE_OFF                = 30,
00669     SSL_SESS_CACHE_CLIENT             = 31,
00670     SSL_SESS_CACHE_SERVER             = 32,
00671     SSL_SESS_CACHE_BOTH               = 33,
00672     SSL_SESS_CACHE_NO_AUTO_CLEAR      = 34,
00673     SSL_SESS_CACHE_NO_INTERNAL_LOOKUP = 35,
00674 
00675     SSL_ERROR_WANT_READ        =  2,
00676     SSL_ERROR_WANT_WRITE       =  3,
00677     SSL_ERROR_WANT_CONNECT     =  7,
00678     SSL_ERROR_WANT_ACCEPT      =  8,
00679     SSL_ERROR_SYSCALL          =  5,
00680     SSL_ERROR_WANT_X509_LOOKUP = 83,
00681     SSL_ERROR_ZERO_RETURN      =  6,
00682     SSL_ERROR_SSL              = 85,
00683 
00684     SSL_SENT_SHUTDOWN     = 1,
00685     SSL_RECEIVED_SHUTDOWN = 2,
00686     SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER = 4,
00687     SSL_OP_NO_SSLv2       = 8,
00688 
00689     SSL_R_SSL_HANDSHAKE_FAILURE           = 101,
00690     SSL_R_TLSV1_ALERT_UNKNOWN_CA          = 102,
00691     SSL_R_SSLV3_ALERT_CERTIFICATE_UNKNOWN = 103,
00692     SSL_R_SSLV3_ALERT_BAD_CERTIFICATE     = 104,
00693 
00694     PEM_BUFSIZE = 1024
00695 };
00696 
00697 
00698 #ifndef NO_PSK
00699     typedef unsigned int (*psk_client_callback)(CYASSL*, const char*, char*,
00700                                     unsigned int, unsigned char*, unsigned int);
00701     CYASSL_API void CyaSSL_CTX_set_psk_client_callback(CYASSL_CTX*,
00702                                                     psk_client_callback);
00703     CYASSL_API void CyaSSL_set_psk_client_callback(CYASSL*,psk_client_callback);
00704 
00705     CYASSL_API const char* CyaSSL_get_psk_identity_hint(const CYASSL*);
00706     CYASSL_API const char* CyaSSL_get_psk_identity(const CYASSL*);
00707 
00708     CYASSL_API int CyaSSL_CTX_use_psk_identity_hint(CYASSL_CTX*, const char*);
00709     CYASSL_API int CyaSSL_use_psk_identity_hint(CYASSL*, const char*);
00710 
00711     typedef unsigned int (*psk_server_callback)(CYASSL*, const char*,
00712                           unsigned char*, unsigned int);
00713     CYASSL_API void CyaSSL_CTX_set_psk_server_callback(CYASSL_CTX*,
00714                                                     psk_server_callback);
00715     CYASSL_API void CyaSSL_set_psk_server_callback(CYASSL*,psk_server_callback);
00716 
00717     #define PSK_TYPES_DEFINED
00718 #endif /* NO_PSK */
00719 
00720 
00721 #ifdef HAVE_ANON
00722     CYASSL_API int CyaSSL_CTX_allow_anon_cipher(CYASSL_CTX*);
00723 #endif /* HAVE_ANON */
00724 
00725 
00726 /* extra begins */
00727 
00728 enum {  /* ERR Constants */
00729     ERR_TXT_STRING = 1
00730 };
00731 
00732 CYASSL_API unsigned long CyaSSL_ERR_get_error_line_data(const char**, int*,
00733                                                  const char**, int *);
00734 
00735 CYASSL_API unsigned long CyaSSL_ERR_get_error(void);
00736 CYASSL_API void          CyaSSL_ERR_clear_error(void);
00737 
00738 
00739 CYASSL_API int  CyaSSL_RAND_status(void);
00740 CYASSL_API int  CyaSSL_RAND_bytes(unsigned char* buf, int num);
00741 CYASSL_API CYASSL_METHOD *CyaSSLv23_server_method(void);
00742 CYASSL_API long CyaSSL_CTX_set_options(CYASSL_CTX*, long);
00743 #ifndef NO_CERTS
00744   CYASSL_API int  CyaSSL_CTX_check_private_key(CYASSL_CTX*);
00745 #endif /* !NO_CERTS */
00746 
00747 CYASSL_API void CyaSSL_ERR_free_strings(void);
00748 CYASSL_API void CyaSSL_ERR_remove_state(unsigned long);
00749 CYASSL_API void CyaSSL_EVP_cleanup(void);
00750 
00751 CYASSL_API void CyaSSL_cleanup_all_ex_data(void);
00752 CYASSL_API long CyaSSL_CTX_set_mode(CYASSL_CTX* ctx, long mode);
00753 CYASSL_API long CyaSSL_CTX_get_mode(CYASSL_CTX* ctx);
00754 CYASSL_API void CyaSSL_CTX_set_default_read_ahead(CYASSL_CTX* ctx, int m);
00755 
00756 CYASSL_API long CyaSSL_CTX_sess_set_cache_size(CYASSL_CTX*, long);
00757 
00758 CYASSL_API int  CyaSSL_CTX_set_default_verify_paths(CYASSL_CTX*);
00759 CYASSL_API int  CyaSSL_CTX_set_session_id_context(CYASSL_CTX*,
00760                                             const unsigned char*, unsigned int);
00761 CYASSL_API CYASSL_X509* CyaSSL_get_peer_certificate(CYASSL* ssl);
00762 
00763 CYASSL_API int CyaSSL_want_read(CYASSL*);
00764 CYASSL_API int CyaSSL_want_write(CYASSL*);
00765 
00766 CYASSL_API int CyaSSL_BIO_printf(CYASSL_BIO*, const char*, ...);
00767 CYASSL_API int CyaSSL_ASN1_UTCTIME_print(CYASSL_BIO*,
00768                                          const CYASSL_ASN1_UTCTIME*);
00769 CYASSL_API int   CyaSSL_sk_num(CYASSL_X509_REVOKED*);
00770 CYASSL_API void* CyaSSL_sk_value(CYASSL_X509_REVOKED*, int);
00771 
00772 /* stunnel 4.28 needs */
00773 CYASSL_API void* CyaSSL_CTX_get_ex_data(const CYASSL_CTX*, int);
00774 CYASSL_API int   CyaSSL_CTX_set_ex_data(CYASSL_CTX*, int, void*);
00775 CYASSL_API void  CyaSSL_CTX_sess_set_get_cb(CYASSL_CTX*,
00776                        CYASSL_SESSION*(*f)(CYASSL*, unsigned char*, int, int*));
00777 CYASSL_API void  CyaSSL_CTX_sess_set_new_cb(CYASSL_CTX*,
00778                                             int (*f)(CYASSL*, CYASSL_SESSION*));
00779 CYASSL_API void  CyaSSL_CTX_sess_set_remove_cb(CYASSL_CTX*,
00780                                        void (*f)(CYASSL_CTX*, CYASSL_SESSION*));
00781 
00782 CYASSL_API int          CyaSSL_i2d_SSL_SESSION(CYASSL_SESSION*,unsigned char**);
00783 CYASSL_API CYASSL_SESSION* CyaSSL_d2i_SSL_SESSION(CYASSL_SESSION**,
00784                                                    const unsigned char**, long);
00785 
00786 CYASSL_API long CyaSSL_SESSION_get_timeout(const CYASSL_SESSION*);
00787 CYASSL_API long CyaSSL_SESSION_get_time(const CYASSL_SESSION*);
00788 CYASSL_API int  CyaSSL_CTX_get_ex_new_index(long, void*, void*, void*, void*);
00789 
00790 /* extra ends */
00791 
00792 
00793 /* CyaSSL extensions */
00794 
00795 /* call before SSL_connect, if verifying will add name check to
00796    date check and signature check */
00797 CYASSL_API int CyaSSL_check_domain_name(CYASSL* ssl, const char* dn);
00798 
00799 /* need to call once to load library (session cache) */
00800 CYASSL_API int CyaSSL_Init(void);
00801 /* call when done to cleanup/free session cache mutex / resources  */
00802 CYASSL_API int CyaSSL_Cleanup(void);
00803 
00804 /* turn logging on, only if compiled in */
00805 CYASSL_API int  CyaSSL_Debugging_ON(void);
00806 /* turn logging off */
00807 CYASSL_API void CyaSSL_Debugging_OFF(void);
00808 
00809 /* do accept or connect depedning on side */
00810 CYASSL_API int CyaSSL_negotiate(CYASSL* ssl);
00811 /* turn on CyaSSL data compression */
00812 CYASSL_API int CyaSSL_set_compression(CYASSL* ssl);
00813 
00814 CYASSL_API int CyaSSL_set_timeout(CYASSL*, unsigned int);
00815 CYASSL_API int CyaSSL_CTX_set_timeout(CYASSL_CTX*, unsigned int);
00816 
00817 /* get CyaSSL peer X509_CHAIN */
00818 CYASSL_API CYASSL_X509_CHAIN* CyaSSL_get_peer_chain(CYASSL* ssl);
00819 /* peer chain count */
00820 CYASSL_API int  CyaSSL_get_chain_count(CYASSL_X509_CHAIN* chain);
00821 /* index cert length */
00822 CYASSL_API int  CyaSSL_get_chain_length(CYASSL_X509_CHAIN*, int idx);
00823 /* index cert */
00824 CYASSL_API unsigned char* CyaSSL_get_chain_cert(CYASSL_X509_CHAIN*, int idx);
00825 /* index cert in X509 */
00826 CYASSL_API CYASSL_X509* CyaSSL_get_chain_X509(CYASSL_X509_CHAIN*, int idx);
00827 /* free X509 */
00828 CYASSL_API void CyaSSL_FreeX509(CYASSL_X509*);
00829 /* get index cert in PEM */
00830 CYASSL_API int  CyaSSL_get_chain_cert_pem(CYASSL_X509_CHAIN*, int idx,
00831                                 unsigned char* buffer, int inLen, int* outLen);
00832 CYASSL_API const unsigned char* CyaSSL_get_sessionID(const CYASSL_SESSION* s);
00833 CYASSL_API int  CyaSSL_X509_get_serial_number(CYASSL_X509*,unsigned char*,int*);
00834 CYASSL_API char*  CyaSSL_X509_get_subjectCN(CYASSL_X509*);
00835 CYASSL_API const unsigned char* CyaSSL_X509_get_der(CYASSL_X509*, int*);
00836 CYASSL_API const unsigned char* CyaSSL_X509_notBefore(CYASSL_X509*);
00837 CYASSL_API const unsigned char* CyaSSL_X509_notAfter(CYASSL_X509*);
00838 CYASSL_API int CyaSSL_X509_version(CYASSL_X509*);
00839 CYASSL_API 
00840 
00841 CYASSL_API int CyaSSL_cmp_peer_cert_to_file(CYASSL*, const char*);
00842 
00843 CYASSL_API char* CyaSSL_X509_get_next_altname(CYASSL_X509*);
00844 
00845 CYASSL_API CYASSL_X509*
00846     CyaSSL_X509_d2i(CYASSL_X509** x509, const unsigned char* in, int len);
00847 #ifndef NO_FILESYSTEM
00848     #ifndef NO_STDIO_FILESYSTEM
00849     CYASSL_API CYASSL_X509*
00850         CyaSSL_X509_d2i_fp(CYASSL_X509** x509, FILE* file);
00851     #endif
00852 CYASSL_API CYASSL_X509*
00853     CyaSSL_X509_load_certificate_file(const char* fname, int format);
00854 #endif
00855 
00856 #ifdef CYASSL_SEP
00857     CYASSL_API unsigned char*
00858            CyaSSL_X509_get_device_type(CYASSL_X509*, unsigned char*, int*);
00859     CYASSL_API unsigned char*
00860            CyaSSL_X509_get_hw_type(CYASSL_X509*, unsigned char*, int*);
00861     CYASSL_API unsigned char*
00862            CyaSSL_X509_get_hw_serial_number(CYASSL_X509*, unsigned char*, int*);
00863 #endif
00864 
00865 /* connect enough to get peer cert */
00866 CYASSL_API int  CyaSSL_connect_cert(CYASSL* ssl);
00867 
00868 /* XXX This should be #ifndef NO_DH */
00869 #ifndef NO_CERTS
00870 /* server Diffie-Hellman parameters */
00871 CYASSL_API int  CyaSSL_SetTmpDH(CYASSL*, const unsigned char* p, int pSz,
00872                                 const unsigned char* g, int gSz);
00873 CYASSL_API int  CyaSSL_SetTmpDH_buffer(CYASSL*, const unsigned char* b, long sz,
00874                                        int format);
00875 CYASSL_API int  CyaSSL_SetTmpEC_DHE_Sz(CYASSL*, unsigned short);
00876 #ifndef NO_FILESYSTEM
00877     CYASSL_API int  CyaSSL_SetTmpDH_file(CYASSL*, const char* f, int format);
00878 #endif
00879 
00880 /* server ctx Diffie-Hellman parameters */
00881 CYASSL_API int  CyaSSL_CTX_SetTmpDH(CYASSL_CTX*, const unsigned char* p,
00882                                     int pSz, const unsigned char* g, int gSz);
00883 CYASSL_API int  CyaSSL_CTX_SetTmpDH_buffer(CYASSL_CTX*, const unsigned char* b,
00884                                            long sz, int format);
00885 CYASSL_API int  CyaSSL_CTX_SetTmpEC_DHE_Sz(CYASSL_CTX*, unsigned short);
00886 
00887 #ifndef NO_FILESYSTEM
00888     CYASSL_API int  CyaSSL_CTX_SetTmpDH_file(CYASSL_CTX*, const char* f,
00889                                              int format);
00890 #endif
00891 #endif
00892 
00893 /* keyblock size in bytes or -1 */
00894 /* need to call CyaSSL_KeepArrays before handshake to save keys */
00895 CYASSL_API int CyaSSL_get_keyblock_size(CYASSL*);
00896 CYASSL_API int CyaSSL_get_keys(CYASSL*,unsigned char** ms, unsigned int* msLen,
00897                                        unsigned char** sr, unsigned int* srLen,
00898                                        unsigned char** cr, unsigned int* crLen);
00899 
00900 /* Computes EAP-TLS and EAP-TTLS keying material from the master_secret. */
00901 CYASSL_API int CyaSSL_make_eap_keys(CYASSL*, void* key, unsigned int len, 
00902                                                              const char* label);
00903 
00904 
00905 #ifndef _WIN32
00906     #ifndef NO_WRITEV
00907         #ifdef __PPU
00908             #include <sys/types.h>
00909             #include <sys/socket.h>
00910         #elif !defined(CYASSL_MDK_ARM) && !defined(CYASSL_IAR_ARM)
00911             #include <sys/uio.h>
00912         #endif
00913         /* allow writev style writing */
00914         CYASSL_API int CyaSSL_writev(CYASSL* ssl, const struct iovec* iov,
00915                                      int iovcnt);
00916     #endif
00917 #endif
00918 
00919 
00920 #ifndef NO_CERTS
00921     /* SSL_CTX versions */
00922     CYASSL_API int CyaSSL_CTX_UnloadCAs(CYASSL_CTX*);
00923     CYASSL_API int CyaSSL_CTX_load_verify_buffer(CYASSL_CTX*, 
00924                                                const unsigned char*, long, int);
00925     CYASSL_API int CyaSSL_CTX_use_certificate_buffer(CYASSL_CTX*,
00926                                                const unsigned char*, long, int);
00927     CYASSL_API int CyaSSL_CTX_use_PrivateKey_buffer(CYASSL_CTX*,
00928                                                const unsigned char*, long, int);
00929     CYASSL_API int CyaSSL_CTX_use_certificate_chain_buffer(CYASSL_CTX*, 
00930                                                     const unsigned char*, long);
00931 
00932     /* SSL versions */
00933     CYASSL_API int CyaSSL_use_certificate_buffer(CYASSL*, const unsigned char*,
00934                                                long, int);
00935     CYASSL_API int CyaSSL_use_PrivateKey_buffer(CYASSL*, const unsigned char*,
00936                                                long, int);
00937     CYASSL_API int CyaSSL_use_certificate_chain_buffer(CYASSL*, 
00938                                                const unsigned char*, long);
00939     CYASSL_API int CyaSSL_UnloadCertsKeys(CYASSL*);
00940 #endif
00941 
00942 CYASSL_API int CyaSSL_CTX_set_group_messages(CYASSL_CTX*);
00943 CYASSL_API int CyaSSL_set_group_messages(CYASSL*);
00944 
00945 /* I/O callbacks */
00946 typedef int (*CallbackIORecv)(CYASSL *ssl, char *buf, int sz, void *ctx);
00947 typedef int (*CallbackIOSend)(CYASSL *ssl, char *buf, int sz, void *ctx);
00948 
00949 #ifdef HAVE_FUZZER
00950 enum fuzzer_type {
00951     FUZZ_HMAC      = 0,
00952     FUZZ_ENCRYPT   = 1,
00953     FUZZ_SIGNATURE = 2,
00954     FUZZ_HASH      = 3,
00955     FUZZ_HEAD      = 4
00956 };
00957 
00958 typedef int (*CallbackFuzzer)(CYASSL* ssl, const unsigned char* buf, int sz,
00959         int type, void* fuzzCtx);
00960 
00961 CYASSL_API void CyaSSL_SetFuzzerCb(CYASSL* ssl, CallbackFuzzer cbf, void* fCtx);
00962 #endif
00963 
00964 CYASSL_API void CyaSSL_SetIORecv(CYASSL_CTX*, CallbackIORecv);
00965 CYASSL_API void CyaSSL_SetIOSend(CYASSL_CTX*, CallbackIOSend);
00966 
00967 CYASSL_API void CyaSSL_SetIOReadCtx( CYASSL* ssl, void *ctx);
00968 CYASSL_API void CyaSSL_SetIOWriteCtx(CYASSL* ssl, void *ctx);
00969 
00970 CYASSL_API void* CyaSSL_GetIOReadCtx( CYASSL* ssl);
00971 CYASSL_API void* CyaSSL_GetIOWriteCtx(CYASSL* ssl);
00972 
00973 CYASSL_API void CyaSSL_SetIOReadFlags( CYASSL* ssl, int flags);
00974 CYASSL_API void CyaSSL_SetIOWriteFlags(CYASSL* ssl, int flags);
00975 
00976 
00977 #ifndef CYASSL_USER_IO
00978     /* default IO callbacks */
00979     CYASSL_API int EmbedReceive(CYASSL* ssl, char* buf, int sz, void* ctx);
00980     CYASSL_API int EmbedSend(CYASSL* ssl, char* buf, int sz, void* ctx);
00981 
00982     #ifdef HAVE_OCSP
00983         CYASSL_API int EmbedOcspLookup(void*, const char*, int, unsigned char*,
00984                                        int, unsigned char**);
00985         CYASSL_API void EmbedOcspRespFree(void*, unsigned char*);
00986     #endif
00987 
00988     #ifdef CYASSL_DTLS
00989         CYASSL_API int EmbedReceiveFrom(CYASSL* ssl, char* buf, int sz, void*);
00990         CYASSL_API int EmbedSendTo(CYASSL* ssl, char* buf, int sz, void* ctx);
00991         CYASSL_API int EmbedGenerateCookie(CYASSL* ssl, unsigned char* buf,
00992                                            int sz, void*);
00993     #endif /* CYASSL_DTLS */
00994 #endif /* CYASSL_USER_IO */
00995 
00996 
00997 #ifdef HAVE_NETX
00998     CYASSL_API void CyaSSL_SetIO_NetX(CYASSL* ssl, NX_TCP_SOCKET* nxsocket,
00999                                       ULONG waitoption);
01000 #endif
01001 
01002 typedef int (*CallbackGenCookie)(CYASSL* ssl, unsigned char* buf, int sz,
01003                                  void* ctx);
01004 CYASSL_API void  CyaSSL_CTX_SetGenCookie(CYASSL_CTX*, CallbackGenCookie);
01005 CYASSL_API void  CyaSSL_SetCookieCtx(CYASSL* ssl, void *ctx);
01006 CYASSL_API void* CyaSSL_GetCookieCtx(CYASSL* ssl);
01007 
01008 
01009 /* I/O Callback default errors */
01010 enum IOerrors {
01011     CYASSL_CBIO_ERR_GENERAL    = -1,     /* general unexpected err */
01012     CYASSL_CBIO_ERR_WANT_READ  = -2,     /* need to call read  again */
01013     CYASSL_CBIO_ERR_WANT_WRITE = -2,     /* need to call write again */
01014     CYASSL_CBIO_ERR_CONN_RST   = -3,     /* connection reset */
01015     CYASSL_CBIO_ERR_ISR        = -4,     /* interrupt */
01016     CYASSL_CBIO_ERR_CONN_CLOSE = -5,     /* connection closed or epipe */
01017     CYASSL_CBIO_ERR_TIMEOUT    = -6      /* socket timeout */
01018 };
01019 
01020 
01021 /* CA cache callbacks */
01022 enum {
01023     CYASSL_SSLV3    = 0,
01024     CYASSL_TLSV1    = 1,
01025     CYASSL_TLSV1_1  = 2,
01026     CYASSL_TLSV1_2  = 3,
01027     CYASSL_USER_CA  = 1,          /* user added as trusted */
01028     CYASSL_CHAIN_CA = 2           /* added to cache from trusted chain */
01029 };
01030 
01031 CYASSL_API int CyaSSL_SetMinVersion(CYASSL* ssl, int version);
01032 CYASSL_API int CyaSSL_GetObjectSize(void);  /* object size based on build */
01033 CYASSL_API int CyaSSL_SetVersion(CYASSL* ssl, int version);
01034 CYASSL_API int CyaSSL_KeyPemToDer(const unsigned char*, int sz, unsigned char*,
01035                                   int, const char*);
01036 CYASSL_API int CyaSSL_CertPemToDer(const unsigned char*, int sz, unsigned char*,
01037                                    int, int);
01038 
01039 typedef void (*CallbackCACache)(unsigned char* der, int sz, int type);
01040 typedef void (*CbMissingCRL)(const char* url);
01041 typedef int  (*CbOCSPIO)(void*, const char*, int,
01042                                          unsigned char*, int, unsigned char**);
01043 typedef void (*CbOCSPRespFree)(void*,unsigned char*);
01044 
01045 /* User Atomic Record Layer CallBacks */
01046 typedef int (*CallbackMacEncrypt)(CYASSL* ssl, unsigned char* macOut, 
01047        const unsigned char* macIn, unsigned int macInSz, int macContent, 
01048        int macVerify, unsigned char* encOut, const unsigned char* encIn,
01049        unsigned int encSz, void* ctx);
01050 CYASSL_API void  CyaSSL_CTX_SetMacEncryptCb(CYASSL_CTX*, CallbackMacEncrypt);
01051 CYASSL_API void  CyaSSL_SetMacEncryptCtx(CYASSL* ssl, void *ctx);
01052 CYASSL_API void* CyaSSL_GetMacEncryptCtx(CYASSL* ssl);
01053 
01054 typedef int (*CallbackDecryptVerify)(CYASSL* ssl, 
01055        unsigned char* decOut, const unsigned char* decIn,
01056        unsigned int decSz, int content, int verify, unsigned int* padSz,
01057        void* ctx);
01058 CYASSL_API void  CyaSSL_CTX_SetDecryptVerifyCb(CYASSL_CTX*,
01059                                                CallbackDecryptVerify);
01060 CYASSL_API void  CyaSSL_SetDecryptVerifyCtx(CYASSL* ssl, void *ctx);
01061 CYASSL_API void* CyaSSL_GetDecryptVerifyCtx(CYASSL* ssl);
01062 
01063 CYASSL_API const unsigned char* CyaSSL_GetMacSecret(CYASSL*, int);
01064 CYASSL_API const unsigned char* CyaSSL_GetClientWriteKey(CYASSL*);
01065 CYASSL_API const unsigned char* CyaSSL_GetClientWriteIV(CYASSL*);
01066 CYASSL_API const unsigned char* CyaSSL_GetServerWriteKey(CYASSL*);
01067 CYASSL_API const unsigned char* CyaSSL_GetServerWriteIV(CYASSL*);
01068 CYASSL_API int                  CyaSSL_GetKeySize(CYASSL*);
01069 CYASSL_API int                  CyaSSL_GetIVSize(CYASSL*);
01070 CYASSL_API int                  CyaSSL_GetSide(CYASSL*);
01071 CYASSL_API int                  CyaSSL_IsTLSv1_1(CYASSL*);
01072 CYASSL_API int                  CyaSSL_GetBulkCipher(CYASSL*);
01073 CYASSL_API int                  CyaSSL_GetCipherBlockSize(CYASSL*);
01074 CYASSL_API int                  CyaSSL_GetAeadMacSize(CYASSL*);
01075 CYASSL_API int                  CyaSSL_GetHmacSize(CYASSL*);
01076 CYASSL_API int                  CyaSSL_GetHmacType(CYASSL*);
01077 CYASSL_API int                  CyaSSL_GetCipherType(CYASSL*);
01078 CYASSL_API int                  CyaSSL_SetTlsHmacInner(CYASSL*, unsigned char*,
01079                                                        unsigned int, int, int);
01080 
01081 /* Atomic User Needs */
01082 enum {
01083     CYASSL_SERVER_END = 0,
01084     CYASSL_CLIENT_END = 1,
01085     CYASSL_BLOCK_TYPE = 2,
01086     CYASSL_STREAM_TYPE = 3,
01087     CYASSL_AEAD_TYPE = 4,
01088     CYASSL_TLS_HMAC_INNER_SZ = 13      /* SEQ_SZ + ENUM + VERSION_SZ + LEN_SZ */
01089 };
01090 
01091 /* for GetBulkCipher and internal use */
01092 enum BulkCipherAlgorithm { 
01093     cyassl_cipher_null,
01094     cyassl_rc4,
01095     cyassl_rc2,
01096     cyassl_des,
01097     cyassl_triple_des,             /* leading 3 (3des) not valid identifier */
01098     cyassl_des40,
01099     cyassl_idea,
01100     cyassl_aes,
01101     cyassl_aes_gcm,
01102     cyassl_aes_ccm,
01103     cyassl_chacha,
01104     cyassl_camellia,
01105     cyassl_hc128,                  /* CyaSSL extensions */
01106     cyassl_rabbit
01107 };
01108 
01109 
01110 /* for KDF TLS 1.2 mac types */
01111 enum KDF_MacAlgorithm {
01112     cyassl_sha256 = 4,     /* needs to match internal MACAlgorithm */
01113     cyassl_sha384,
01114     cyassl_sha512
01115 };
01116 
01117 
01118 /* Public Key Callback support */
01119 typedef int (*CallbackEccSign)(CYASSL* ssl, 
01120        const unsigned char* in, unsigned int inSz,
01121        unsigned char* out, unsigned int* outSz,
01122        const unsigned char* keyDer, unsigned int keySz,
01123        void* ctx);
01124 CYASSL_API void  CyaSSL_CTX_SetEccSignCb(CYASSL_CTX*, CallbackEccSign);
01125 CYASSL_API void  CyaSSL_SetEccSignCtx(CYASSL* ssl, void *ctx);
01126 CYASSL_API void* CyaSSL_GetEccSignCtx(CYASSL* ssl);
01127 
01128 typedef int (*CallbackEccVerify)(CYASSL* ssl, 
01129        const unsigned char* sig, unsigned int sigSz,
01130        const unsigned char* hash, unsigned int hashSz,
01131        const unsigned char* keyDer, unsigned int keySz,
01132        int* result, void* ctx);
01133 CYASSL_API void  CyaSSL_CTX_SetEccVerifyCb(CYASSL_CTX*, CallbackEccVerify);
01134 CYASSL_API void  CyaSSL_SetEccVerifyCtx(CYASSL* ssl, void *ctx);
01135 CYASSL_API void* CyaSSL_GetEccVerifyCtx(CYASSL* ssl);
01136 
01137 typedef int (*CallbackRsaSign)(CYASSL* ssl, 
01138        const unsigned char* in, unsigned int inSz,
01139        unsigned char* out, unsigned int* outSz,
01140        const unsigned char* keyDer, unsigned int keySz,
01141        void* ctx);
01142 CYASSL_API void  CyaSSL_CTX_SetRsaSignCb(CYASSL_CTX*, CallbackRsaSign);
01143 CYASSL_API void  CyaSSL_SetRsaSignCtx(CYASSL* ssl, void *ctx);
01144 CYASSL_API void* CyaSSL_GetRsaSignCtx(CYASSL* ssl);
01145 
01146 typedef int (*CallbackRsaVerify)(CYASSL* ssl, 
01147        unsigned char* sig, unsigned int sigSz,
01148        unsigned char** out,
01149        const unsigned char* keyDer, unsigned int keySz,
01150        void* ctx);
01151 CYASSL_API void  CyaSSL_CTX_SetRsaVerifyCb(CYASSL_CTX*, CallbackRsaVerify);
01152 CYASSL_API void  CyaSSL_SetRsaVerifyCtx(CYASSL* ssl, void *ctx);
01153 CYASSL_API void* CyaSSL_GetRsaVerifyCtx(CYASSL* ssl);
01154 
01155 /* RSA Public Encrypt cb */
01156 typedef int (*CallbackRsaEnc)(CYASSL* ssl, 
01157        const unsigned char* in, unsigned int inSz,
01158        unsigned char* out, unsigned int* outSz,
01159        const unsigned char* keyDer, unsigned int keySz,
01160        void* ctx);
01161 CYASSL_API void  CyaSSL_CTX_SetRsaEncCb(CYASSL_CTX*, CallbackRsaEnc);
01162 CYASSL_API void  CyaSSL_SetRsaEncCtx(CYASSL* ssl, void *ctx);
01163 CYASSL_API void* CyaSSL_GetRsaEncCtx(CYASSL* ssl);
01164 
01165 /* RSA Private Decrypt cb */
01166 typedef int (*CallbackRsaDec)(CYASSL* ssl, 
01167        unsigned char* in, unsigned int inSz,
01168        unsigned char** out,
01169        const unsigned char* keyDer, unsigned int keySz,
01170        void* ctx);
01171 CYASSL_API void  CyaSSL_CTX_SetRsaDecCb(CYASSL_CTX*, CallbackRsaDec);
01172 CYASSL_API void  CyaSSL_SetRsaDecCtx(CYASSL* ssl, void *ctx);
01173 CYASSL_API void* CyaSSL_GetRsaDecCtx(CYASSL* ssl);
01174 
01175 
01176 #ifndef NO_CERTS
01177     CYASSL_API void CyaSSL_CTX_SetCACb(CYASSL_CTX*, CallbackCACache);
01178 
01179     CYASSL_API CYASSL_CERT_MANAGER* CyaSSL_CertManagerNew(void);
01180     CYASSL_API void CyaSSL_CertManagerFree(CYASSL_CERT_MANAGER*);
01181 
01182     CYASSL_API int CyaSSL_CertManagerLoadCA(CYASSL_CERT_MANAGER*, const char* f,
01183                                                                  const char* d);
01184     CYASSL_API int CyaSSL_CertManagerUnloadCAs(CYASSL_CERT_MANAGER* cm);
01185     CYASSL_API int CyaSSL_CertManagerVerify(CYASSL_CERT_MANAGER*, const char* f,
01186                                                                     int format);
01187     CYASSL_API int CyaSSL_CertManagerVerifyBuffer(CYASSL_CERT_MANAGER* cm,
01188                                 const unsigned char* buff, long sz, int format);
01189     CYASSL_API int CyaSSL_CertManagerCheckCRL(CYASSL_CERT_MANAGER*,
01190                                                         unsigned char*, int sz);
01191     CYASSL_API int CyaSSL_CertManagerEnableCRL(CYASSL_CERT_MANAGER*,
01192                                                                    int options);
01193     CYASSL_API int CyaSSL_CertManagerDisableCRL(CYASSL_CERT_MANAGER*);
01194     CYASSL_API int CyaSSL_CertManagerLoadCRL(CYASSL_CERT_MANAGER*, const char*,
01195                                                                       int, int);
01196     CYASSL_API int CyaSSL_CertManagerSetCRL_Cb(CYASSL_CERT_MANAGER*,
01197                                                                   CbMissingCRL);
01198     CYASSL_API int CyaSSL_CertManagerCheckOCSP(CYASSL_CERT_MANAGER*,
01199                                                         unsigned char*, int sz);
01200     CYASSL_API int CyaSSL_CertManagerEnableOCSP(CYASSL_CERT_MANAGER*,
01201                                                                    int options);
01202     CYASSL_API int CyaSSL_CertManagerDisableOCSP(CYASSL_CERT_MANAGER*);
01203     CYASSL_API int CyaSSL_CertManagerSetOCSPOverrideURL(CYASSL_CERT_MANAGER*,
01204                                                                    const char*);
01205     CYASSL_API int CyaSSL_CertManagerSetOCSP_Cb(CYASSL_CERT_MANAGER*,
01206                                                CbOCSPIO, CbOCSPRespFree, void*);
01207 
01208     CYASSL_API int CyaSSL_EnableCRL(CYASSL* ssl, int options);
01209     CYASSL_API int CyaSSL_DisableCRL(CYASSL* ssl);
01210     CYASSL_API int CyaSSL_LoadCRL(CYASSL*, const char*, int, int);
01211     CYASSL_API int CyaSSL_SetCRL_Cb(CYASSL*, CbMissingCRL);
01212     CYASSL_API int CyaSSL_EnableOCSP(CYASSL*, int options);
01213     CYASSL_API int CyaSSL_DisableOCSP(CYASSL*);
01214     CYASSL_API int CyaSSL_SetOCSP_OverrideURL(CYASSL*, const char*);
01215     CYASSL_API int CyaSSL_SetOCSP_Cb(CYASSL*, CbOCSPIO, CbOCSPRespFree, void*);
01216 
01217     CYASSL_API int CyaSSL_CTX_EnableCRL(CYASSL_CTX* ctx, int options);
01218     CYASSL_API int CyaSSL_CTX_DisableCRL(CYASSL_CTX* ctx);
01219     CYASSL_API int CyaSSL_CTX_LoadCRL(CYASSL_CTX*, const char*, int, int);
01220     CYASSL_API int CyaSSL_CTX_SetCRL_Cb(CYASSL_CTX*, CbMissingCRL);
01221     CYASSL_API int CyaSSL_CTX_EnableOCSP(CYASSL_CTX*, int options);
01222     CYASSL_API int CyaSSL_CTX_DisableOCSP(CYASSL_CTX*);
01223     CYASSL_API int CyaSSL_CTX_SetOCSP_OverrideURL(CYASSL_CTX*, const char*);
01224     CYASSL_API int CyaSSL_CTX_SetOCSP_Cb(CYASSL_CTX*,
01225                                                CbOCSPIO, CbOCSPRespFree, void*);
01226 #endif /* !NO_CERTS */
01227 
01228 /* end of handshake frees temporary arrays, if user needs for get_keys or
01229    psk hints, call KeepArrays before handshake and then FreeArrays when done
01230    if don't want to wait for object free */
01231 CYASSL_API void CyaSSL_KeepArrays(CYASSL*);
01232 CYASSL_API void CyaSSL_FreeArrays(CYASSL*);
01233 
01234 
01235 /* cavium additions */
01236 CYASSL_API int CyaSSL_UseCavium(CYASSL*, int devId);
01237 CYASSL_API int CyaSSL_CTX_UseCavium(CYASSL_CTX*, int devId);
01238 
01239 /* TLS Extensions */
01240 
01241 /* Server Name Indication */
01242 #ifdef HAVE_SNI
01243 
01244 /* SNI types */
01245 enum {
01246     CYASSL_SNI_HOST_NAME = 0
01247 };
01248 
01249 CYASSL_API int CyaSSL_UseSNI(CYASSL* ssl, unsigned char type, const void* data,
01250                                                            unsigned short size);
01251 CYASSL_API int CyaSSL_CTX_UseSNI(CYASSL_CTX* ctx, unsigned char type,
01252                                          const void* data, unsigned short size);
01253 
01254 #ifndef NO_CYASSL_SERVER
01255 
01256 /* SNI options */
01257 enum {
01258     CYASSL_SNI_CONTINUE_ON_MISMATCH = 0x01, /* do not abort on mismatch flag */
01259     CYASSL_SNI_ANSWER_ON_MISMATCH   = 0x02  /* fake match on mismatch flag */
01260 };
01261 
01262 CYASSL_API void CyaSSL_SNI_SetOptions(CYASSL* ssl, unsigned char type,
01263                                                          unsigned char options);
01264 CYASSL_API void CyaSSL_CTX_SNI_SetOptions(CYASSL_CTX* ctx, unsigned char type,
01265                                                          unsigned char options);
01266 
01267 /* SNI status */
01268 enum {
01269     CYASSL_SNI_NO_MATCH   = 0,
01270     CYASSL_SNI_FAKE_MATCH = 1, /* if CYASSL_SNI_ANSWER_ON_MISMATCH is enabled */
01271     CYASSL_SNI_REAL_MATCH = 2
01272 };
01273 
01274 CYASSL_API unsigned char CyaSSL_SNI_Status(CYASSL* ssl, unsigned char type);
01275 
01276 CYASSL_API unsigned short CyaSSL_SNI_GetRequest(CYASSL *ssl, unsigned char type,
01277                                                                    void** data);
01278 CYASSL_API int CyaSSL_SNI_GetFromBuffer(
01279                  const unsigned char* clientHello, unsigned int helloSz,
01280                  unsigned char type, unsigned char* sni, unsigned int* inOutSz);
01281 
01282 #endif
01283 #endif
01284 
01285 /* Maximum Fragment Length */
01286 #ifdef HAVE_MAX_FRAGMENT
01287 
01288 /* Fragment lengths */
01289 enum {
01290     CYASSL_MFL_2_9  = 1, /*  512 bytes */
01291     CYASSL_MFL_2_10 = 2, /* 1024 bytes */
01292     CYASSL_MFL_2_11 = 3, /* 2048 bytes */
01293     CYASSL_MFL_2_12 = 4, /* 4096 bytes */
01294     CYASSL_MFL_2_13 = 5  /* 8192 bytes *//* CyaSSL ONLY!!! */
01295 };
01296 
01297 #ifndef NO_CYASSL_CLIENT
01298 
01299 CYASSL_API int CyaSSL_UseMaxFragment(CYASSL* ssl, unsigned char mfl);
01300 CYASSL_API int CyaSSL_CTX_UseMaxFragment(CYASSL_CTX* ctx, unsigned char mfl);
01301 
01302 #endif
01303 #endif
01304 
01305 /* Truncated HMAC */
01306 #ifdef HAVE_TRUNCATED_HMAC
01307 #ifndef NO_CYASSL_CLIENT
01308 
01309 CYASSL_API int CyaSSL_UseTruncatedHMAC(CYASSL* ssl);
01310 CYASSL_API int CyaSSL_CTX_UseTruncatedHMAC(CYASSL_CTX* ctx);
01311 
01312 #endif
01313 #endif
01314 
01315 /* Elliptic Curves */
01316 #ifdef HAVE_SUPPORTED_CURVES
01317 
01318 enum {
01319     CYASSL_ECC_SECP160R1 = 0x10,
01320     CYASSL_ECC_SECP192R1 = 0x13,
01321     CYASSL_ECC_SECP224R1 = 0x15,
01322     CYASSL_ECC_SECP256R1 = 0x17,
01323     CYASSL_ECC_SECP384R1 = 0x18,
01324     CYASSL_ECC_SECP521R1 = 0x19
01325 };
01326 
01327 #ifndef NO_CYASSL_CLIENT
01328 
01329 CYASSL_API int CyaSSL_UseSupportedCurve(CYASSL* ssl, unsigned short name);
01330 CYASSL_API int CyaSSL_CTX_UseSupportedCurve(CYASSL_CTX* ctx,
01331                                                            unsigned short name);
01332 
01333 #endif
01334 #endif
01335 
01336 /* Secure Renegotiation */
01337 #ifdef HAVE_SECURE_RENEGOTIATION
01338 
01339 CYASSL_API int CyaSSL_UseSecureRenegotiation(CYASSL* ssl);
01340 CYASSL_API int CyaSSL_Rehandshake(CYASSL* ssl);
01341 
01342 #endif
01343 
01344 /* Session Ticket */
01345 #ifdef HAVE_SESSION_TICKET
01346 #ifndef NO_CYASSL_CLIENT
01347 
01348 CYASSL_API int CyaSSL_UseSessionTicket(CYASSL* ssl);
01349 CYASSL_API int CyaSSL_CTX_UseSessionTicket(CYASSL_CTX* ctx);
01350 CYASSL_API int CyaSSL_get_SessionTicket(CYASSL*, unsigned char*, unsigned int*);
01351 CYASSL_API int CyaSSL_set_SessionTicket(CYASSL*, unsigned char*, unsigned int);
01352 typedef int (*CallbackSessionTicket)(CYASSL*, const unsigned char*, int, void*);
01353 CYASSL_API int CyaSSL_set_SessionTicket_cb(CYASSL*,
01354                                                   CallbackSessionTicket, void*);
01355 
01356 #endif
01357 #endif
01358 
01359 #define CYASSL_CRL_MONITOR   0x01   /* monitor this dir flag */
01360 #define CYASSL_CRL_START_MON 0x02   /* start monitoring flag */
01361 
01362 
01363 /* External facing KDF */
01364 CYASSL_API
01365 int CyaSSL_MakeTlsMasterSecret(unsigned char* ms, unsigned int msLen,
01366                                const unsigned char* pms, unsigned int pmsLen,
01367                                const unsigned char* cr, const unsigned char* sr,
01368                                int tls1_2, int hash_type);
01369 
01370 CYASSL_API
01371 int CyaSSL_DeriveTlsKeys(unsigned char* key_data, unsigned int keyLen,
01372                                const unsigned char* ms, unsigned int msLen,
01373                                const unsigned char* sr, const unsigned char* cr,
01374                                int tls1_2, int hash_type);
01375 
01376 #ifdef CYASSL_CALLBACKS
01377 
01378 /* used internally by CyaSSL while OpenSSL types aren't */
01379 #include <cyassl/callbacks.h>
01380 
01381 typedef int (*HandShakeCallBack)(HandShakeInfo*);
01382 typedef int (*TimeoutCallBack)(TimeoutInfo*);
01383 
01384 /* CyaSSL connect extension allowing HandShakeCallBack and/or TimeoutCallBack
01385    for diagnostics */
01386 CYASSL_API int CyaSSL_connect_ex(CYASSL*, HandShakeCallBack, TimeoutCallBack,
01387                                  Timeval);
01388 CYASSL_API int CyaSSL_accept_ex(CYASSL*, HandShakeCallBack, TimeoutCallBack,
01389                                 Timeval);
01390 
01391 #endif /* CYASSL_CALLBACKS */
01392 
01393 
01394 #ifdef CYASSL_HAVE_WOLFSCEP
01395     CYASSL_API void CyaSSL_wolfSCEP(void);
01396 #endif /* CYASSL_HAVE_WOLFSCEP */
01397 
01398 #ifdef CYASSL_HAVE_CERT_SERVICE
01399     CYASSL_API void CyaSSL_cert_service(void);
01400 #endif
01401 
01402 
01403 #ifdef __cplusplus
01404     }  /* extern "C" */
01405 #endif
01406 
01407 
01408 #endif /* CYASSL_SSL_H */
01409