orengine 0.7.0-alpha.1

Optimized ring engine for Rust. It is a lighter and faster asynchronous library than tokio-rs, async-std, may, and even smol.
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

use orengine_macros::poll_for_io_request;
use std::future::Future;
use std::io::Result;
use std::pin::Pin;
use std::task::{Context, Poll};

use crate as orengine;
use crate::io::io_request_data::IoRequestData;
use crate::io::sys::{AsRawFd, RawFd};
use crate::io::worker::{local_worker, IoWorker};

/// `fallocate` io operation which allows to allocate space in a file from a given offset.
pub struct Fallocate {
    fd: RawFd,
    offset: usize,
    len: usize,
    flags: i32,
    io_request_data: Option<IoRequestData>,
}

impl Fallocate {
    /// Creates a new `fallocate` io operation.
    pub fn new(fd: RawFd, offset: usize, len: usize, flags: i32) -> Self {
        Self {
            fd,
            len,
            offset,
            flags,
            io_request_data: None,
        }
    }
}

impl Future for Fallocate {
    type Output = Result<usize>;

    fn poll(self: Pin<&mut Self>, cx: &mut Context) -> Poll<Self::Output> {
        let this = unsafe { self.get_unchecked_mut() };
        let ret;

        poll_for_io_request!((
            local_worker().fallocate(
                this.fd,
                this.offset as u64,
                this.len as u64,
                this.flags,
                unsafe { this.io_request_data.as_mut().unwrap_unchecked() }
            ),
            ret
        ));
    }
}

unsafe impl Send for Fallocate {}

/// This trait allows to create a `fallocate` io operation
/// which allows to allocate space in a file from a given offset.
///
/// Call [`fallocate`](AsyncFallocate::fallocate) to allocate len bytes on the disk.
pub trait AsyncFallocate: AsRawFd {
    #[inline(always)]
    fn fallocate(&self, offset: usize, len: usize, flags: i32) -> Fallocate {
        Fallocate::new(self.as_raw_fd(), offset, len, flags)
    }
}