Expand description
Shared-memory transport utilities (open/create/validate).
This crate will own OS-facing mapping logic and treat SHM as untrusted input.
§Crash / cleanup semantics
Regions are file-backed mappings. If a process crashes, the backing file may remain on disk. Subsequent openers will:
- validate layout compatibility once initialization is complete
- wait for a bounded time if the mapping is observed in an “initializing” state
- fail closed with
Error::Layout(indexbus_core::Error::NotInitialized)if initialization does not complete (e.g. the initializing process crashed)
Best-effort cleanup is performed by callers (tests/benches remove their temp files). Operator tooling may also remove stale mapping files as needed.
Structs§
- Events
Chain Region - File-backed events-chain region (one slot pool +
QSPSC queues +QMPSC queues of slot indices). - Mapping
Info - Describes the OS-facing properties of a mapped backing region.
- Open
Options - Options for opening a mapped ByteOr-owned region.
- Sequenced
Slots Region - File-backed sequenced-slots region.
Enums§
- Error
- Errors returned by this transport.