httpzo - Zero-Allocation HTTP/1.1 Parser for OxCaml#

A high-performance HTTP/1.1 parser and serializer achieving zero heap allocations using OxCaml's unboxed types (int16#, int64#, char#) and local allocations.

Will soon have io_uring on Linux.

Features#

• Zero heap allocations: Parser results are stack-allocated using OxCaml unboxed records and local lists
• Unboxed integers throughout: Uses int16# for offsets/counts and int64# for content lengths - no boxing overhead
• Direct bigstring I/O: Read and write directly to/from bigarray buffers
• HTTP/1.1 support: Methods, headers, chunked transfer encoding, keep-alive, range requests, ETags
• Async file server included: Production-ready static file server

Architecture#

httpzo achieves zero-allocation parsing through:

1. Unboxed records (#{...}): Request, span, and header types are stack-allocated
2. Unboxed primitives: int16# for buffer offsets, int64# for content lengths, char# for byte comparisons
3. Local lists (@ local): Header list grows on the stack, not heap
4. Span-based parsing: Strings are referenced by offset+length into the input buffer
5. Pre-allocated buffers: 32KB read buffer reused across requests

Performance#

Benchmarks comparing httpzo (OxCaml) vs httpe (Eio-based parser):

Throughput: 6.5M requests/sec

Detailed Timings#

True zero-allocation parsing - all values are stack-allocated via unboxed records and threaded position.

Installation#

Requires OxCaml compiler from https://oxcaml.org/

Static File Server#

An Async-based static file server is included:

# Serve current directory on port 8080
dune exec bin/httpzo_server.exe

# Serve specific directory on custom port
dune exec bin/httpzo_server.exe -- -d /var/www -p 3000

# Get help
dune exec bin/httpzo_server.exe -- -help

Features:

• Async concurrent connection handling (up to 10,000 connections)
• Zero-copy bigstring I/O
• MIME type detection
• Directory traversal protection
• Automatic index.html for directories

Running Benchmarks#

# Comparative benchmark (httpzo vs httpe)
dune exec bench/bench_compare.exe

# Detailed httpzo benchmarks with core_bench
dune exec bench/bench_httpzo.exe -- -quota 2

License#

ISC