async-rdma 0.5.0

A rust async wrapper for RDMA ibvers lib
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

use crate::error_utilities::{log_last_os_err, log_ret_last_os_err};
use crate::Context;
use rdma_sys::{ibv_comp_channel, ibv_create_comp_channel, ibv_destroy_comp_channel};
use std::os::unix::prelude::{AsRawFd, RawFd};
use std::{io, ptr::NonNull, sync::Arc};
use tokio::io::unix::AsyncFd;

/// Event channel wrapper for `ibv_comp_channel`
#[derive(Debug)]
pub(crate) struct EventChannel {
    /// The ibv device context
    _ctx: Arc<Context>,
    /// The inner ibv_comp_channel pointer
    inner_ec: NonNull<ibv_comp_channel>,
}

impl EventChannel {
    /// Get the inner `ibv_comp_channel` pointer
    pub(crate) fn as_ptr(&self) -> *mut ibv_comp_channel {
        self.inner_ec.as_ptr()
    }

    /// Create a new `EventChannel`
    pub(crate) fn new(ctx: Arc<Context>) -> io::Result<Self> {
        // SAFETY: ffi
        // TODO: check safety
        let inner_ec = NonNull::new(unsafe { ibv_create_comp_channel(ctx.as_ptr()) })
            .ok_or_else(log_ret_last_os_err)?;
        Ok(Self {
            _ctx: ctx,
            inner_ec,
        })
    }

    /// Get the event channel fd and wrap it into Tokio `AsyncFd`
    pub(crate) fn async_fd(&self) -> io::Result<AsyncFd<RawFd>> {
        // SAFETY: ?
        // TODO: check safety
        AsyncFd::new(unsafe { *self.as_ptr() }.fd.as_raw_fd())
    }
}

unsafe impl Sync for EventChannel {}

unsafe impl Send for EventChannel {}

impl Drop for EventChannel {
    fn drop(&mut self) {
        // SAFETY: ffi
        // TODO: check safety
        let errno = unsafe { ibv_destroy_comp_channel(self.as_ptr()) };
        if errno != 0_i32 {
            log_last_os_err();
        }
    }
}