| --- | |
| date: 2020-5-3 | |
| footer: libibverbs | |
| header: "Libibverbs Programmer's Manual" | |
| layout: page | |
| license: 'Licensed under the OpenIB.org BSD license (FreeBSD Variant) - See COPYING.md' | |
| section: 3 | |
| title: ibv_import_device | |
| --- | |
| # NAME | |
| ibv_import_device - import a device from a given command FD | |
| # SYNOPSIS | |
| ```c | |
| #include <infiniband/verbs.h> | |
| struct ibv_context *ibv_import_device(int cmd_fd); | |
| ``` | |
| # DESCRIPTION | |
| **ibv_import_device()** returns an *ibv_context* pointer that is associated with the given | |
| *cmd_fd*. | |
| The *cmd_fd* is obtained from the ibv_context cmd_fd member, which must be dup'd (eg by dup(), SCM_RIGHTS, etc) | |
| before being passed to ibv_import_device(). | |
| Once the *ibv_context* usage has been ended *ibv_close_device()* should be called. | |
| This call may cleanup whatever is needed/opposite of the import including closing the command FD. | |
| # RETURN VALUE | |
| **ibv_import_device()** returns a pointer to the allocated RDMA context, or NULL if the request fails, and errno is set to indicate the reason. | |
| # SEE ALSO | |
| **ibv_open_device**(3), | |
| **ibv_close_device**(3), | |
| # AUTHOR | |
| Yishai Hadas <yishaih@mellanox.com> | |