History log of /freebsd-10.3-release/sbin/mount_nfs/mount_nfs.8
Revision Date Author Comments
(<<< Hide modified files)
(Show modified files >>>)
# 296373 04-Mar-2016 marius

- Copy stable/10@296371 to releng/10.3 in preparation for 10.3-RC1
builds.
- Update newvers.sh to reflect RC1.
- Update __FreeBSD_version to reflect 10.3.
- Update default pkg(8) configuration to use the quarterly branch.

Approved by: re (implicit)

# 275250 29-Nov-2014 trasz

MFC r273851:

Note that the "timeout" nfs option is in tenths of a second.

Sponsored by: The FreeBSD Foundation


# 275249 29-Nov-2014 trasz

MFC r273849:

Add support for "timeo", "actimeo", "noac", and "proto" options
to mount_nfs(8). They are implemented on Linux, OS X, and Solaris,
and thus can be expected to appear in automounter maps.

Sponsored by: The FreeBSD Foundation


# 270043 16-Aug-2014 bz

MFC r269583:

Provide -o vers= support for mount_nfs.

Our mount_nfs does use -o nfsv<2|3|4> or -2 or -3 to specify the version.
OSX (these days), Solaris, and Linux use -o vers=<2,3,4>.

With the upcoming autofs support we can make a lot of (entrerprisy) setups
getting mount options from LDAP just work by providing -o vers= compatibility.

Reviewed by: wblock, bjk (man page), rmacklem, emaste
Sponsored by: DARPA,AFRL
PR: 192379


# 260108 30-Dec-2013 rmacklem

MFC: r259089
Document the noncontigwr NFS mount option.
This is a content change.


# 256281 10-Oct-2013 gjb

Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation


# 253051 09-Jul-2013 rmacklem

Document the "gssname" and "allgssname" mount options added by the
host-based initiator credential patches.
This is a content change.


# 244055 09-Dec-2012 rmacklem

Document the new NFS mount options added by r244042.
This is a content change.


# 230547 25-Jan-2012 jhb

Add a timeout on positive name cache entries in the NFS client. That is,
we will only trust a positive name cache entry for a specified amount of
time before falling back to a LOOKUP RPC, even if the ctime for the file
handle matches the cached copy in the name cache entry. The timeout is
configured via a new 'nametimeo' mount option and defaults to 60 seconds.
It may be set to zero to disable positive name caching entirely.

Reviewed by: rmacklem
MFC after: 1 week


# 227507 14-Nov-2011 jhb

Finish making 'wcommitsize' an NFS client mount option.

Reviewed by: rmacklem
MFC after: 1 week


# 221436 04-May-2011 ru

Implemented a mount option "nocto" that disables cache coherency
checking at open time. It may improve performance for read-only
NFS mounts. Use deliberately.

MFC after: 1 week
Reviewed by: rmacklem, jhb (earlier version)


# 221145 28-Apr-2011 rmacklem

Update man pages related to the change in default NFS client
applied by r221124. I also deleted references to idmapd, since that
daemon no longer exists.
This is a content change.


# 202772 21-Jan-2010 rmacklem

Document the negnametimeo option for mount_nfs as implemented
by r202767. This is a content change.

MFC after: 2 weeks


# 195942 29-Jul-2009 rmacklem

Delete the descriptions of the gssname and allgssname optionss from
mount_nfs.8 since these options are not implemented in FreeBSD8.
This is content change for the man page.

Approved by: re (kensmith), kib (mentor)


# 192930 27-May-2009 rmacklem

Add support for the experimental nfs client to mount_nfs. The
experimental client is used when the fstype is "newnfs" or the "nfsv4"
option is specified. It includes the addition of the option:
gssname - to specify a client side initiator host based principal name
which is specific to NFSv4.
It also includes a change to mount.c, so that it knows about
mount_newnfs, but not mount_nfs4.

Reviewed by: dfr
Approved by: kib (mentor)


# 192578 22-May-2009 rwatson

Remove the unmaintained University of Michigan NFSv4 client from 8.x
prior to 8.0-RELEASE. Rick Macklem's new and more feature-rich NFSv234
client and server are replacing it.

Discussed with: rmacklem


# 183008 13-Sep-2008 rodrigc

Instead of building up a "struct nfs_args" to pass to the kernel
via nmount(), build up an iovec where each iovec member is an NFS mount
option, and pass the iovec down to the kernel via nmount(). These options
are then parsed in the kernel.
This should make it easier to add new NFS mount options in future.

Many, many thanks to Doug Rabson for taking my initial patches,
and cleaning them up. In addition, Doug added a fallback_mount()
function so that the newer mount_nfs program will work against older
kernels, to facilitate upgrading/downgrading scenarios.
Doug also re-wrote the mount_nfs.8 man page.

