rdma_get_devices — Get a list of RDMA devices currently available.

Synopsis

#include <rdma/rdma_cma.h>

struct ibv_context ** rdma_get_devices (int *num_devices);

Arguments

num_devices

If non-NULL, set to the number of devices returned.

Description

Return a NULL-terminated array of opened RDMA devices.  Callers can use this routine to allocate resources on specific RDMA devices that will be shared across multiple rdma_cm_id's.

Return Value

Returns an array of available RDMA devices, or NULL if the request fails.  On failure, errno will be set to indicate the failure reason.

Notes

The returned array must be released by calling rdma_free_devices.  Devices remain opened while the librdmacm is loaded.

See Also

rdma_free_devices(3)

Referenced By

rdma_cm(7), rdma_create_id(3), rdma_free_devices(3).

2007-05-15 Librdmacm Programmer's Manual