Skip to content

docs(design): plan io_uring regular vs SQPOLL vs std I/O bench (#1626)#3880

Merged
oferchen merged 1 commit into
masterfrom
design/io-uring-submission-modes-bench
May 7, 2026
Merged

docs(design): plan io_uring regular vs SQPOLL vs std I/O bench (#1626)#3880
oferchen merged 1 commit into
masterfrom
design/io-uring-submission-modes-bench

Conversation

@oferchen
Copy link
Copy Markdown
Owner

@oferchen oferchen commented May 7, 2026

Summary

  • Adds docs/design/io-uring-submission-modes-bench.md covering regular submission, SQPOLL, and DEFER_TASKRUN against the standard-I/O baseline.
  • Documents bench plan (64 KiB random reads, queue depth 256, tmpfs and SSD), bursty vs sustained workload variants, and metrics (ops/sec, syscalls/sec, kernel CPU%, p99).
  • Provides a kernel/CAP-aware decision matrix to drive the fast_io SubmissionMode selector default.

Closes #1626 once the bench lands and tuning thresholds are committed.

Test plan

  • Land the Criterion submission_modes group under crates/fast_io/benches/ per the plan.
  • Capture sustained and bursty runs on tmpfs and NVMe SSD; export CSV under target/bench/io-uring-modes/.
  • Confirm the decision matrix matches measured p99/throughput before flipping the default selector.

Adds a focused benchmark plan covering submission modes (regular,
SQPOLL, DEFER_TASKRUN) against the standard-I/O baseline, with
workload variants, metrics, and a kernel/CAP-aware default-selection
matrix for the fast_io SubmissionMode selector.
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 7, 2026
@oferchen oferchen merged commit 350a089 into master May 7, 2026
8 checks passed
@oferchen oferchen deleted the design/io-uring-submission-modes-bench branch May 8, 2026 03:52
oferchen added a commit that referenced this pull request May 18, 2026
#3880)

Adds a focused benchmark plan covering submission modes (regular,
SQPOLL, DEFER_TASKRUN) against the standard-I/O baseline, with
workload variants, metrics, and a kernel/CAP-aware default-selection
matrix for the fast_io SubmissionMode selector.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant