Struct IbvDeviceInfo 

pub struct IbvDeviceInfo {
    pub name: String,
    /* private fields */
}

Represents an RDMA device in the system.

This struct encapsulates information about an RDMA device, including its hardware characteristics, capabilities, and port information. It provides access to device attributes such as vendor information, firmware version, and supported features.

Examples

use monarch_rdma::backend::ibverbs::device::list_all_devices;

let devices = list_all_devices();
if let Some(device) = devices.first() {
    // Access device name and firmware version
    let device_name = device.name();
    let firmware_version = device.fw_ver();
}

Fields

name: String

name - The name of the RDMA device (e.g., “mlx5_0”).

Implementations

impl IbvDeviceInfo

pub fn name(&self) -> &String

Returns the name of the RDMA device.

pub fn first_available() -> Option<IbvDeviceInfo>

Returns the first available RDMA device, if any.

pub fn vendor_id(&self) -> u32

Returns the vendor ID of the RDMA device.

pub fn vendor_part_id(&self) -> u32

Returns the vendor part ID of the RDMA device.

pub fn hw_ver(&self) -> u32

Returns the hardware version of the RDMA device.

pub fn fw_ver(&self) -> &String

Returns the firmware version of the RDMA device.

pub fn node_guid(&self) -> u64

Returns the node GUID of the RDMA device.

pub fn ports(&self) -> &Vec<IbvPort>

Returns a reference to the vector of ports available on the RDMA device.

pub fn port(&self, port_num: u8) -> Option<&IbvPort>

Returns the port with the given port_num, if present.

pub fn port_speed_mbytes_per_sec(&self) -> u32

Aggregate bandwidth (MB/s) of the device’s fastest active port, derived from its IB active_speed / active_width. 0 if no port is active, which ranks the device at the worst case.

pub fn max_qp(&self) -> i32

Returns the maximum number of queue pairs supported by the RDMA device.

pub fn max_cq(&self) -> i32

Returns the maximum number of completion queues supported by the RDMA device.

pub fn max_mr(&self) -> i32

Returns the maximum number of memory regions supported by the RDMA device.

pub fn max_pd(&self) -> i32

Returns the maximum number of protection domains supported by the RDMA device.

pub fn max_qp_wr(&self) -> i32

Returns the maximum number of work requests per queue pair supported by the RDMA device.

pub fn max_sge(&self) -> i32

Returns the maximum number of scatter/gather elements per work request supported by the RDMA device.

impl IbvDeviceInfo

pub fn default<I: IbvDeviceImpl>() -> Self

The optimal default device of backend I: the best NIC for CPU memory on any NUMA node. Panics if I has no devices.

Trait Implementations

impl Clone for IbvDeviceInfo

fn clone(&self) -> IbvDeviceInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IbvDeviceInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for IbvDeviceInfo

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for IbvDeviceInfo

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

Formats the value using the given formatter.

impl Serialize for IbvDeviceInfo

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

where __S: Serializer,

Serialize this value into the given Serde serializer.