How frostyplanet/crossfire-rs works
Crossfire is a Rust lock-free channel library for single- and multi-producer/consumer patterns. Applications construct a channel through the SPSC, MPSC, or MPMC APIs, then send and receive through async or blocking endpoints; shared channel state connects those operations to queue flavors and wakeup coordination. The documented product also includes one-shot channels, selection, cancellation channels, wait groups, and async compatibility adapters. Some modules are unsampled; their capabilities are retained from the README, while unverified implementation links are omitted.
Main entry points: shared.rs Shared Channel State · mod.rs Flavor Interface · async_tx.rs Async Sender · async_rx.rs Async Receiver
Components 26
Send And Receive
- Async Sender
src/async_tx.rs - Async Receiver
src/async_rx.rs - Blocking Sender
src/blocking_tx.rs - Blocking Receiver
src/blocking_rx.rs
Channel Internals
- Shared Channel State
src/shared.rs - Waker Registry
src/waker_registry.rs - Wake Mechanism
src/waker.rs - Backoff Policy
src/backoff.rs
Queue Flavors
- Flavor Interface
src/flavor/mod.rs - Array Queues
src/crossbeam/array_queue.rs - MPSC Array Queue
src/crossbeam/array_queue_mpsc.rs - SPSC Array Queue
src/crossbeam/array_queue_spsc.rs - Segmented Queue
src/crossbeam/seg_queue.rs - One-Item Flavors
src/flavor/one.rs
Additional Features
- Receiver Selection
src/select/select.rs - Multiplex Receiver
src/select/multiplex.rs - One-Shot Channels
src/oneshot.rs - Cancellation Channel
src/null.rs - Wait Group
src/waitgroup.rs - Async Adapters
src/compat.rs - Stream Adapter
src/stream.rs - Sink Adapter
src/sink.rs
Other components
- Application
Connections 34
- Application → SPSC API: builds channel
- Application → MPSC API: builds channel
- Application → MPMC API: builds channel
- SPSC API → Async Sender: creates endpoints
- SPSC API → Async Receiver: creates endpoints
- MPSC API → Blocking Sender: creates endpoints
- MPSC API → Blocking Receiver: creates endpoints
- MPMC API → Async Sender: creates endpoints
- MPMC API → Async Receiver: creates endpoints
- Async Sender → Shared Channel State: uses shared state
src/async_tx.rs - Async Receiver → Shared Channel State: uses shared state
src/async_rx.rs - Blocking Sender → Shared Channel State: uses shared state
src/blocking_tx.rs - Blocking Receiver → Shared Channel State: uses shared state
src/blocking_rx.rs - Shared Channel State → Flavor Interface: uses flavor
src/shared.rs - Shared Channel State → Waker Registry: notifies endpoints
src/shared.rs - Waker Registry → Wake Mechanism: manages wakeups
src/waker_registry.rs - Flavor Interface → Array Queues: dispatches queue ops
src/flavor/mod.rs - Flavor Interface → MPSC Array Queue: dispatches queue ops
src/flavor/mod.rs - Flavor Interface → SPSC Array Queue: dispatches queue ops
src/flavor/mod.rs - Flavor Interface → Segmented Queue: dispatches queue ops
src/flavor/mod.rs - Flavor Interface → One-Item Flavors: exposes flavor
src/flavor/mod.rs - Receiver Selection → Shared Channel State: selects receivers
src/select/select.rs - Multiplex Receiver → Shared Channel State: reads channels
src/select/multiplex.rs - Application → One-Shot Channels: uses one-shot
- Application → Cancellation Channel: uses cancellation
- Application → Receiver Selection: selects messages
- Application → Multiplex Receiver: multiplexes receivers
- Application → Wait Group: coordinates tasks
- Async Sender → Async Adapters: converts context
- Async Receiver → Async Adapters: converts context
- Async Sender → Sink Adapter: adapts sending
src/async_tx.rs - Async Receiver → Stream Adapter: adapts receiving
src/async_rx.rs - Blocking Sender → Backoff Policy: backs off
src/blocking_tx.rs - Blocking Receiver → Backoff Policy: backs off
src/blocking_rx.rs