History

David Garske 76491e6b60 Merge pull request #10661 from yosuke-wolfssl/fix/f_5808 Enable SCSV check unconditionally		2026-07-08 10:52:59 -07:00
..
asn1	update Copyright year	2026-02-18 09:52:21 -07:00
async	Add WOLFSSL_ASYNC_CERT_YIELD opt-in for per-certificate WC_PENDING_E yield during async TLS chain processing	2026-06-18 16:51:25 -07:00
benchmark	Merge pull request #10551 from julek-wolfssl/dtls-perf-benchmark	2026-07-08 10:31:11 -07:00
client	ARM66 Windows: Add assembly	2026-07-08 07:53:53 +10:00
configs	Merge pull request #10661 from yosuke-wolfssl/fix/f_5808	2026-07-08 10:52:59 -07:00
crypto_policies	…
echoclient	ARM66 Windows: Add assembly	2026-07-08 07:53:53 +10:00
echoserver	ARM66 Windows: Add assembly	2026-07-08 07:53:53 +10:00
ocsp_responder	Fix flaky tcp bind on Windows test runs	2026-05-04 10:35:04 +02:00
pem	the examples pem.c --padding flag does not need gated behind WOLFSSL_DER_TO_PEM	2026-06-12 10:46:01 -06:00
sctp	limit wolfSSL_read() to sizeof(buffer) - 1	2026-06-16 14:30:13 -06:00
server	ARM66 Windows: Add assembly	2026-07-08 07:53:53 +10:00
tls13	Address tls13_memio review: build-time MEM_BUF_SZ/HS_MAX_ITERS/CERT_DIR, drop snprintf, doc PSK	2026-06-29 12:58:55 -07:00
tsp	Time-Stamp Protocol (RFC 3161)	2026-07-08 09:33:47 +10:00
README.md	…
include.am	Time-Stamp Protocol (RFC 3161)	2026-07-08 09:33:47 +10:00

README.md

wolfSSL examples directory

client and server

These directories contain a client (client.c) and server (server.c) that utilize a variety of the wolfSSL library's capabilities. The manner in which both programs operate can depend on the configure or can be specified at run-time depending on the end goal. Both applications contain testing as well as benchmarking code.

Compile

./configure
make

Usage

./examples/server/server

./examples/client/client

Run ./examples/server/server -h and ./examples/client/client -h for usage details.

For simpler wolfSSL TLS server/client examples, visit https://github.com/wolfSSL/wolfssl-examples/tree/master/tls

echoclient and echoserver

These directories contain a client (echoclient.c) and server (echoserver.c) that establish a connection encrypted by wolfSSL. Like the names indicate, once the connection has been established any messages entered into echoclient are sent to and displayed on the echoserver and are then echoed back to echoclient. The nature of the encryption, as well as additional behavior of the two programs, depends on how wolfSSL was configured ( DTLS enabled/disabled, Filesystem enabled/disabled, etc ... ).

Compile

./configure
make

Usage

./examples/echoserver/echoserver

./examples/echoclient/echoclient

benchmark

The benchmark directory offers an application that can help you grasp just how well wolfSSL's TLS functionality is performing on your local machine.

Compile

./configure
make

Usage

./examples/benchmark/tls_bench

The tls_bench executable can also be compiled separately with gcc -lwolfssl -lpthread -o tls_bench tls_bench.c.

Run ./examples/benchmark/tls_bench -? for usage details.

sctp

This directory contains servers and clients that demonstrate wolfSSL's DTLS-SCTP support.

Compile

./configure --enable-sctp
make

Usage

./examples/sctp/sctp-server

./examples/sctp/sctp-client

and

./examples/sctp/sctp-server-dtls

./examples/sctp/sctp-client-dtls

configs

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

See configs/README.md for more details.

asn1

This directory contains an example that prints the ASN.1 data of a BER/DER or PEM encoded file. Configure wolfSSL with --enable-asn-print.

pem

This directory contains an example of converting to/from PEM and DER. Configure wolfSSL with --enable-coding