join is a modular C++ network runtime framework for Linux, designed for low-latency, high-throughput, and system-level networking.
It provides a set of composable libraries covering networking primitives, concurrency, serialization, cryptography, and Linux network fabric management.
- Linux-native networking (sockets, netlink, raw sockets)
- Event-driven and reactor-based architecture
- Predictable latency and high throughput
- Strong separation of concerns via modular libraries
- High test coverage and correctness-first design
- Suitable for infrastructure, control-plane, and runtime components
join focuses on providing robust, efficient building blocks for:
- network runtimes
- system services
- control planes
- high-performance servers
- infrastructure tooling
The framework is a collection of specialized modules that build upon one another:
| Module | Purpose | Highlights |
|---|---|---|
core |
Foundation | Epoll Reactor, TCP/UDP/TLS, Unix Sockets, Thread Pools, Mutexes. |
fabric |
Network Control | Netlink Interface Manager, ARP client, DNS Resolver. |
crypto |
Security | OpenSSL Wrappers, HMAC, Digital Signatures, Base64. |
data |
Serialization | High-perf JSON (DOM/SAX), MessagePack, Zlib Streams. |
services |
Protocols | HTTP/1.1 (Client/Server), SMTP, Mail Parsing. |
Ensure you have OpenSSL, Zlib, and GTest (for testing) installed on your system:
sudo apt install libssl-dev zlib1g-dev libgtest-dev libgmock-devOpenSSL is required by
join-coreas TLS support is part of the core runtime.
git clone https://github.com/joinframework/join.git
cd join
cmake -B build -DCMAKE_BUILD_TYPE=Release -DJOIN_ENABLE_TESTS=ON
cmake --build buildctest --test-dir build --output-on-failurejoin exports standard CMake targets. To use it in your project:
find_package(join REQUIRED)
target_link_libraries(your_app PRIVATE
join::core
join::fabric
join::services
)Every commit is validated against an extensive test suite to ensure stability in concurrent environments:
- 1000+ Unit Tests covering networking, concurrency, and data parsing.
- Security: Continuous scanning via Codacy and GitHub Security workflows.
- API Reference: Explore the Doxygen Docs
- License: Licensed under the MIT License.