Struct RdmaDomain

pub struct RdmaDomain {
    pub context: *mut ibv_context,
    pub pd: *mut ibv_pd,
    /* private fields */
}

Represents a domain for RDMA operations, encapsulating the necessary resources for establishing and managing RDMA connections.

An RdmaDomain manages the context, protection domain (PD), and memory region (MR) required for RDMA operations. It provides the foundation for creating queue pairs and establishing connections between RDMA devices.

Fields

• context: A pointer to the RDMA device context, representing the connection to the RDMA device.
• pd: A pointer to the protection domain, which provides isolation between different connections.
• mr_map: A map of memory region IDs to pointers, representing registered memory regions.
• counter: A counter for generating unique memory region IDs.

Fields

context: *mut ibv_context

pd: *mut ibv_pd

Implementations

impl RdmaDomain

pub fn new(device: RdmaDevice) -> Result<Self, Error>

Creates a new RdmaDomain.

This function initializes the RDMA device context, creates a protection domain, and registers a memory region with appropriate access permissions.

SAFETY: Our memory region (MR) registration uses implicit ODP for RDMA access, which maps large virtual address ranges without explicit pinning. This is convenient, but it broadens the memory footprint exposed to the NIC and introduces a security liability.

We currently assume a trusted, single-environment and are not enforcing finer-grained memory isolation at this layer. We plan to investigate mitigations - such as memory windows or tighter registration boundaries in future follow-ups.

Arguments

• config - Configuration settings for the RDMA operations

Errors

This function may return errors if:

• No RDMA devices are found
• The specified device cannot be found
• Device context creation fails
• Protection domain allocation fails
• Memory region registration fails

pub fn register_buffer( &mut self, addr: usize, size: usize, ) -> Result<RdmaMemoryRegionView, Error>

pub fn deregister_buffer(&mut self, buffer: RdmaBuffer) -> Result<(), Error>

Trait Implementations

impl Debug for RdmaDomain

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for RdmaDomain

fn drop(&mut self)

Executes the destructor for this type.

impl Send for RdmaDomain

impl Sync for RdmaDomain