NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO | AUTHORS | COLOPHON

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

NAME         top

       ibv_open_device,  ibv_close_device  -  open  and close an RDMA device
       context

SYNOPSIS         top

       #include <infiniband/verbs.h>

       struct ibv_context *ibv_open_device(struct ibv_device *device);

       int ibv_close_device(struct ibv_context *context);

DESCRIPTION         top

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

       ibv_close_device() closes the device context context.

RETURN VALUE         top

       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         top

       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.

       Setting the environment variable **RDMAV_ALLOW_DISASSOC_DESTROY**
       tells the library to relate an EIO from destroy commands as a success
       as the kernel resources were already released. This comes to prevent
       memory leakage in the user space area upon device disassociation.
       Applications using this flag cannot call ibv_get_cq_event or
       ibv_get_async_event concurrently with any call to an object
       destruction function.

SEE ALSO         top

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

AUTHORS         top

       Dotan Barak <dotanba@gmail.com>

COLOPHON         top

       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 2019-07-28.  (At
       that time, the date of the most recent commit that was found in the
       repository was 2019-07-25.)  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

libibverbs                       2006-10-31               IBV_OPEN_DEVICE(3)

Pages that refer to this page: ibv_create_ah_from_wc(3)ibv_create_comp_channel(3)ibv_get_async_event(3)ibv_query_device(3)ibv_query_device_ex(3)ibv_query_rt_values_ex(3)