PROJECT LINEAGE

kvspill became kvio bench

kvspill was Davidlohr Bueso's standalone prototype for applying sustained KV-cache-shaped fio pressure to an SSD. Its useful parts now live in kvio; there is no separate kvspill command or current kvspill user guide in this project.

Use kvio bench →

What the prototype contributed

kvspill supplied the initial restore, prefix, eviction, and same-device interference workload shapes, along with preconditioning, fio result parsing, and median A/B comparison. David also recorded an LMCache calibration using Qwen2.5-1.5B-Instruct: four synchronous workers moving 7 MiB KV objects.

Those ideas became kvio bench and kvio bench-compare. kvio added one CLI, explicit measured-versus- synthetic evidence labels, external JSON profiles, structured run artifacts, target-specific IRQ accounting, bounded test regions, and stricter raw-device safety and cleanup.

What the name means now

kvspill is history, not a second product. Current usage, profile definitions, safety rules, and interpretation limits belong to the kvio documentation.

Only the calibrated restore profile came from a recorded KV-cache setup. The other inherited shapes are controlled synthetic stress tests; in particular, the 4 KiB interference case is not a claim that LMCache emits 4 KiB reads.

Credit and source

The work was merged with David's permission under this repository's Apache-2.0 license. His authorship remains in the integration commit and NOTICE. The original project remains available at github.com/davidlohr/kvspill.

This hostname remains online so old references explain where kvio bench came from and lead readers to the maintained interface.