Reviewed by: dfr


# 176202 12-Feb-2008 ceri

Add the -4 option to the synopsis.


# 176201 12-Feb-2008 ceri

Bump .Dd for r1.48.


# 176198 11-Feb-2008 kris

Switch the default NFS mount mode from UDP to TCP. UDP mounts are a
historical relic, and are no longer appropriate for either LAN or WAN
mounting. At modern (gigabit and 10 gigabit) LAN speeds packet loss
from socket buffer fill events is common, and sequence numbers wrap
quickly enough that data corruption is possible. TCP solves both of
these problems without imposing significant overhead.

MFC after: 1 month


# 167236 05-Mar-2007 thomas

Add "fg" option as antonym to "bg"; add "hard" option as antonym to "soft".
This is for better compatibility with other environments (Linux, Solaris,
HP-UX, AIX and Tru64 support these options).

PR: bin/109924
MFC after: 1 week


# 166183 23-Jan-2007 rodrigc

Merge mount_nfs4.c and mount_nfs.c into one program.
If argv[0] == "mount_nfs4", then default to mounting NFSv4,
otherwise if argv[0] == "mount_nfs", default to the old mount_nfs behavior.

- Add a -4 option.
- Add the University of Michigan copyright from mount_nfs4.c, for the
code merged from mount_nfs4.c.

Reviewed by: rees


# 163110 07-Oct-2006 trhodes

Properly separate sentences by adding a semi-colon.

Hinted by: bmah


# 153711 25-Dec-2005 trhodes

Kill the BUGS section, and remove a similar line noted under -T. As far
as I know, Sun's NFS support works with TCP just fine. This is even
hinted at in the PR.

PR: 71782


# 141611 10-Feb-2005 ru

Sync program's usage() with manpage's SYNOPSIS.


# 131488 02-Jul-2004 ru

Mechanically kill hard sentence breaks.


# 128073 09-Apr-2004 markm

Remove advertising clause from University of California Regent's license,
per letter dated July 22, 1999.

Approved by: core, imp


# 119951 10-Sep-2003 ru

mdoc(7): There cannot be a subsection inside a list.

Reported by: naddy


# 115119 17-May-2003 ru

mdoc(7) markup overhaul.


# 114894 11-May-2003 trhodes

Remove remnants of the -p option. While I'm here, remove wording about
-P which could be interpreted as 'this option must be specified'.

PR: 37221 && 51886
Discussed with: bmah
Approved by: re (blanket)


# 112580 25-Mar-2003 mdodd

Add mount options 'noinet4' and 'noinet6' which prevent using those
address families.

This is useful for preventing NFS mounts from using IPv6 on hosts
that have both A and AAAA records for the same name.


# 109948 27-Jan-2003 dillon

Update mount_nfs documentation to reference new sysctl for -c default.


# 102231 21-Aug-2002 trhodes

s/filesystem/file system/g as discussed on -developers


# 99501 06-Jul-2002 charnier

The .Nm utility


# 96707 16-May-2002 trhodes

more file system > filesystem


# 86285 12-Nov-2001 alfred

note that 'nolockd' can't be used when updating mount flags


# 86284 12-Nov-2001 alfred

Allow users to use the 'nolockd' or -L options with mount_nfs in order
to avoid the need for rpc.lockd to perform client locks. Using
this option a user can revert back to using local locks for NFS mounts
like we did before we had rpc.lockd.


# 83653 18-Sep-2001 peter

Userland part of nfs client/server split and cleanup.


# 81622 14-Aug-2001 ru

mdoc(7) police: s/BSD/.Bx/ where appropriate.


# 80086 21-Jul-2001 iedowse

Change the foreground mount behaviour so that we keep retrying
forever by default. This matches what mount_nfs did before revision
1.40, and it is the generally expected behaviour for NFS mounts.

Document the current defaults near the start of the man page and
mention the options that can be used to change them.

Discussed on: -hackers


# 80006 19-Jul-2001 iedowse

Since revision 1.40/1.41, the default behaviour for mount_nfs is
to give up after one attempt unless a background mount is requested.
Background mounts would retry 10000 times (at least 7 days) before
giving up.

For some situations such as diskless terminals, an NFS filesystem
may be critical to the boot process, so neither the "try once" nor
background mounts are appropiate. To cater for this situation,
unbreak the -R (retry count) parameter so that it also works in
the non-background case. Interpret a zero retry count as "retry
forever".

The defaults are now "try once" for non-background mounts and "retry
forever" for background mounts; both can be overridden via -R.
Add a description of this behaviour to the manpage.


# 79754 15-Jul-2001 dd

Remove whitespace at EOL.


