hringas 0.6.0

no libc, no_std, pure rust bindings to io_uring
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

use hringas::{Cqe, IoUring};
use std::fs;
use std::os::fd::AsFd;

fn main() {
    let mut ring = IoUring::new(8).unwrap();

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

    let sqe = ring.get_sqe().expect("submission queue is full");
    sqe.prep_read(0x42, fd.as_fd(), &mut buf, 0);

    // Note that the developer needs to ensure
    // that the entry pushed into submission queue is valid (e.g. fd, buffer).
    let Cqe { user_data, res, .. } = unsafe {
        ring.submit_and_wait(1).unwrap();
        ring.copy_cqe().expect("completion queue is empty")
    };

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