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] [-d] [-?] [-V]
  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 .TP
  40 .B -d
  41 By default,
  42 .B rpc.statd
  43 sends logging messages via
  44 .BR syslog (3)
  45 to system log.  The
  46 .B -d
  47 argument forces it to log verbose output to
  48 .B stderr
  49 instead. This option is mainly for debugging purposes, and may only
  50 be used in conjunction with the
  51 .B -F
  52 parameter.
  53 .TP
  54 .B -?
  55 Causes
  56 .B rpc.statd
  57 to print out command-line help and exit.
  58 .TP
  59 .B -V
  60 Causes
  61 .B rpc.statd
  62 to print out version information and exit.
  63
  64
  65
  66 .SH TCP_WRAPPERS SUPPORT
  67 This
  68 .B rpc.statd
  69 version is protected by the
  70 .B tcp_wrapper
  71 library. You have to give the clients access to
  72 .B rpc.statd
  73 if they should be allowed to use it. To allow connects from clients of
  74 the .bar.com domain you could use the following line in /etc/hosts.allow:
  75
  76 statd: .bar.com
  77
  78 You have to use the daemon name
  79 .B statd
  80 for the daemon name (even if the binary has a different name). For the
  81 client names you can only use the keyword ALL or IP addresses (NOT
  82 host or domain names).
  83
  84 For further information please have a look at the
  85 .BR tcpd (8),
  86 .BR hosts_allow (5)
  87 and
  88 .BR hosts_access (5)
  89 manual pages.
  90
  91 .SH FILES
  92 .BR /var/lib/nfs/sm/state
  93 .br
  94 .BR /var/lib/nfs/sm/*
  95 .br
  96 .BR /var/lib/nfs/sm.bak/*
  97 .SH SEE ALSO
  98 .BR rpc.nfsd(8)
  99 .SH AUTHORS
 100 .br
 101 Jeff Uphoff <juphoff@transmeta.com>
 102 .br
 103 Olaf Kirch <okir@monad.swb.de>
 104 .br
 105 H.J. Lu <hjl@gnu.org>