rdma_create_event_channel(3) — Linux manual page

RDMA_CR..._CHANNEL(3) Librdmacm Programmer's ManualRDMA_CR..._CHANNEL(3)

NAME

       rdma_create_event_channel - Open a channel used to report
       communication events.

SYNOPSIS

       #include <rdma/rdma_cma.h>

       struct rdma_event_channel * rdma_create_event_channel (void);

ARGUMENTS

       void        no arguments

DESCRIPTION

       Asynchronous events are reported to users through event channels.

RETURN VALUE

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

NOTES

       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

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

COLOPHON

       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 2024-06-14.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2024-06-10.)  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_CR..._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)

---