Manpages

Manpage of rpc.statd

rpc.statd

Section: Maintenance Commands (8)
Updated: 16 Sep 2002
Index
Return to Main Contents
 

NAME

rpc.statd - NSM status monitor  

SYNOPSIS

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

DESCRIPTION

The rpc.statd server implements the NSM (Network Status Monitor) RPC protocol. This service is somewhat misnomed, since it doesn't actually provide active monitoring as one might suspect; instead, NSM implements a reboot notification service. It is used by the NFS file locking service, 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 creates 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 foreground. 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).
-?
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.

 

FILES

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

SEE ALSO

rpc.nfsd(8), portmap(8)  

AUTHORS


Jeff Uphoff <juphoff@nrao.edu>
Olaf Kirch <okir@monad.swb.de>
H.J. Lu <hjl@gnu.org>
Lon Hohberger <hohberger@missioncriticallinux.com>


 

Index

NAME
SYNOPSIS
DESCRIPTION
Operation
OPTIONS
TCP_WRAPPERS SUPPORT
FILES
SEE ALSO
AUTHORS

This document was created by man2html, using the manual pages.
Time: 23:26:09 GMT, March 01, 2024