2000-08-25 Ion Badulescu <ionut@cs.columbia.edu>
[nfs-utils.git] / 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.
6 .TH rpc.statd 8 "20 Aug 2000"
7 .SH NAME
8 rpc.statd \- NSM status monitor
9 .SH SYNOPSIS
10 .B "/usr/sbin/rpc.statd [-F]
11 .SH DESCRIPTION
12 The
13 .B rpc.statd
14 server implements the NSM (Network Status Monitor) RPC protocol.
15 This service is somewhat misnomed, since it doesn't actually provide
16 active monitoring as one might suspect; instead, NSM implements a
17 reboot notification service. It is used by the NFS file locking service,
18 .BR rpc.lockd ,
19 to implement lock recovery when the NFS server machine crashes and
20 reboots.
21 .SS Operation
22 For each NFS client or server machine to be monitored,
23 .B rpc.statd
24 creates a file in
25 .BR /var/lib/nfs/sm .
26 When starting, it iterates through these files and notifies the
27 peer
28 .B rpc.statd
29 on those machines.
30 .SH OPTIONS
31 .TP
32 .B -F
33 By default,
34 .B rpc.statd
35 forks and puts itself in the background when started. The
36 .B -F
37 argument tells it to remain in the foreground. This option is
38 mainly for debugging purposes.
39
40 .SH TCP_WRAPPERS SUPPORT
41 This
42 .B rpc.statd
43 version is protected by the
44 .B tcp_wrapper
45 library. You have to give the clients access to
46 .B rpc.statd
47 if they should be allowed to use it. To allow connects from clients of
48 the .bar.com domain you could use the following line in /etc/hosts.allow:
49
50 statd: .bar.com
51
52 You have to use the daemon name 
53 .B statd
54 for the daemon name (even if the binary has a different name). For the
55 client names you can only use the keyword ALL or IP addresses (NOT
56 host or domain names).
57
58 For further information please have a look at the
59 .BR tcpd (8),
60 .BR hosts_allow (5)
61 and
62 .BR hosts_access (5)
63 manual pages.
64
65 .SH FILES
66 .BR /var/lib/nfs/sm/state
67 .br
68 .BR /var/lib/nfs/sm/*
69 .br
70 .BR /var/lib/nfs/sm.bak/*
71 .SH SEE ALSO
72 .BR rpc.nfsd(8)
73 .SH AUTHORS
74 .br
75 Jeff Uphoff <juphoff@transmeta.com>
76 .br
77 Olaf Kirch <okir@monad.swb.de>
78 .br
79 H.J. Lu <hjl@gnu.org>