NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO | COLOPHON |
|
|
RDMA_CREATE_SRQ(3) Librdmacm Programmer's Manual RDMA_CREATE_SRQ(3)
rdma_create_srq - Allocate a shared receive queue.
#include <rdma/rdma_verbs.h> int rdma_create_srq (struct rdma_cm_id *id, struct ibv_pd *pd, struct ibv_srq_init_attr *attr);
id RDMA identifier. pd Optional protection ___domain for the SRQ. attr Initial SRQ attributes.
Allocate a SRQ associated with the specified rdma_cm_id.
Returns 0 on success, or -1 on error. If an error occurs, errno will be set to indicate the failure reason.
The rdma_cm_id must be bound to a local RDMA device before calling this function, and the protection ___domain, if provided, must be for that same device. After being allocated, the SRQ will be ready to handle posting of receives. If a protection ___domain is not given - pd parameter is NULL - then the rdma_cm_id will be created using a default protection ___domain. One default protection ___domain is allocated per RDMA device. The initial SRQ attributes are specified by the attr parameter. The ext.xrc.cq fields in the ibv_srq_init_attr is optional. If a completion queue is not specified for an XRC SRQ, then a CQ will be allocated by the rdma_cm for the SRQ, along with corresponding completion channels. Completion channels and CQ data created by the rdma_cm are exposed to the user through the rdma_cm_id structure. The actual capabilities and properties of the created SRQ will be returned to the user through the attr parameter. An rdma_cm_id may only be associated with a single SRQ.
rdma_bind_addr(3), rdma_resolve_addr(3), rdma_create_ep(3), rdma_destroy_srq(3), ibv_create_srq(3), ibv_create_xsrq(3)
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 2025-02-02. (At
that time, the date of the most recent commit that was found in
the repository was 2025-02-02.) 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]
librdmacm 2011-06-15 RDMA_CREATE_SRQ(3)
Pages that refer to this page: rdma_destroy_srq(3)