Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

rdma_xclient (1)

Name

rdma_xclient - RDMA CM communication client test program

Synopsis

rdma_xclient [-s server_address] [-p server_port] [-c comm_type]

Description

RDMA_XCLIENT(1)                    librdmacm                   RDMA_XCLIENT(1)



NAME
       rdma_xclient - RDMA CM communication client test program

SYNOPSIS
       rdma_xclient [-s server_address] [-p server_port] [-c comm_type]

DESCRIPTION
       Uses synchronous librdmam calls to establish an RDMA connection between
       two nodes.  This example is intended to provide a  very  simple  coding
       example of how to use RDMA.

OPTIONS
       -s server_address
              Specifies the address of the system that the rdma_server is run-
              ning on.  By default, the client will attempt to connect to  the
              server using 127.0.0.1.

       -p server_port
              Specifies  the  port  number  that  the  server  listens on.  By
              default the server listens on port 7471.

       -c communication type
              Specifies the type of communication established with the  server
              program.   'r'  results  in  using  a reliable-connected QP (the
              default).  'x' uses extended reliable-connected XRC QPs.


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


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

NOTES
       Basic usage is to start rdma_xserver, then connect to the server  using
       the rdma_client program.

       Because  this  test maps RDMA resources to userspace, users must ensure
       that they have available system resources  and  permissions.   See  the
       libibverbs README file for additional details.

       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_cm(7),    udaddy(1),    mckey(1),    rping(1),    rdma_xserver(1),
       rdma_client(1)




librdmacm                         2011-06-15                   RDMA_XCLIENT(1)