Struct IbvConfig 

pub struct IbvConfig {

    pub target: Option<IbvDeviceTarget>,
    pub cq_entries: i32,
    pub port_num: 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: IbvQpType,
    pub max_sge_override: i32,
}

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

target: Option<IbvDeviceTarget>

target - An explicit RDMA device target, resolved to a concrete device via resolve_target. When None, the consumer picks the device itself (the co-located NIC for GPU memory, or a hash-assigned NIC for host memory).

cq_entries: i32

cq_entries - The number of completion queue entries.

port_num: u8

port_num - The physical port number on the 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: IbvQpType

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

max_sge_override: i32

Test-only override for register_segments’s max_sge. <= 0 (default) uses ibv_query_device; small positive values force RDMAXCEL_MKEY_REG_LIMIT to exercise the dmabuf fallback.

Implementations

impl IbvConfig

pub fn targeting(target: IbvDeviceTarget) -> Self

An IbvConfig with default parameters whose device target is target (see IbvDeviceTarget).

Trait Implementations

impl Clone for IbvConfig

fn clone(&self) -> IbvConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IbvConfig

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

Formats the value using the given formatter.

impl Default for IbvConfig

rdma-core defaults below come from common rdma-core examples; tune for production based on ibv_query_device() results and workload characteristics. The default target is None, leaving device selection to the consumer.

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for IbvConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for IbvConfig

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

Formats the value using the given formatter.

impl Named for IbvConfig

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

A globally unique numeric identifier for this type.

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 IbvConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.