wolfssl

mirror of https://github.com/wolfSSL/wolfssl.git synced 2026-08-18 01:31:32 +02:00

Files

T

Tobias Frauenschläger 29506d2cac build: distribute IDE project trees per-directory to fix "make dist"

The non-recursive automake "distdir" recipe inlines the entire $(DISTFILES)
list into a single shell command. Enumerating every IDE integration file
individually made that list large enough (~123 KB) that the recipe exceeded
the Linux MAX_ARG_STRLEN (128 KB) single-argument exec limit, so "make dist"
failed with:

    /bin/bash: Argument list too long
    make[2]: *** [distdir-am] Error 127

Replace the per-file EXTRA_DIST enumeration of the IDE directories with one
wholesale "EXTRA_DIST += IDE/<dir>" entry per directory (automake copies the
tree recursively). This collapses ~745 file entries into ~52 directory
entries and shrinks the top-level DISTFILES from ~123 KB to ~97 KB, well
under the limit.

The set of distributed IDE files is unchanged: a before/after "make dist"
diff shows no project file added or removed (only the now-unused include.am
build fragments are gone). Three directories that intentionally omit some
tracked files (apple-universal, MPLABX16, Renesas - private IDE configs,
.gitkeep placeholders, helper scripts) stay enumerated file-by-file.

2026-07-20 17:22:10 +02:00

README

Correct misspellings and typos from codespell tool

2019-12-24 12:29:33 -06:00

user_settings.h

update Copyright year

2026-02-18 09:52:21 -07:00

README

The wolfSSL examples in the WICED SDK require a server or client application. wolfSSL
provides an easy solution in the <wolfSSL root>/examples/ directory. The wolfSSL 
code repository is located on GitHub at https://github.com/wolfSSL/wolfssl. 
You can download or clone the repository. Run the autogen script and configure 
the library with necessary functionality, see ./configure -h 
for a list of configure options. Finally, run make and make check to ensure the
build was successful. You can install wolfSSL on your system with make
install if you wish. See www.wolfssl.com/docs/wolfssl-manual/ch2/, 'Building
Wolfssl' for more information.

Run ./examples/server/server -h for a list of server options or
./examples/client/client -h for client options. If you would like
to test the server or client, you may run them on localhost. Instructions on
running the client or server can be found in the snip code examples in the
WICED SDK. The snips are meant to be a starting off point for your applications.

Download and install WICED Studio from the Cypress website.

In the <wolfSSL_root>/IDE/WICED-STUDIO/ directory, you will find the library file
user_settings.h which should be copied to <wolfSSL_root>. This is your wolfSSL
configuration file. Please see www.wolfssl.com/docs/ for detailed instructions on
how to use the configure options.

Once you have installed the WICED software:
    1. Create a directory called 'wolfssl_lib' in the BESL directory of WICED
       SDK. The path to the new directory should be:
                43xxx_Wi-Fi/WICED/security/BESL/wolfssl_lib.
    2. Drag and drop the wolfssl library directory into the wolfssl_lib folder
       you just created. The root wolfSSL directory was created when you either
       downloaded or cloned the wolfSSL repository from github.
    3. The user_settings.h file in the IDE/WICED-STUDIO/ directory should be
       placed at <wolfssl_root> added to the WICED project in step #2.. This
       file provides the configure options for compiling wolfSSL with your project.
       The default values will give you a starting point and you may further
       configure the library to meet your needs.
    4. Apply the patch to your WICED IDE project's 43xxx_Wi-Fi/ directory.
            a. Open a terminal and cd into the project 43xxx_Wi-Fi/ directory.:
            b. git apply --ignore-space-change --ignore-whitespace mychanges.patch

You can now build and use the wolfSSL and wolfCrypt snips within the WICED SDK.
Cypress includes great documentation and getting started videos to learn how to
build and run the snips in the Cypress Community section of their website,
https://community.cypress.com/welcome/..

wolfSSL provides a wolfCrypt test application, a TLS client and server application,
and an HTTPS client application. Future development and additions will be made.

Support for TLS 1.3 is available in the provided snippets and it is the most current
TLS version available.

Further instructions and documentation can be found on the wolfSSL website at
www.wolfssl.com or visit us on our forums at www.wolfssl.com/forums/.