Linux 的 io_uring API，使用 rustix

这是 Rust 的 Linux io_uring 用户空间接口，它比用户空间边界 API 更高级，但比异步运行时更低级。

此库基于 io_uring crate 开发，并通过使用 rustix 来执行系统调用进行了修改。

用法

要使用 io-uring crate，首先将其添加到您的 Cargo.toml

[dependencies]
rustix-uring = "0.1"

接下来，我们可以开始使用 io-uring crate。以下是一个使用 Read 读取文件的快速介绍。

use rustix_uring::{opcode, types, IoUring};
use std::os::unix::io::AsRawFd;
use std::{fs, io};

fn main() -> io::Result<()> {
    let mut ring = IoUring::new(8)?;

    let fd = fs::File::open("README.md")?;
    let mut buf = vec![0; 1024];

    let read_e = opcode::Read::new(types::Fd(fd.as_raw_fd()), buf.as_mut_ptr(), buf.len() as _)
        .build()
        .user_data(0x42);

    // Note that the developer needs to ensure
    // that the entry pushed into submission queue is valid (e.g. fd, buffer).
    unsafe {
        ring.submission()
            .push(&read_e)
            .expect("submission queue is full");
    }

    ring.submit_and_wait(1)?;

    let cqe = ring.completion().next().expect("completion queue is empty");

    assert_eq!(cqe.user_data(), 0x42);
    assert!(cqe.result() >= 0, "read error: {}", cqe.result());

    Ok(())
}

请注意，opcode Read 只在内核 5.6 之后可用。如果您使用低于 5.6 的内核，此示例将失败。

测试和基准测试

您可以使用以下命令运行库的测试和基准测试。

$ cargo run --package io-uring-test
$ cargo bench --package io-uring-bench

许可证

此项目许可采用以下之一

• Apache 许可证 2.0 版本，(LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
• MIT 许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

任选其一。

贡献

除非您明确说明，否则您有意提交给 io-uring 的任何贡献，根据 Apache-2.0 许可证的定义，应按上述方式双重许可，不附加任何额外条款或条件。