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