Copy stable/9 to releng/9.3 as part of the 9.3-RELEASE cycle.

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

MFC r251485:

Revert r238399.

The "failok" option doesn't have any effect at all unless specified in
fstab(5) and combined with the -a flag. The "failok" option is already
documented in fstab(5).

PR: 177630

MFC r241581:

Fix minor nits:
use a comma after "i.e."
sentences begin on new lines.

No .Dd bump for trivial modification.

Approved by: cperciva (implicit)

MFC r238399:
Document the behavior of mount with failok specified.

PR: docs/163742
Approved by: cperciva (implicit)

MFC r235873, r235967:

Fixes to man8 groff mandoc style, usage mistakes, or typos.

PR: 168016
Submitted by: Nobuyuki Koganemaru
Approved by: gjb (mentor)

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by: re (implicit)

Add another example to mount(8) on using the "-o" argument.

PR: docs/157389
Submitted by: Warren Block <wblock wonkity.com>
MFC after: 1 week

Another man page update related to the switchover of the
NFS clients done by r221124.
This is a content change.

Submitted by: jh

Revert r217871.

Clarify the availability of the noatime option on network file systems

Delete /sys/ufs/ffs/README.snapshot as it is no longer relevant.
Drop reference to it in mount(8).

MFC: 3 days

Clarify devfs manpages slightly.

mount(8): add xref to devfs(5)
devfs(5): change example to something more likely to be useful (it is not
necessary to mount a devfs on /dev manually, but for chroots/jails it is
often needed), mention since when devfs is preferred to device nodes on ufs

PR: 146600
MFC after: 2 weeks

mdoc: move CAVEATS, BUGS and SECURITY CONSIDERATIONS sections to the
bottom of the manpages and order them consistently.

GNU groff doesn't care about the ordering, and doesn't even mention
CAVEATS and SECURITY CONSIDERATIONS as common sections and where to put
them.

Found by: mdocml lint run
Reviewed by: ru

- Remove reference to nfs4. mount_nfs4(8) was removed in r192578.
- Add newnfs.

Implement NFSv4 ACL support for UFS.

Reviewed by: rwatson

Add links to zfs(8) and zpool(8) to mount(8) manual page.

Modify mount(8) to skip MNT_IGNORE file systems by default, just like df(1)
does. This is not POLA violation, because there is no single file system in the
base that use MNT_IGNORE currently, although ZFS snapshots will be mounted with
MNT_IGNORE after next commit.

Reviewed by: kib
MFC after: 3 days

Add a -o mountprog parameter to mount which explicitly allows
an alternative program to be used for mounting a file system.
Ideally, all file systems
should be converted to pass string arguments to nmount(), so that
/sbin/mount can handle them. However, certain file systems such as FUSE have
not done this, and want to have their own userland mount programs.

For example, to mount an NTFS file system with the FUSE NTFS driver:

mount -t ntfs -o mountprog=/usr/local/bin/ntfs-3g /dev/acd0 /mnt

or via an fstab entry:

/dev/acd0 /mnt ntfs ro,noauto,mountprog=/usr/local/bin/ntfs-3g 0 0

PR: 120784
Requested by: Dominic Fandrey

Fix markup.

Add note about a reason to use mount(8) instead of mount_somefs.

Reported and proof-readed by: pho
Discussed with: rodrigc
MFC after: 3 days

- Update with a better example which shows that options specific to a
file system may be passed using -o.

Approved by: remko, rodrigc

- Also change the /sbin/mount_unionfs line I managed to miss just two
lines down to '-o below'.

Approved by: remko
Noticed by: rodrigc
Pointyhat by: me

- unionfs -b option is deprecated in favor of '-o below' as per
mount_unionfs(8).

Approved by: remko

Properly sort 'sync' in the list of options passed to -o.

MFC after: 3 days

Remove stale reference to mount_std.

- Remove UMAP filesystem. It was disconnected from build three years ago,
and it is seriously broken.

Discussed on: freebsd-arch@
Approved by: re (mux)

Markup fixes.

Fix markup snafu.

Spotted by: ru

Re-word the description of the "async" flag.

Suggested by: Milos Vyletel (mv@rulez.sk)
Reviewed by: ru
Approved by: keramida (mentor), trhodes (mentor)

Teach mount(8) about a 'late' keyword, which means the file system should
not be mounted unless the -l flag was specified.

Add an rc script, mountlate, which basically runs 'mount -a -l'. It runs
after DAEMON but before LOGIN.

This is useful for things like loopback mounts, because mountcritremote
runs before mountd / nfsd (since /usr might be a remote file system), so
an attempt to mount a loopback network file system in mountcritremote will
fail.

Also add a progress message to mountcritlocal, for the sake of symmetry
with similar messages in mountcritremote and mountlate.

