Struct IbverbsConfig

pub struct IbverbsConfig {

    pub device: RdmaDevice,
    pub cq_entries: i32,
    pub port_num: u8,
    pub gid_index: u8,
    pub max_send_wr: u32,
    pub max_recv_wr: u32,
    pub max_send_sge: u32,
    pub max_recv_sge: u32,
    pub path_mtu: u32,
    pub retry_cnt: u8,
    pub rnr_retry: u8,
    pub qp_timeout: u8,
    pub min_rnr_timer: u8,
    pub max_dest_rd_atomic: u8,
    pub max_rd_atomic: u8,
    pub pkey_index: u16,
    pub psn: u32,
    pub use_gpu_direct: bool,
    pub hw_init_delay_ms: u64,
    pub qp_type: RdmaQpType,
}

Represents ibverbs specific configurations.

This struct holds various parameters required to establish and manage an RDMA connection. It includes settings for the RDMA device, queue pair attributes, and other connection-specific parameters.

Fields

device: RdmaDevice

device - The RDMA device to use for the connection.

cq_entries: i32

cq_entries - The number of completion queue entries.

port_num: u8

port_num - The physical port number on the device.

gid_index: u8

gid_index - The GID index for the RDMA device.

max_send_wr: u32

max_send_wr - The maximum number of outstanding send work requests.

max_recv_wr: u32

max_recv_wr - The maximum number of outstanding receive work requests.

max_send_sge: u32

max_send_sge - Te maximum number of scatter/gather elements in a send work request.

max_recv_sge: u32

max_recv_sge - The maximum number of scatter/gather elements in a receive work request.

path_mtu: u32

path_mtu - The path MTU (Maximum Transmission Unit) for the connection.

retry_cnt: u8

retry_cnt - The number of retry attempts for a connection request.

rnr_retry: u8

rnr_retry - The number of retry attempts for a receiver not ready (RNR) condition.

qp_timeout: u8

qp_timeout - The timeout for a queue pair operation.

min_rnr_timer: u8

min_rnr_timer - The minimum RNR timer value.

max_dest_rd_atomic: u8

max_dest_rd_atomic - The maximum number of outstanding RDMA read operations at the destination.

max_rd_atomic: u8

max_rd_atomic - The maximum number of outstanding RDMA read operations at the initiator.

pkey_index: u16

pkey_index - The partition key index.

psn: u32

psn - The packet sequence number.

use_gpu_direct: bool

use_gpu_direct - Whether to enable GPU Direct RDMA support on init.

hw_init_delay_ms: u64

hw_init_delay_ms - The delay in milliseconds before initializing the hardware. This is used to allow the hardware to settle before starting the first transmission.

qp_type: RdmaQpType

qp_type - The type of queue pair to create (Auto, Standard, or Mlx5dv).

Implementations

impl IbverbsConfig

pub fn targeting(target: &str) -> Self

Create a new IbverbsConfig targeting a specific device

Device targets use a unified “type:id” format:

• “cpu:N” -> finds RDMA device closest to NUMA node N
• “cuda:N” -> finds RDMA device closest to CUDA device N
• “nic:mlx5_N” -> returns the specified NIC directly

Shortcuts:

• “cpu” -> defaults to “cpu:0”
• “cuda” -> defaults to “cuda:0”

Arguments

• target - Target device specification

Returns

• IbverbsConfig with resolved device, or default device if resolution fails

Trait Implementations

impl Clone for IbverbsConfig

fn clone(&self) -> IbverbsConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IbverbsConfig

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

Formats the value using the given formatter.

impl Default for IbverbsConfig

Default RDMA parameters below are based on common values from rdma-core examples For high-performance or production use, consider tuning based on ibv_query_device() results and workload characteristics

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for IbverbsConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for IbverbsConfig

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

Formats the value using the given formatter.

impl Named for IbverbsConfig

fn typename() -> &'static str

The globally unique type name for the type. This should typically be the fully qualified Rust name of the type.

fn typehash() -> u64

A globally unique hash for this type. TODO: actually enforce perfect hashing

fn typeid() -> TypeId

The TypeId for this type. TypeIds are unique only within a binary, and should not be used for global identification.

fn port() -> u64

The globally unique port for this type. Typed ports are in the range of 1<<63..1<<64-1.

fn arm(&self) -> Option<&'static str>

If the named type is an enum, this returns the name of the arm of the value self.

unsafe fn arm_unchecked(self_: *const ()) -> Option<&'static str>

An unsafe version of ‘arm’, accepting a pointer to the value, for use in type-erased settings.

impl Serialize for IbverbsConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.