blob: 579b5d6403f0ea08a4fc7a39b25da24920842ec7 [file] [log] [blame]
Paul Bakker5121ce52009-01-03 21:22:43 +00001/**
2 * \file config.h
3 *
Paul Bakker37ca75d2011-01-06 12:28:03 +00004 * \brief Configuration options (set of defines)
5 *
Paul Bakker0a597072012-09-25 21:55:46 +00006 * Copyright (C) 2006-2012, Brainspark B.V.
Paul Bakkerb96f1542010-07-18 20:36:00 +00007 *
8 * This file is part of PolarSSL (http://www.polarssl.org)
Paul Bakker84f12b72010-07-18 10:13:04 +00009 * Lead Maintainer: Paul Bakker <polarssl_maintainer at polarssl.org>
Paul Bakkerb96f1542010-07-18 20:36:00 +000010 *
Paul Bakker77b385e2009-07-28 17:23:11 +000011 * All rights reserved.
Paul Bakkere0ccd0a2009-01-04 16:27:10 +000012 *
Paul Bakkere0ccd0a2009-01-04 16:27:10 +000013 * 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 Bakker5121ce52009-01-03 21:22:43 +000027 * 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 Bakker40e46942009-01-03 21:51:57 +000031#ifndef POLARSSL_CONFIG_H
32#define POLARSSL_CONFIG_H
Paul Bakker5121ce52009-01-03 21:22:43 +000033
Paul Bakkercce9d772011-11-18 14:26:47 +000034#if defined(_MSC_VER) && !defined(_CRT_SECURE_NO_DEPRECATE)
Paul Bakker5121ce52009-01-03 21:22:43 +000035#define _CRT_SECURE_NO_DEPRECATE 1
36#endif
37
Paul Bakkerf3b86c12011-01-27 15:24:17 +000038/**
Paul Bakker0a62cd12011-01-21 11:00:08 +000039 * \name SECTION: System support
40 *
41 * This section sets system specific settings.
42 * \{
43 */
44
Paul Bakkerf3b86c12011-01-27 15:24:17 +000045/**
46 * \def POLARSSL_HAVE_INT8
Paul Bakker5121ce52009-01-03 21:22:43 +000047 *
Paul Bakkerf3b86c12011-01-27 15:24:17 +000048 * The system uses 8-bit wide native integers.
49 *
50 * Uncomment if native integers are 8-bit wide.
Paul Bakker40e46942009-01-03 21:51:57 +000051#define POLARSSL_HAVE_INT8
Paul Bakker5121ce52009-01-03 21:22:43 +000052 */
53
Paul Bakkerf3b86c12011-01-27 15:24:17 +000054/**
55 * \def POLARSSL_HAVE_INT16
Paul Bakker5121ce52009-01-03 21:22:43 +000056 *
Paul Bakkerf3b86c12011-01-27 15:24:17 +000057 * The system uses 16-bit wide native integers.
58 *
59 * Uncomment if native integers are 16-bit wide.
Paul Bakker40e46942009-01-03 21:51:57 +000060#define POLARSSL_HAVE_INT16
Paul Bakker5121ce52009-01-03 21:22:43 +000061 */
62
Paul Bakkerf3b86c12011-01-27 15:24:17 +000063/**
Paul Bakker62261d62012-10-02 12:19:31 +000064 * \def POLARSSL_HAVE_LONGLONG
Paul Bakker5121ce52009-01-03 21:22:43 +000065 *
Paul Bakker62261d62012-10-02 12:19:31 +000066 * The compiler supports the 'long long' type.
67 * (Only used on 32-bit platforms)
Paul Bakker5121ce52009-01-03 21:22:43 +000068 */
Paul Bakker62261d62012-10-02 12:19:31 +000069#define POLARSSL_HAVE_LONGLONG
Paul Bakker5121ce52009-01-03 21:22:43 +000070
Paul Bakkerf3b86c12011-01-27 15:24:17 +000071/**
72 * \def POLARSSL_HAVE_ASM
73 *
74 * The compiler has support for asm()
75 *
Paul Bakker5121ce52009-01-03 21:22:43 +000076 * Uncomment to enable the use of assembly code.
Paul Bakker68041ec2009-04-19 21:17:55 +000077 *
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 Bakker5121ce52009-01-03 21:22:43 +000085 */
Paul Bakker40e46942009-01-03 21:51:57 +000086#define POLARSSL_HAVE_ASM
Paul Bakker5121ce52009-01-03 21:22:43 +000087
Paul Bakkerf3b86c12011-01-27 15:24:17 +000088/**
89 * \def POLARSSL_HAVE_SSE2
90 *
Paul Bakkere23c3152012-10-01 14:42:47 +000091 * CPU supports SSE2 instruction set.
Paul Bakkerf3b86c12011-01-27 15:24:17 +000092 *
Paul Bakker5121ce52009-01-03 21:22:43 +000093 * Uncomment if the CPU supports SSE2 (IA-32 specific).
94 *
Paul Bakker40e46942009-01-03 21:51:57 +000095#define POLARSSL_HAVE_SSE2
Paul Bakker5121ce52009-01-03 21:22:43 +000096 */
Paul Bakker0a62cd12011-01-21 11:00:08 +000097/* \} name */
98
Paul Bakkerf3b86c12011-01-27 15:24:17 +000099/**
Paul Bakker0a62cd12011-01-21 11:00:08 +0000100 * \name SECTION: PolarSSL feature support
101 *
102 * This section sets support for features that are or are not needed
103 * within the modules that are enabled.
104 * \{
105 */
Paul Bakker5121ce52009-01-03 21:22:43 +0000106
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000107/**
Paul Bakker15566e42011-04-24 21:19:15 +0000108 * \def POLARSSL_AES_ROM_TABLES
109 *
110 * Store the AES tables in ROM.
111 *
112 * Uncomment this macro to store the AES tables in ROM.
113 *
114#define POLARSSL_AES_ROM_TABLES
115 */
116
117/**
Paul Bakkerb6ecaf52011-04-19 14:29:23 +0000118 * \def POLARSSL_CIPHER_MODE_CFB
119 *
120 * Enable Cipher Feedback mode (CFB) for symmetric ciphers.
121 */
122#define POLARSSL_CIPHER_MODE_CFB
123
124/**
125 * \def POLARSSL_CIPHER_MODE_CTR
126 *
127 * Enable Counter Block Cipher mode (CTR) for symmetric ciphers.
128 */
129#define POLARSSL_CIPHER_MODE_CTR
130
131/**
Paul Bakkerfab5c822012-02-06 16:45:10 +0000132 * \def POLARSSL_CIPHER_NULL_CIPHER
133 *
134 * Enable NULL cipher.
135 * Warning: Only do so when you know what you are doing. This allows for
136 * encryption or channels without any security!
137 *
138 * Requires POLARSSL_ENABLE_WEAK_CIPHERSUITES as well to enable
139 * the following ciphersuites:
Paul Bakker645ce3a2012-10-31 12:32:41 +0000140 * TLS_RSA_WITH_NULL_MD5
141 * TLS_RSA_WITH_NULL_SHA
142 * TLS_RSA_WITH_NULL_SHA256
Paul Bakkerfab5c822012-02-06 16:45:10 +0000143 *
144 * Uncomment this macro to enable the NULL cipher and ciphersuites
145#define POLARSSL_CIPHER_NULL_CIPHER
146 */
147
148/**
Paul Bakkerfab5c822012-02-06 16:45:10 +0000149 * \def POLARSSL_ENABLE_WEAK_CIPHERSUITES
150 *
Paul Bakker645ce3a2012-10-31 12:32:41 +0000151 * Enable weak ciphersuites in SSL / TLS
Paul Bakkerfab5c822012-02-06 16:45:10 +0000152 * Warning: Only do so when you know what you are doing. This allows for
Paul Bakker9a736322012-11-14 12:39:52 +0000153 * channels with virtually no security at all!
Paul Bakkerfab5c822012-02-06 16:45:10 +0000154 *
155 * This enables the following ciphersuites:
Paul Bakker645ce3a2012-10-31 12:32:41 +0000156 * TLS_RSA_WITH_DES_CBC_SHA
157 * TLS_DHE_RSA_WITH_DES_CBC_SHA
Paul Bakkerfab5c822012-02-06 16:45:10 +0000158 *
159 * Uncomment this macro to enable weak ciphersuites
160#define POLARSSL_ENABLE_WEAK_CIPHERSUITES
161 */
162
163/**
Paul Bakker8fe40dc2013-02-02 12:43:08 +0100164 * \def POLARSSL_ERROR_STRERROR_DUMMY
165 *
166 * Enable a dummy error function to make use of error_strerror() in
167 * third party libraries easier.
168 *
169 * Disable if you run into name conflicts and want to really remove the
170 * error_strerror()
171 */
172#define POLARSSL_ERROR_STRERROR_DUMMY
173
174/**
Paul Bakker15566e42011-04-24 21:19:15 +0000175 * \def POLARSSL_GENPRIME
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000176 *
Paul Bakker5690efc2011-05-26 13:16:06 +0000177 * Requires: POLARSSL_BIGNUM_C, POLARSSL_RSA_C
178 *
Paul Bakker15566e42011-04-24 21:19:15 +0000179 * Enable the RSA prime-number generation code.
Paul Bakker5121ce52009-01-03 21:22:43 +0000180 */
Paul Bakker15566e42011-04-24 21:19:15 +0000181#define POLARSSL_GENPRIME
Paul Bakker5121ce52009-01-03 21:22:43 +0000182
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000183/**
Paul Bakker335db3f2011-04-25 15:28:35 +0000184 * \def POLARSSL_FS_IO
185 *
186 * Enable functions that use the filesystem.
187 */
188#define POLARSSL_FS_IO
189
190/**
Paul Bakker43655f42011-12-15 20:11:16 +0000191 * \def POLARSSL_NO_DEFAULT_ENTROPY_SOURCES
192 *
193 * Do not add default entropy sources. These are the platform specific,
194 * hardclock and HAVEGE based poll functions.
195 *
196 * This is useful to have more control over the added entropy sources in an
197 * application.
198 *
199 * Uncomment this macro to prevent loading of default entropy functions.
200#define POLARSSL_NO_DEFAULT_ENTROPY_SOURCES
201 */
202
203/**
Paul Bakker6083fd22011-12-03 21:45:14 +0000204 * \def POLARSSL_NO_PLATFORM_ENTROPY
205 *
206 * Do not use built-in platform entropy functions.
207 * This is useful if your platform does not support
208 * standards like the /dev/urandom or Windows CryptoAPI.
209 *
210 * Uncomment this macro to disable the built-in platform entropy functions.
211#define POLARSSL_NO_PLATFORM_ENTROPY
212 */
213
214/**
Paul Bakker9dcc3222011-03-08 14:16:06 +0000215 * \def POLARSSL_PKCS1_V21
216 *
Paul Bakker5690efc2011-05-26 13:16:06 +0000217 * Requires: POLARSSL_MD_C, POLARSSL_RSA_C
218 *
Paul Bakker9dcc3222011-03-08 14:16:06 +0000219 * Enable support for PKCS#1 v2.1 encoding.
220 * This enables support for RSAES-OAEP and RSASSA-PSS operations.
221 */
222#define POLARSSL_PKCS1_V21
223
224/**
Paul Bakker0216cc12011-03-26 13:40:23 +0000225 * \def POLARSSL_RSA_NO_CRT
226 *
227 * Do not use the Chinese Remainder Theorem for the RSA private operation.
228 *
229 * Uncomment this macro to disable the use of CRT in RSA.
230 *
231#define POLARSSL_RSA_NO_CRT
232 */
Paul Bakker15566e42011-04-24 21:19:15 +0000233
234/**
235 * \def POLARSSL_SELF_TEST
236 *
237 * Enable the checkup functions (*_self_test).
238 */
239#define POLARSSL_SELF_TEST
Paul Bakker5c721f92011-07-27 16:51:09 +0000240
241/**
Paul Bakker40865c82013-01-31 17:13:13 +0100242 * \def POLARSSL_SSL_ALL_ALERT_MESSAGES
243 *
244 * Enable sending of alert messages in case of encountered errors as per RFC.
245 * If you choose not to send the alert messages, PolarSSL can still communicate
246 * with other servers, only debugging of failures is harder.
247 *
248 * The advantage of not sending alert messages, is that no information is given
249 * about reasons for failures thus preventing adversaries of gaining intel.
250 *
251 * Enable sending of all alert messages
252 */
253#define POLARSSL_SSL_ALERT_MESSAGES
254
255/**
Paul Bakkerd66f0702013-01-31 16:57:45 +0100256 * \def POLARSSL_SSL_DEBUG_ALL
257 *
258 * Enable the debug messages in SSL module for all issues.
259 * Debug messages have been disabled in some places to prevent timing
260 * attacks due to (unbalanced) debugging function calls.
261 *
262 * If you need all error reporting you should enable this during debugging,
263 * but remove this for production servers that should log as well.
264 *
265 * Uncomment this macro to report all debug messages on errors introducing
266 * a timing side-channel.
267 *
268#define POLARSSL_SSL_DEBUG_ALL
269 */
270
271/**
Paul Bakker05ef8352012-05-08 09:17:57 +0000272 * \def POLARSSL_SSL_HW_RECORD_ACCEL
273 *
274 * Enable hooking functions in SSL module for hardware acceleration of
275 * individual records.
276 *
277 * Uncomment this macro to enable hooking functions.
278#define POLARSSL_SSL_HW_RECORD_ACCEL
279 */
280
281/**
Paul Bakker78a8c712013-03-06 17:01:52 +0100282 * \def POLARSSL_SSL_SRV_SUPPORT_SSLV2_CLIENT_HELLO
283 *
284 * Enable support for receiving and parsing SSLv2 Client Hello messages for the
285 * SSL Server module (POLARSSL_SSL_SRV_C)
286 *
287 * Comment this macro to disable support for SSLv2 Client Hello messages.
288 */
289#define POLARSSL_SSL_SRV_SUPPORT_SSLV2_CLIENT_HELLO
290
291/**
Paul Bakker5c721f92011-07-27 16:51:09 +0000292 * \def POLARSSL_X509_ALLOW_UNSUPPORTED_CRITICAL_EXTENSION
293 *
294 * If set, the X509 parser will not break-off when parsing an X509 certificate
295 * and encountering an unknown critical extension.
296 *
297 * Uncomment to prevent an error.
298 *
299#define POLARSSL_X509_ALLOW_UNSUPPORTED_CRITICAL_EXTENSION
300 */
Paul Bakker2770fbd2012-07-03 13:30:23 +0000301
302/**
303 * \def POLARSSL_ZLIB_SUPPORT
304 *
305 * If set, the SSL/TLS module uses ZLIB to support compression and
306 * decompression of packet data.
307 *
308 * Used in: library/ssl_tls.c
309 * library/ssl_cli.c
310 * library/ssl_srv.c
311 *
312 * This feature requires zlib library and headers to be present.
313 *
314 * Uncomment to enable use of ZLIB
315#define POLARSSL_ZLIB_SUPPORT
316 */
Paul Bakker0a62cd12011-01-21 11:00:08 +0000317/* \} name */
318
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000319/**
Paul Bakker0a62cd12011-01-21 11:00:08 +0000320 * \name SECTION: PolarSSL modules
321 *
322 * This section enables or disables entire modules in PolarSSL
323 * \{
324 */
Paul Bakker5121ce52009-01-03 21:22:43 +0000325
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000326/**
327 * \def POLARSSL_AES_C
328 *
329 * Enable the AES block cipher.
330 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000331 * Module: library/aes.c
332 * Caller: library/ssl_tls.c
Paul Bakker96743fc2011-02-12 14:30:57 +0000333 * library/pem.c
Paul Bakker6083fd22011-12-03 21:45:14 +0000334 * library/ctr_drbg.c
Paul Bakker5121ce52009-01-03 21:22:43 +0000335 *
Paul Bakker645ce3a2012-10-31 12:32:41 +0000336 * This module enables the following ciphersuites (if other requisites are
337 * enabled as well):
338 * TLS_RSA_WITH_AES_128_CBC_SHA
339 * TLS_RSA_WITH_AES_256_CBC_SHA
340 * TLS_DHE_RSA_WITH_AES_128_CBC_SHA
341 * TLS_DHE_RSA_WITH_AES_256_CBC_SHA
342 * TLS_RSA_WITH_AES_128_CBC_SHA256
343 * TLS_RSA_WITH_AES_256_CBC_SHA256
344 * TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
345 * TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
346 * TLS_RSA_WITH_AES_128_GCM_SHA256
347 * TLS_RSA_WITH_AES_256_GCM_SHA384
Paul Bakker6deb37e2013-02-19 13:17:08 +0100348 *
349 * PEM uses AES for decrypting encrypted keys.
Paul Bakker5121ce52009-01-03 21:22:43 +0000350 */
Paul Bakker40e46942009-01-03 21:51:57 +0000351#define POLARSSL_AES_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000352
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000353/**
354 * \def POLARSSL_ARC4_C
355 *
356 * Enable the ARCFOUR stream cipher.
357 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000358 * Module: library/arc4.c
359 * Caller: library/ssl_tls.c
360 *
361 * This module enables the following ciphersuites:
Paul Bakker645ce3a2012-10-31 12:32:41 +0000362 * TLS_RSA_WITH_RC4_128_MD5
363 * TLS_RSA_WITH_RC4_128_SHA
Paul Bakker5121ce52009-01-03 21:22:43 +0000364 */
Paul Bakker40e46942009-01-03 21:51:57 +0000365#define POLARSSL_ARC4_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000366
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000367/**
Paul Bakkerefc30292011-11-10 14:43:23 +0000368 * \def POLARSSL_ASN1_PARSE_C
369 *
370 * Enable the generic ASN1 parser.
371 *
372 * Module: library/asn1.c
373 * Caller: library/x509parse.c
374 */
375#define POLARSSL_ASN1_PARSE_C
376
377/**
Paul Bakkerbdb912d2012-02-13 23:11:30 +0000378 * \def POLARSSL_ASN1_WRITE_C
379 *
380 * Enable the generic ASN1 writer.
381 *
382 * Module: library/asn1write.c
383 */
384#define POLARSSL_ASN1_WRITE_C
385
386/**
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000387 * \def POLARSSL_BASE64_C
388 *
389 * Enable the Base64 module.
390 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000391 * Module: library/base64.c
Paul Bakker5690efc2011-05-26 13:16:06 +0000392 * Caller: library/pem.c
Paul Bakker5121ce52009-01-03 21:22:43 +0000393 *
Paul Bakker5690efc2011-05-26 13:16:06 +0000394 * This module is required for PEM support (required by X.509).
Paul Bakker5121ce52009-01-03 21:22:43 +0000395 */
Paul Bakker40e46942009-01-03 21:51:57 +0000396#define POLARSSL_BASE64_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000397
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000398/**
399 * \def POLARSSL_BIGNUM_C
400 *
Paul Bakker9a736322012-11-14 12:39:52 +0000401 * Enable the multi-precision integer library.
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000402 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000403 * Module: library/bignum.c
404 * Caller: library/dhm.c
405 * library/rsa.c
406 * library/ssl_tls.c
407 * library/x509parse.c
408 *
409 * This module is required for RSA and DHM support.
410 */
Paul Bakker40e46942009-01-03 21:51:57 +0000411#define POLARSSL_BIGNUM_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000412
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000413/**
Paul Bakkera9379c02012-07-04 11:02:11 +0000414 * \def POLARSSL_BLOWFISH_C
415 *
416 * Enable the Blowfish block cipher.
417 *
418 * Module: library/blowfish.c
419 */
420#define POLARSSL_BLOWFISH_C
421
422/**
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000423 * \def POLARSSL_CAMELLIA_C
424 *
425 * Enable the Camellia block cipher.
426 *
Paul Bakker38119b12009-01-10 23:31:23 +0000427 * Module: library/camellia.c
Paul Bakker13e2dfe2009-07-28 07:18:38 +0000428 * Caller: library/ssl_tls.c
Paul Bakker38119b12009-01-10 23:31:23 +0000429 *
Paul Bakker645ce3a2012-10-31 12:32:41 +0000430 * This module enables the following ciphersuites (if other requisites are
431 * enabled as well):
432 * TLS_RSA_WITH_CAMELLIA_128_CBC_SHA
433 * TLS_RSA_WITH_CAMELLIA_256_CBC_SHA
434 * TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA
435 * TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA
436 * TLS_RSA_WITH_CAMELLIA_128_CBC_SHA256
437 * TLS_RSA_WITH_CAMELLIA_256_CBC_SHA256
438 * TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256
439 * TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256
Paul Bakker38119b12009-01-10 23:31:23 +0000440 */
441#define POLARSSL_CAMELLIA_C
442
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000443/**
444 * \def POLARSSL_CERTS_C
445 *
446 * Enable the test certificates.
447 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000448 * Module: library/certs.c
449 * Caller:
450 *
451 * This module is used for testing (ssl_client/server).
452 */
Paul Bakker40e46942009-01-03 21:51:57 +0000453#define POLARSSL_CERTS_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000454
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000455/**
456 * \def POLARSSL_CIPHER_C
457 *
458 * Enable the generic cipher layer.
459 *
Paul Bakker8123e9d2011-01-06 15:37:30 +0000460 * Module: library/cipher.c
461 * Caller:
462 *
463 * Uncomment to enable generic cipher wrappers.
464 */
465#define POLARSSL_CIPHER_C
466
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000467/**
Paul Bakker0e04d0e2011-11-27 14:46:59 +0000468 * \def POLARSSL_CTR_DRBG_C
469 *
470 * Enable the CTR_DRBG AES-256-based random generator
471 *
472 * Module: library/ctr_drbg.c
473 * Caller:
474 *
Paul Bakker6083fd22011-12-03 21:45:14 +0000475 * Requires: POLARSSL_AES_C
476 *
Paul Bakker0e04d0e2011-11-27 14:46:59 +0000477 * This module provides the CTR_DRBG AES-256 random number generator.
478 */
479#define POLARSSL_CTR_DRBG_C
480
481/**
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000482 * \def POLARSSL_DEBUG_C
483 *
484 * Enable the debug functions.
485 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000486 * Module: library/debug.c
487 * Caller: library/ssl_cli.c
488 * library/ssl_srv.c
489 * library/ssl_tls.c
490 *
491 * This module provides debugging functions.
492 */
Paul Bakker40e46942009-01-03 21:51:57 +0000493#define POLARSSL_DEBUG_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000494
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000495/**
496 * \def POLARSSL_DES_C
497 *
498 * Enable the DES block cipher.
499 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000500 * Module: library/des.c
Paul Bakker6deb37e2013-02-19 13:17:08 +0100501 * Caller: library/pem.c
502 * library/ssl_tls.c
Paul Bakker5121ce52009-01-03 21:22:43 +0000503 *
Paul Bakker645ce3a2012-10-31 12:32:41 +0000504 * This module enables the following ciphersuites (if other requisites are
505 * enabled as well):
506 * TLS_RSA_WITH_3DES_EDE_CBC_SHA
507 * TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA
Paul Bakker6deb37e2013-02-19 13:17:08 +0100508 *
509 * PEM uses DES/3DES for decrypting encrypted keys.
Paul Bakker5121ce52009-01-03 21:22:43 +0000510 */
Paul Bakker40e46942009-01-03 21:51:57 +0000511#define POLARSSL_DES_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000512
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000513/**
514 * \def POLARSSL_DHM_C
515 *
516 * Enable the Diffie-Hellman-Merkle key exchange.
517 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000518 * Module: library/dhm.c
519 * Caller: library/ssl_cli.c
520 * library/ssl_srv.c
521 *
Paul Bakker645ce3a2012-10-31 12:32:41 +0000522 * This module enables the following ciphersuites (if other requisites are
523 * enabled as well):
524 * TLS_DHE_RSA_WITH_DES_CBC_SHA
525 * TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA
526 * TLS_DHE_RSA_WITH_AES_128_CBC_SHA
527 * TLS_DHE_RSA_WITH_AES_256_CBC_SHA
528 * TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
529 * TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
530 * TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA
531 * TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA
532 * TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256
533 * TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256
534 * TLS_DHE_RSA_WITH_AES_128_GCM_SHA256
535 * TLS_DHE_RSA_WITH_AES_256_GCM_SHA384
Paul Bakker5121ce52009-01-03 21:22:43 +0000536 */
Paul Bakker40e46942009-01-03 21:51:57 +0000537#define POLARSSL_DHM_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000538
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000539/**
Paul Bakker6083fd22011-12-03 21:45:14 +0000540 * \def POLARSSL_ENTROPY_C
541 *
542 * Enable the platform-specific entropy code.
543 *
544 * Module: library/entropy.c
545 * Caller:
546 *
547 * Requires: POLARSSL_SHA4_C
548 *
549 * This module provides a generic entropy pool
550 */
551#define POLARSSL_ENTROPY_C
552
553/**
Paul Bakker9d781402011-05-09 16:17:09 +0000554 * \def POLARSSL_ERROR_C
555 *
556 * Enable error code to error string conversion.
557 *
558 * Module: library/error.c
559 * Caller:
560 *
561 * This module enables err_strerror().
562 */
563#define POLARSSL_ERROR_C
564
565/**
Paul Bakker89e80c92012-03-20 13:50:09 +0000566 * \def POLARSSL_GCM_C
567 *
568 * Enable the Galois/Counter Mode (GCM) for AES
569 *
570 * Module: library/gcm.c
571 *
572 * Requires: POLARSSL_AES_C
Paul Bakker645ce3a2012-10-31 12:32:41 +0000573 *
574 * This module enables the following ciphersuites (if other requisites are
575 * enabled as well):
576 * TLS_RSA_WITH_AES_128_GCM_SHA256
577 * TLS_RSA_WITH_AES_256_GCM_SHA384
Paul Bakker89e80c92012-03-20 13:50:09 +0000578 */
579#define POLARSSL_GCM_C
580
581/**
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000582 * \def POLARSSL_HAVEGE_C
583 *
584 * Enable the HAVEGE random generator.
585 *
Paul Bakker08f06cf2013-06-06 14:05:26 +0200586 * Warning: the HAVEGE random generator is not suitable for virtualized
587 * environments
588 *
589 * Warning: the HAVEGE random generator is dependent on timing and specific
590 * processor traits. It is therefore not advised to use HAVEGE as
591 * your applications primary random generator or primary entropy pool
592 * input. As a secondary input to your entropy pool, it IS able add
593 * the (limited) extra entropy it provides.
594 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000595 * Module: library/havege.c
596 * Caller:
597 *
Paul Bakker5690efc2011-05-26 13:16:06 +0000598 * Requires: POLARSSL_TIMING_C
599 *
Paul Bakker08f06cf2013-06-06 14:05:26 +0200600 * Uncomment to enable the HAVEGE random generator.
Paul Bakker40e46942009-01-03 21:51:57 +0000601#define POLARSSL_HAVEGE_C
Paul Bakker08f06cf2013-06-06 14:05:26 +0200602 */
Paul Bakker5121ce52009-01-03 21:22:43 +0000603
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000604/**
605 * \def POLARSSL_MD_C
606 *
607 * Enable the generic message digest layer.
608 *
Paul Bakker17373852011-01-06 14:20:01 +0000609 * Module: library/md.c
610 * Caller:
611 *
612 * Uncomment to enable generic message digest wrappers.
613 */
614#define POLARSSL_MD_C
615
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000616/**
617 * \def POLARSSL_MD2_C
618 *
619 * Enable the MD2 hash algorithm
620 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000621 * Module: library/md2.c
622 * Caller: library/x509parse.c
623 *
624 * Uncomment to enable support for (rare) MD2-signed X.509 certs.
625 *
Paul Bakker13e2dfe2009-07-28 07:18:38 +0000626#define POLARSSL_MD2_C
Paul Bakker6506aff2009-07-28 20:52:02 +0000627 */
Paul Bakker5121ce52009-01-03 21:22:43 +0000628
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000629/**
630 * \def POLARSSL_MD4_C
631 *
632 * Enable the MD4 hash algorithm
633 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000634 * Module: library/md4.c
635 * Caller: library/x509parse.c
636 *
637 * Uncomment to enable support for (rare) MD4-signed X.509 certs.
638 *
Paul Bakker13e2dfe2009-07-28 07:18:38 +0000639#define POLARSSL_MD4_C
Paul Bakker6506aff2009-07-28 20:52:02 +0000640 */
Paul Bakker5121ce52009-01-03 21:22:43 +0000641
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000642/**
643 * \def POLARSSL_MD5_C
644 *
645 * Enable the MD5 hash algorithm
646 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000647 * Module: library/md5.c
Paul Bakker6deb37e2013-02-19 13:17:08 +0100648 * Caller: library/pem.c
649 * library/ssl_tls.c
Paul Bakker5121ce52009-01-03 21:22:43 +0000650 * library/x509parse.c
651 *
652 * This module is required for SSL/TLS and X.509.
Paul Bakker6deb37e2013-02-19 13:17:08 +0100653 * PEM uses MD5 for decrypting encrypted keys.
Paul Bakker5121ce52009-01-03 21:22:43 +0000654 */
Paul Bakker40e46942009-01-03 21:51:57 +0000655#define POLARSSL_MD5_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000656
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000657/**
658 * \def POLARSSL_NET_C
659 *
660 * Enable the TCP/IP networking routines.
661 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000662 * Module: library/net.c
663 * Caller:
664 *
665 * This module provides TCP/IP networking routines.
666 */
Paul Bakker40e46942009-01-03 21:51:57 +0000667#define POLARSSL_NET_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000668
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000669/**
670 * \def POLARSSL_PADLOCK_C
671 *
672 * Enable VIA Padlock support on x86.
673 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000674 * Module: library/padlock.c
675 * Caller: library/aes.c
676 *
677 * This modules adds support for the VIA PadLock on x86.
678 */
Paul Bakker40e46942009-01-03 21:51:57 +0000679#define POLARSSL_PADLOCK_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000680
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000681/**
Paul Bakkerf518b162012-08-23 13:03:18 +0000682 * \def POLARSSL_PBKDF2_C
683 *
684 * Enable PKCS#5 PBKDF2 key derivation function
685 *
686 * Module: library/pbkdf2.c
687 *
688 * Requires: POLARSSL_MD_C
689 *
690 * This module adds support for the PKCS#5 PBKDF2 key derivation function.
691#define POLARSSL_PBKDF2_C
692 */
693
694/**
Paul Bakker96743fc2011-02-12 14:30:57 +0000695 * \def POLARSSL_PEM_C
696 *
697 * Enable PEM decoding
698 *
699 * Module: library/pem.c
700 * Caller: library/x509parse.c
701 *
Paul Bakker5690efc2011-05-26 13:16:06 +0000702 * Requires: POLARSSL_BASE64_C
703 *
Paul Bakker96743fc2011-02-12 14:30:57 +0000704 * This modules adds support for decoding PEM files.
705 */
706#define POLARSSL_PEM_C
707
708/**
Paul Bakker5690efc2011-05-26 13:16:06 +0000709 * \def POLARSSL_PKCS11_C
710 *
Paul Bakkereb2c6582012-09-27 19:15:01 +0000711 * Enable wrapper for PKCS#11 smartcard support.
Paul Bakker5690efc2011-05-26 13:16:06 +0000712 *
713 * Module: library/ssl_srv.c
714 * Caller: library/ssl_cli.c
715 * library/ssl_srv.c
716 *
717 * Requires: POLARSSL_SSL_TLS_C
718 *
Paul Bakkereb2c6582012-09-27 19:15:01 +0000719 * This module enables SSL/TLS PKCS #11 smartcard support.
Paul Bakker5690efc2011-05-26 13:16:06 +0000720 * Requires the presence of the PKCS#11 helper library (libpkcs11-helper)
721#define POLARSSL_PKCS11_C
722 */
723
724/**
Paul Bakkercf6e95d2013-06-12 13:18:15 +0200725 * \def POLARSSL_PKCS12_C
726 *
727 * Enable PKCS#12 PBE functions
728 * Adds algorithms for parsing PKCS#8 encrypted private keys
729 *
730 * Module: library/pkcs12.c
731 * Caller: library/x509parse.c
732 *
733 * Requires: POLARSSL_ASN1_PARSE_C
734 * Can use: POLARSSL_SHA1_C, POLARSSL_DES_C, POLARSSL_ARC4_C
735 *
736 * This module enables PKCS#12 functions.
737 */
738#define POLARSSL_PKCS12_C
739
740/**
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000741 * \def POLARSSL_RSA_C
742 *
743 * Enable the RSA public-key cryptosystem.
744 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000745 * Module: library/rsa.c
746 * Caller: library/ssl_cli.c
747 * library/ssl_srv.c
748 * library/ssl_tls.c
749 * library/x509.c
750 *
Paul Bakker5690efc2011-05-26 13:16:06 +0000751 * Requires: POLARSSL_BIGNUM_C
752 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000753 * This module is required for SSL/TLS and MD5-signed certificates.
754 */
Paul Bakker40e46942009-01-03 21:51:57 +0000755#define POLARSSL_RSA_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000756
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000757/**
758 * \def POLARSSL_SHA1_C
759 *
760 * Enable the SHA1 cryptographic hash algorithm.
761 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000762 * Module: library/sha1.c
763 * Caller: library/ssl_cli.c
764 * library/ssl_srv.c
765 * library/ssl_tls.c
766 * library/x509parse.c
767 *
768 * This module is required for SSL/TLS and SHA1-signed certificates.
769 */
Paul Bakker40e46942009-01-03 21:51:57 +0000770#define POLARSSL_SHA1_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000771
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000772/**
773 * \def POLARSSL_SHA2_C
774 *
775 * Enable the SHA-224 and SHA-256 cryptographic hash algorithms.
776 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000777 * Module: library/sha2.c
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000778 * Caller: library/md_wrap.c
779 * library/x509parse.c
Paul Bakker5121ce52009-01-03 21:22:43 +0000780 *
781 * This module adds support for SHA-224 and SHA-256.
Paul Bakker769075d2012-11-24 11:26:46 +0100782 * This module is required for the SSL/TLS 1.2 PRF function.
Paul Bakker5121ce52009-01-03 21:22:43 +0000783 */
Paul Bakker40e46942009-01-03 21:51:57 +0000784#define POLARSSL_SHA2_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000785
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000786/**
787 * \def POLARSSL_SHA4_C
788 *
789 * Enable the SHA-384 and SHA-512 cryptographic hash algorithms.
790 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000791 * Module: library/sha4.c
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000792 * Caller: library/md_wrap.c
793 * library/x509parse.c
Paul Bakker5121ce52009-01-03 21:22:43 +0000794 *
795 * This module adds support for SHA-384 and SHA-512.
796 */
Paul Bakker40e46942009-01-03 21:51:57 +0000797#define POLARSSL_SHA4_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000798
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000799/**
Paul Bakker0a597072012-09-25 21:55:46 +0000800 * \def POLARSSL_SSL_CACHE_C
801 *
802 * Enable simple SSL cache implementation.
803 *
804 * Module: library/ssl_cache.c
805 * Caller:
806 *
807 * Requires: POLARSSL_SSL_CACHE_C
808 */
809#define POLARSSL_SSL_CACHE_C
810
811/**
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000812 * \def POLARSSL_SSL_CLI_C
813 *
814 * Enable the SSL/TLS client code.
815 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000816 * Module: library/ssl_cli.c
817 * Caller:
818 *
Paul Bakker5690efc2011-05-26 13:16:06 +0000819 * Requires: POLARSSL_SSL_TLS_C
820 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000821 * This module is required for SSL/TLS client support.
822 */
Paul Bakker40e46942009-01-03 21:51:57 +0000823#define POLARSSL_SSL_CLI_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000824
Paul Bakker9a736322012-11-14 12:39:52 +0000825/**
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000826 * \def POLARSSL_SSL_SRV_C
827 *
828 * Enable the SSL/TLS server code.
829 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000830 * Module: library/ssl_srv.c
831 * Caller:
832 *
Paul Bakker5690efc2011-05-26 13:16:06 +0000833 * Requires: POLARSSL_SSL_TLS_C
834 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000835 * This module is required for SSL/TLS server support.
836 */
Paul Bakker40e46942009-01-03 21:51:57 +0000837#define POLARSSL_SSL_SRV_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000838
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000839/**
840 * \def POLARSSL_SSL_TLS_C
841 *
Paul Bakkere29ab062011-05-18 13:26:54 +0000842 * Enable the generic SSL/TLS code.
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000843 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000844 * Module: library/ssl_tls.c
845 * Caller: library/ssl_cli.c
846 * library/ssl_srv.c
847 *
Paul Bakker5690efc2011-05-26 13:16:06 +0000848 * Requires: POLARSSL_MD5_C, POLARSSL_SHA1_C, POLARSSL_X509_PARSE_C
849 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000850 * This module is required for SSL/TLS.
851 */
Paul Bakker40e46942009-01-03 21:51:57 +0000852#define POLARSSL_SSL_TLS_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000853
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000854/**
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000855 * \def POLARSSL_TIMING_C
856 *
857 * Enable the portable timing interface.
858 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000859 * Module: library/timing.c
860 * Caller: library/havege.c
861 *
862 * This module is used by the HAVEGE random number generator.
863 */
Paul Bakker40e46942009-01-03 21:51:57 +0000864#define POLARSSL_TIMING_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000865
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000866/**
867 * \def POLARSSL_VERSION_C
868 *
869 * Enable run-time version information.
870 *
Paul Bakker0a62cd12011-01-21 11:00:08 +0000871 * Module: library/version.c
872 *
873 * This module provides run-time version information.
874 */
875#define POLARSSL_VERSION_C
876
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000877/**
878 * \def POLARSSL_X509_PARSE_C
879 *
880 * Enable X.509 certificate parsing.
881 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000882 * Module: library/x509parse.c
883 * Caller: library/ssl_cli.c
884 * library/ssl_srv.c
885 * library/ssl_tls.c
886 *
Paul Bakkerefc30292011-11-10 14:43:23 +0000887 * Requires: POLARSSL_ASN1_PARSE_C, POLARSSL_BIGNUM_C, POLARSSL_RSA_C
Paul Bakker5690efc2011-05-26 13:16:06 +0000888 *
Paul Bakker5121ce52009-01-03 21:22:43 +0000889 * This module is required for X.509 certificate parsing.
890 */
Paul Bakker40e46942009-01-03 21:51:57 +0000891#define POLARSSL_X509_PARSE_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000892
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000893/**
Paul Bakkerbdb912d2012-02-13 23:11:30 +0000894 * \def POLARSSL_X509_WRITE_C
895 *
896 * Enable X.509 buffer writing.
897 *
898 * Module: library/x509write.c
899 *
900 * Requires: POLARSSL_BIGNUM_C, POLARSSL_RSA_C
901 *
902 * This module is required for X.509 certificate request writing.
903 */
904#define POLARSSL_X509_WRITE_C
905
906/**
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000907 * \def POLARSSL_XTEA_C
Paul Bakker5121ce52009-01-03 21:22:43 +0000908 *
Paul Bakkerf3b86c12011-01-27 15:24:17 +0000909 * Enable the XTEA block cipher.
910 *
Paul Bakker7a7c78f2009-01-04 18:15:48 +0000911 * Module: library/xtea.c
912 * Caller:
913 */
914#define POLARSSL_XTEA_C
Paul Bakker0a62cd12011-01-21 11:00:08 +0000915/* \} name */
Paul Bakker7a7c78f2009-01-04 18:15:48 +0000916
Paul Bakker5121ce52009-01-03 21:22:43 +0000917#endif /* config.h */