mirror of
https://github.com/tokio-rs/tokio.git
synced 2026-08-17 00:00:11 +02:00
Carl Lerche
13083153aa
Introduce a tokio-sync crate containing useful synchronization primitives for programs written using Tokio. The initial release contains: * An mpsc channel * A oneshot channel * A semaphore implementation * An `AtomicTask` primitive. The `oneshot` and `mpsc` channels are new implementations providing improved performance characteristics. In some benchmarks, the new mpsc channel shows up to 7x improvement over the version provided by the `futures` crate. Unfortunately, the `oneshot` implementation only provides a slight performance improvement as it is mostly limited by the `futures` 0.1 task system. Once updated to the `std` version of `Future` (currently nightly only), much greater performance improvements should be achievable by `oneshot`. Additionally, he implementations provided here are checked using [Loom](http://github.com/carllerche/loom/), which provides greater confidence of correctness.
17 lines
488 B
Rust
17 lines
488 B
Rust
//! Future-aware synchronization
|
|
//!
|
|
//! This module is enabled with the **`sync`** feature flag.
|
|
//!
|
|
//! Tasks sometimes need to communicate with each other. This module contains
|
|
//! two basic abstractions for doing so:
|
|
//!
|
|
//! - [oneshot](oneshot/index.html), a way of sending a single value
|
|
//! from one task to another.
|
|
//! - [mpsc](mpsc/index.html), a multi-producer, single-consumer channel for
|
|
//! sending values between tasks.
|
|
|
|
pub use tokio_sync::{
|
|
mpsc,
|
|
oneshot,
|
|
};
|