Update the async examples and add CI for it.

Author: dgarske

.github/workflows/async-examples.yml

@@ -0,0 +1,52 @@
+name: Async Examples
+
+on:
+  push:
+    branches: [ 'master', 'main', 'release/**' ]
+  pull_request:
+    branches: [ '*' ]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  async_examples:
+    if: github.repository_owner == 'wolfssl'
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+        name: Checkout wolfSSL
+
+      - name: Build async examples (no configure)
+        run: |
+          make -C examples/async clean
+          make -C examples/async
+
+      - name: Run async examples (ECC + X25519)
+        run: |
+          set -euo pipefail
+          run_pair() {
+            local mode="$1"
+            ./examples/async/async_server --"$mode" > "/tmp/async_server_${mode}.log" 2>&1 &
+            local pid=$!
+            sleep 1
+            ./examples/async/async_client --"$mode" 127.0.0.1 11111 > "/tmp/async_client_${mode}.log" 2>&1
+            local rc=$?
+            kill "$pid" >/dev/null 2>&1 || true
+            wait "$pid" >/dev/null 2>&1 || true
+            return "$rc"
+          }
+          run_pair ecc
+          run_pair x25519
+
+      - name: Print async logs
+        if: ${{ failure() }}
+        run: |
+          for f in /tmp/async_server_*.log /tmp/async_client_*.log; do
+            if [ -f "$f" ]; then
+              echo "==> $f"
+              cat "$f"
+            fi
+          done

examples/async/Makefile

@@ -0,0 +1,45 @@
+CC ?= gcc
+AR ?= ar
+RM ?= rm -f
+
+WOLFSSL_TOP ?= $(abspath ../..)
+OBJDIR ?= build
+
+CFLAGS ?= -O0 -g
+CFLAGS += -I.
+CFLAGS += -I$(WOLFSSL_TOP)
+CFLAGS += -I$(WOLFSSL_TOP)/wolfssl
+CFLAGS += -I$(WOLFSSL_TOP)/wolfssl/wolfcrypt
+CFLAGS += -DWOLFSSL_USER_SETTINGS
+CFLAGS += -DUSE_CERT_BUFFERS_256
+
+LDFLAGS ?=
+LDLIBS ?=
+
+TARGETS = async_client async_server
+
+WOLFSSL_SRC := $(wildcard $(WOLFSSL_TOP)/src/*.c)
+WOLFCRYPT_SRC := $(wildcard $(WOLFSSL_TOP)/wolfcrypt/src/*.c)
+LOCAL_SRC := async_client.c async_server.c
+
+WOLFSSL_OBJS := $(patsubst $(WOLFSSL_TOP)/%, $(OBJDIR)/%, $(WOLFSSL_SRC:.c=.o))
+WOLFCRYPT_OBJS := $(patsubst $(WOLFSSL_TOP)/%, $(OBJDIR)/%, $(WOLFCRYPT_SRC:.c=.o))
+LOCAL_OBJS := $(patsubst %.c, $(OBJDIR)/%.o, $(LOCAL_SRC))
+
+OBJS := $(LOCAL_OBJS) $(WOLFSSL_OBJS) $(WOLFCRYPT_OBJS)
+
+all: $(TARGETS)
+
+$(TARGETS): %: $(OBJDIR)/%.o $(WOLFSSL_OBJS) $(WOLFCRYPT_OBJS)
+	$(CC) $(LDFLAGS) -o $@ $^ $(LDLIBS)
+
+$(OBJDIR)/%.o: %.c user_settings.h
+	@mkdir -p $(dir $@)
+	$(CC) $(CFLAGS) -c $< -o $@
+
+$(OBJDIR)/%.o: $(WOLFSSL_TOP)/%.c
+	@mkdir -p $(dir $@)
+	$(CC) $(CFLAGS) -c $< -o $@
+
+clean:
+	$(RM) -r $(OBJDIR) $(TARGETS)

examples/async/README.md

@@ -15,9 +15,10 @@ Tested with:
 * `./configure --enable-asynccrypt --enable-pkcallbacks --disable-rsa --enable-ecc`
 
 ```
-make
-./examples/async/async_server
-./examples/async/async_client 127.0.0.1
+make -C examples/async
+./examples/async/async_server --ecc
+./examples/async/async_client --ecc 127.0.0.1 11111
+./examples/async/async_client --x25519 ecc256.badssl.com 443
 ```
 
 ## Asynchronous Cryptography Design