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

NAME

6       rdma_create_qp - Allocate a QP.
7

SYNOPSIS

9       #include <rdma/rdma_cma.h>
10
11       int  rdma_create_qp  (struct  rdma_cm_id *id, struct ibv_pd *pd, struct
12       ibv_qp_init_attr *qp_init_attr);
13

ARGUMENTS

15       id          RDMA identifier.
16
17       pd          Optional protection domain for the QP.
18
19       qp_init_attr
20                   Initial QP attributes.
21

DESCRIPTION

23       Allocate a QP associated with the specified rdma_cm_id  and  transition
24       it for sending and receiving.
25

RETURN VALUE

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

NOTES

31       The rdma_cm_id must be bound to a local RDMA device before calling this
32       function,  and the protection domain must be for that same device.  QPs
33       allocated to an rdma_cm_id are automatically transitioned by the librd‐
34       macm through their states.  After being allocated, the QP will be ready
35       to handle posting of receives.  If the QP is unconnected,  it  will  be
36       ready to post sends.
37
38       If  a  protection domain is not given - pd parameter is NULL - then the
39       rdma_cm_id will be created using  a  default  protection  domain.   One
40       default protection domain is allocated per RDMA device.
41
42       The  initial QP attributes are specified by the qp_init_attr parameter.
43       The send_cq and recv_cq fields in the  ibv_qp_init_attr  are  optional.
44       If  a send or receive completion queue is not specified, then a CQ will
45       be allocated by the rdma_cm for the QP, along with  corresponding  com‐
46       pletion  channels.   Completion  channels  and  CQ  data created by the
47       rdma_cm are exposed to the user through the rdma_cm_id structure.
48
49       The actual capabilities and  properties  of  the  created  QP  will  be
50       returned to the user through the qp_init_attr parameter.  An rdma_cm_id
51       may only be associated with a single QP.
52

SEE ALSO

54       rdma_bind_addr(3), rdma_resolve_addr(3),  rdma_destroy_qp(3),  ibv_cre‐
55       ate_qp(3), ibv_modify_qp(3)
56
57
58
59librdmacm                         2007-05-15                 RDMA_CREATE_QP(3)
Impressum