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

NAME

6       rdma_notify - Notifies the librdmacm of an asynchronous event.
7

SYNOPSIS

9       #include <rdma/rdma_cma.h>
10
11       int rdma_notify (struct rdma_cm_id *id, enum ibv_event_type event);
12

ARGUMENTS

14       id          RDMA identifier.
15
16       event       Asynchronous event.
17

DESCRIPTION

19       Used  to notify the librdmacm of asynchronous events that have occurred
20       on a QP associated with the rdma_cm_id.
21

RETURN VALUE

23       Returns 0 on success, or -1 on error.  If an error occurs,  errno  will
24       be  set  to  indicate  the  failure reason.  If errno is set to EISCONN
25       (transport endpoint is already connected), this indicates that the  the
26       underlying  communication manager established the connection before the
27       call to rdma_notify could be processed.  In this case,  the  error  may
28       safely be ignored.
29

NOTES

31       Asynchronous  events that occur on a QP are reported through the user's
32       device event handler.  This routine is used to notify the librdmacm  of
33       communication events.  In most cases, use of this routine is not neces‐
34       sary, however if connection establishment is done out of band (such  as
35       done through Infiniband), it's possible to receive data on a QP that is
36       not yet considered connected.  This routine forces the connection  into
37       an established state in this case in order to handle the rare situation
38       where the connection never forms on  its  own.   Calling  this  routine
39       ensures  the  delivery  of  the  RDMA_CM_EVENT_ESTABLISHED event to the
40       application.   Events  that  should  be  reported  to   the   CM   are:
41       IB_EVENT_COMM_EST.
42

SEE ALSO

44       rdma_connect(3), rdma_accept(3), rdma_listen(3)
45
46
47
48librdmacm                         2007-05-15                    RDMA_NOTIFY(3)
Impressum