wolfssl/examples/configs
gojimmypi 3254f56d32
Improve PlatformIO Certificate Bundle Support
2025-06-06 15:48:07 -07:00
..
README.md Template for wolfSSH minimal build using user_settings.h. ZD 17991. 2024-06-03 09:34:52 -07:00
include.am Fixes for ECC non-blocking tests. Added example user_settings.h build test. Demonstrate ECC 256, 384 and 521 bit. 2025-03-05 15:58:51 -08:00
user_settings_EBSnet.h update copyright date 2025-01-21 09:55:03 -07:00
user_settings_all.h update copyright date 2025-01-21 09:55:03 -07:00
user_settings_arduino.h Fix Arduino progmem print, AVR WOLFSSL_USER_IO 2025-04-18 14:29:32 +02:00
user_settings_eccnonblock.h fix a couple broken configs in examples/configs/ - simultaneous SP and NO_BIG_INT. 2025-03-20 22:40:08 -05:00
user_settings_espressif.h Adjust Espressif Examples for Post Quantum ML-KEM 2025-06-02 15:11:53 -07:00
user_settings_fipsv2.h update copyright date 2025-01-21 09:55:03 -07:00
user_settings_fipsv5.h update copyright date 2025-01-21 09:55:03 -07:00
user_settings_min_ecc.h update copyright date 2025-01-21 09:55:03 -07:00
user_settings_platformio.h Improve PlatformIO Certificate Bundle Support 2025-06-06 15:48:07 -07:00
user_settings_stm32.h ML-KEM/Kyber: finish name change 2025-03-10 08:37:14 +10:00
user_settings_template.h update copyright date 2025-01-21 09:55:03 -07:00
user_settings_tls12.h update copyright date 2025-01-21 09:55:03 -07:00
user_settings_wolfboot_keytools.h update copyright date 2025-01-21 09:55:03 -07:00
user_settings_wolfssh.h update copyright date 2025-01-21 09:55:03 -07:00
user_settings_wolftpm.h fix a couple broken configs in examples/configs/ - simultaneous SP and NO_BIG_INT. 2025-03-20 22:40:08 -05:00

README.md

Example build configurations

Example wolfSSL configuration file templates for use when autoconf is not available, such as building with a custom IDE.

Files

  • user_settings_template.h: Template that allows modular algorithm and feature selection using #if 0 logic.
  • user_settings_all.h: This is wolfSSL with all features enabled. Equivalent to ./configure --enable-all.
  • user_settings_arduino.h: An example Arduino file. See also wolfSSL/Arduino-wolfSSL. *.user_settings_EBSnet.h: Example configuration file for use with EBSnet ports.
  • user_settings_fipsv2.h: The FIPS v2 (3389) 140-2 certificate build options.
  • user_settings_fipsv5.h: The FIPS v5 (ready) 140-3 build options. Equivalent to ./configure --enable-fips=v5-dev.
  • user_settings_min_ecc.h: This is ECC and SHA-256 only. For ECC verify only add BUILD_VERIFY_ONLY.
  • user_settings_platformio.h: An example for PlatformIO library. See also platformio/wolfssl
  • user_settings_stm32.h: Example configuration file generated from the wolfSSL STM32 Cube pack.
  • user_settings_tls12: Example for TLS v1.2 client only, ECC only, AES GCM only, SHA2-256 only.
  • user_settings_wolfboot_keytools.h: This from wolfBoot tools/keytools and is ECC, RSA, ED25519 and ChaCha20.
  • user_settings_wolfssh.h: Minimum options for building wolfSSH. See comment at top for ./configure used to generate.
  • user_settings_wolftpm.h: Minimum options for building wolfTPM. See comment at top for ./configure used to generate.

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