NAME

       RDMA-NDD - RDMA device Node Description update daemon

SYNOPSIS

       rdma-ndd <options>

DESCRIPTION

       rdma-ndd  is a system daemon which watches for rdma device changes and/or hostname changes
       and updates the Node Description of the rdma devices based on those changes.

DETAILS

       Full operation of this daemon  requires  kernels  which  support  polling  of  the  procfs
       hostname file as well as libudev.

       If  your  system  does  not support either of these features, the daemon will set the Node
       Descriptions at start up and then sleep forever.

   Node Description configuration
       The daemon uses the environment variable RDMA_NDD_ND_FORMAT to set the  node  description.
       The following wild cards can be specified for more dynamic control.

       %h -- replace with the current hostname (not including domain)

       %d -- replace with the device name (for example mlx4_0, qib0, etc.)

       If not specified the default is "%h %d".

       NOTE:  At  startup, and on new device detection, the Node Description is always written to
       ensure the SM and rdma-ndd are in sync.   Subsequent  events  will  only  write  the  Node
       Description on a device if it has changed.

   Using systemd
       Setting  the environment variable for the daemon is normally be done via a systemd drop in
       unit.    For   example   the   following   could   be    added    to    a    file    named
       /etc/systemd/system/rdma-ndd.service.d/nd-format.conf  to  use  only  the hostname as your
       node description.

       [Service] Environment="RDMA_NDD_ND_FORMAT=%%h"

       NOTE: Systemd requires an extra '%'.

OPTIONS

       -f, --foreground Run in the foreground instead of as a daemon

       -d, --debug Log additional debugging information to syslog

       --systemd Enable systemd integration.

AUTHOR

       Ira Weiny
              < ira.weiny@intel.com >

                                                                                      RDMA-NDD(8)