 gx
|
6608f5d2f6
|
docs(protocol): bit-exact wire protocol specification (R4)
Closes последний RED-flag из arch review.
Что описано (§-sections):
1. Resources & lifecycle (socket / shm / IPC handles cleanup, crash recovery)
2. Shared memory byte-by-byte layout (offsets, packing, atomics)
2.1 frame meta (64 bytes)
2.2 slot descriptor (192 bytes)
2.3 subscriber slot (128 bytes)
3. Unix socket TLV protocol (8 message types, framing)
4. State machines (subscriber-side, publisher-side per-subscriber)
5. ACK protocol с cudaEventRecord / cudaStreamWaitEvent
6. Versioning rules (proto_version vs lib_version, reserved fields)
7. Conformance test skeleton (offset checks, sizeof checks, handshake)
8. Open для v0.2 (TLS, multi-format, ROCm)
9. Reference impl pointer (libcuframes/src/protocol.c — Phase 1)
После v0.2 release — wire protocol frozen, breaking changes = bump
proto_version. До v0.2 — experimental.
Решает все 4 пункта из arch review section R4:
✓ SHM layout (annotated struct + ASCII layout)
✓ Socket protocol (state machine + message framing)
✓ Versioning rules
✓ Lifecycle / cleanup (incl. CUDA IPC handle leak при crash)
Готов к Step 2 (Phase 1 implementation).
|
2026-05-14 23:04:46 +01:00 |
|