Short:        TLS/SSL shared lib (wolfSSL 5.9.1) + SDK
Author:       wolfSSL Inc. (wolfSSL); Matthias Muench (AmigaOS port)
Uploader:     wolfssl amigaworld de (Matthias Muench)
Type:         util/libs
Version:      0.20
Requires:     68020+ CPU; a bsdsocket.library TCP/IP stack (AmiTCP/Roadshow/...)
Architecture: m68k-amigaos >= 3.0
Distribution: Aminet

wolfssl.library is a native AmigaOS shared library that brings modern TLS
(up to TLS 1.3) and the wolfCrypt cryptography suite to 68k Amigas, built on
wolfSSL 5.9.1.

Applications call the familiar wolfSSL_* / SSL_* names through the library jump
table (jsr -N(a6)) -- no statically linked wolfSSL needed. This is the same
drop-in pattern as AmiSSL: an inline header (proto_wolfssl.h) plus a per-task
library base. A complete TLS client links against nothing but -lamiga and the
header; the crypto code lives entirely inside the library.

Highlights
  - wolfSSL 5.9.1, TLS 1.3 client (and server) through the library facade
  - OpenSSL-compatible API surface (859 compat vectors; BN/RSA/AES are real)
  - CA root bundle (~146 roots) bundled INSIDE the library
    -> wolfSSL_CTX_UseSystemCAs(ctx), no certificate file to ship
  - Hardware-grade RNG cold-start from mouse entropy
    -> WolfRngEnsureSeeded(cb) before the first handshake
  - Big-endian, FPU-less 68020 target

AmigaOS specifics vs. plain OpenSSL
  - SSL_set_fd does not exist (the library uses WOLFSSL_NO_SOCK);
    bind a socket with wolfSSL_AmigaBindSocket(ssl, SocketBase, fd).
    SocketBase is per-task.
  - The CA bundle is in the library: wolfSSL_CTX_UseSystemCAs(ctx).
  - Seed the RNG with WolfRngEnsureSeeded(cb) before the first connect.

Package contents
  Libs/wolfssl.library          the shared library  -> copy to LIBS:
  SDK/include/proto_wolfssl.h    the entire API as inline stubs
  SDK/examples/compattest.c      drop-in TLS 1.3 client example
  COPYING                        GPLv3 license text

Installation
  Copy Libs/wolfssl.library to LIBS:, put SDK/include/proto_wolfssl.h on your
  compiler's include path, then OpenLibrary("wolfssl.library", 0) -- check the
  revision is >= 20.

Build the example (Bebbo GCC m68k-amigaos)
  m68k-amigaos-gcc -noixemul -mcpu=68020 -O2 -o compattest compattest.c -lamiga
  compattest example.com 443 /

License
  wolfSSL 5.9.1 (since 5.8.2) is GNU GPL v3 -- see COPYING. Linking this library
  into distributed software places that software under the GPLv3, unless you hold
  a commercial wolfSSL license from wolfSSL Inc.