ibv_close_device(3) [debian man page]

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

NAME

       ibv_open_device, ibv_close_device - open and close an RDMA device context

SYNOPSIS

       #include <infiniband/verbs.h>

       struct ibv_context *ibv_open_device(struct ibv_device *device);

       int ibv_close_device(struct ibv_context *context);

DESCRIPTION

       ibv_open_device() opens the device device and creates a context for further use.

       ibv_close_device() closes the device context context.

RETURN VALUE

       ibv_open_device() returns a pointer to the allocated device context, or NULL if the request fails.

       ibv_close_device() returns 0 on success, -1 on failure.

NOTES

       ibv_close_device()  does  not  release all the resources allocated using context context.  To avoid resource leaks, the user should release
       all associated resources before closing a context.

SEE ALSO

       ibv_get_device_list(3), ibv_query_device(3), ibv_query_port(3), ibv_query_gid(3), ibv_query_pkey(3)

AUTHORS

       Dotan Barak <dotanba@gmail.com>

libibverbs							    2006-10-31							IBV_OPEN_DEVICE(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)