rdma_create_event_channel(3) — Linux manual page



NAME         top

       rdma_create_event_channel  - Open a channel used to report communica‐
       tion events.

SYNOPSIS         top

       #include <rdma/rdma_cma.h>

       struct rdma_event_channel * rdma_create_event_channel (void);

ARGUMENTS         top

       void        no arguments

DESCRIPTION         top

       Asynchronous events are reported to users through event channels.

RETURN VALUE         top

       Returns a pointer to the created event channel, or NULL if the
       request fails.  On failure, errno will be set to indicate the failure

NOTES         top

       Event channels are used to direct all events on an rdma_cm_id.  For
       many clients, a single event channel may be sufficient, however, when
       managing a large number of connections or cm_id's, users may find it
       useful to direct events for different cm_id's to different channels
       for processing.

       All created event channels must be destroyed by calling
       rdma_destroy_event_channel.  Users should call rdma_get_cm_event to
       retrieve events on an event channel.

       Each event channel is mapped to a file descriptor.  The associated
       file descriptor can be used and manipulated like any other fd to
       change its behavior.  Users may make the fd non-blocking, poll or
       select the fd, etc.

SEE ALSO         top

       rdma_cm(7), rdma_get_cm_event(3), rdma_destroy_event_channel(3)

COLOPHON         top

       This page is part of the rdma-core (RDMA Core Userspace Libraries and
       Daemons) project.  Information about the project can be found at 
       ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug report
       for this manual page, send it to linux-rdma@vger.kernel.org.  This
       page was obtained from the project's upstream Git repository
       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2020-09-18.  (At
       that time, the date of the most recent commit that was found in the
       repository was 2020-09-16.)  If you discover any rendering problems
       in this HTML version of the page, or you believe there is a better or
       more up-to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not part
       of the original manual page), send a mail to man-pages@man7.org

librdmacm                        2007-05-15     RDMA_CREATE_EVENT_CHANNEL(3)

Pages that refer to this page: rdma_create_ep(3)rdma_create_id(3)rdma_destroy_event_channel(3)rdma_get_cm_event(3)rdma_migrate_id(3)rdma_cm(7)