4 releases (2 breaking)
|new 0.3.1||Oct 15, 2020|
|0.3.0||Jul 13, 2020|
|0.2.0||Aug 6, 2019|
|0.1.0||Jun 18, 2019|
#54 in Unix APIs
469 downloads per month
Inter-Process Multiple Producer, Single Consumer Channels for Rust
This library provides a type-safe, high-performance inter-process
channel implementation based on a shared memory ring buffer. It uses
bincode for (de)serialization,
including zero-copy deserialization, making it ideal for messages with
&[u8] fields. And it has a name that rolls right
off the tongue.
The examples directory contains a sender and receiver pair, which you can run in separate terminals like so:
cargo run --example ipmpsc-receive -- --zero-copy /tmp/ipmpsc
cargo run --example ipmpsc-send -- /tmp/ipmpsc
Type some lines of text into the sender and observe that they are printed by the receiver. You can also run additional senders from other terminals -- the receiver will receive messages from any of them.
ipmpsc::Receiver::zero_copy_context, used in combination with
serde_bytes, is capable of
supporting very high bandwidth, low latency transfers
(e.g. uncompressed video frames).
The ring buffer is backed by a shared memory-mapped file, which means any process with access to that file can read from or write to it depending on its privileges. This may or may not be acceptable depending on the security needs of your application and the environment in which it runs.
The current implementation should work on any POSIX-compatible OS. It's been tested on Linux and Android. Windows support is planned but has not been started yet.
ipc-channel - mature and robust IPC channels. Does not yet support Android, multiple simultaneous senders, or zero-copy deserialization.
shared_memory - low-level, cross-platform shared memory support. May be used as the basis for a ring-buffer based channel, but does not yet support Android.