EFADV_QUERY_MR(3)           EFA Direct Verbs Manual          EFADV_QUERY_MR(3)

NAME
       efadv_query_mr - Query EFA specific Memory Region attributes

SYNOPSIS
              #include <infiniband/efadv.h>

              int efadv_query_mr(struct ibv_mr *ibvmr, struct efadv_mr_attr *attr, uint32_t inlen);

DESCRIPTION
       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).

SEE ALSO
       efadv(7)

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

AUTHORS
       Michael Margolin <mrgolin@amazon.com>

efa                               2023-11-13                 EFADV_QUERY_MR(3)