IBV_GET_DEVICE_LIST - Online Linux Manual PageSection : 3
Updated : 2006-10-31
Source : libibverbs
Note : Libibverbs Programmers Manual

NAMEibv_get_device_list, ibv_free_device_list - get and release list of available RDMA devices

SYNOPSIS #include <infiniband/verbs.h> struct ibv_device **ibv_get_device_list(int *num_devices); void ibv_free_device_list(struct ibv_device **list);

DESCRIPTIONibv_get_device_list() returns a NULL-terminated array of RDMA devices currently available. The argument num_devices is optional; if not NULL, it is set to the number of devices returned in the array. ibv_free_device_list() frees the array of devices list returned by ibv_get_device_list().

RETURN VALUEibv_get_device_list() returns the array of available RDMA devices, or sets errno and returns NULL if the request fails. If no devices are found then num_devices is set to 0, and non-NULL is returned. ibv_free_device_list() returns no value.

ERRORSEPERM  Permission denied. ENOSYS  No kernel support for RDMA. ENOMEM  Insufficient memory to complete the operation.

NOTESClient code should open all the devices it intends to use with ibv_open_device() before calling ibv_free_device_list(). Once it frees the array with ibv_free_device_list(), it will be able to use only the open devices; pointers to unopened devices will no longer be valid. Setting the environment variable IBV_SHOW_WARNINGS will cause warnings to be emitted to stderr if a kernel verbs device is discovered, but no corresponding userspace driver can be found for it.

STATIC LINKINGIf libibverbs is statically linked to the application then all provider drivers must also be statically linked. The library will not load dynamic providers when static linking is used. To link the providers set the RDMA_STATIC_PROVIDERS define to the comma separated list of desired providers when compiling the application. The special keyword `all' will statically link all supported libibverbs providers. This is intended to be used along with pkg-config(1) to setup the proper flags for libibverbs linking. If this is not done then ibv_get_device_list will always return an empty list. Using only dynamic linking for libibverbs applications is strongly recommended.

SEE ALSOibv_fork_init(3), ibv_get_device_guid(3), ibv_get_device_name(3), ibv_get_device_index(3), ibv_open_device(3)

AUTHORDotan Barak <dotanba@gmail.com>
0
Johanes Gumabo
Data Size   :   10,142 byte
man-ibv_free_device_list.3Build   :   2024-12-29, 07:25   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   5 / 256,159
Visitor ID   :     :  
Visitor IP   :   3.22.81.40   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.29
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.