NAME

       ucmatose - RDMA CM connection and simple ping-pong test.

SYNOPSIS

       ucmatose [-s server_address] [-b bind_address]
                 [-f address_format] [-P port_space]
                 [-c connections] [-C message_count] [-S message_size] [-a ack_timeout]
       ucmatose -s server_address [-b bind_address]
                 [-f address_format] [-P port_space]
                 [-c connections] [-C message_count] [-S message_size] [-t tos] [-a ack_timeout]

DESCRIPTION

       Establishes  a  set  of  reliable  RDMA  connections  between  two  nodes using the librdmacm, optionally
       transfers data between the nodes, then disconnects.

OPTIONS

       -s server_address
              The network name or IP address of the server system listening for connections.  The used  name  or
              address must route over an RDMA device.  This option must be specified by the client.

       -b bind_address
              The local network address to bind to.  To bind to any address with IPv6 use -b ::0 .

       -f address_format
              Specifies  the  format  of  the  server and bind address.  Be default, the format is determined by
              getaddrinfo() as either being a hostname, an IPv4 address, or an IPv6 address.  This option may be
              used  to  indicate  that  a  specific  address format has been provided.  Supported address_format
              values are: name, ip, ipv6, and gid.

       -P port_space
              Specifies the port space for the connection.  Be default, the port space  is  the  RDMA  TCP  port
              space.  (Note  that  the  RDMA  port  space  may  be  separate  from that used for IP.)  Supported
              port_space values are: tcp and ib.

       -c connections
              The number of connections to establish between the client and server.  (default 1)

       -C message_count
              The number of messages to transfer over each connection.  (default 10)

       -S message_size
              The size of each message transferred, in bytes.  (default 100)

       -t tos Indicates the type of service used for the  communication.   Type  of  service  is  implementation
              dependent based on subnet configuration.

       -a ack_timeout
              Indicates  the  QP  ACK  timeout value that should be used.  The value calculated according to the
              formula 4.096 * 2^(ack_timeout) usec.

       -m     Tests event channel migration.  Migrates  all  communication  identifiers  to  a  different  event
              channel for disconnect events.

NOTES

       Basic usage is to start ucmatose on a server system, then run ucmatose -s server_name on a client system.

       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.

SEE ALSO

       rdma_cm(7), udaddy(1), mckey(1), rping(1)