ibv_get_device_name()函数

Posted 2020-10-17 huststephen

const char *ibv_get_device_name(struct ibv_device *device);

描述

函数用来获取一个与RDMA设备相关联的名字

注意

• 这个名字在一台特定的机器中是唯一的（相同的名字不会分配给其他设备）；
• 这个名字在跨InfiniBand fabric并不是唯一的；
• 当一台电脑上拥有多于一台的RDMA设备时，修改RDMA设备在电脑上的位置（例如，总线上的位置），可能会导致关联的name改变；
• 为了区分设备，建议使用设备的GUID进行区分，函数ibv_get_device_guid()可以返回该值；

 

参数（struct ibv_device *device）

函数ibv_get_device_list()返回值中的某一项。（函数ibv_get_device_list()返回当前可用的RDMA设备数组）

 

返回值（const char *）

函数返回一个指向设备名的指针，如果出错，返回NULL。

名字的组成

• prefix前缀---描述RDMA设备供应商和样式
• cxgb3 ---Chelsio Communications, T3 RDMA family
• cxgb4 - Chelsio Communications, T4 RDMA family
• ehca - IBM, eHCA family
• ipathverbs - QLogic
• mlx4 - Mellanox Technologies, ConnectX family
• mthca - Mellanox Technologies, InfiniHost family
• nes - Intel, Intel-NE family
• index索引-用来在同一台电脑中区分相同供应商的一个数字

 

例子

函数ibv_get_device_name()可能返回的RDMA设备名的例子

• mlx4_0
• mlx4_1
• mthca0

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

int main(void)
{
    struct ibv_device **device_list;
    int num_devices;
    int i;

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

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

    for (i = 0; i < num_devices; ++ i)
        printf("RDMA device[%d]: name=%s\n", i,
               ibv_get_device_name(device_list[i]));

    ibv_free_device_list(device_list);

    return 0;
}