2001-12-26 Chip Salzenberg <chip@pobox.com>

[nfs-utils.git] / utils / rquotad / rquotad.man

diff --git a/utils/rquotad/rquotad.man b/utils/rquotad/rquotad.man
index da8fa8cd489fb03b8e58d37023b8c9a188526ec5..a9a1f74a59134b252bbca699b88e2fdfa784bc93 100644 (file)
--- a/utils/rquotad/rquotad.man
+++ b/utils/rquotad/rquotad.man
@@ -1,9 +1,9 @@
-.\"@(#)rquotad.8c"
-.TH RQUOTAD 8C"
+.\"@(#)rquotad.8"
+.TH RQUOTAD 8 "8 Mar 2001"
 .SH NAME
 rquotad, rpc.rquotad \- remote quota server
 .SH SYNOPSIS
-.B /usr/etc/rpc.rquotad
+.B /usr/etc/rpc.rquotad [-p " port "] "
 .SH DESCRIPTION
 .LP
 .IX  "rquotad daemon"  ""  "\fLrquotad\fP \(em remote quota server"
@@ -13,7 +13,7 @@ rquotad, rpc.rquotad \- remote quota server
 .IX  "quotas"  "rquotad daemon"  ""  "\fLrquotad\fP \(em remote quota server"
 .IX  "file system"  "rquotad daemon"  ""  "\fLrquotad\fP \(em remote quota server"
 .IX  "remote procedure call services"  "rquotad"  ""  "\fLrquotad\fP \(em remote quota server"
-.B rquotad
+.BR rquotad
 is an
 .BR rpc (3N)
 server which returns quotas for a user of a local file system
@@ -22,20 +22,65 @@ which is mounted by a remote machine over the
 The results are used by
 .BR quota (1)
 to display user quotas for remote file systems.
+
 The
-.B rquotad
+.BR rquotad
 daemon is normally started at boottime from the
 .BR rc.net
-script
+script (on systems with BSD'ish scripts, e.g. Slackware), or from the
+.BR nfs
+script in
+.BR /etc/rc.d/init.d/
+or
+.BR /etc/init.d/
+(on systems with SysV'ish scripts, e.g. RedHat, SuSE, etc).
+
+.SH OPTIONS
+.TP
+.BI "\-p," "" " \-\-port " port
+specify a port for 
+.BR rpc.rquotad 
+to listen on.  By default,
+.BR rpc.rquotad
+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.
+
+.SH TCP_WRAPPERS SUPPORT
+This
+.BR rpc.rquotad
+version is protected by the
+.BR tcp_wrapper
+library. You have to give the clients access to
+.BR rpc.rquotad
+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:
+
+mountd: .bar.com
+
+You have to use the daemon name 
+.BR rquotad
+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 FILES
-.PD 0
-.TP 20
-.B quotas
-quota file at the file system root
+.BR quota.user ,
+.BR quota.group
+-- quota files locate in the file system's root
 .PD
 .SH "SEE ALSO"
-.BR quota (1),
+.BR quota (8),
 .BR rpc (3N),
-.BR nfs (4P),
-.BR services (5)
-.BR inetd (8C),
+.BR nfs (5),
+.BR services (5),
+.BR portmap(8),
+.BR inetd (8)