rpc.statd(8)							  rpc.statd(8)



NAME
       rpc.statd - NSM status monitor

SYNOPSIS
       /sbin/rpc.statd	[-F] [-d] [-?] [-n  name ] [-o	port ] [-p  port ] [-H
       prog ] [-V]

DESCRIPTION
       The rpc.statd server implements the NSM (Network  Status  Monitor)  RPC
       protocol.  This service is somewhat misnamed, since it doesnt actually
       provide active monitoring as one might suspect; instead, NSM implements
       a  reboot notification service. It is used by the NFS file locking ser
       vice, rpc.lockd, to implement lock recovery when the NFS server machine
       crashes and reboots.

   Operation
       For  each  NFS client or server machine to be monitored, rpc.statd cre
       ates a file in /var/lib/nfs/sm.	When  starting,  it  iterates  through
       these files and notifies the peer rpc.statd on those machines.

OPTIONS
       -F     By  default,  rpc.statd  forks and puts itself in the background
	      when started. The -F argument tells it to remain	in  the  fore
	      ground. This option is mainly for debugging purposes.

       -d     By  default,  rpc.statd  sends logging messages via syslog(3) to
	      system log.  The -d argument forces it to log verbose output  to
	      stderr  instead.	This  option is mainly for debugging purposes,
	      and may only be used in conjunction with the -F parameter.

       -n, --name name
	      specify a name for rpc.statd to use as the  local  hostname.  By
	      default,	rpc.statd  will  call  gethostname(2) to get the local
	      hostname. Specifying a local hostname may be useful for machines
	      with more than one interfaces.

       -o, --outgoing-port port
	      specify  a  port	for rpc.statd to send outgoing status requests
	      from.  By default, rpc.statd will ask portmap(8) to assign it  a
	      port  number.   As of this writing, there is not a standard port
	      number that portmap always or  usually  assigns.	 Specifying  a
	      port may be useful when implementing a firewall.

       -p, --port port
	      specify  a  port	for  rpc.statd	to  listen  on.   By  default,
	      rpc.statd will ask portmap(8) to assign it a port number.  As of
	      this  writing,  there is not a standard port number that portmap
	      always or usually assigns.  Specifying a port may be useful when
	      implementing a firewall.

       -P, --state-directory-path directory
	      specify  a  directory in which to place statd state information.
	      If this option is not specified the default of  /var/lib/nfs  is
	      used.

       -N     Causes  statd  to  run  in the notify-only mode. When started in
	      this mode, the statd program will  check	its  state  directory,
	      send  notifications  to  any  monitored nodes, and exit once the
	      notifications have been sent. This mode is used to enable Highly
	      Available NFS implementations (i.e. HA-NFS).

       -H,  --ha-callout prog
	      Specify  a high availability callout program, which will receive
	      callouts for all client monitor  and  unmonitor  requests.  This
	      allows  rpc.statd to be used in a High Availability NFS (HA-NFS)
	      environment. The program will be	run  with  3  arguments:   The
	      first is either add-client or del-client depending on the reason
	      for the callout.	The second will be the	name  of  the  client.
	      The third will be the name of the server as known to the client.

       -?     Causes rpc.statd to print out command-line help and exit.

       -V     Causes rpc.statd to print out version information and exit.




TCP_WRAPPERS SUPPORT
       This rpc.statd version is protected by  the  tcp_wrapper  library.  You
       have  to give the clients access to rpc.statd if they should be allowed
       to use it. To allow connects from clients of the  .bar.com  domain  you
       could use the following line in /etc/hosts.allow:

       statd: .bar.com

       You  have to use the daemon name statd for the daemon name (even if the
       binary has a different name).

       For  further  information  please  have	a  look  at  the  tcpd(8)  and
       hosts_access(5) manual pages.


SIGNALS
       SIGUSR1	causes rpc.statd to re-read the notify list from disk and send
       notifications to clients. This can be used  in  High  Availability  NFS
       (HA-NFS)  environments  to  notify clients to reacquire file locks upon
       takeover of an NFS export from another server.


FILES
       /var/lib/nfs/state
       /var/lib/nfs/sm/*
       /var/lib/nfs/sm.bak/*

SEE ALSO
       rpc.nfsd(8), portmap(8)

AUTHORS
       Jeff Uphoff 
       Olaf Kirch 
       H.J. Lu 
       Lon Hohberger 
       Paul Clements 



				  31 Aug 2004			  rpc.statd(8)