Skip to content

docs(fast_io): map io_uring opcodes to IOCP equivalents (WPG-7.b)#4760

Merged
oferchen merged 1 commit into
masterfrom
docs/wpg-7b-iouring-iocp-mapping
May 23, 2026
Merged

docs(fast_io): map io_uring opcodes to IOCP equivalents (WPG-7.b)#4760
oferchen merged 1 commit into
masterfrom
docs/wpg-7b-iouring-iocp-mapping

Conversation

@oferchen
Copy link
Copy Markdown
Owner

Summary

  • Maps every io_uring opcode catalogued in WPG-7.a (docs/design/wpg-7-iouring-opcode-inventory.md, merged as docs(fast_io): inventory io_uring opcodes (WPG-7.a) #4755) to its Windows IOCP / Winsock / RIO equivalent or an explicit gap.
  • Covers all 23 opcodes in use: 15 SQE-side rows (READ/WRITE, READ_FIXED/WRITE_FIXED, FSYNC, SEND/SEND_ZC/RECV, POLL_ADD, STATX, RENAMEAT, LINKAT, ASYNC_CANCEL classic + extended, LINK_TIMEOUT, NOP) and 8 register/setup rows (REGISTER_FILES, UNREGISTER_FILES, REGISTER_BUFFERS, UNREGISTER_BUFFERS, REGISTER_PROBE, REGISTER_PBUF_RING, UNREGISTER_PBUF_RING, SETUP_SQPOLL).
  • Classifies each row by severity (P0 data-path, P1 metadata, P2 utility, N/A) and identifies 4 concrete gaps: NOP, READ_FIXED, WRITE_FIXED, LINK_TIMEOUT.
  • Cross-references feed WPG-8 (zero-copy send: SEND_ZC + SEND rows) and WPG-9 (registered buffers: READ_FIXED, WRITE_FIXED, REGISTER_BUFFERS, UNREGISTER_BUFFERS, REGISTER_PBUF_RING, UNREGISTER_PBUF_RING rows).
  • Audit-only - no source changes.

Test plan

  • Doc-only change; CI fmt+clippy/nextest/Windows/macOS/Linux musl checks should pass unchanged.

Map all 23 opcodes catalogued in WPG-7.a (15 SQE-side, 8 register/setup)
to their Windows IOCP / Winsock / RIO peers, classify each by severity
(P0 data path, P1 metadata, P2 utility, N/A), and identify 4 concrete
gaps. Adds cross-references that feed WPG-8 (zero-copy send) and WPG-9
(registered-buffer scheme). Audit-only; no source changes.
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 23, 2026
@oferchen oferchen merged commit 04dc51e into master May 23, 2026
10 checks passed
@oferchen oferchen deleted the docs/wpg-7b-iouring-iocp-mapping branch May 28, 2026 03:37
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