- cleanup dead flags

- minor mdoc/rewording improvements
- add some relevant crossrefs

ok jmc

1 files changed, 37 insertions, 22 deletions

diff --git a/sbin/mount_nfs/mount_nfs.8 b/sbin/mount_nfs/mount_nfs.8
index 3282c6ab9c8..5e06f4e6e95 100644
--- a/sbin/mount_nfs/mount_nfs.8
+++ b/sbin/mount_nfs/mount_nfs.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: mount_nfs.8,v 1.33 2005/02/22 06:09:28 jaredy Exp $
+.\"	$OpenBSD: mount_nfs.8,v 1.34 2005/06/23 00:41:56 jaredy Exp $
 .\"	$NetBSD: mount_nfs.8,v 1.3 1996/02/18 11:59:10 fvdl Exp $
 .\"
 .\" Copyright (c) 1992, 1993, 1994, 1995
@@ -39,19 +39,17 @@
 .Sh SYNOPSIS
 .Nm mount_nfs
 .Bk -words
-.Op Fl 23PTUbcdilqs
-.Op Fl D Ar deadthresh
-.Op Fl I Ar readdirsize
-.Op Fl L Ar leaseterm
-.Op Fl R Ar retrycnt
+.Op Fl 23bcdilsTU
 .Op Fl a Ar maxreadahead
 .Op Fl g Ar maxgroups
+.Op Fl I Ar readdirsize
 .Op Fl o Ar options
+.Op Fl R Ar retrycnt
 .Op Fl r Ar readsize
 .Op Fl t Ar timeout
 .Op Fl w Ar writesize
 .Op Fl x Ar retrans
-.Ar rhost:path node
+.Ar rhost : Ns Ar path node
 .Ek
 .Sh DESCRIPTION
 The
@@ -81,11 +79,6 @@ Set the readdir read size to the specified value.
 The value should normally be a multiple of
 .Dv DIRBLKSIZ
 that is less than or equal to the read size for the mount.
-.It Fl P
-The kernel always uses a reserved port number to communicate with
-clients.
-This option is ignored, and exists solely for compatibility
-with older systems.
 .It Fl R Ar retrycnt
 Set the retry count for doing the mount to the specified value.
 The default is 10000.
@@ -136,7 +129,9 @@ Make the mount interruptible, which implies that file system calls that
 are delayed due to an unresponsive server will fail with EINTR when a
 termination signal is posted for the process.
 .It Fl l
-Used with NFSV3 to specify that the \fBReaddirPlus\fR RPC should
+Used with NFSV3 to specify that the
+.Dq readdir plus
+RPC should
 be used.
 This option reduces RPC traffic for cases such as
 .Dq "ls -l" ,
@@ -149,34 +144,39 @@ bandwidth-delay product.
 Options are specified with a
 .Fl o
 flag followed by a comma separated string of options.
+The prefix
+.Dq no
+may be added to invert the behavior of default options that do not
+take arguments.
 See the
 .Xr mount 8
 man page for possible options and their meanings.
+.Pp
 The following NFS specific options are also available:
-.Bl -tag -width indent
-.It acregmax=num
+.Bl -tag -width 15n
+.It Cm ac
+Enable attribute caching for both files and directories (default).
+.It Cm acregmax Ns = Ns Ar num
 Cache file attributes for no more than
 .Ar num
 seconds.
 The default is 60 seconds.
-.It acregmin=num
+.It Cm acregmin Ns = Ns Ar num
 Cache file attributes for at least
 .Ar num
 seconds.
 The default is 5 seconds.
-.It acdirmax=num
+.It Cm acdirmax Ns = Ns Ar num
 Cache directory attributes for no more than
 .Ar num
 seconds.
 The default is 60 seconds.
-.It acdirmin=num
+.It Cm acdirmin Ns = Ns Ar num
 Cache directory attributes for at least
 .Ar num
 seconds.
 The default is 5 seconds.
-.It noac
-Disable attribute caching for both files and directories.
-.It port=portnumber
+.It Cm port Ns = Ns Ar portnumber
 Use the specified port number for NFS requests.
 The default is to query the portmapper for the NFS port.
 .El
@@ -197,7 +197,10 @@ See the
 option as well.
 .It Fl s
 A soft mount, which implies that file system calls will fail
-after \fBRetry\fR round trip timeout intervals.
+after
+.Ar retrans
+round trip timeout intervals have been reached (see
+.Fl x ) .
 .It Fl t Ar timeout
 Set the initial retransmit timeout to the specified value.
 May be useful for fine tuning UDP mounts over internetworks
@@ -226,6 +229,7 @@ options should only be used as a last ditch effort at improving performance
 when mounting servers that do not support TCP mounts.
 .It Fl x Ar retrans
 Set the retransmit timeout count for soft mounts to the specified value.
+Defaults to 10.
 .El
 .Pp
 In versions prior to
@@ -242,12 +246,23 @@ to adjust the
 value, which is the number of kernel threads created
 to serve asynchronous NFS I/O requests.
 .Sh SEE ALSO
+.Xr nfsstat 1 ,
 .Xr mount 2 ,
+.Xr tcp 4 ,
+.Xr udp 4 ,
 .Xr fstab 5 ,
 .Xr mount 8 ,
 .Xr nfsd 8 ,
 .Xr sysctl 8 ,
 .Xr umount 8
+.Sh HISTORY
+The
+.Fl P
+flag historically informed the kernel to use a reserved port when
+communicating with clients.
+In
+.Ox ,
+a reserved port is always used.
 .Sh BUGS
 Due to the way that Sun RPC is implemented on top of UDP (unreliable datagram),
 tuning such mounts is really a black art that can only be expected