1RDMA-NDD(8)                   OpenIB Diagnostics                   RDMA-NDD(8)
2
3
4

NAME

6       RDMA-NDD - RDMA device Node Description update daemon
7

SYNOPSIS

9       rdma-ndd <options>
10

DESCRIPTION

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

DETAILS

17       Full operation of this daemon requires kernels which support polling of
18       the procfs hostname file as well as libudev.
19
20       If your system does not support either of these  features,  the  daemon
21       will set the Node Descriptions at start up and then sleep forever.
22
23   Node Description configuration
24       The  daemon uses the environment variable RDMA_NDD_ND_FORMAT to set the
25       node description.  The following wild cards can be specified  for  more
26       dynamic control.
27
28       %h -- replace with the current hostname (not including domain)
29
30       %d -- replace with the device name (for example mlx4_0, qib0, etc.)
31
32       If not specified the default is "%h %d".
33
34       NOTE:  At startup, and on new device detection, the Node Description is
35       always written to ensure the SM and rdma-ndd are in  sync.   Subsequent
36       events  will  only  write  the  Node  Description on a device if it has
37       changed.
38
39   Using systemd
40       Setting the environment variable for the daemon is normally be done via
41       a  systemd drop in unit.  For example the following could be added to a
42       file named /etc/systemd/system/rdma-ndd.service.d/nd-format.conf to use
43       only the hostname as your node description.
44
45       [Service] Environment="RDMA_NDD_ND_FORMAT=%%h"
46
47       NOTE: Systemd requires an extra '%'.
48

OPTIONS

50       -f, --foreground Run in the foreground instead of as a daemon
51
52       -d, --debug Log additional debugging information to syslog
53
54       --systemd Enable systemd integration.
55

AUTHOR

57       Ira Weiny
58              < ira.weiny@intel.com >
59
60
61
62
63                                                                   RDMA-NDD(8)