#io-uring #tokio #async #fs #fs-file #buffer

tokio-uring

io-uring support for the Tokio asynchronous runtime

5 releases (breaking)

0.4.0 Nov 5, 2022
0.3.0 Mar 4, 2022
0.2.0 Jan 9, 2022
0.1.0 Jul 19, 2021
0.0.0 Nov 14, 2020

#589 in Asynchronous

Download history 2786/week @ 2023-11-26 3652/week @ 2023-12-03 4308/week @ 2023-12-10 2979/week @ 2023-12-17 1957/week @ 2023-12-24 3232/week @ 2023-12-31 3653/week @ 2024-01-07 5543/week @ 2024-01-14 4034/week @ 2024-01-21 3573/week @ 2024-01-28 5464/week @ 2024-02-04 4084/week @ 2024-02-11 3324/week @ 2024-02-18 3806/week @ 2024-02-25 3963/week @ 2024-03-03 1687/week @ 2024-03-10

12,928 downloads per month
Used in 33 crates (27 directly)

MIT license

150KB
2.5K SLoC

tokio-uring

This crate provides io-uring for Tokio by exposing a new Runtime that is compatible with Tokio but also can drive io-uring-backed resources. Any library that works with Tokio also works with tokio-uring. The crate provides new resource types that work with io-uring.

API Docs | Chat

Getting started

Using tokio-uring requires starting a tokio-uring runtime. This runtime internally manages the main Tokio runtime and a io-uring driver.

In your Cargo.toml:

[dependencies]
tokio = { version = "0.4.0" }

In your main.rs:

use tokio_uring::fs::File;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    tokio_uring::start(async {
        // Open a file
        let file = File::open("hello.txt").await?;

        let buf = vec![0; 4096];
        // Read some data, the buffer is passed by ownership and
        // submitted to the kernel. When the operation completes,
        // we get the buffer back.
        let (res, buf) = file.read_at(buf, 0).await;
        let n = res?;

        // Display the contents
        println!("{:?}", &buf[..n]);

        Ok(())
    })
}

Requirements

tokio-uring requires a very recent linux kernel. (Not even all kernels with io_uring support will work) In particular 5.4.0 does not work (This is standard on Ubuntu 20.4). However 5.11.0 (the ubuntu hwe image) does work.

Project status

The tokio-uring project is still very young. Currently, we are focusing on supporting filesystem and network operations. Eventually, we will add safe APIs for all io-uring compatible operations.

License

This project is licensed under the MIT license.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in tokio-uring by you, shall be licensed as MIT, without any additional terms or conditions.

Dependencies

~3–13MB
~116K SLoC