utils/statd/statd.man

   1 .\"
   2 .\" statd(8)
   3 .\"
   4 .\" Copyright (C) 1999 Olaf Kirch <okir@monad.swb.de>
   5 .\" Modified by Jeffrey A. Uphoff, 1999, 2002.
   6 .\" Modified by Lon Hohberger, 2000.
   7 .TH rpc.statd 8 "16 Sep 2002"
   8 .SH NAME
   9 rpc.statd \- NSM status monitor
  10 .SH SYNOPSIS
  11 .B "/sbin/rpc.statd [-F] [-d] [-?] [-n " name "] [-o " port "] [-p " port "] [-V]"
  12 .SH DESCRIPTION
  13 The
  14 .B rpc.statd
  15 server implements the NSM (Network Status Monitor) RPC protocol.
  16 This service is somewhat misnomed, since it doesn't actually provide
  17 active monitoring as one might suspect; instead, NSM implements a
  18 reboot notification service. It is used by the NFS file locking service,
  19 .BR rpc.lockd ,
  20 to implement lock recovery when the NFS server machine crashes and
  21 reboots.
  22 .SS Operation
  23 For each NFS client or server machine to be monitored,
  24 .B rpc.statd
  25 creates a file in
  26 .BR /var/lib/nfs/sm .
  27 When starting, it iterates through these files and notifies the
  28 peer
  29 .B rpc.statd
  30 on those machines.
  31 .SH OPTIONS
  32 .TP
  33 .B -F
  34 By default,
  35 .B rpc.statd
  36 forks and puts itself in the background when started. The
  37 .B -F
  38 argument tells it to remain in the foreground. This option is
  39 mainly for debugging purposes.
  40 .TP
  41 .B -d
  42 By default,
  43 .B rpc.statd
  44 sends logging messages via
  45 .BR syslog (3)
  46 to system log.  The
  47 .B -d
  48 argument forces it to log verbose output to
  49 .B stderr
  50 instead. This option is mainly for debugging purposes, and may only
  51 be used in conjunction with the
  52 .B -F
  53 parameter.
  54 .TP
  55 .BI "\-n," "" " \-\-name " name
  56 specify a name for
  57 .B rpc.statd
  58 to use as the local hostname. By default,
  59 .BR rpc.statd
  60 will call
  61 .BR gethostname (2)
  62 to get the local hostname. Specifying
  63 a local hostname may be useful for machines with more than one
  64 interfaces.
  65 .TP
  66 .BI "\-o," "" " \-\-outgoing\-port "  port
  67 specify a port for
  68 .B rpc.statd
  69 to send outgoing status requests from.  By default,
  70 .BR rpc.statd
  71 will ask
  72 .BR portmap (8)
  73 to assign it a port number.  As of this writing, there is not
  74 a standard port number that
  75 .BR portmap
  76 always or usually assigns.  Specifying
  77 a port may be useful when implementing a firewall.
  78 .TP
  79 .BI "\-p," "" " \-\-port " port
  80 specify a port for
  81 .B rpc.statd
  82 to listen on.  By default,
  83 .BR rpc.statd
  84 will ask
  85 .BR portmap (8)
  86 to assign it a port number.  As of this writing, there is not
  87 a standard port number that
  88 .BR portmap
  89 always or usually assigns.  Specifying
  90 a port may be useful when implementing a firewall.
  91 .TP
  92 .BI "\-P," "" " \-\-state\-directory\-path "  directory
  93 specify a directory in which to place statd state information.
  94 If this option is not specified the default of
  95 .BR /var/lib/nfs
  96 is used.
  97 .TP
  98 .B -N
  99 Causes statd to run in the notify-only mode. When started in this mode, the
 100 statd program will check its state directory, send notifications to any
 101 monitored nodes, and exit once the notifications have been sent. This mode is
 102 used to enable Highly Available NFS implementations (i.e. HA-NFS).
 103 .TP
 104 .B -?
 105 Causes
 106 .B rpc.statd
 107 to print out command-line help and exit.
 108 .TP
 109 .B -V
 110 Causes
 111 .B rpc.statd
 112 to print out version information and exit.
 113
 114
 115
 116 .SH TCP_WRAPPERS SUPPORT
 117 This
 118 .B rpc.statd
 119 version is protected by the
 120 .B tcp_wrapper
 121 library. You have to give the clients access to
 122 .B rpc.statd
 123 if they should be allowed to use it. To allow connects from clients of
 124 the .bar.com domain you could use the following line in /etc/hosts.allow:
 125
 126 statd: .bar.com
 127
 128 You have to use the daemon name
 129 .B statd
 130 for the daemon name (even if the binary has a different name).
 131
 132 For further information please have a look at the
 133 .BR tcpd (8)
 134 and
 135 .BR hosts_access (5)
 136 manual pages.
 137
 138 .SH FILES
 139 .BR /var/lib/nfs/state
 140 .br
 141 .BR /var/lib/nfs/sm/*
 142 .br
 143 .BR /var/lib/nfs/sm.bak/*
 144 .SH SEE ALSO
 145 .BR rpc.nfsd(8),
 146 .BR portmap(8)
 147 .SH AUTHORS
 148 .br
 149 Jeff Uphoff <juphoff@nrao.edu>
 150 .br
 151 Olaf Kirch <okir@monad.swb.de>
 152 .br
 153 H.J. Lu <hjl@gnu.org>
 154 .br
 155 Lon Hohberger <hohberger@missioncriticallinux.com>