1IBV_GET_DEVICE_LIST(3)  Libibverbs Programmer's Manual  IBV_GET_DEVICE_LIST(3)
2
3
4

NAME

6       ibv_get_device_list,  ibv_free_device_list  -  get  and release list of
7       available InfiniBand devices
8

SYNOPSIS

10       #include <infiniband/verbs.h>
11
12       struct ibv_device **ibv_get_device_list(int *num_devices);
13       void ibv_free_device_list(struct ibv_device **list);
14

DESCRIPTION

16       ibv_get_device_list() returns a  NULL-terminated  array  of  InfiniBand
17       devices  currently available.  The argument num_devices is optional; if
18       not NULL, it is set to the number of devices returned in the array.
19
20       ibv_free_device_list() frees the array  of  devices  list  returned  by
21       ibv_get_device_list().
22

RETURN VALUE

24       ibv_get_device_list()   returns   the  array  of  available  InfiniBand
25       devices, or NULL if the request fails.
26
27       ibv_free_device_list() returns no value.
28

NOTES

30       Client code should  open  all  the  devices  it  intends  to  use  with
31       ibv_open_device() before calling ibv_free_device_list().  Once it frees
32       the array with ibv_free_device_list(), it will be able to use only  the
33       open devices; pointers to unopened devices will no longer be valid.
34

SEE ALSO

36       ibv_fork_init(3),    ibv_get_device_name(3),    ibv_get_device_guid(3),
37       ibv_open_device(3)
38

AUTHORS

40       Dotan Barak <dotanb@mellanox.co.il>
41
42
43
44libibverbs                        2006-10-31            IBV_GET_DEVICE_LIST(3)