io_uring bench for FC-shaped stage-in / hydrate I/O

[sethupathib]

Summary

Adds iouring-fc-io/: liburing microbench for FC-shaped I/O, plus a detailed white paper, DEFEND_QA, figures, and PDF.

Honest scope

FC is closed-source. This accelerates / measures stage-in, library hydrate, log ingest — not Synopsys internals.

Docs

• WHITEAPER.md — full paper (motivation → farm A/B → claim policy)
• docs/iouring_fc_io_whitepaper.pdf
• DEFEND_QA.md
• Figures: architecture, workloads, speedup, claim scope
• Mechanism GIF (not a benchmark)

Measured (authoring host, warm cache)

• large_files / iouring_openat: ~1.20× vs posix → CLAIM_GATE=yes_iouring_win
• small_files / mixed: posix faster (uring overhead on warm tiny reads)

Architecture
Speedup
Claim scope
iouring_fc_pipeline.gif

Reproduce

cd iouring-fc-io
sudo apt-get install -y liburing-dev build-essential
make && ./examples/compare_all.sh
make all-docs   # figures + gif + pdf

Test plan

• Bench builds and compare harness regenerates SUMMARY/CLAIM_GATE
• White paper PDF builds from WHITEAPER.md
• Figures driven by results/summary.json
• No claim that FC binaries use io_uring

_{To show artifacts inline, enable in settings.}