efadv_query_mr(3)

efadv_query_mr3

Query efa specific memory region attributes

Usage

#include <infiniband/efadv.h>
int efadv_query_mr(struct ibv_mr *ibvmr, struct efadv_mr_attr *attr, uint32_t inlen);

Overview

efadv_query_mr() queries device-specific Memory Region attributes.

Compatibility is handled using the comp_mask and inlen fields.

struct efadv_mr_attr {
    uint64_t comp_mask;
    uint16_t ic_id_validity;
    uint16_t recv_ic_id;
    uint16_t rdma_read_ic_id;
    uint16_t rdma_recv_ic_id;
};
inlen

In: Size of struct efadv_mr_attr.

comp_mask

Compatibility mask.

ic_id_validity

Validity mask of interconnect id fields:

EFADV_MR_ATTR_VALIDITY_RECV_IC_ID: recv_ic_id has a valid value. EFADV_MR_ATTR_VALIDITY_RDMA_READ_IC_ID: rdma_read_ic_id has a valid value. EFADV_MR_ATTR_VALIDITY_RDMA_RECV_IC_ID: rdma_recv_ic_id has a valid value.

recv_ic_id

Physical interconnect used by the device to reach the MR for receive operation.

rdma_read_ic_id

Physical interconnect used by the device to reach the MR for RDMA read operation.

rdma_recv_ic_id

Physical interconnect used by the device to reach the MR for RDMA write receive.

Return value

efadv_query_mr() returns 0 on success, or the value of errno on failure (which indicates the failure reason).

Notes

•

Compatibility mask (comp_mask) is an out field and currently has no values.

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

Authors

Michael Margolin ⟨[email protected]⟩\c

From rdma-core 65.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.