ibv_query_srq(3) — Linux manual page

IBV_QUERY_SRQ(3)     Libibverbs Programmer's Manual     IBV_QUERY_SRQ(3)

NAME

       ibv_query_srq - get the attributes of a shared receive queue
       (SRQ)

SYNOPSIS

       #include <infiniband/verbs.h>

       int ibv_query_srq(struct ibv_srq *srq, struct ibv_srq_attr *srq_attr);

DESCRIPTION

       ibv_query_srq() gets the attributes of the SRQ srq and returns
       them through the pointer srq_attr.  The argument srq_attr is an
       ibv_srq_attr struct, as defined in <infiniband/verbs.h>.

       struct ibv_srq_attr {
               uint32_t                max_wr;         /* maximum number of outstanding work requests (WRs) in the SRQ */
               uint32_t                max_sge;        /* maximum number of scatter elements per WR */
               uint32_t                srq_limit;      /* the limit value of the SRQ */
       };

RETURN VALUE

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

NOTES

       If the value returned for srq_limit is 0, then the SRQ limit
       reached ("low watermark") event is not (or no longer) armed, and
       no asynchronous events will be generated until the event is
       rearmed.

SEE ALSO

       ibv_create_srq(3), ibv_destroy_srq(3), ibv_modify_srq(3)

AUTHORS

       Dotan Barak <dotanba@gmail.com>

COLOPHON

       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 2024-06-14.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2024-06-10.)  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

libibverbs                     2006-10-31               IBV_QUERY_SRQ(3)

Pages that refer to this page: ibv_create_srq(3), ibv_create_srq_ex(3), ibv_modify_srq(3)

---