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 .\" Modified by Paul Clements, 2004.
8 .TH rpc.statd 8 "31 Aug 2004"
10 rpc.statd \- NSM status monitor
12 .B "/sbin/rpc.statd [-F] [-d] [-?] [-n " name "] [-o " port "] [-p " port "] [-H " prog "] [-V]"
16 server implements the NSM (Network Status Monitor) RPC protocol.
17 This service is somewhat misnomed, since it doesn't actually provide
18 active monitoring as one might suspect; instead, NSM implements a
19 reboot notification service. It is used by the NFS file locking service,
21 to implement lock recovery when the NFS server machine crashes and
24 For each NFS client or server machine to be monitored,
28 When starting, it iterates through these files and notifies the
37 forks and puts itself in the background when started. The
39 argument tells it to remain in the foreground. This option is
40 mainly for debugging purposes.
45 sends logging messages via
49 argument forces it to log verbose output to
51 instead. This option is mainly for debugging purposes, and may only
52 be used in conjunction with the
56 .BI "\-n," "" " \-\-name " name
59 to use as the local hostname. By default,
63 to get the local hostname. Specifying
64 a local hostname may be useful for machines with more than one
67 .BI "\-o," "" " \-\-outgoing\-port " port
70 to send outgoing status requests from. By default,
74 to assign it a port number. As of this writing, there is not
75 a standard port number that
77 always or usually assigns. Specifying
78 a port may be useful when implementing a firewall.
80 .BI "\-p," "" " \-\-port " port
83 to listen on. By default,
87 to assign it a port number. As of this writing, there is not
88 a standard port number that
90 always or usually assigns. Specifying
91 a port may be useful when implementing a firewall.
93 .BI "\-P," "" " \-\-state\-directory\-path " directory
94 specify a directory in which to place statd state information.
95 If this option is not specified the default of
100 Causes statd to run in the notify-only mode. When started in this mode, the
101 statd program will check its state directory, send notifications to any
102 monitored nodes, and exit once the notifications have been sent. This mode is
103 used to enable Highly Available NFS implementations (i.e. HA-NFS).
105 .BI "\-H, " "" " \-\-ha-callout " prog
106 Specify a high availability callout program, which will receive callouts
107 for all client monitor and unmonitor requests. This allows
109 to be used in a High Availability NFS (HA-NFS) environment. The
110 program will be run with 3 arguments: The first is either
114 depending on the reason for the callout.
115 The second will be the name of the client.
116 The third will be the name of the server as known to the client.
121 to print out command-line help and exit.
126 to print out version information and exit.
130 .SH TCP_WRAPPERS SUPPORT
133 version is protected by the
135 library. You have to give the clients access to
137 if they should be allowed to use it. To allow connects from clients of
138 the .bar.com domain you could use the following line in /etc/hosts.allow:
142 You have to use the daemon name
144 for the daemon name (even if the binary has a different name).
146 For further information please have a look at the
156 to re-read the notify list from disk
157 and send notifications to clients. This can be used in High Availability NFS
158 (HA-NFS) environments to notify clients to reacquire file locks upon takeover
159 of an NFS export from another server.
162 .BR /var/lib/nfs/state
164 .BR /var/lib/nfs/sm/*
166 .BR /var/lib/nfs/sm.bak/*
172 Jeff Uphoff <juphoff@nrao.edu>
174 Olaf Kirch <okir@monad.swb.de>
176 H.J. Lu <hjl@gnu.org>
178 Lon Hohberger <hohberger@missioncriticallinux.com>
180 Paul Clements <paul.clements@steeleye.com>