RDMA-打开设备列表与释放设备列表

一：ibv_get_device_list()

struct ibv_device** ibv_get_device_list(int *num_devices);

先决条件

Ibv_fork_init()应该在调用libibverb中的任何其他函数之前调用。

Description

ibv_get_device_list()返回当前可用的以null结尾的RDMA设备数组。该数组应该使用ibv_free_device_list()释放。
不应该直接访问数组项。相反，它们应该与以下服务动词一起使用:ibv_get_device_name()、ibv_get_device_guid()和ibv_open_device()。

Parameters

Return Values

bv_get_device_list()在成功时返回可用RDMA设备的数组，如果请求失败则返回NULL并设置errno。如果没有找到设备，那么num_devices被设置为0，并且返回非null。

可能的errno值有:
EPERM - 权限问题
ENOMEM - 内存不足
ENOSYS - 内核不支持

Examples

Get device list without a parameter:

struct ibv_device **dev_list;
 
dev_list = ibv_get_device_list(NULL);
if (!dev_list)
        exit(1);

Get device list with a parameter:

struct ibv_device **dev_list;
int num_devices;
 
dev_list = ibv_get_device_list(&num_devices);
if (!dev_list)
        exit(1);

常见问题

我调用ibv_get_device_list()它返回NULL，这是什么意思?
这是一个不应该失败的verbs，检查模块ib_uverbs是否已加载。
驱动程序找不到任何RDMA设备。

检查lspci，如果您的机器中有任何RDMA设备
使用lsmod检查您的RDMA设备的低级驱动程序是否已加载
检查dmesg/var/log/messages是否有错误

二：ibv_free_device_list()

void ibv_free_device_list(struct ibv_device **list);

Description

ibv_free_device_list()释放RDMA设备数组列表。
一旦释放数组，指向未使用ibv_open_device()打开的设备的指针将不再有效。客户端代码必须打开所有设备，它打算在调用ibv_free_device_list()之前使用。

Parameters

Return Values

None (this function always succeeds).

Examples

struct ibv_device **dev_list;
dev_list = ibv_get_device_list(NULL);
if (!dev_list)
        exit(1);
ibv_free_device_list(dev_list);

例程：

#include <stdio.h>
#include <infiniband/verbs.h>

static int get_num_rdma_devices_count(void)
{
	struct ibv_device **device_list;
	int num_devices = 0;

	device_list = ibv_get_device_list(NULL);
	if (!device_list) {
		fprintf(stderr, "Error, ibv_get_device_list() failed\n");
		return -1;
	}

	while (device_list[num_devices])
		num_devices ++;

	ibv_free_device_list(device_list);

	return num_devices;
}

static int get_num_rdma_devices_param(void)
{
	struct ibv_device **device_list;
	int num_devices;

	device_list = ibv_get_device_list(&num_devices);
	if (!device_list) {
		fprintf(stderr, "Error, ibv_get_device_list() failed\n");
		return -1;
	}

	ibv_free_device_list(device_list);

	return num_devices;
}

int main(void)
{
	int num_devices;

	/* print the number of RDMA devices by counting them */
	num_devices = get_num_rdma_devices_count();
	if (num_devices < 0) {
		fprintf(stderr, "Error, failed ot get number of RDMA devices by count\n");
		return 1;
	}

	printf("%d RDMA device(s) found by count\n", num_devices);

	/* print the number of RDMa devices using parameter */
	num_devices = get_num_rdma_devices_param();
	if (num_devices < 0) {
		fprintf(stderr, "Error, failed ot get number of RDMA devices by function parameter\n");
		return 1;
	}

	printf("%d RDMA device(s) found by function parameter\n", num_devices);

	return 0;
}

编译：

gcc device_list.c -o device_list -libverbs