Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

rdma_get_devices (3)

Name

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);

Description

Librdmacm Programmer's Manual                              RDMA_GET_DEVICES(3)



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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | network/open-fabrics  |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+

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

       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source   was   downloaded   from    ['https://www.openfabrics.org/down-
       loads/ibutils/ibutils-1.5.7-0.2.gbd7e502.tar.gz', 'https://www.openfab-
       rics.org/downloads/libibverbs/libibverbs-1.1.8.tar.gz',
       'https://www.openfabrics.org/downloads/libmlx4/libmlx4-1.0.6.tar.gz',
       'https://www.openfabrics.org/downloads/libsdp/lib-
       sdp-1.1.108-0.15.gd7fdb72.tar.gz',   'https://www.openfabrics.org/down-
       loads/management/infiniband-diags-1.6.5.tar.gz',  'https://www.openfab-
       rics.org/downloads/management/libibmad-1.3.12.tar.gz',
       'https://www.openfabrics.org/downloads/management/libibu-
       mad-1.3.10.2.tar.gz',    'https://www.openfabrics.org/downloads/manage-
       ment/opensm-3.3.19.tar.gz',          'https://www.openfabrics.org/down-
       loads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz', 'https://www.open-
       fabrics.org/downloads/qperf/qperf-0.4.9.tar.gz',  'https://www.openfab-
       rics.org/downloads/rdmacm/librdmacm-1.0.21.tar.gz',  'https://www.open-
       fabrics.org/downloads/rds-tools/rds-tools-2.0.4.tar.gz'].

       Further information about this software can be found on the open source
       community website at http://www.openfabrics.org/.

SEE ALSO
       rdma_free_devices(3)




librdmacm                         2007-05-15               RDMA_GET_DEVICES(3)