docs: update runbook with cargo run commands and matrix config

This commit is contained in:
2026-02-12 15:00:04 +02:00
parent f836bdf6c4
commit 8cbe65fc7d
4 changed files with 129 additions and 49 deletions

View File

@@ -24,13 +24,13 @@
## Milestone 3 -- KX selection (X25519 vs X25519MLKEM768) \[MUST\]
- [x] rustls provider wiring (`aws_lc_rs` for PQ)
- [ ] negotiated group logging (debug mode)
- [X] negotiated group logging (debug mode)
## Milestone 4 -- Concurrency & runner [MUST]
- [x] tokio-based runner
- [X] concurrency control and warmup
- [ ] matrix runner over (mode, payload, concurrency)
- [X] matrix runner over (mode, payload, concurrency)
## Milestone 5 -- HTTP/1.1 mode (hyper) \[OPTIONAL\]

View File

@@ -20,13 +20,41 @@ Example:
```bash
./target/release/runner \
--server 1.2.3.4:4433 \
--mode x25519mlkem768 \
--payload-bytes 1024 \
--concurrency 10 \
--iters 500 \
--warmup 50 \
--out results.ndjson
--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`):
```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:
```bash
./target/release/runner --config matrix.toml
```
## 4) Collect perf stats (optional)
@@ -34,8 +62,7 @@ Example:
Run on the client:
```bash
perf stat -e cycles,instructions,cache-misses \
./target/release/runner ...
perf stat -e cycles,instructions,cache-misses ./target/release/runner ...
```
## 5) Summarize