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>