dtact-util 0.2.0

Async utilities for Dtact: I/O, filesystem, process, signal, stream and timer primitives with lock-free native (io_uring/IOCP/kqueue) and tokio backends. Designed for hardware-level control and non-blocking heterogeneous orchestration.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

//! Async filesystem primitives.
//!
//! Two backends, selected the same way as [`crate::io`]:
//! - `native` (default): a small dedicated blocking-thread pool that bridges
//!   `std::fs`/platform positional-I/O syscalls into futures. On Linux this
//!   is a reasonable place to grow real `io_uring` opcodes (Openat/Read/Write/
//!   Fsync/Close/Statx) later — see the module doc on `native` for exactly
//!   what's deferred and why.
//! - `tokio` (when `native` is off): a thin wrapper over `tokio::fs`.

#[cfg(all(feature = "native", windows))]
mod iocp_windows;
#[cfg(all(feature = "native", windows))]
pub use iocp_windows::*;

#[cfg(all(feature = "native", target_os = "linux"))]
mod uring_linux;
#[cfg(all(feature = "native", target_os = "linux"))]
pub use uring_linux::*;

#[cfg(all(feature = "native", not(windows), not(target_os = "linux")))]
mod native;
#[cfg(all(feature = "native", not(windows), not(target_os = "linux")))]
pub use native::*;

// NOTE: named `tokio_backend`, not `tokio` - see io/mod.rs for why a local
// module literally named `tokio` shadows the extern crate of the same name.
#[cfg(all(feature = "tokio", not(feature = "native")))]
mod tokio_backend;
#[cfg(all(feature = "tokio", not(feature = "native")))]
pub use tokio_backend::*;