|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO | AUTHORS | COLOPHON |
|
|
|
IBV_MODIFY_SRQ(3) Libibverbs Programmer's Manual IBV_MODIFY_SRQ(3)
ibv_modify_srq - modify attributes of a shared receive queue
(SRQ)
#include <infiniband/verbs.h>
int ibv_modify_srq(struct ibv_srq *srq,
struct ibv_srq_attr *srq_attr,
int srq_attr_mask);
ibv_modify_srq() modifies the attributes of SRQ srq with the
attributes in srq_attr according to the mask srq_attr_mask. 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; /* number of scatter elements per WR (irrelevant for ibv_modify_srq) */
uint32_t srq_limit; /* the limit value of the SRQ */
};
The argument srq_attr_mask specifies the SRQ attributes to be
modified. The argument is either 0 or the bitwise OR of one or
more of the following flags:
IBV_SRQ_MAX_WR Resize the SRQ
IBV_SRQ_LIMIT Set the SRQ limit
ibv_modify_srq() returns 0 on success, or the value of errno on
failure (which indicates the failure reason).
If any of the modify attributes is invalid, none of the
attributes will be modified.
Not all devices support resizing SRQs. To check if a device
supports it, check if the IBV_DEVICE_SRQ_RESIZE bit is set in the
device capabilities flags.
Modifying the srq_limit arms the SRQ to produce an
IBV_EVENT_SRQ_LIMIT_REACHED "low watermark" asynchronous event
once the number of WRs in the SRQ drops below srq_limit.
ibv_query_device(3), ibv_create_srq(3), ibv_destroy_srq(3),
ibv_query_srq(3)
Dotan Barak <[email protected]>
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
[email protected]. 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
[email protected]
libibverbs 2006-10-31 IBV_MODIFY_SRQ(3)
Pages that refer to this page: ibv_create_srq(3), ibv_create_srq_ex(3), ibv_query_srq(3)
|
HTML rendering created 2024-06-26 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|