Reviewed by: freebsd-rc
MFC after: 3 weeks

Remove reference to mount_procfs(8), add reference to procfs(5).
mount(8) doesn't use mount_procfs(8), and instead passes an fstype
of "procfs" directly to nmount().

Remove reference to mount_ext2fs(8), add reference to ext2fs(5).
mount no longer invokes mount_ext2fs, it calls nmount() directly
with fstype "ext2fs".

Update text to reflect that:
- mount(8) now calls the nmount(2) system call directly, not mount(2)
- specifying a filesystem type with -t will not automatically
invoke an external /sbin/mount_XXXX program....this only happens for
certain file system types. For all other file system types, nmount(2)
is called directly.

- Xref mount_reiserfs(8)

PR: docs/90902
Submitted by: Scott Robbins <scottro@nyc.rr.com>
MFC after: 3 days

Remove Xref to mount_hpfs(8), it's not hooked up to the build.

Approved by: re (blanket)
MFC after: 3 days

Add verbiage to the description of the noexec mount option clarifying
that it really wasn't intended as a security feature.

Wording mostly by: simon
Discussed with: secteam

Sort sections.

Fix typo.

Noticed by: clement

Fix the mount(8) status reporting, now that MNT_NODEV is a no-op (zero).

Asked to commit by: phk

Assorted markup, grammar, and spelling fixes.

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

Approved by: core, imp

Correct the definition of the multilabel flag: it enables multilabel
MAC support on the file system, if supported, which causes MAC to treat
each object as having its own label, rather than using a single label
for all objects on the file system. This doesn't have to be used in
combination with the tunefs/newfs flags -- it's an alternative.

s/considred/considered/

Reorder Xrefs in SEE ALSO.

Update to inform users of acls and multilabel options. Add Xrefs to the
more relevant manual pages.

PR: 62394
Submitted by: Marc Silver <marcs@draenor.org>

Style(9) option sorting

Submitted by: Ruslan Ermilov <ru@FreeBSD.org>

Fix manpage and usage() to reflect that -a can be used in combination
with -o

Submitted by: Ruslan Ermilov <ru@FreeBSD.org>
Pointed out by: Ceri Davies <ceri@submonkey.net

Reduce fstab(5)/mount(8) confusion by changing the man pages to say "ro"
instead of "rdonly". "rdonly" works for mount(8) and mount_std(8) but
not from /etc/fstab, whereas "ro" works for all mount_*(8) commands.

Fixed the markup in the recently added ENVIRONMENT section.

Bump the date for recent commits.

Clarify the behavior of PATH_FSTAB with regard to 'tainted' execution.

Requested by: ru

Implement the '-F' option for mount & umount which allows the user to
specify an alternate fstab file.

mdoc(7) police: kill unnecessary xref.

Mention the oddities and requirements for mount operations executed by
non-root users.

PR: docs/42651
Submitted by: Thomas Seck <tmseck@netcologne.de>
MFC after: 3 days

Remove the incorrect information about dump(8) and snapshots. All the
dump(8) issues are assumed to be fixed.

PR: 46224
Submitted By: Chris Knight <chris@aims.com.au>
Approved By: re (murray)

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

mdoc(7) police: missing markup bits.

Update the manpage to match the code. The mount utilities
now don't try to load the filesystem module, the kernel takes
care of this.

Add a bit of information on FFS snapshots to the mount(8) manual page.

PR: 30139
Submitted by: Chris Knight <chris@aims.com.au?
MFC after: 3 days

The .Nm utility

more file system > filesystem

Fix a typo : ".Xr mount_udf 8," -> ".Xr mount_udf 8 ,".

Add mount_udf and mount_smbfs to crossrefs.

PR: 37200
Submitted by: Cyrille Lefevre <cyrille.lefevre@laposte.net>

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

- VFS_SET(msdos) -> VFS_SET(msdosfs)
- msdos.ko -> msdosfs.ko
- mount_msdos(8) -> mount_msdosfs(8)
- "msdos" -> "msdosfs" compatibility glue in mount(8)

Remove vestiges of MFS.

Rename (after a repo-copy) some mount(8) programs:

mount_fdesc -> mount_fdescfs
mount_null -> mount_nullfs
mount_portal -> mount_portalfs
mount_umap -> mount_umapfs
mount_union -> mount_unionfs

Add an xref for mount_ntfs.

PR: docs/24693
Submitted by: Etienne Vidal <hallik@libertysurf.fr>

Retire kernfs (userland part).

Prepare for mdoc(7)NG.

mdoc(7) police: misc minor fixes.

o get rid lfs mentions
o remove non-mdoc groff's instructions

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

.Xr to mount_ext2fs, mount_hpfs, mount_linprocfs, mount_nwfs, and
mount_std.

PR: docs/20369
Submitted by: bmah

