Sort options.

This commit is contained in:
wiz 2006-12-27 11:27:37 +00:00
parent b9625c8fbe
commit 78cc844673

View File

@ -1,4 +1,4 @@
.\" $NetBSD: mount_nfs.8,v 1.33 2006/12/27 11:08:30 yamt Exp $
.\" $NetBSD: mount_nfs.8,v 1.34 2006/12/27 11:27:37 wiz Exp $
.\"
.\" Copyright (c) 1992, 1993, 1994, 1995
.\" The Regents of the University of California. All rights reserved.
@ -38,30 +38,30 @@
.Sh SYNOPSIS
.Nm
.Bk -words
.Op Fl 23bcCdilpPqsTUX
.Op Fl 23bCcdilPpqsTUX
.Ek
.Bk -words
.Op Fl a Ar maxreadahead
.Ek
.Bk -words
.Op Fl D Ar deadthresh
.Ek
.Bk -words
.Op Fl g Ar maxgroups
.Ek
.Bk -words
.Op Fl I Ar readdirsize
.Ek
.Bk -words
.Op Fl L Ar leaseterm
.Ek
.Bk -words
.Op Fl R Ar retrycnt
.Ek
.Bk -words
.Op Fl a Ar maxreadahead
.Ek
.Bk -words
.Op Fl g Ar maxgroups
.Ek
.Bk -words
.Op Fl o Ar options
.Ek
.Bk -words
.Op Fl R Ar retrycnt
.Ek
.Bk -words
.Op Fl r Ar readsize
.Ek
.Bk -words
@ -105,61 +105,6 @@ Use the
Version 3 protocol.
The default is to try version 3 first, and
fall back to version 2 if the mount fails.
.It Fl D
Set the
.Dq "dead server threshold"
to the specified number of round trip timeout intervals.
After a
.Dq "dead server threshold"
of retransmit timeouts,
.Dq "not responding"
message is printed to a tty.
.It Fl I
Set the readdir read size to the specified value.
The value should normally
be a multiple of
.Dv DIRBLKSIZ
that is \*[Le] the read size for the mount.
.It Fl L
Ignored.
It used to be
.Tn NQNFS
lease term.
.It Fl P
Use a reserved socket port number.
This is the default, and available
for backwards compatibility purposes only.
.It Fl R
Set the retry count for doing the mount to the specified value.
.It Fl T
Use
.Tn TCP
transport instead of
.Tn UDP .
This is recommended for servers that are not on the same physical network as
the client.
Not all
.Tn NFS
servers, especially not old ones, support this.
.It Fl U
Force the mount protocol to use
.Tn UDP
transport, even for
.Tn TCP
.Tn NFS
mounts.
This is necessary for some old
.Bx
servers.
.It Fl X
Perform 32 \*[Lt]-\*[Gt] 64 bit directory cookie translation for version 3 mounts.
This may be need in the case of a server using the upper 32 bits of
version 3 directory cookies, and when you are running emulated binaries
that access such a filesystem.
Native
.Nx
binaries will never need this option.
This option introduces some overhead.
.It Fl a
Set the read-ahead count to the specified value.
This may be in the range of 0 - 4, and determines how many blocks
@ -172,14 +117,6 @@ trying the mount in the background.
Useful for
.Xr fstab 5 ,
where the filesystem mount is not critical to multiuser operation.
.It Fl c
For
.Tn UDP
mount points, do not do a
.Xr connect 2 .
This flag is deprecated and connectionless
.Tn UDP
mounts are the default.
.It Fl C
For
.Tn UDP
@ -195,6 +132,23 @@ port number 2049, or for servers with multiple network interfaces.
In these cases if the socket is connected and the server
replies from a different port number or a different network interface
the client will get ICMP port unreachable and the mount will hang.
.It Fl c
For
.Tn UDP
mount points, do not do a
.Xr connect 2 .
This flag is deprecated and connectionless
.Tn UDP
mounts are the default.
.It Fl D
Set the
.Dq "dead server threshold"
to the specified number of round trip timeout intervals.
After a
.Dq "dead server threshold"
of retransmit timeouts,
.Dq "not responding"
message is printed to a tty.
.It Fl d
Turn off the dynamic retransmit timeout estimator.
This may be useful for
@ -209,12 +163,23 @@ This should be used for mounts on old servers that cannot handle a
group list size of 16, as specified in RFC 1057.
Try 8, if users in a lot of groups cannot get response from the mount
point.
.It Fl I
Set the readdir read size to the specified value.
The value should normally
be a multiple of
.Dv DIRBLKSIZ
that is \*[Le] the read size for the mount.
.It Fl i
Make the mount interruptible, which implies that file system calls that
are delayed due to an unresponsive server will fail with
.Er EINTR
when a
termination signal is posted for the process.
.It Fl L
Ignored.
It used to be
.Tn NQNFS
lease term.
.It Fl l
Used with
.Tn NFS
@ -237,6 +202,10 @@ flag followed by a comma separated string of options.
See the
.Xr mount 8
man page for possible options and their meanings.
.It Fl P
Use a reserved socket port number.
This is the default, and available
for backwards compatibility purposes only.
.It Fl p
Do not use a reserved port number for RPCs.
This option is provided only to be able to mimic the old
@ -246,6 +215,8 @@ A synonym of
.Fl 3 .
It used to specify
.Tn NQNFS .
.It Fl R
Set the retry count for doing the mount to the specified value.
.It Fl r
Set the read data size to the specified value in bytes.
It should normally be a power of 2 greater than or equal to 1024.
@ -271,6 +242,16 @@ A soft mount, which implies that file system calls will fail
after
.Ar retrycnt
round trip timeout intervals.
.It Fl T
Use
.Tn TCP
transport instead of
.Tn UDP .
This is recommended for servers that are not on the same physical network as
the client.
Not all
.Tn NFS
servers, especially not old ones, support this.
.It Fl t
Set the initial retransmit timeout to the specified value.
May be useful for fine tuning
@ -284,6 +265,16 @@ value if there is a low retransmit rate but long response delay observed.
Normally, the -d option should be specified when using this option to manually
tune the timeout
interval.
.It Fl U
Force the mount protocol to use
.Tn UDP
transport, even for
.Tn TCP
.Tn NFS
mounts.
This is necessary for some old
.Bx
servers.
.It Fl w
Set the write data size to the specified value in bytes.
.Pp
@ -303,6 +294,15 @@ options should only be used as a last ditch effort at improving performance
when mounting servers that do not support
.Tn TCP
mounts.
.It Fl X
Perform 32 \*[Lt]-\*[Gt] 64 bit directory cookie translation for version 3 mounts.
This may be need in the case of a server using the upper 32 bits of
version 3 directory cookies, and when you are running emulated binaries
that access such a filesystem.
Native
.Nx
binaries will never need this option.
This option introduces some overhead.
.It Fl x
Set the retransmit timeout count for soft mounts to the specified value.
.El