Module common

Some utilities to support fuse-backend-rs.

Wrappers for Rust async io

It’s challenging to support Rust async io, and it’s even more challenging to support Rust async io with Linux io-uring.

This common module adds a wrapper layer over tokio and tokio-uring to simplify the way to support Rust async io by providing:

• FileReadWriteVolatile: A trait similar to std::io::Read and std::io::Write, but uses FileVolatileSlice objects as data buffers.
• FileVolatileSlice: An adapter structure to work around limitations of the vm-memory crate.
• FileVolatileBuf: An adapter structure to support io-uring based asynchronous IO.
• File: An adapter for for tokio::fs::File and [tokio-uring::fs::File].
• Runtime: An adapter for for tokio::runtime::Runtime and [tokio-uring::Runtime].

Modules

async_file

File to wrap over tokio::fs::File and tokio-uring::fs::File.

async_runtime

Runtime to wrap over tokio current-thread Runtime and tokio-uring Runtime.

file_buf

Provide data buffers to support tokio and tokio-uring based async io.

file_traits

File extension traits to transfer data between File objects and VolatileSlice buffers.

mpmc

Asynchronous Multi-Producer Multi-Consumer channel.