1RDMA_CREATE_EVENT_CHANNEL(L3i)brdmacm Programmer's ManRuDaMlA_CREATE_EVENT_CHANNEL(3)
2
3
4
6 rdma_create_event_channel - Open a channel used to report communication
7 events.
8
10 #include <rdma/rdma_cma.h>
11
12 struct rdma_event_channel * rdma_create_event_channel (void);
13
15 void no arguments
16
18 Asynchronous events are reported to users through event channels.
19
21 Returns a pointer to the created event channel, or NULL if the request
22 fails. On failure, errno will be set to indicate the failure reason.
23
25 Event channels are used to direct all events on an rdma_cm_id. For
26 many clients, a single event channel may be sufficient, however, when
27 managing a large number of connections or cm_id's, users may find it
28 useful to direct events for different cm_id's to different channels for
29 processing.
30
31 All created event channels must be destroyed by calling
32 rdma_destroy_event_channel. Users should call rdma_get_cm_event to
33 retrieve events on an event channel.
34
35 Each event channel is mapped to a file descriptor. The associated file
36 descriptor can be used and manipulated like any other fd to change its
37 behavior. Users may make the fd non-blocking, poll or select the fd,
38 etc.
39
41 rdma_cm(7), rdma_get_cm_event(3), rdma_destroy_event_channel(3)
42
43
44
45librdmacm 2007-05-15 RDMA_CREATE_EVENT_CHANNEL(3)