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 .\" Modified by Lon Hohberger, 2000.
   7 .TH rpc.statd 8 "02 Feb 2001"
   8 .SH NAME
   9 rpc.statd \- NSM status monitor
  10 .SH SYNOPSIS
  11 .B "/sbin/rpc.statd [-F] [-d] [-?] [-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 .B -?
  56 Causes
  57 .B rpc.statd
  58 to print out command-line help and exit.
  59 .TP
  60 .B -V
  61 Causes
  62 .B rpc.statd
  63 to print out version information and exit.
  64
  65
  66
  67 .SH TCP_WRAPPERS SUPPORT
  68 This
  69 .B rpc.statd
  70 version is protected by the
  71 .B tcp_wrapper
  72 library. You have to give the clients access to
  73 .B rpc.statd
  74 if they should be allowed to use it. To allow connects from clients of
  75 the .bar.com domain you could use the following line in /etc/hosts.allow:
  76
  77 statd: .bar.com
  78
  79 You have to use the daemon name
  80 .B statd
  81 for the daemon name (even if the binary has a different name). For the
  82 client names you can only use the keyword ALL or IP addresses (NOT
  83 host or domain names).
  84
  85 For further information please have a look at the
  86 .BR tcpd (8),
  87 .BR hosts_allow (5)
  88 and
  89 .BR hosts_access (5)
  90 manual pages.
  91
  92 .SH FILES
  93 .BR /var/lib/nfs/state
  94 .br
  95 .BR /var/lib/nfs/sm/*
  96 .br
  97 .BR /var/lib/nfs/sm.bak/*
  98 .SH SEE ALSO
  99 .BR rpc.nfsd(8)
 100 .SH AUTHORS
 101 .br
 102 Jeff Uphoff <juphoff@transmeta.com>
 103 .br
 104 Olaf Kirch <okir@monad.swb.de>
 105 .br
 106 H.J. Lu <hjl@gnu.org>
 107 .br
 108 Lon Hohberger <hohberger@missioncriticallinux.com>