bionic (8) iwpmd.8.gz

Provided by: rdma-core_17.1-1ubuntu0.2_amd64 bug

NAME

       iwpmd - port mapping services for iWARP.

SYNOPSIS

       iwpmd

DESCRIPTION

       The  iWARP  Port  Mapper  Daemon provides a user space service (iwpmd) for the iWarp drivers to claim tcp
       ports through the standard socket interface.

       The kernel space support for the port mapper is part of the iw_cm module.  The  ib_core  module  includes
       netlink  support,  which is used by the port mapper clients to exchange messages with iwpmd. Both modules
       iw_cm and ib_core need to be loaded in order for the libiwpm service to start successfully.

IWARP PORT MAPPING DETAILS

       The iWARP Port Mapper implementation is based on the port mapper specification  section  in  the  Sockets
       Direct Protocol: http://www.rdmaconsortium.org/home/draft-pinkerton-iwarp-sdp-v1.0.pdf

       Existing  iWARP  RDMA  providers  use  the  same IP address as the native TCP/IP stack when creating RDMA
       connections.  They need a mechanism to claim the TCP ports used for RDMA connections to prevent TCP  port
       collisions  when  other  host  applications  use  TCP  ports.   The iWARP Port Mapper provides a standard
       mechanism to accomplish this.  Without this service it is possible for RDMA application to bind/listen on
       the  same  port which is already being used by native TCP host application.  If that happens the incoming
       TCP connection data can be passed to the RDMA stack with error.

       The iWARP Connection Manager (port mapper client) sends to the IWPM service the local IP address and  TCP
       port  it has received from the RDMA application, when starting a connection.  The IWPM service performs a
       socket bind from user space to get an available TCP port, called a mapped port, and communicates it  back
       to  the  client.  In that sense, the IWPM service is used to map the TCP port, which the RDMA application
       uses to any port available from the host TCP port  space.  The  mapped  ports  are  used  in  iWARP  RDMA
       connections  to avoid collisions with native TCP stack which is aware that these ports are taken. When an
       RDMA connection using a mapped port is terminated, the client  notifies  the  IWPM  service,  which  then
       releases the TCP port.

       The message exchange between iwpmd and the iWARP Connection Manager (between user space and kernel space)
       is implemented using netlink sockets.

OPTIONS

       -s, --systemd Enable systemd integration.

SIGNALS

       SIGUSR1 will force a dump of the current mappings to the system message log.

       SIGTERM/SIGHUP will force iwpmd to exit.

FILES

       /etc/iwpmd.conf

SEE ALSO

       rdma_cm(7)