Struct RdmaMemoryRegionView

pub struct RdmaMemoryRegionView {
    pub id: usize,
    pub virtual_addr: usize,
    pub rdma_addr: usize,
    pub size: usize,
    pub lkey: u32,
    pub rkey: u32,
}

Represents a view of a memory region that can be registered with an RDMA device.

This is a ‘view’ of a registered Memory Region, allowing multiple views into a single large MR registration. This is commonly used with PyTorch’s caching allocator, which reserves large memory blocks and provides different data pointers into that space.

Example

PyTorch Caching Allocator creates a 16GB segment at virtual address 0x01000000. The underlying Memory Region registers 16GB but at RDMA address 0x0. To access virtual address 0x01100000, we return a view at RDMA address 0x100000.

Safety

The caller must ensure the memory remains valid and is not freed, moved, or overwritten while RDMA operations are in progress.

Fields

id: usize

virtual_addr: usize

Virtual address in the process address space. This is the pointer/address as seen by the local process.

rdma_addr: usize

Memory address assigned after Memory Region (MR) registration. This is the address may be offset a base MR addr.

size: usize

lkey: u32

rkey: u32

Implementations

impl RdmaMemoryRegionView

pub fn new( id: usize, virtual_addr: usize, rdma_addr: usize, size: usize, lkey: u32, rkey: u32, ) -> Self

Creates a new RdmaMemoryRegionView with the given address and size.

Trait Implementations

impl Clone for RdmaMemoryRegionView

fn clone(&self) -> RdmaMemoryRegionView

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RdmaMemoryRegionView

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RdmaMemoryRegionView

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for RdmaMemoryRegionView

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for RdmaMemoryRegionView

fn eq(&self, other: &RdmaMemoryRegionView) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RdmaMemoryRegionView

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for RdmaMemoryRegionView

impl Eq for RdmaMemoryRegionView

impl Send for RdmaMemoryRegionView

impl StructuralPartialEq for RdmaMemoryRegionView

impl Sync for RdmaMemoryRegionView