efadv_query_mr(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | NOTES | AUTHORS | COLOPHON

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

NAME         top

       efadv_query_mr - Query EFA specific Memory Region attributes

SYNOPSIS         top

              #include <infiniband/efadv.h>

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

DESCRIPTION         top

       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         top

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

SEE ALSO         top

       efadv(7)

NOTES         top

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

AUTHORS         top

       Michael Margolin ⟨mrgolin@amazon.com⟩

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries
       and Daemons) project.  Information about the project can be found
       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug
       report for this manual page, send it to
       linux-rdma@vger.kernel.org.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2025-08-11.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-08-04.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

efa                             2023-11-13              EFADV_QUERY_MR(3)