claw-cargo: default --parallel-restore back to 1 (sequential wins on loopback) #30

Merged
osobh merged 1 commits from default-parallel-restore-1 into main 2026-07-13 08:09:54 +00:00
+9 -6
View File
@@ -220,12 +220,15 @@ struct BuildArgs {
/// Skip capture + upload on a miss. Useful for read-only cache use. /// Skip capture + upload on a miss. Useful for read-only cache use.
#[arg(long)] #[arg(long)]
no_upload: bool, no_upload: bool,
/// Field finding 2026-07-12: parallel chunk fetch on cache HIT. /// Field finding 2026-07-12/13: parallel chunk fetch on cache
/// Sequential BlobGetStream restore of 947 MiB on Pi 5 took 18s /// HIT. Default `1` (sequential BlobGetStream) — measured on Pi 5
/// (~53 MiB/s); parallel chunk fetches stack their per-stream /// loopback, sequential beats parallel=8 by 70% (20s vs 34s)
/// throughputs. Set to 1 to force sequential (matches pre-fix /// because per-stream QUIC congestion control is more efficient
/// behavior). /// than N-way stream contention when the connection has no
#[arg(long, default_value_t = 8)] /// per-stream ceiling. Opt in with `--parallel-restore N` on
/// cross-node connections where the per-stream cap actually bites
/// (WAN, tunneled links).
#[arg(long, default_value_t = 1)]
parallel_restore: usize, parallel_restore: usize,
/// Extra args passed verbatim to `cargo build` (after `--`). /// Extra args passed verbatim to `cargo build` (after `--`).
#[arg(last = true)] #[arg(last = true)]