Linux IO Uring

Rust的底层 io_uring 用户空间接口。

用法

要使用 io-uring crate，首先在您的 Cargo.toml 中添加以下内容

[dependencies]
io-uring = "0.6"

接下来，我们可以开始使用 io-uring crate。以下是用 Read 对文件进行快速介绍的示例。

use io_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(())
}

请注意，操作码 Read 仅在内核5.6及以上版本中可用。如果您使用低于5.6的内核，此示例将失败。

测试和基准测试

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

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

许可证

此项目根据您的选择，受以下任一许可证的许可：

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

。

贡献

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