2020-04-03 10:58:16 -07:00
|
|
|
# Example build configurations
|
|
|
|
|
|
2020-07-31 11:41:40 -07:00
|
|
|
Example wolfSSL configuration file templates for use when autoconf is not available, such as building with a custom IDE.
|
2020-04-03 10:58:16 -07:00
|
|
|
|
|
|
|
|
## Files
|
|
|
|
|
|
2021-06-09 12:40:40 -07:00
|
|
|
* `user_settings_template.h`: Template that allows modular algorithm and feature selection using `#if 0` logic.
|
2020-07-31 11:41:40 -07:00
|
|
|
* `user_settings_all.h`: This is wolfSSL with all features enabled. Equivalent to `./configure --enable-all`.
|
2020-04-03 10:58:16 -07:00
|
|
|
* `user_settings_min_ecc.h`: This is ECC and SHA-256 only. For ECC verify only add `BUILD_VERIFY_ONLY`.
|
2020-07-31 11:41:40 -07:00
|
|
|
* `user_settings_wolfboot_keytools.h`: This from wolfBoot tools/keytools and is ECC, RSA, ED25519 and ChaCha20.
|
2021-06-09 12:40:40 -07:00
|
|
|
* `user_settings_fipsv2.h`: The FIPS v2 (3389) 140-2 certificate build options.
|
2022-02-02 08:29:05 -08:00
|
|
|
* `user_settings_fipsv5.h`: The FIPS v5 (ready) 140-3 build options. Equivalent to `./configure --enable-fips=v5-dev`.
|
2021-06-10 08:33:16 -07:00
|
|
|
* `user_settings_stm32.h`: Example configuration file generated from the wolfSSL STM32 Cube pack.
|
2020-07-31 11:41:40 -07:00
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
1. Copy to your local project and rename to `user_settings.h`.
|
|
|
|
|
2. Add pre-processor macro `WOLFSSL_USER_SETTINGS` to your project.
|
|
|
|
|
3. Make sure and include `#include <wolfssl/wolfcrypt/settings.h>` prior to any other wolfSSL headers in your application.
|
|
|
|
|
|
|
|
|
|
## Testing with Autoconf
|
|
|
|
|
|
|
|
|
|
To use these with autoconf:
|
|
|
|
|
|
|
|
|
|
1. Copy file to root as `user_settings.h`.
|
|
|
|
|
2. Run `./configure --enable-usersettings --disable-examples && make`
|
