const char *ibv_get_device_name(struct ibv_device *device);

Description

ibv_get_device_name() returns a string of the name, which is associated with the RDMA device device.

This name is unique within a specific machine (the same name cannot be assigned to more than one device)

However, this name isn't unique across an InfiniBand fabric (this name can be found in different machines).

When there are more than one RDMA devices in a computer, changing the device location in the computer (i.e. in the PCI bus) may result a change in the names associated with the devices. In order to distinguish between the device, it is recommended using the device GUID, returned by ibv_get_device_guid().

Parameters

Return Values

ibv_get_device_name() returns a pointer to the device name, or NULL in case of a failure.

The name is composed from:

• prefix - which describes the RDMA device vendor and model
• 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 - a number that helps to differentiate between several devices from the same vendor and family in the same computer

Examples

Here are some examples for RDMA device names that may be returned by ibv_get_device_name():

• mlx4_0
• mlx4_1
• mthca0

Show all existing RDMA device names:

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");
        exit(1);
}
 
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);

show_devices_name.c

Written by: Dotan Barak on June 13, 2012.on February 17, 2015.