From e4ab2a414c7f066391fa899b42a330a36b5f3b10 Mon Sep 17 00:00:00 2001
From: TapTap <taptap.programming@gmail.com>
Date: Sun, 5 Jul 2026 21:11:33 +0200
Subject: [PATCH] docs: add LAN/WAN benchmark results table to README

---
 README.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/README.md b/README.md
index fcb2d9f..bffd576 100644
--- a/README.md
+++ b/README.md
@@ -142,3 +142,29 @@ The benchmark prints throughput metrics for the best configuration and speedup v
 3. `sendfile()` bypasses userspace — ~2× faster on localhost for large files
 4. Multithreading scales with core count
 5. Metadata transfer adds negligible overhead when disabled, ~24 bytes per file when enabled
+
+## Benchmark Results
+
+50 MB of mixed file sizes over `localhost` with disk I/O throttled (reads ≤ 15 MB/s, writes ≤ 10 MB/s) and network emulation via `tc netem`. Each test was run 3×; the median is reported below.
+
+### LAN (1000 Mbit, 20 ms ±1 ms, 0.1% loss)
+
+| Configuration | Time | vs rsync (archive) | vs rsync (compress) |
+|---|---|---|---|
+| **Best: `-m -c`** | **0.20 s** | **11.2× faster** | **3.6× faster** |
+| Compression (`-c`) | 0.31 s | 7.3× faster | 2.3× faster |
+| Standard | 1.27 s | 1.8× faster | — |
+| rsync (archive) | 2.27 s | — | — |
+| rsync (archive + compress) | 0.72 s | — | — |
+
+### WAN (100 Mbit, 50 ms ±10 ms, 1% loss)
+
+| Configuration | Time | vs rsync (archive) | vs rsync (compress) |
+|---|---|---|---|
+| **Best: `-m -c`** | **0.39 s** | **44.8× faster** | **3.8× faster** |
+| Compression (`-c`) | 0.64 s | 27.3× faster | 2.3× faster |
+| Standard | 7.12 s | 2.4× faster | — |
+| rsync (archive) | 17.44 s | — | — |
+| rsync (archive + compress) | 1.47 s | — | — |
+
+Compression reduces the data on the wire enough that the transfer becomes latency-bound rather than bandwidth-bound. On WAN, the best configuration runs 10.8× faster than the theoretical limit for uncompressed data, since zstd shrinks the 50 MB payload to a fraction of its original size over the wire.