# 79530 10-Jul-2001 ru

mdoc(7) police: removed HISTORY info from the .Os call.


# 78576 22-Jun-2001 iedowse

Make it much more obvious that the use of NQNFS is discouraged (the
NQNFS code is ancient, bug-ridden, and should probably be removed).
The wording here was very confusing; it was easy to get the impression
that NQNFS is an extension to NFSv3 when in fact it just uses some
NFSv3-like extensions on top of NFSv2. As witnessed by the mailing
lists and PRs, some people were reading the description and deciding
that NQNFS was what they wanted to use.

MFC after: 1 week


# 71895 01-Feb-2001 ru

mdoc(7) police: split punctuation characters + misc fixes.


# 68960 20-Nov-2000 ru

mdoc(7) police: use the new features of the Nm macro.


# 64542 11-Aug-2000 sheldonh

Explain why adding ``options NFSKERB'' breaks the kernel build.

PR: 10642
Reported by: Stefan Eggers <seggers@semyam.dinoco.de>
Submitted by: johan


# 63439 18-Jul-2000 sheldonh

Cross-reference mount_nfs(8) and showmount(8).

PR: 20008
Reported by: Gerald Pfeifer <pfeifer@dbai.tuwien.ac.at>


# 63438 18-Jul-2000 sheldonh

Order the cross-references in the SEE ALSO section, in preparation
for PR 20008.


# 57695 02-Mar-2000 sheldonh

Remove more single-space hard sentence breaks.


# 57668 01-Mar-2000 sheldonh

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.


# 55937 13-Jan-2000 dillon

Thresh-out the nfs manual page references a bit

Reviewed by: Julian Elischer <julian@elischer.org>


# 50476 28-Aug-1999 peter

$Id$ -> $FreeBSD$


# 37427 06-Jul-1998 charnier

Sync usage string and man page. Correct use of .Nm. Spelling. Remove
unused #includes.


# 37253 29-Jun-1998 jkoshy

Fix bogon in man page. "-o conn" actually turns off NFSMNT_NOCONN as it is
a "negative" option. This makes it equivalent to /not/ specifying "-c".
The compile time default is /not/ to have the NFSMNT_NOCONN flag set, so
"-o conn" should never be needed---truly a deprecated option :-).

PR: 6905.


# 36178 19-May-1998 peter

Support changing the attribute cache limits per-mount. We don't have
many option letters left, I used long names only (like the previous
port= option)


# 35583 01-May-1998 peter

Mention the 2GB NFS v2 filesize limit.

PR: 6335
Submitted by: tom@sdf.com


# 30580 19-Oct-1997 joerg

Introduce a -N option that disables the use of reserved ports, now
that -P is on by default. Remove do-nothing code in the -P case (but
leave the option itself for backward compatibility).

PR: bin/4500


# 25004 18-Apr-1997 dfr

Use v3 protocol by default if it is supported by the server. Allow the
user to force v2 protocol even if the server supports v3.

Obtained from: NetBSD but with a slightly different implementation


# 23680 11-Mar-1997 peter

Merge from Lite2 (use new getvfsbyname() and mount(2) interface)


# 22990 22-Feb-1997 peter

Revert $FreeBSD$ to $Id$


# 21673 14-Jan-1997 jkh

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.


# 19112 22-Oct-1996 joerg

Mention the historic mount options, as `deprecated'.

Closes PR # docs/735.


# 13720 29-Jan-1996 mpp

Fix a bunch of spelling errors.


# 9336 27-Jun-1995 dfr

Changes to support version 3 of the NFS protocol.
The version 2 support has been tested (client+server) against FreeBSD-2.0,
IRIX 5.3 and FreeBSD-current (using a loopback mount). The version 2 support
is stable AFAIK.
The version 3 support has been tested with a loopback mount and minimally
against an IRIX 5.3 server. It needs more testing and may have problems.
I have patched amd to support the new variable length filehandles although
it will still only use version 2 of the protocol.

Before booting a kernel with these changes, nfs clients will need to at least
build and install /usr/sbin/mount_nfs. Servers will need to build and
install /usr/sbin/mountd.

NFS diskless support is untested.

Obtained from: Rick Macklem <rick@snowhite.cis.uoguelph.ca>


# 9230 14-Jun-1995 karl

Added -o port option. Use specified port number for NFS requests. The default
is to query the portmapper for the NFS port. This is useful for CFS users.


# 1559 26-May-1994 rgrimes

This commit was generated by cvs2svn to compensate for changes in r1558,
which included commits to RCS files with non-trunk default branches.


# 1558 26-May-1994 rgrimes

BSD 4.4 Lite sbin Sources

Note: XNSrouted and routed NOT imported here, they shall be imported with
usr.sbin.