1RDMA_CREATE_SRQ(3)       Librdmacm Programmer's Manual      RDMA_CREATE_SRQ(3)
2
3
4

NAME

6       rdma_create_srq - Allocate a shared receive queue.
7

SYNOPSIS

9       #include <rdma/rdma_verbs.h>
10
11       int  rdma_create_srq  (struct rdma_cm_id *id, struct ibv_pd *pd, struct
12       ibv_srq_init_attr *attr);
13

ARGUMENTS

15       id          RDMA identifier.
16
17       pd          Optional protection domain for the SRQ.
18
19       attr        Initial SRQ attributes.
20

DESCRIPTION

22       Allocate a SRQ associated with the specified rdma_cm_id.
23

RETURN VALUE

25       Returns 0 on success, or -1 on error.  If an error occurs,  errno  will
26       be set to indicate the failure reason.
27

NOTES

29       The rdma_cm_id must be bound to a local RDMA device before calling this
30       function, and the protection domain, if provided, must be for that same
31       device.  After being allocated, the SRQ will be ready to handle posting
32       of receives.
33
34       If a protection domain is not given - pd parameter is NULL -  then  the
35       rdma_cm_id  will  be  created  using  a default protection domain.  One
36       default protection domain is allocated per RDMA device.
37
38       The initial SRQ attributes are specified by the  attr  parameter.   The
39       ext.xrc.cq  fields  in the ibv_srq_init_attr is optional.  If a comple‐
40       tion queue is not specified for an XRC SRQ, then a CQ will be allocated
41       by  the  rdma_cm for the SRQ, along with corresponding completion chan‐
42       nels.  Completion channels and CQ  data  created  by  the  rdma_cm  are
43       exposed to the user through the rdma_cm_id structure.
44
45       The  actual  capabilities  and  properties  of  the created SRQ will be
46       returned to the user through the attr  parameter.   An  rdma_cm_id  may
47       only be associated with a single SRQ.
48

SEE ALSO

50       rdma_bind_addr(3),       rdma_resolve_addr(3),       rdma_create_ep(3),
51       rdma_destroy_srq(3), ibv_create_srq(3), ibv_create_xsrq(3)
52
53
54
55librdmacm                         2011-06-15                RDMA_CREATE_SRQ(3)
Impressum