rdma_get_devices(3)

rdma_get_devices3

Get a list of rdma devices currently available.

Usage

#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.

Overview

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.

Releases

Unchanged in 22 releases since FreeBSD 11.3-RELEASE.

  1. 11.3–16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's man source.