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

NAME

6       rdma_post_recvv - post a work request to receive incoming messages.
7

SYNOPSIS

9       #include <rdma/rdma_verbs.h>
10
11       int  rdma_post_recvv  (struct  rdma_cm_id  *id,  void  *context, struct
12       ibv_sge *sgl, int nsge);
13

ARGUMENTS

15       id          A reference to a communication identifier where the message
16                   buffer(s) will be posted.
17
18       context     User-defined context associated with the request.
19
20       sgl         A  scatter-gather list of memory buffers posted as a single
21                   request.
22
23       nsge        The number of scatter-gather entries in the sgl array.
24

DESCRIPTION

26       Posts a single work request to the receive  queue  of  the  queue  pair
27       associated  with  the rdma_cm_id.  The posted buffers will be queued to
28       receive an incoming message sent by the remote peer.
29

RETURN VALUE

31       Returns 0 on success, or -1 on error.  If an error occurs,  errno  will
32       be set to indicate the failure reason.
33

NOTES

35       The  user  is  responsible for ensuring that the receive is posted, and
36       the total buffer space is large enough to contain all sent data  before
37       the  peer  posts  the  corresponding send message.  The message buffers
38       must have been registered before being posted,  and  the  buffers  must
39       remain registered until the receive completes.
40
41       Messages  may  be  posted  to an rdma_cm_id only after a queue pair has
42       been associated with it.  A queue pair is bound to an rdma_cm_id  after
43       calling  rdma_create_ep  or  rdma_create_qp, if the rdma_cm_id is allo‐
44       cated using rdma_create_id.
45
46       The user-defined context associated with the receive  request  will  be
47       returned  to  the  user through the work completion wr_id, work request
48       identifier, field.
49

SEE ALSO

51       rdma_cm(7),  rdma_create_id(3),  rdma_create_ep(3),  rdma_create_qp(3),
52       rdma_reg_read(3),  ibv_reg_mr(3),  ibv_dereg_mr(3),  rdma_post_recv(3),
53       rdma_post_send(3)
54
55
56
57librdmacm                         2010-07-19                RDMA_POST_RECVV(3)
Impressum