23 stable releases
2.4.1 | Aug 20, 2023 |
---|---|
2.4.0 | Mar 25, 2023 |
2.3.0 | Jul 2, 2022 |
2.2.3 | Mar 3, 2020 |
0.2.1 | Jun 3, 2016 |
#73 in Concurrency
6,875 downloads per month
Used in 30 crates
(28 directly)
40KB
433 lines
bus
Bus provides a lock-free, bounded, single-producer, multi-consumer, broadcast channel.
NOTE: bus sometimes busy-waits in the current implementation, which may cause increased CPU usage — see #23.
It uses a circular buffer and atomic instructions to implement a lock-free single-producer,
multi-consumer channel. The interface is similar to that of the std::sync::mpsc
channels,
except that multiple consumers (readers of the channel) can be produced, whereas only a single
sender can exist. Furthermore, in contrast to most multi-consumer FIFO queues, bus is
broadcast; every send goes to every consumer.
I haven't seen this particular implementation in literature (some extra bookkeeping is necessary to allow multiple consumers), but a lot of related reading can be found in Ross Bencina's blog post "Some notes on lock-free and wait-free algorithms".
See the documentation for usage examples.
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~0.5–5MB
~12K SLoC