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)