tubbz-alt / fd-reactor

A Rust crate which provides an async reactor for handling file descriptors in a background thread

File Descriptor Reactor

Provides an async reactor for handling file descriptors in a background thread.

The purpose of this crate is to provide a standardized means of creating generic std::future::Future types which need to register file descriptors -- and which are independent of a particular async runtime -- as opposed to rolling their own reactors on a background thread. Futures created with this would be universally compatible with both async-std and tokio, and share the same background thread.

Implementation Notes

• The reactor's background thread is spawned on the first time that the reactor handle is fetched.
• Each file descriptor registers an interest to listen for.
• On registering a new file descriptor, a pipe is used to interrupt the poll operation.

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.