tls-pq-bench/docs/runbook.md

Runbook

1) Build

cargo build --release

2) Start server

Example:

./target/release/server --mode x25519 --listen 0.0.0.0:4433

3) Run client benchmark

Example:

./target/release/runner \
    --server 1.2.3.4:4433 \
    --mode x25519mlkem768 \
    --payload-bytes 1024 \
    --concurrency 10 \
    --iters 500 \
    --warmup 50 \
    --out results.ndjson

Matrix Benchmarks

Create a config file (matrix.toml):

[[benchmarks]]
server = "1.2.3.4:4433"
mode = "x25519"
payload = 1024
iters = 500
warmup = 50
concurrency = 1

[[benchmarks]]
server = "1.2.3.4:4433"
mode = "x25519mlkem768"
payload = 1024
iters = 500
warmup = 50
concurrency = 1

Run matrix:

./target/release/runner --config matrix.toml

4) Collect perf stats (optional)

Run on the client:

perf stat -e cycles,instructions,cache-misses ./target/release/runner ...

5) Summarize

Use a script to compute p50/p95/p99 from NDJSON.