Explain the notion that additional mount options may be described
in mount_XXX manual pages. Remove explicit mention of NFS mount
options, since they are accurately described by this rule.

PR: 20814

Removed xref to mount_lfs, this died in 2.mumble.

PR: docs/18272
Submitted by: Michael Lucas <mwlucas@blackhelicopters.org>

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.

Don't scare the users.
Kirk argees that the comment about corruption caused by switching the flags
on an already mounted manpage are bogus, it doesn't happen.

Ok by: mckusick

Document the "noasync" option.

$Id$ -> $FreeBSD$

Null commit.

> PR: bin/6399
> Submitted by: David Malone <dwmalone@maths.tcd.ie>

Also reviewed by: bde

1. Enhanced syntax for mount(8). The -o option now supports two 'meta'
options:

-o fstab brings in filesystem options specified in /etc/fstab
-o current incorporates the current set of options for the file
system

The rightmost option wins in the case of conflicting options being
specified.

E.g.:-

# mount -u -o current,nosuid /home

will preserve the current mount options while adding the 'nosuid' flag.

2. Rewording of manual page to be hopefully clearer; small -Wall
cleanups.

Thanks to David Malone for his patience and willingness to work
multiple patches on request.

PR: bin/6399
Submitted by: David Malone <dwmalone@maths.tcd.ie>

modload -> kldload and add ref to kldload(8) in See Also section.

Submitted by: Nathan Ahlstrom <nrahlstr@winternet.com>

Warn about "mount -u" bug.

Add a CAVEAT section documenting the minimum permissions required for a mount
point to be traversable in both directions by all users.

PR: 7172

New mount option nosymfollow. If enabled, the kernel lookup()
function will not follow symbolic links on the mounted
file system and return EACCES (Permission denied).

Add mount_devfs(8) to the SEE ALSO section.

PR: 5125

Reviewed by: hackers@freebsd.org in general
Obtained from: Whistle Communications tree

Add an option to the way UFS works dependent on the SUID bit of directories
This changes makes things a whole lot simpler on systems running as
fileservers for PCs and MACS. to enable the new code you must
1/ enable option SUIDDIR on the kernel.
2/ mount the filesystem with option suiddir.
hopefully this makes it difficult enough for people to
do this accidentally.
see the new chmod(2) man page for detailed info.

Add noclusterr and noclusterw options. The noclusterr and noclusterw
disable clustered read and write, respectively.

Reviewed by: bde

Try to avoid mounting filesystems multiple times. Also while
I'm here do some -Wall cleaning.

PR: kern/1839
Reviewed and corrected by: joerg

Mention the various reasons for messages of the form:

xxxxx filesystem is not available

Inspired by: PR 3311, and a following discussion with Mikhail

Always include the section name in the .Xr macro and cleanup
.Nm macro usage.

PR: docs/3940
Submitted by: Kazuo Horikawa <k-horik@yk.rim.or.jp>

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

**DANGER WILL ROBINSON!!** You must be running a -current kernel
from within a week or so in order for this to work!

Revert $FreeBSD$ to $Id$

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.

Add mount_msdos(8) reference
2.2 candidate

Added description of "noatime" option.

[HISTORY] command appeared in Version 1 AT&T UNIX
Obtained from: A Quarter Century of UNIX, Peter H. Salus, page 41

I have added a new option -p to the mount command. This was
inspired by SunOS version of mount which uses option -p to
indicate that the mount information should be printed in fstab
format.
This is a neat way to create a new fstab file to use later when
one has modified the mount points or mount options or added or
removed mount some mount points. You just type

mount -p > /etc/fstab.new

and there is your new fstab file ready to be used though you
will of course have to add any necessary noauto flags manually.

[Committers note: This also seems to do the wrong thing for AMD
mounts, but in the more average case this is a nifty feature nonetheless
and one can always edit the bogus entries out]

Submitted-By: Jukka Ukkonen <jau@jau.csc.fi>

Document that suid wrapper like suidperl(1) break option 'nosuid'.

Another round of various man page cleanups.

Document the -a option, and mention ``noauto''.

The changes for adding the "noauto" option were mostly wrong. MNT_NOAUTO
is a kernel flag, and the kernel definately doesn't need to know about
it.

Sigh. This isn't my night. I forgot the manpage updates too!
Thanks, Andrey.

Fixed incompleteness that would allow dirty filesystems to get mounted
when the single user shell was terminated. These changes disallow mounting
or R/W upgrading filesystems that are dirty unless "-f" (force) option
is used with mount. /etc/rc has been modified to abort the startup if
one or more non-nfs partitions fail to mount.

Reviewed by: Poul-Henning Kamp, Rod Grimes

Document the requirements of dynamic loading on mounting order. Cross-ref
to vfsload(3).

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

BSD 4.4 Lite sbin Sources

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