linux-io-uring 0.0.4

The `io_uring` library for Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

use linux_io_uring::{ opcode, IoUring };


#[test]
fn test_full() -> anyhow::Result<()> {
    let mut io_uring = IoUring::new(4)?;

    // fill squeue
    unsafe {
        let mut queue = io_uring.submission().available();
        for i in 0..4 {
            let entry = opcode::Nop::new()
                .build()
                .user_data(i);
            queue.push(entry)
                .map_err(drop)
                .expect("queue is full");
        }
        assert!(queue.is_full());
    }
    assert_eq!(io_uring.submit_and_wait(4)?, 4);
    assert!(io_uring.submission().is_empty());

    // fill cqueue
    unsafe {
        let mut queue = io_uring.submission().available();
        for i in 4..8 {
            let entry = opcode::Nop::new()
                .build()
                .user_data(i);
            queue.push(entry)
                .map_err(drop)
                .expect("queue is full");
        }
        assert!(queue.is_full());
    }
    assert_eq!(io_uring.submit_and_wait(8)?, 4);
    assert!(io_uring.submission().is_empty());
    assert!(io_uring.completion().is_full());

    // overflow cqueue
    unsafe {
        let mut queue = io_uring.submission().available();
        for i in 8..12 {
            let entry = opcode::Nop::new()
                .build()
                .user_data(i);
            queue.push(entry)
                .map_err(drop)
                .expect("queue is full");
        }
        assert!(queue.is_full());
    }

    assert_eq!(io_uring.submit_and_wait(4)?, 4);

    assert!(io_uring.submission().is_empty());
    assert!(io_uring.completion().is_full());
    assert_eq!(io_uring.completion().overflow(), 4);

    let mut cqes = io_uring
        .completion()
        .available()
        .map(|entry| entry.user_data())
        .collect::<Vec<_>>();

    cqes.sort();
    assert_eq!(cqes, &[0, 1, 2, 3, 4, 5, 6, 7]);

    Ok(())
}