X-Git-Url: https://git.decadent.org.uk/gitweb/?p=nfs-utils.git;a=blobdiff_plain;f=utils%2Fstatd%2Fstatd.man;h=0579273026c7fa368646f5ecac9237e263565f05;hp=373cf77b5374be7fbdb1b767bf1bf7cd805f11b8;hb=2650ce9c83edfde2fbe2de3cb65812309b2edebd;hpb=8b7ad01b14df1e7529b9ba8a1ea17df0d6004ef9 diff --git a/utils/statd/statd.man b/utils/statd/statd.man index 373cf77..0579273 100644 --- a/utils/statd/statd.man +++ b/utils/statd/statd.man @@ -2,12 +2,14 @@ .\" statd(8) .\" .\" Copyright (C) 1999 Olaf Kirch -.\" Modified by Jeffrey A. Uphoff, 1999. -.TH rpc.statd 8 "11 June 1999" +.\" Modified by Jeffrey A. Uphoff, 1999, 2002, 2005. +.\" Modified by Lon Hohberger, 2000. +.\" Modified by Paul Clements, 2004. +.TH rpc.statd 8 "31 Aug 2004" .SH NAME rpc.statd \- NSM status monitor .SH SYNOPSIS -.B "/usr/sbin/rpc.statd [-F] +.B "/sbin/rpc.statd [-F] [-d] [-?] [-n " name "] [-o " port "] [-p " port "] [-H " prog "] [-V]" .SH DESCRIPTION The .B rpc.statd @@ -36,18 +38,143 @@ forks and puts itself in the background when started. The .B -F argument tells it to remain in the foreground. This option is mainly for debugging purposes. +.TP +.B -d +By default, +.B rpc.statd +sends logging messages via +.BR syslog (3) +to system log. The +.B -d +argument forces it to log verbose output to +.B stderr +instead. This option is mainly for debugging purposes, and may only +be used in conjunction with the +.B -F +parameter. +.TP +.BI "\-n," "" " \-\-name " name +specify a name for +.B rpc.statd +to use as the local hostname. By default, +.BR rpc.statd +will call +.BR gethostname (2) +to get the local hostname. Specifying +a local hostname may be useful for machines with more than one +interfaces. +.TP +.BI "\-o," "" " \-\-outgoing\-port " port +specify a port for +.B rpc.statd +to send outgoing status requests from. By default, +.BR rpc.statd +will ask +.BR portmap (8) +to assign it a port number. As of this writing, there is not +a standard port number that +.BR portmap +always or usually assigns. Specifying +a port may be useful when implementing a firewall. +.TP +.BI "\-p," "" " \-\-port " port +specify a port for +.B rpc.statd +to listen on. By default, +.BR rpc.statd +will ask +.BR portmap (8) +to assign it a port number. As of this writing, there is not +a standard port number that +.BR portmap +always or usually assigns. Specifying +a port may be useful when implementing a firewall. +.TP +.BI "\-P," "" " \-\-state\-directory\-path " directory +specify a directory in which to place statd state information. +If this option is not specified the default of +.BR /var/lib/nfs +is used. +.TP +.B -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). +.TP +.BI "\-H, " "" " \-\-ha-callout " prog +Specify a high availability callout program, which will receive callouts +for all client monitor and unmonitor requests. This allows +.B 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 +.B add-client +or +.B 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. +.TP +.B -? +Causes +.B rpc.statd +to print out command-line help and exit. +.TP +.B -V +Causes +.B rpc.statd +to print out version information and exit. + + + +.SH TCP_WRAPPERS SUPPORT +This +.B rpc.statd +version is protected by the +.B tcp_wrapper +library. You have to give the clients access to +.B 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 +.B statd +for the daemon name (even if the binary has a different name). + +For further information please have a look at the +.BR tcpd (8) +and +.BR hosts_access (5) +manual pages. + +.SH SIGNALS +.BR SIGUSR1 +causes +.B 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. + .SH FILES -.BR /var/lib/nfs/sm/state +.BR /var/lib/nfs/state .br .BR /var/lib/nfs/sm/* .br .BR /var/lib/nfs/sm.bak/* .SH SEE ALSO -.BR rpc.nfsd(8) +.BR rpc.nfsd(8), +.BR portmap(8) .SH AUTHORS .br -Jeff Uphoff +Jeff Uphoff .br Olaf Kirch .br H.J. Lu +.br +Lon Hohberger +.br +Paul Clements