What is bnl?

bnl (Binary Networking Library) consists of a WIP HTTP/3 implementation, an easy to use wrapper around ngtcp2 (a QUIC implementation) and an example HTTP/3 client for testing interop with other implementations.

All protocols implemented under bnl work on buffers of binary data and as such, data can be transported between two endpoints in any way the user sees fit. One immediate advantage of this approach is the possibility to verify application layer protocols such as HTTP/3 in-memory before moving on to test the implementation using its associated transport protocol (in the case of HTTP/3: QUIC). Of course, eventually the goal is to provide common transports and other required OS integrations as part of bnl (first and foremost being an UDP transport to facililate transporting QUIC packets over the Internet).

Build instructions

bnl uses the CMake build system. At least version 3.13 is required. All other dependencies are automatically downloaded when running CMake for the first time.

git clone https://github.com/DaanDeMeyer/bnl.git
cmake -B build -S bnl -DBNL_TEST=ON
build/test # Run tests

CMake options

User

• BNL_TEST: Build tests (default: ON)

Developer

• BNL_SANITIZERS: Build with sanitizers (default: OFF).
• BNL_TIDY: Run clang-tidy when building (default: OFF).
• BNL_WARNINGS_AS_ERRORS: Add -Werror or equivalent to the compile flags and
  clang-tidy (default: OFF).