Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 1 | /** |
| 2 | * \file config.h |
| 3 | * |
Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 4 | * \brief Configuration options (set of defines) |
| 5 | * |
Paul Bakker | 6fa5488 | 2013-06-17 15:44:03 +0200 | [diff] [blame] | 6 | * Copyright (C) 2006-2013, Brainspark B.V. |
Paul Bakker | b96f154 | 2010-07-18 20:36:00 +0000 | [diff] [blame] | 7 | * |
| 8 | * This file is part of PolarSSL (http://www.polarssl.org) |
Paul Bakker | 84f12b7 | 2010-07-18 10:13:04 +0000 | [diff] [blame] | 9 | * Lead Maintainer: Paul Bakker <polarssl_maintainer at polarssl.org> |
Paul Bakker | b96f154 | 2010-07-18 20:36:00 +0000 | [diff] [blame] | 10 | * |
Paul Bakker | 77b385e | 2009-07-28 17:23:11 +0000 | [diff] [blame] | 11 | * All rights reserved. |
Paul Bakker | e0ccd0a | 2009-01-04 16:27:10 +0000 | [diff] [blame] | 12 | * |
Paul Bakker | e0ccd0a | 2009-01-04 16:27:10 +0000 | [diff] [blame] | 13 | * This program is free software; you can redistribute it and/or modify |
| 14 | * it under the terms of the GNU General Public License as published by |
| 15 | * the Free Software Foundation; either version 2 of the License, or |
| 16 | * (at your option) any later version. |
| 17 | * |
| 18 | * This program is distributed in the hope that it will be useful, |
| 19 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 20 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 21 | * GNU General Public License for more details. |
| 22 | * |
| 23 | * You should have received a copy of the GNU General Public License along |
| 24 | * with this program; if not, write to the Free Software Foundation, Inc., |
| 25 | * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. |
| 26 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 27 | * This set of compile-time options may be used to enable |
| 28 | * or disable features selectively, and reduce the global |
| 29 | * memory footprint. |
| 30 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 31 | #ifndef POLARSSL_CONFIG_H |
| 32 | #define POLARSSL_CONFIG_H |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 33 | |
Paul Bakker | cce9d77 | 2011-11-18 14:26:47 +0000 | [diff] [blame] | 34 | #if defined(_MSC_VER) && !defined(_CRT_SECURE_NO_DEPRECATE) |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 35 | #define _CRT_SECURE_NO_DEPRECATE 1 |
| 36 | #endif |
| 37 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 38 | /** |
Paul Bakker | 0a62cd1 | 2011-01-21 11:00:08 +0000 | [diff] [blame] | 39 | * \name SECTION: System support |
| 40 | * |
| 41 | * This section sets system specific settings. |
| 42 | * \{ |
| 43 | */ |
| 44 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 45 | /** |
| 46 | * \def POLARSSL_HAVE_INT8 |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 47 | * |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 48 | * The system uses 8-bit wide native integers. |
| 49 | * |
| 50 | * Uncomment if native integers are 8-bit wide. |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 51 | #define POLARSSL_HAVE_INT8 |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 52 | */ |
| 53 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 54 | /** |
| 55 | * \def POLARSSL_HAVE_INT16 |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 56 | * |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 57 | * The system uses 16-bit wide native integers. |
| 58 | * |
| 59 | * Uncomment if native integers are 16-bit wide. |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 60 | #define POLARSSL_HAVE_INT16 |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 61 | */ |
| 62 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 63 | /** |
Paul Bakker | 62261d6 | 2012-10-02 12:19:31 +0000 | [diff] [blame] | 64 | * \def POLARSSL_HAVE_LONGLONG |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 65 | * |
Paul Bakker | 62261d6 | 2012-10-02 12:19:31 +0000 | [diff] [blame] | 66 | * The compiler supports the 'long long' type. |
| 67 | * (Only used on 32-bit platforms) |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 68 | */ |
Paul Bakker | 62261d6 | 2012-10-02 12:19:31 +0000 | [diff] [blame] | 69 | #define POLARSSL_HAVE_LONGLONG |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 70 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 71 | /** |
| 72 | * \def POLARSSL_HAVE_ASM |
| 73 | * |
| 74 | * The compiler has support for asm() |
| 75 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 76 | * Uncomment to enable the use of assembly code. |
Paul Bakker | 68041ec | 2009-04-19 21:17:55 +0000 | [diff] [blame] | 77 | * |
| 78 | * Requires support for asm() in compiler. |
| 79 | * |
| 80 | * Used in: |
| 81 | * library/timing.c |
| 82 | * library/padlock.c |
| 83 | * include/polarssl/bn_mul.h |
| 84 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 85 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 86 | #define POLARSSL_HAVE_ASM |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 87 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 88 | /** |
| 89 | * \def POLARSSL_HAVE_SSE2 |
| 90 | * |
Paul Bakker | e23c315 | 2012-10-01 14:42:47 +0000 | [diff] [blame] | 91 | * CPU supports SSE2 instruction set. |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 92 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 93 | * Uncomment if the CPU supports SSE2 (IA-32 specific). |
| 94 | * |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 95 | #define POLARSSL_HAVE_SSE2 |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 96 | */ |
Paul Bakker | 9ccb211 | 2014-07-07 13:43:31 +0200 | [diff] [blame^] | 97 | |
| 98 | /** |
| 99 | * \def POLARSSL_HAVE_READDIR_R |
| 100 | * |
| 101 | * (Non Windows) System has readdir_r(). |
| 102 | * |
| 103 | * Required for x509_crt_parse_path() in non-Windows systems. |
| 104 | * |
| 105 | * Comment if your system does not have support. |
| 106 | */ |
| 107 | #define POLARSSL_HAVE_READDIR_R |
Paul Bakker | 0a62cd1 | 2011-01-21 11:00:08 +0000 | [diff] [blame] | 108 | /* \} name */ |
| 109 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 110 | /** |
Paul Bakker | 0a62cd1 | 2011-01-21 11:00:08 +0000 | [diff] [blame] | 111 | * \name SECTION: PolarSSL feature support |
| 112 | * |
| 113 | * This section sets support for features that are or are not needed |
| 114 | * within the modules that are enabled. |
| 115 | * \{ |
| 116 | */ |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 117 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 118 | /** |
Paul Bakker | 4087c47 | 2013-06-12 16:49:10 +0200 | [diff] [blame] | 119 | * \def POLARSSL_XXX_ALT |
| 120 | * |
| 121 | * Uncomment a macro to let PolarSSL use your alternate core implementation of |
| 122 | * a symmetric or hash algorithm (e.g. platform specific assembly optimized |
| 123 | * implementations). Keep in mind that the function prototypes should remain |
| 124 | * the same. |
| 125 | * |
| 126 | * Example: In case you uncomment POLARSSL_AES_ALT, PolarSSL will no longer |
| 127 | * provide the "struct aes_context" definition and omit the base function |
| 128 | * declarations and implementations. "aes_alt.h" will be included from |
| 129 | * "aes.h" to include the new function definitions. |
| 130 | * |
| 131 | * Uncomment a macro to enable alternate implementation for core algorithm |
| 132 | * functions |
| 133 | #define POLARSSL_AES_ALT |
| 134 | #define POLARSSL_ARC4_ALT |
| 135 | #define POLARSSL_BLOWFISH_ALT |
| 136 | #define POLARSSL_CAMELLIA_ALT |
| 137 | #define POLARSSL_DES_ALT |
| 138 | #define POLARSSL_XTEA_ALT |
| 139 | #define POLARSSL_MD2_ALT |
| 140 | #define POLARSSL_MD4_ALT |
| 141 | #define POLARSSL_MD5_ALT |
| 142 | #define POLARSSL_SHA1_ALT |
| 143 | #define POLARSSL_SHA2_ALT |
| 144 | #define POLARSSL_SHA4_ALT |
| 145 | */ |
| 146 | |
| 147 | /** |
Paul Bakker | 15566e4 | 2011-04-24 21:19:15 +0000 | [diff] [blame] | 148 | * \def POLARSSL_AES_ROM_TABLES |
| 149 | * |
| 150 | * Store the AES tables in ROM. |
| 151 | * |
| 152 | * Uncomment this macro to store the AES tables in ROM. |
| 153 | * |
| 154 | #define POLARSSL_AES_ROM_TABLES |
| 155 | */ |
| 156 | |
| 157 | /** |
Paul Bakker | b6ecaf5 | 2011-04-19 14:29:23 +0000 | [diff] [blame] | 158 | * \def POLARSSL_CIPHER_MODE_CFB |
| 159 | * |
| 160 | * Enable Cipher Feedback mode (CFB) for symmetric ciphers. |
| 161 | */ |
| 162 | #define POLARSSL_CIPHER_MODE_CFB |
| 163 | |
| 164 | /** |
| 165 | * \def POLARSSL_CIPHER_MODE_CTR |
| 166 | * |
| 167 | * Enable Counter Block Cipher mode (CTR) for symmetric ciphers. |
| 168 | */ |
| 169 | #define POLARSSL_CIPHER_MODE_CTR |
| 170 | |
| 171 | /** |
Paul Bakker | fab5c82 | 2012-02-06 16:45:10 +0000 | [diff] [blame] | 172 | * \def POLARSSL_CIPHER_NULL_CIPHER |
| 173 | * |
| 174 | * Enable NULL cipher. |
| 175 | * Warning: Only do so when you know what you are doing. This allows for |
| 176 | * encryption or channels without any security! |
| 177 | * |
| 178 | * Requires POLARSSL_ENABLE_WEAK_CIPHERSUITES as well to enable |
| 179 | * the following ciphersuites: |
Paul Bakker | 645ce3a | 2012-10-31 12:32:41 +0000 | [diff] [blame] | 180 | * TLS_RSA_WITH_NULL_MD5 |
| 181 | * TLS_RSA_WITH_NULL_SHA |
| 182 | * TLS_RSA_WITH_NULL_SHA256 |
Paul Bakker | fab5c82 | 2012-02-06 16:45:10 +0000 | [diff] [blame] | 183 | * |
| 184 | * Uncomment this macro to enable the NULL cipher and ciphersuites |
| 185 | #define POLARSSL_CIPHER_NULL_CIPHER |
| 186 | */ |
| 187 | |
| 188 | /** |
Paul Bakker | fab5c82 | 2012-02-06 16:45:10 +0000 | [diff] [blame] | 189 | * \def POLARSSL_ENABLE_WEAK_CIPHERSUITES |
| 190 | * |
Paul Bakker | 645ce3a | 2012-10-31 12:32:41 +0000 | [diff] [blame] | 191 | * Enable weak ciphersuites in SSL / TLS |
Paul Bakker | fab5c82 | 2012-02-06 16:45:10 +0000 | [diff] [blame] | 192 | * Warning: Only do so when you know what you are doing. This allows for |
Paul Bakker | 9a73632 | 2012-11-14 12:39:52 +0000 | [diff] [blame] | 193 | * channels with virtually no security at all! |
Paul Bakker | fab5c82 | 2012-02-06 16:45:10 +0000 | [diff] [blame] | 194 | * |
| 195 | * This enables the following ciphersuites: |
Paul Bakker | 645ce3a | 2012-10-31 12:32:41 +0000 | [diff] [blame] | 196 | * TLS_RSA_WITH_DES_CBC_SHA |
| 197 | * TLS_DHE_RSA_WITH_DES_CBC_SHA |
Paul Bakker | fab5c82 | 2012-02-06 16:45:10 +0000 | [diff] [blame] | 198 | * |
| 199 | * Uncomment this macro to enable weak ciphersuites |
| 200 | #define POLARSSL_ENABLE_WEAK_CIPHERSUITES |
| 201 | */ |
| 202 | |
| 203 | /** |
Paul Bakker | 8fe40dc | 2013-02-02 12:43:08 +0100 | [diff] [blame] | 204 | * \def POLARSSL_ERROR_STRERROR_DUMMY |
| 205 | * |
| 206 | * Enable a dummy error function to make use of error_strerror() in |
| 207 | * third party libraries easier. |
| 208 | * |
| 209 | * Disable if you run into name conflicts and want to really remove the |
| 210 | * error_strerror() |
| 211 | */ |
| 212 | #define POLARSSL_ERROR_STRERROR_DUMMY |
| 213 | |
| 214 | /** |
Paul Bakker | 15566e4 | 2011-04-24 21:19:15 +0000 | [diff] [blame] | 215 | * \def POLARSSL_GENPRIME |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 216 | * |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 217 | * Requires: POLARSSL_BIGNUM_C, POLARSSL_RSA_C |
| 218 | * |
Paul Bakker | 15566e4 | 2011-04-24 21:19:15 +0000 | [diff] [blame] | 219 | * Enable the RSA prime-number generation code. |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 220 | */ |
Paul Bakker | 15566e4 | 2011-04-24 21:19:15 +0000 | [diff] [blame] | 221 | #define POLARSSL_GENPRIME |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 222 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 223 | /** |
Paul Bakker | 335db3f | 2011-04-25 15:28:35 +0000 | [diff] [blame] | 224 | * \def POLARSSL_FS_IO |
| 225 | * |
| 226 | * Enable functions that use the filesystem. |
| 227 | */ |
| 228 | #define POLARSSL_FS_IO |
| 229 | |
| 230 | /** |
Paul Bakker | 43655f4 | 2011-12-15 20:11:16 +0000 | [diff] [blame] | 231 | * \def POLARSSL_NO_DEFAULT_ENTROPY_SOURCES |
| 232 | * |
| 233 | * Do not add default entropy sources. These are the platform specific, |
| 234 | * hardclock and HAVEGE based poll functions. |
| 235 | * |
| 236 | * This is useful to have more control over the added entropy sources in an |
| 237 | * application. |
| 238 | * |
| 239 | * Uncomment this macro to prevent loading of default entropy functions. |
| 240 | #define POLARSSL_NO_DEFAULT_ENTROPY_SOURCES |
| 241 | */ |
| 242 | |
| 243 | /** |
Paul Bakker | 6083fd2 | 2011-12-03 21:45:14 +0000 | [diff] [blame] | 244 | * \def POLARSSL_NO_PLATFORM_ENTROPY |
| 245 | * |
| 246 | * Do not use built-in platform entropy functions. |
| 247 | * This is useful if your platform does not support |
| 248 | * standards like the /dev/urandom or Windows CryptoAPI. |
| 249 | * |
| 250 | * Uncomment this macro to disable the built-in platform entropy functions. |
| 251 | #define POLARSSL_NO_PLATFORM_ENTROPY |
| 252 | */ |
| 253 | |
| 254 | /** |
Paul Bakker | 9dcc322 | 2011-03-08 14:16:06 +0000 | [diff] [blame] | 255 | * \def POLARSSL_PKCS1_V21 |
| 256 | * |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 257 | * Requires: POLARSSL_MD_C, POLARSSL_RSA_C |
| 258 | * |
Paul Bakker | 9dcc322 | 2011-03-08 14:16:06 +0000 | [diff] [blame] | 259 | * Enable support for PKCS#1 v2.1 encoding. |
| 260 | * This enables support for RSAES-OAEP and RSASSA-PSS operations. |
| 261 | */ |
| 262 | #define POLARSSL_PKCS1_V21 |
| 263 | |
| 264 | /** |
Paul Bakker | 0216cc1 | 2011-03-26 13:40:23 +0000 | [diff] [blame] | 265 | * \def POLARSSL_RSA_NO_CRT |
| 266 | * |
| 267 | * Do not use the Chinese Remainder Theorem for the RSA private operation. |
| 268 | * |
| 269 | * Uncomment this macro to disable the use of CRT in RSA. |
| 270 | * |
| 271 | #define POLARSSL_RSA_NO_CRT |
| 272 | */ |
Paul Bakker | 15566e4 | 2011-04-24 21:19:15 +0000 | [diff] [blame] | 273 | |
| 274 | /** |
| 275 | * \def POLARSSL_SELF_TEST |
| 276 | * |
| 277 | * Enable the checkup functions (*_self_test). |
| 278 | */ |
| 279 | #define POLARSSL_SELF_TEST |
Paul Bakker | 5c721f9 | 2011-07-27 16:51:09 +0000 | [diff] [blame] | 280 | |
| 281 | /** |
Paul Bakker | 40865c8 | 2013-01-31 17:13:13 +0100 | [diff] [blame] | 282 | * \def POLARSSL_SSL_ALL_ALERT_MESSAGES |
| 283 | * |
| 284 | * Enable sending of alert messages in case of encountered errors as per RFC. |
| 285 | * If you choose not to send the alert messages, PolarSSL can still communicate |
| 286 | * with other servers, only debugging of failures is harder. |
| 287 | * |
| 288 | * The advantage of not sending alert messages, is that no information is given |
| 289 | * about reasons for failures thus preventing adversaries of gaining intel. |
| 290 | * |
| 291 | * Enable sending of all alert messages |
| 292 | */ |
| 293 | #define POLARSSL_SSL_ALERT_MESSAGES |
| 294 | |
| 295 | /** |
Paul Bakker | d66f070 | 2013-01-31 16:57:45 +0100 | [diff] [blame] | 296 | * \def POLARSSL_SSL_DEBUG_ALL |
| 297 | * |
| 298 | * Enable the debug messages in SSL module for all issues. |
| 299 | * Debug messages have been disabled in some places to prevent timing |
| 300 | * attacks due to (unbalanced) debugging function calls. |
| 301 | * |
| 302 | * If you need all error reporting you should enable this during debugging, |
| 303 | * but remove this for production servers that should log as well. |
| 304 | * |
| 305 | * Uncomment this macro to report all debug messages on errors introducing |
| 306 | * a timing side-channel. |
| 307 | * |
| 308 | #define POLARSSL_SSL_DEBUG_ALL |
| 309 | */ |
| 310 | |
| 311 | /** |
Paul Bakker | 05ef835 | 2012-05-08 09:17:57 +0000 | [diff] [blame] | 312 | * \def POLARSSL_SSL_HW_RECORD_ACCEL |
| 313 | * |
| 314 | * Enable hooking functions in SSL module for hardware acceleration of |
| 315 | * individual records. |
| 316 | * |
| 317 | * Uncomment this macro to enable hooking functions. |
| 318 | #define POLARSSL_SSL_HW_RECORD_ACCEL |
| 319 | */ |
| 320 | |
| 321 | /** |
Paul Bakker | 78a8c71 | 2013-03-06 17:01:52 +0100 | [diff] [blame] | 322 | * \def POLARSSL_SSL_SRV_SUPPORT_SSLV2_CLIENT_HELLO |
| 323 | * |
| 324 | * Enable support for receiving and parsing SSLv2 Client Hello messages for the |
| 325 | * SSL Server module (POLARSSL_SSL_SRV_C) |
| 326 | * |
| 327 | * Comment this macro to disable support for SSLv2 Client Hello messages. |
| 328 | */ |
| 329 | #define POLARSSL_SSL_SRV_SUPPORT_SSLV2_CLIENT_HELLO |
| 330 | |
| 331 | /** |
Paul Bakker | 5c721f9 | 2011-07-27 16:51:09 +0000 | [diff] [blame] | 332 | * \def POLARSSL_X509_ALLOW_UNSUPPORTED_CRITICAL_EXTENSION |
| 333 | * |
| 334 | * If set, the X509 parser will not break-off when parsing an X509 certificate |
| 335 | * and encountering an unknown critical extension. |
| 336 | * |
| 337 | * Uncomment to prevent an error. |
| 338 | * |
| 339 | #define POLARSSL_X509_ALLOW_UNSUPPORTED_CRITICAL_EXTENSION |
| 340 | */ |
Paul Bakker | 2770fbd | 2012-07-03 13:30:23 +0000 | [diff] [blame] | 341 | |
| 342 | /** |
| 343 | * \def POLARSSL_ZLIB_SUPPORT |
| 344 | * |
| 345 | * If set, the SSL/TLS module uses ZLIB to support compression and |
| 346 | * decompression of packet data. |
| 347 | * |
| 348 | * Used in: library/ssl_tls.c |
| 349 | * library/ssl_cli.c |
| 350 | * library/ssl_srv.c |
| 351 | * |
| 352 | * This feature requires zlib library and headers to be present. |
| 353 | * |
| 354 | * Uncomment to enable use of ZLIB |
| 355 | #define POLARSSL_ZLIB_SUPPORT |
| 356 | */ |
Paul Bakker | 0a62cd1 | 2011-01-21 11:00:08 +0000 | [diff] [blame] | 357 | /* \} name */ |
| 358 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 359 | /** |
Paul Bakker | 0a62cd1 | 2011-01-21 11:00:08 +0000 | [diff] [blame] | 360 | * \name SECTION: PolarSSL modules |
| 361 | * |
| 362 | * This section enables or disables entire modules in PolarSSL |
| 363 | * \{ |
| 364 | */ |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 365 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 366 | /** |
| 367 | * \def POLARSSL_AES_C |
| 368 | * |
| 369 | * Enable the AES block cipher. |
| 370 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 371 | * Module: library/aes.c |
| 372 | * Caller: library/ssl_tls.c |
Paul Bakker | 96743fc | 2011-02-12 14:30:57 +0000 | [diff] [blame] | 373 | * library/pem.c |
Paul Bakker | 6083fd2 | 2011-12-03 21:45:14 +0000 | [diff] [blame] | 374 | * library/ctr_drbg.c |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 375 | * |
Paul Bakker | 645ce3a | 2012-10-31 12:32:41 +0000 | [diff] [blame] | 376 | * This module enables the following ciphersuites (if other requisites are |
| 377 | * enabled as well): |
| 378 | * TLS_RSA_WITH_AES_128_CBC_SHA |
| 379 | * TLS_RSA_WITH_AES_256_CBC_SHA |
| 380 | * TLS_DHE_RSA_WITH_AES_128_CBC_SHA |
| 381 | * TLS_DHE_RSA_WITH_AES_256_CBC_SHA |
| 382 | * TLS_RSA_WITH_AES_128_CBC_SHA256 |
| 383 | * TLS_RSA_WITH_AES_256_CBC_SHA256 |
| 384 | * TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 |
| 385 | * TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 |
| 386 | * TLS_RSA_WITH_AES_128_GCM_SHA256 |
| 387 | * TLS_RSA_WITH_AES_256_GCM_SHA384 |
Paul Bakker | 6deb37e | 2013-02-19 13:17:08 +0100 | [diff] [blame] | 388 | * |
| 389 | * PEM uses AES for decrypting encrypted keys. |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 390 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 391 | #define POLARSSL_AES_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 392 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 393 | /** |
| 394 | * \def POLARSSL_ARC4_C |
| 395 | * |
| 396 | * Enable the ARCFOUR stream cipher. |
| 397 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 398 | * Module: library/arc4.c |
| 399 | * Caller: library/ssl_tls.c |
| 400 | * |
| 401 | * This module enables the following ciphersuites: |
Paul Bakker | 645ce3a | 2012-10-31 12:32:41 +0000 | [diff] [blame] | 402 | * TLS_RSA_WITH_RC4_128_MD5 |
| 403 | * TLS_RSA_WITH_RC4_128_SHA |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 404 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 405 | #define POLARSSL_ARC4_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 406 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 407 | /** |
Paul Bakker | efc3029 | 2011-11-10 14:43:23 +0000 | [diff] [blame] | 408 | * \def POLARSSL_ASN1_PARSE_C |
| 409 | * |
| 410 | * Enable the generic ASN1 parser. |
| 411 | * |
| 412 | * Module: library/asn1.c |
| 413 | * Caller: library/x509parse.c |
| 414 | */ |
| 415 | #define POLARSSL_ASN1_PARSE_C |
| 416 | |
| 417 | /** |
Paul Bakker | bdb912d | 2012-02-13 23:11:30 +0000 | [diff] [blame] | 418 | * \def POLARSSL_ASN1_WRITE_C |
| 419 | * |
| 420 | * Enable the generic ASN1 writer. |
| 421 | * |
| 422 | * Module: library/asn1write.c |
| 423 | */ |
| 424 | #define POLARSSL_ASN1_WRITE_C |
| 425 | |
| 426 | /** |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 427 | * \def POLARSSL_BASE64_C |
| 428 | * |
| 429 | * Enable the Base64 module. |
| 430 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 431 | * Module: library/base64.c |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 432 | * Caller: library/pem.c |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 433 | * |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 434 | * This module is required for PEM support (required by X.509). |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 435 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 436 | #define POLARSSL_BASE64_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 437 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 438 | /** |
| 439 | * \def POLARSSL_BIGNUM_C |
| 440 | * |
Paul Bakker | 9a73632 | 2012-11-14 12:39:52 +0000 | [diff] [blame] | 441 | * Enable the multi-precision integer library. |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 442 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 443 | * Module: library/bignum.c |
| 444 | * Caller: library/dhm.c |
| 445 | * library/rsa.c |
| 446 | * library/ssl_tls.c |
| 447 | * library/x509parse.c |
| 448 | * |
| 449 | * This module is required for RSA and DHM support. |
| 450 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 451 | #define POLARSSL_BIGNUM_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 452 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 453 | /** |
Paul Bakker | a9379c0 | 2012-07-04 11:02:11 +0000 | [diff] [blame] | 454 | * \def POLARSSL_BLOWFISH_C |
| 455 | * |
| 456 | * Enable the Blowfish block cipher. |
| 457 | * |
| 458 | * Module: library/blowfish.c |
| 459 | */ |
| 460 | #define POLARSSL_BLOWFISH_C |
| 461 | |
| 462 | /** |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 463 | * \def POLARSSL_CAMELLIA_C |
| 464 | * |
| 465 | * Enable the Camellia block cipher. |
| 466 | * |
Paul Bakker | 38119b1 | 2009-01-10 23:31:23 +0000 | [diff] [blame] | 467 | * Module: library/camellia.c |
Paul Bakker | 13e2dfe | 2009-07-28 07:18:38 +0000 | [diff] [blame] | 468 | * Caller: library/ssl_tls.c |
Paul Bakker | 38119b1 | 2009-01-10 23:31:23 +0000 | [diff] [blame] | 469 | * |
Paul Bakker | 645ce3a | 2012-10-31 12:32:41 +0000 | [diff] [blame] | 470 | * This module enables the following ciphersuites (if other requisites are |
| 471 | * enabled as well): |
| 472 | * TLS_RSA_WITH_CAMELLIA_128_CBC_SHA |
| 473 | * TLS_RSA_WITH_CAMELLIA_256_CBC_SHA |
| 474 | * TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA |
| 475 | * TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA |
| 476 | * TLS_RSA_WITH_CAMELLIA_128_CBC_SHA256 |
| 477 | * TLS_RSA_WITH_CAMELLIA_256_CBC_SHA256 |
| 478 | * TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 |
| 479 | * TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 |
Paul Bakker | 38119b1 | 2009-01-10 23:31:23 +0000 | [diff] [blame] | 480 | */ |
| 481 | #define POLARSSL_CAMELLIA_C |
| 482 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 483 | /** |
| 484 | * \def POLARSSL_CERTS_C |
| 485 | * |
| 486 | * Enable the test certificates. |
| 487 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 488 | * Module: library/certs.c |
| 489 | * Caller: |
| 490 | * |
| 491 | * This module is used for testing (ssl_client/server). |
| 492 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 493 | #define POLARSSL_CERTS_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 494 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 495 | /** |
| 496 | * \def POLARSSL_CIPHER_C |
| 497 | * |
| 498 | * Enable the generic cipher layer. |
| 499 | * |
Paul Bakker | 8123e9d | 2011-01-06 15:37:30 +0000 | [diff] [blame] | 500 | * Module: library/cipher.c |
| 501 | * Caller: |
| 502 | * |
| 503 | * Uncomment to enable generic cipher wrappers. |
| 504 | */ |
| 505 | #define POLARSSL_CIPHER_C |
| 506 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 507 | /** |
Paul Bakker | 0e04d0e | 2011-11-27 14:46:59 +0000 | [diff] [blame] | 508 | * \def POLARSSL_CTR_DRBG_C |
| 509 | * |
| 510 | * Enable the CTR_DRBG AES-256-based random generator |
| 511 | * |
| 512 | * Module: library/ctr_drbg.c |
| 513 | * Caller: |
| 514 | * |
Paul Bakker | 6083fd2 | 2011-12-03 21:45:14 +0000 | [diff] [blame] | 515 | * Requires: POLARSSL_AES_C |
| 516 | * |
Paul Bakker | 0e04d0e | 2011-11-27 14:46:59 +0000 | [diff] [blame] | 517 | * This module provides the CTR_DRBG AES-256 random number generator. |
| 518 | */ |
| 519 | #define POLARSSL_CTR_DRBG_C |
| 520 | |
| 521 | /** |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 522 | * \def POLARSSL_DEBUG_C |
| 523 | * |
| 524 | * Enable the debug functions. |
| 525 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 526 | * Module: library/debug.c |
| 527 | * Caller: library/ssl_cli.c |
| 528 | * library/ssl_srv.c |
| 529 | * library/ssl_tls.c |
| 530 | * |
| 531 | * This module provides debugging functions. |
| 532 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 533 | #define POLARSSL_DEBUG_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 534 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 535 | /** |
| 536 | * \def POLARSSL_DES_C |
| 537 | * |
| 538 | * Enable the DES block cipher. |
| 539 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 540 | * Module: library/des.c |
Paul Bakker | 6deb37e | 2013-02-19 13:17:08 +0100 | [diff] [blame] | 541 | * Caller: library/pem.c |
| 542 | * library/ssl_tls.c |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 543 | * |
Paul Bakker | 645ce3a | 2012-10-31 12:32:41 +0000 | [diff] [blame] | 544 | * This module enables the following ciphersuites (if other requisites are |
| 545 | * enabled as well): |
| 546 | * TLS_RSA_WITH_3DES_EDE_CBC_SHA |
| 547 | * TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA |
Paul Bakker | 6deb37e | 2013-02-19 13:17:08 +0100 | [diff] [blame] | 548 | * |
| 549 | * PEM uses DES/3DES for decrypting encrypted keys. |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 550 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 551 | #define POLARSSL_DES_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 552 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 553 | /** |
| 554 | * \def POLARSSL_DHM_C |
| 555 | * |
| 556 | * Enable the Diffie-Hellman-Merkle key exchange. |
| 557 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 558 | * Module: library/dhm.c |
| 559 | * Caller: library/ssl_cli.c |
| 560 | * library/ssl_srv.c |
| 561 | * |
Paul Bakker | 645ce3a | 2012-10-31 12:32:41 +0000 | [diff] [blame] | 562 | * This module enables the following ciphersuites (if other requisites are |
| 563 | * enabled as well): |
| 564 | * TLS_DHE_RSA_WITH_DES_CBC_SHA |
| 565 | * TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA |
| 566 | * TLS_DHE_RSA_WITH_AES_128_CBC_SHA |
| 567 | * TLS_DHE_RSA_WITH_AES_256_CBC_SHA |
| 568 | * TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 |
| 569 | * TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 |
| 570 | * TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA |
| 571 | * TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA |
| 572 | * TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 |
| 573 | * TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 |
| 574 | * TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 |
| 575 | * TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 576 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 577 | #define POLARSSL_DHM_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 578 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 579 | /** |
Paul Bakker | 6083fd2 | 2011-12-03 21:45:14 +0000 | [diff] [blame] | 580 | * \def POLARSSL_ENTROPY_C |
| 581 | * |
| 582 | * Enable the platform-specific entropy code. |
| 583 | * |
| 584 | * Module: library/entropy.c |
| 585 | * Caller: |
| 586 | * |
| 587 | * Requires: POLARSSL_SHA4_C |
| 588 | * |
| 589 | * This module provides a generic entropy pool |
| 590 | */ |
| 591 | #define POLARSSL_ENTROPY_C |
| 592 | |
| 593 | /** |
Paul Bakker | 9d78140 | 2011-05-09 16:17:09 +0000 | [diff] [blame] | 594 | * \def POLARSSL_ERROR_C |
| 595 | * |
| 596 | * Enable error code to error string conversion. |
| 597 | * |
| 598 | * Module: library/error.c |
| 599 | * Caller: |
| 600 | * |
| 601 | * This module enables err_strerror(). |
| 602 | */ |
| 603 | #define POLARSSL_ERROR_C |
| 604 | |
| 605 | /** |
Paul Bakker | 89e80c9 | 2012-03-20 13:50:09 +0000 | [diff] [blame] | 606 | * \def POLARSSL_GCM_C |
| 607 | * |
| 608 | * Enable the Galois/Counter Mode (GCM) for AES |
| 609 | * |
| 610 | * Module: library/gcm.c |
| 611 | * |
| 612 | * Requires: POLARSSL_AES_C |
Paul Bakker | 645ce3a | 2012-10-31 12:32:41 +0000 | [diff] [blame] | 613 | * |
| 614 | * This module enables the following ciphersuites (if other requisites are |
| 615 | * enabled as well): |
| 616 | * TLS_RSA_WITH_AES_128_GCM_SHA256 |
| 617 | * TLS_RSA_WITH_AES_256_GCM_SHA384 |
Paul Bakker | 89e80c9 | 2012-03-20 13:50:09 +0000 | [diff] [blame] | 618 | */ |
| 619 | #define POLARSSL_GCM_C |
| 620 | |
| 621 | /** |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 622 | * \def POLARSSL_HAVEGE_C |
| 623 | * |
| 624 | * Enable the HAVEGE random generator. |
| 625 | * |
Paul Bakker | 08f06cf | 2013-06-06 14:05:26 +0200 | [diff] [blame] | 626 | * Warning: the HAVEGE random generator is not suitable for virtualized |
| 627 | * environments |
| 628 | * |
| 629 | * Warning: the HAVEGE random generator is dependent on timing and specific |
| 630 | * processor traits. It is therefore not advised to use HAVEGE as |
| 631 | * your applications primary random generator or primary entropy pool |
| 632 | * input. As a secondary input to your entropy pool, it IS able add |
| 633 | * the (limited) extra entropy it provides. |
| 634 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 635 | * Module: library/havege.c |
| 636 | * Caller: |
| 637 | * |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 638 | * Requires: POLARSSL_TIMING_C |
| 639 | * |
Paul Bakker | 08f06cf | 2013-06-06 14:05:26 +0200 | [diff] [blame] | 640 | * Uncomment to enable the HAVEGE random generator. |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 641 | #define POLARSSL_HAVEGE_C |
Paul Bakker | 08f06cf | 2013-06-06 14:05:26 +0200 | [diff] [blame] | 642 | */ |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 643 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 644 | /** |
| 645 | * \def POLARSSL_MD_C |
| 646 | * |
| 647 | * Enable the generic message digest layer. |
| 648 | * |
Paul Bakker | 1737385 | 2011-01-06 14:20:01 +0000 | [diff] [blame] | 649 | * Module: library/md.c |
| 650 | * Caller: |
| 651 | * |
| 652 | * Uncomment to enable generic message digest wrappers. |
| 653 | */ |
| 654 | #define POLARSSL_MD_C |
| 655 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 656 | /** |
| 657 | * \def POLARSSL_MD2_C |
| 658 | * |
| 659 | * Enable the MD2 hash algorithm |
| 660 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 661 | * Module: library/md2.c |
| 662 | * Caller: library/x509parse.c |
| 663 | * |
| 664 | * Uncomment to enable support for (rare) MD2-signed X.509 certs. |
| 665 | * |
Paul Bakker | 13e2dfe | 2009-07-28 07:18:38 +0000 | [diff] [blame] | 666 | #define POLARSSL_MD2_C |
Paul Bakker | 6506aff | 2009-07-28 20:52:02 +0000 | [diff] [blame] | 667 | */ |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 668 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 669 | /** |
| 670 | * \def POLARSSL_MD4_C |
| 671 | * |
| 672 | * Enable the MD4 hash algorithm |
| 673 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 674 | * Module: library/md4.c |
| 675 | * Caller: library/x509parse.c |
| 676 | * |
| 677 | * Uncomment to enable support for (rare) MD4-signed X.509 certs. |
| 678 | * |
Paul Bakker | 13e2dfe | 2009-07-28 07:18:38 +0000 | [diff] [blame] | 679 | #define POLARSSL_MD4_C |
Paul Bakker | 6506aff | 2009-07-28 20:52:02 +0000 | [diff] [blame] | 680 | */ |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 681 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 682 | /** |
| 683 | * \def POLARSSL_MD5_C |
| 684 | * |
| 685 | * Enable the MD5 hash algorithm |
| 686 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 687 | * Module: library/md5.c |
Paul Bakker | 6deb37e | 2013-02-19 13:17:08 +0100 | [diff] [blame] | 688 | * Caller: library/pem.c |
| 689 | * library/ssl_tls.c |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 690 | * library/x509parse.c |
| 691 | * |
| 692 | * This module is required for SSL/TLS and X.509. |
Paul Bakker | 6deb37e | 2013-02-19 13:17:08 +0100 | [diff] [blame] | 693 | * PEM uses MD5 for decrypting encrypted keys. |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 694 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 695 | #define POLARSSL_MD5_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 696 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 697 | /** |
| 698 | * \def POLARSSL_NET_C |
| 699 | * |
| 700 | * Enable the TCP/IP networking routines. |
| 701 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 702 | * Module: library/net.c |
| 703 | * Caller: |
| 704 | * |
| 705 | * This module provides TCP/IP networking routines. |
| 706 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 707 | #define POLARSSL_NET_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 708 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 709 | /** |
| 710 | * \def POLARSSL_PADLOCK_C |
| 711 | * |
| 712 | * Enable VIA Padlock support on x86. |
| 713 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 714 | * Module: library/padlock.c |
| 715 | * Caller: library/aes.c |
| 716 | * |
| 717 | * This modules adds support for the VIA PadLock on x86. |
| 718 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 719 | #define POLARSSL_PADLOCK_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 720 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 721 | /** |
Paul Bakker | f518b16 | 2012-08-23 13:03:18 +0000 | [diff] [blame] | 722 | * \def POLARSSL_PBKDF2_C |
| 723 | * |
| 724 | * Enable PKCS#5 PBKDF2 key derivation function |
Paul Bakker | 19bd297 | 2013-06-14 12:06:45 +0200 | [diff] [blame] | 725 | * DEPRECATED: Use POLARSSL_PKCS5_C instead |
Paul Bakker | f518b16 | 2012-08-23 13:03:18 +0000 | [diff] [blame] | 726 | * |
| 727 | * Module: library/pbkdf2.c |
| 728 | * |
Paul Bakker | 19bd297 | 2013-06-14 12:06:45 +0200 | [diff] [blame] | 729 | * Requires: POLARSSL_PKCS5_C |
Paul Bakker | f518b16 | 2012-08-23 13:03:18 +0000 | [diff] [blame] | 730 | * |
| 731 | * This module adds support for the PKCS#5 PBKDF2 key derivation function. |
| 732 | #define POLARSSL_PBKDF2_C |
| 733 | */ |
| 734 | |
| 735 | /** |
Paul Bakker | 96743fc | 2011-02-12 14:30:57 +0000 | [diff] [blame] | 736 | * \def POLARSSL_PEM_C |
| 737 | * |
| 738 | * Enable PEM decoding |
| 739 | * |
| 740 | * Module: library/pem.c |
| 741 | * Caller: library/x509parse.c |
| 742 | * |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 743 | * Requires: POLARSSL_BASE64_C |
| 744 | * |
Paul Bakker | 96743fc | 2011-02-12 14:30:57 +0000 | [diff] [blame] | 745 | * This modules adds support for decoding PEM files. |
| 746 | */ |
| 747 | #define POLARSSL_PEM_C |
| 748 | |
| 749 | /** |
Paul Bakker | 19bd297 | 2013-06-14 12:06:45 +0200 | [diff] [blame] | 750 | * \def POLARSSL_PKCS5_C |
| 751 | * |
| 752 | * Enable PKCS#5 functions |
| 753 | * |
| 754 | * Module: library/pkcs5.c |
| 755 | * |
| 756 | * Requires: POLARSSL_MD_C |
| 757 | * |
| 758 | * This module adds support for the PKCS#5 functions. |
| 759 | */ |
| 760 | #define POLARSSL_PKCS5_C |
| 761 | |
| 762 | /** |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 763 | * \def POLARSSL_PKCS11_C |
| 764 | * |
Paul Bakker | eb2c658 | 2012-09-27 19:15:01 +0000 | [diff] [blame] | 765 | * Enable wrapper for PKCS#11 smartcard support. |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 766 | * |
| 767 | * Module: library/ssl_srv.c |
| 768 | * Caller: library/ssl_cli.c |
| 769 | * library/ssl_srv.c |
| 770 | * |
| 771 | * Requires: POLARSSL_SSL_TLS_C |
| 772 | * |
Paul Bakker | eb2c658 | 2012-09-27 19:15:01 +0000 | [diff] [blame] | 773 | * This module enables SSL/TLS PKCS #11 smartcard support. |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 774 | * Requires the presence of the PKCS#11 helper library (libpkcs11-helper) |
| 775 | #define POLARSSL_PKCS11_C |
| 776 | */ |
| 777 | |
| 778 | /** |
Paul Bakker | cf6e95d | 2013-06-12 13:18:15 +0200 | [diff] [blame] | 779 | * \def POLARSSL_PKCS12_C |
| 780 | * |
| 781 | * Enable PKCS#12 PBE functions |
| 782 | * Adds algorithms for parsing PKCS#8 encrypted private keys |
| 783 | * |
| 784 | * Module: library/pkcs12.c |
| 785 | * Caller: library/x509parse.c |
| 786 | * |
Paul Bakker | 602c31b | 2013-06-18 16:49:18 +0200 | [diff] [blame] | 787 | * Requires: POLARSSL_ASN1_PARSE_C, POLARSSL_CIPHER_C, POLARSSL_MD_C |
| 788 | * Can use: POLARSSL_ARC4_C |
Paul Bakker | cf6e95d | 2013-06-12 13:18:15 +0200 | [diff] [blame] | 789 | * |
| 790 | * This module enables PKCS#12 functions. |
| 791 | */ |
| 792 | #define POLARSSL_PKCS12_C |
| 793 | |
| 794 | /** |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 795 | * \def POLARSSL_RSA_C |
| 796 | * |
| 797 | * Enable the RSA public-key cryptosystem. |
| 798 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 799 | * Module: library/rsa.c |
| 800 | * Caller: library/ssl_cli.c |
| 801 | * library/ssl_srv.c |
| 802 | * library/ssl_tls.c |
| 803 | * library/x509.c |
| 804 | * |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 805 | * Requires: POLARSSL_BIGNUM_C |
| 806 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 807 | * This module is required for SSL/TLS and MD5-signed certificates. |
| 808 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 809 | #define POLARSSL_RSA_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 810 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 811 | /** |
| 812 | * \def POLARSSL_SHA1_C |
| 813 | * |
| 814 | * Enable the SHA1 cryptographic hash algorithm. |
| 815 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 816 | * Module: library/sha1.c |
| 817 | * Caller: library/ssl_cli.c |
| 818 | * library/ssl_srv.c |
| 819 | * library/ssl_tls.c |
| 820 | * library/x509parse.c |
| 821 | * |
| 822 | * This module is required for SSL/TLS and SHA1-signed certificates. |
| 823 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 824 | #define POLARSSL_SHA1_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 825 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 826 | /** |
| 827 | * \def POLARSSL_SHA2_C |
| 828 | * |
| 829 | * Enable the SHA-224 and SHA-256 cryptographic hash algorithms. |
| 830 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 831 | * Module: library/sha2.c |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 832 | * Caller: library/md_wrap.c |
| 833 | * library/x509parse.c |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 834 | * |
| 835 | * This module adds support for SHA-224 and SHA-256. |
Paul Bakker | 769075d | 2012-11-24 11:26:46 +0100 | [diff] [blame] | 836 | * This module is required for the SSL/TLS 1.2 PRF function. |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 837 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 838 | #define POLARSSL_SHA2_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 839 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 840 | /** |
| 841 | * \def POLARSSL_SHA4_C |
| 842 | * |
| 843 | * Enable the SHA-384 and SHA-512 cryptographic hash algorithms. |
| 844 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 845 | * Module: library/sha4.c |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 846 | * Caller: library/md_wrap.c |
| 847 | * library/x509parse.c |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 848 | * |
| 849 | * This module adds support for SHA-384 and SHA-512. |
| 850 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 851 | #define POLARSSL_SHA4_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 852 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 853 | /** |
Paul Bakker | 0a59707 | 2012-09-25 21:55:46 +0000 | [diff] [blame] | 854 | * \def POLARSSL_SSL_CACHE_C |
| 855 | * |
| 856 | * Enable simple SSL cache implementation. |
| 857 | * |
| 858 | * Module: library/ssl_cache.c |
| 859 | * Caller: |
| 860 | * |
| 861 | * Requires: POLARSSL_SSL_CACHE_C |
| 862 | */ |
| 863 | #define POLARSSL_SSL_CACHE_C |
| 864 | |
| 865 | /** |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 866 | * \def POLARSSL_SSL_CLI_C |
| 867 | * |
| 868 | * Enable the SSL/TLS client code. |
| 869 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 870 | * Module: library/ssl_cli.c |
| 871 | * Caller: |
| 872 | * |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 873 | * Requires: POLARSSL_SSL_TLS_C |
| 874 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 875 | * This module is required for SSL/TLS client support. |
| 876 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 877 | #define POLARSSL_SSL_CLI_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 878 | |
Paul Bakker | 9a73632 | 2012-11-14 12:39:52 +0000 | [diff] [blame] | 879 | /** |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 880 | * \def POLARSSL_SSL_SRV_C |
| 881 | * |
| 882 | * Enable the SSL/TLS server code. |
| 883 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 884 | * Module: library/ssl_srv.c |
| 885 | * Caller: |
| 886 | * |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 887 | * Requires: POLARSSL_SSL_TLS_C |
| 888 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 889 | * This module is required for SSL/TLS server support. |
| 890 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 891 | #define POLARSSL_SSL_SRV_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 892 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 893 | /** |
| 894 | * \def POLARSSL_SSL_TLS_C |
| 895 | * |
Paul Bakker | e29ab06 | 2011-05-18 13:26:54 +0000 | [diff] [blame] | 896 | * Enable the generic SSL/TLS code. |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 897 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 898 | * Module: library/ssl_tls.c |
| 899 | * Caller: library/ssl_cli.c |
| 900 | * library/ssl_srv.c |
| 901 | * |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 902 | * Requires: POLARSSL_MD5_C, POLARSSL_SHA1_C, POLARSSL_X509_PARSE_C |
| 903 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 904 | * This module is required for SSL/TLS. |
| 905 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 906 | #define POLARSSL_SSL_TLS_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 907 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 908 | /** |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 909 | * \def POLARSSL_TIMING_C |
| 910 | * |
| 911 | * Enable the portable timing interface. |
| 912 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 913 | * Module: library/timing.c |
| 914 | * Caller: library/havege.c |
| 915 | * |
| 916 | * This module is used by the HAVEGE random number generator. |
| 917 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 918 | #define POLARSSL_TIMING_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 919 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 920 | /** |
| 921 | * \def POLARSSL_VERSION_C |
| 922 | * |
| 923 | * Enable run-time version information. |
| 924 | * |
Paul Bakker | 0a62cd1 | 2011-01-21 11:00:08 +0000 | [diff] [blame] | 925 | * Module: library/version.c |
| 926 | * |
| 927 | * This module provides run-time version information. |
| 928 | */ |
| 929 | #define POLARSSL_VERSION_C |
| 930 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 931 | /** |
| 932 | * \def POLARSSL_X509_PARSE_C |
| 933 | * |
| 934 | * Enable X.509 certificate parsing. |
| 935 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 936 | * Module: library/x509parse.c |
| 937 | * Caller: library/ssl_cli.c |
| 938 | * library/ssl_srv.c |
| 939 | * library/ssl_tls.c |
| 940 | * |
Paul Bakker | efc3029 | 2011-11-10 14:43:23 +0000 | [diff] [blame] | 941 | * Requires: POLARSSL_ASN1_PARSE_C, POLARSSL_BIGNUM_C, POLARSSL_RSA_C |
Paul Bakker | 5690efc | 2011-05-26 13:16:06 +0000 | [diff] [blame] | 942 | * |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 943 | * This module is required for X.509 certificate parsing. |
| 944 | */ |
Paul Bakker | 40e4694 | 2009-01-03 21:51:57 +0000 | [diff] [blame] | 945 | #define POLARSSL_X509_PARSE_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 946 | |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 947 | /** |
Paul Bakker | bdb912d | 2012-02-13 23:11:30 +0000 | [diff] [blame] | 948 | * \def POLARSSL_X509_WRITE_C |
| 949 | * |
| 950 | * Enable X.509 buffer writing. |
| 951 | * |
| 952 | * Module: library/x509write.c |
| 953 | * |
| 954 | * Requires: POLARSSL_BIGNUM_C, POLARSSL_RSA_C |
| 955 | * |
| 956 | * This module is required for X.509 certificate request writing. |
| 957 | */ |
| 958 | #define POLARSSL_X509_WRITE_C |
| 959 | |
| 960 | /** |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 961 | * \def POLARSSL_XTEA_C |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 962 | * |
Paul Bakker | f3b86c1 | 2011-01-27 15:24:17 +0000 | [diff] [blame] | 963 | * Enable the XTEA block cipher. |
| 964 | * |
Paul Bakker | 7a7c78f | 2009-01-04 18:15:48 +0000 | [diff] [blame] | 965 | * Module: library/xtea.c |
| 966 | * Caller: |
| 967 | */ |
| 968 | #define POLARSSL_XTEA_C |
Paul Bakker | 0a62cd1 | 2011-01-21 11:00:08 +0000 | [diff] [blame] | 969 | /* \} name */ |
Paul Bakker | 7a7c78f | 2009-01-04 18:15:48 +0000 | [diff] [blame] | 970 | |
Paul Bakker | 6fa5488 | 2013-06-17 15:44:03 +0200 | [diff] [blame] | 971 | /** |
| 972 | * \name SECTION: Module configuration options |
| 973 | * |
| 974 | * This section allows for the setting of module specific sizes and |
| 975 | * configuration options. The default values are already present in the |
| 976 | * relevant header files and should suffice for the regular use cases. |
| 977 | * Our advice is to enable POLARSSL_CONFIG_OPTIONS and change values here |
| 978 | * only if you have a good reason and know the consequences. |
| 979 | * |
| 980 | * If POLARSSL_CONFIG_OPTIONS is undefined here the options in the module |
| 981 | * header file take precedence. |
| 982 | * |
| 983 | * Please check the respective header file for documentation on these |
| 984 | * parameters (to prevent duplicate documentation). |
| 985 | * |
| 986 | * Uncomment POLARSSL_CONFIG_OPTIONS to enable using the values defined here. |
| 987 | * \{ |
| 988 | */ |
| 989 | //#define POLARSSL_CONFIG_OPTIONS /**< Enable config.h module value configuration */ |
| 990 | |
| 991 | #if defined(POLARSSL_CONFIG_OPTIONS) |
| 992 | |
| 993 | // MPI / BIGNUM options |
| 994 | // |
| 995 | #define POLARSSL_MPI_WINDOW_SIZE 6 /**< Maximum windows size used. */ |
| 996 | #define POLARSSL_MPI_MAX_SIZE 512 /**< Maximum number of bytes for usable MPIs. */ |
| 997 | |
| 998 | // CTR_DRBG options |
| 999 | // |
| 1000 | #define CTR_DRBG_ENTROPY_LEN 48 /**< Amount of entropy used per seed by default */ |
| 1001 | #define CTR_DRBG_RESEED_INTERVAL 10000 /**< Interval before reseed is performed by default */ |
| 1002 | #define CTR_DRBG_MAX_INPUT 256 /**< Maximum number of additional input bytes */ |
| 1003 | #define CTR_DRBG_MAX_REQUEST 1024 /**< Maximum number of requested bytes per call */ |
| 1004 | #define CTR_DRBG_MAX_SEED_INPUT 384 /**< Maximum size of (re)seed buffer */ |
| 1005 | |
| 1006 | // Entropy options |
| 1007 | // |
| 1008 | #define ENTROPY_MAX_SOURCES 20 /**< Maximum number of sources supported */ |
| 1009 | #define ENTROPY_MAX_GATHER 128 /**< Maximum amount requested from entropy sources */ |
| 1010 | |
| 1011 | // SSL Cache options |
| 1012 | // |
| 1013 | #define SSL_CACHE_DEFAULT_TIMEOUT 86400 /**< 1 day */ |
| 1014 | #define SSL_CACHE_DEFAULT_MAX_ENTRIES 50 /**< Maximum entries in cache */ |
| 1015 | |
| 1016 | // SSL options |
| 1017 | // |
| 1018 | #define SSL_MAX_CONTENT_LEN 16384 /**< Size of the input / output buffer */ |
| 1019 | |
| 1020 | #endif /* POLARSSL_CONFIG_OPTIONS */ |
| 1021 | |
| 1022 | /* \} name */ |
Paul Bakker | 5121ce5 | 2009-01-03 21:22:43 +0000 | [diff] [blame] | 1023 | #endif /* config.h */ |