cwebsocket

cwebsocket is a portable, high performance websocket client library, intended for use on low power embedded systems.

cwebsocket is compliant with the following standards:

1. ANSI C
2. POSIX
3. RFC 6455

Dependencies

1. autoconf
2. automake
3. libtool
4. libssl-dev
5. libev-dev
6. docker (for qa testing)

Build

cwebsocket is built with multi-threading and SSL support by default.

To build, run:

./autogen.sh
./configure
make
sudo make install

To built without multi-threading:

./configure --enable-threads=no

To build without SSL:

./configure --enable-ssl=no

Client

The websocket client is able to connect and exchange data with any RFC 6455 compliant server.

./websocket-client wss://echo.websocket.org

Dockerized Tests

All tests run inside a Docker container — nothing is installed on the host.

• Build the test image:

  make docker-build

• Run unit tests inside the container:

  make test

• Run the Autobahn integration suite (reports in test/autobahn/reports/clients on the host):

  make integration-test

• Open a shell in the container (optional):

  make docker-shell

Note: Integration tests start the Autobahn fuzzing server inside the container and run websocket-testsuite against it. Reports are written to the mounted host directory test/autobahn/reports/clients.

Docker-based QA Tools

All quality assurance tools (valgrind, cppcheck, flawfinder, clang-tools, lcov) are bundled in the Docker image — no installation on the host required.

• Run the complete QA suite:

  make docker-qa

• Memory leak detection with Valgrind:

  make docker-valgrind make docker-memcheck

• Static code analysis with cppcheck:

  make docker-cppcheck

• Security vulnerability scanning:

  make docker-flawfinder make docker-security

• Deep static analysis with Clang analyzer:

  make docker-clang-analyze

Support

Please consider supporting this project for ongoing success and sustainability. I'm a passionate open source contributor making a professional living creating free, secure, scalable, robust, enterprise grade, distributed systems and cloud native solutions.

I'm also available for international consulting opportunities. Please let me know how I can assist you or your organization in achieving your desired security posture and technology goals.

https://github.com/sponsors/jeremyhahn

https://www.linkedin.com/in/jeremyhahn