NAME

       rdma_notify - Notifies the librdmacm of an asynchronous event.

SYNOPSIS

       #include <rdma/rdma_cma.h>

       int rdma_notify (struct rdma_cm_id *id, enum ibv_event_type event);

ARGUMENTS

       id          RDMA identifier.

       event       Asynchronous event.

DESCRIPTION

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

RETURN VALUE

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

NOTES

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

SEE ALSO

       rdma_connect(3), rdma_accept(3), rdma_listen(3)

librdmacm                                          2007-05-15                                     RDMA_NOTIFY(3)