rdma_create_event_channel(3) [debian man page]

RDMA_CREATE_EVENT_CHANNEL(3)				   Librdmacm Programmer's Manual			      RDMA_CREATE_EVENT_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 rea-
       son.

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)

librdmacm							    2007-05-15					      RDMA_CREATE_EVENT_CHANNEL(3)

IBV_CREATE_COMP_CHANNEL(3)				  Libibverbs Programmer's Manual				IBV_CREATE_COMP_CHANNEL(3)

NAME

       ibv_create_comp_channel, ibv_destroy_comp_channel - create or destroy a completion event channel

SYNOPSIS

       #include <infiniband/verbs.h>

       struct ibv_comp_channel *ibv_create_comp_channel(struct ibv_context
							*context);

       int ibv_destroy_comp_channel(struct ibv_comp_channel *channel);

DESCRIPTION

       ibv_create_comp_channel() creates a completion event channel for the RDMA device context context.

       ibv_destroy_comp_channel() destroys the completion event channel channel.

RETURN VALUE

       ibv_create_comp_channel() returns a pointer to the created completion event channel, or NULL if the request fails.

       ibv_destroy_comp_channel() returns 0 on success, or the value of errno on failure (which indicates the failure reason).

NOTES

       A "completion channel" is an abstraction introduced by libibverbs that does not exist in the InfiniBand Architecture verbs specification or
       RDMA Protocol Verbs Specification.  A completion channel is essentially file descriptor that is used to deliver completion notifications to
       a  userspace  process.  When a completion event is generated for a completion queue (CQ), the event is delivered via the completion channel
       attached to that CQ.  This may be useful to steer completion events to different threads by using multiple completion channels.

       ibv_destroy_comp_channel() fails if any CQs are still associated with the completion event channel being destroyed.

SEE ALSO

       ibv_open_device(3), ibv_create_cq(3), ibv_get_cq_event(3)

AUTHORS

       Dotan Barak <dotanba@gmail.com>

libibverbs							    2006-10-31						IBV_CREATE_COMP_CHANNEL(3)