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.

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

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>

Referenced By

ibv_create_ah_from_wc(3), ibv_create_comp_channel(3), ibv_get_async_event(3), ibv_get_device_guid(3), ibv_get_device_list(3), ibv_get_device_name(3), ibv_get_pkey_index(3), ibv_query_device(3), ibv_query_device_ex(3), ibv_query_gid(3), ibv_query_pkey(3), ibv_query_rt_values_ex(3).

The man page ibv_close_device(3) is an alias of ibv_open_device(3).

2006-10-31 Libibverbs Programmer's Manual