Separate the description of the flags for mount(2) and unmount(2)

to clarify which system call accepts which arguments. Previously
the manual page gave the impression that calling unmount() with
flags of (MNT_FORCE | MNT_UPDATE | MNT_RDONLY) would downgrade a
read-write mount to read-only, which is clearly untrue; to do that,
these flags should be passed to mount() instead.
This commit is contained in:
Ian Dowse 2003-06-30 22:22:12 +00:00
parent 3b5ba84fd2
commit ff1db98495
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=117089

View File

@ -32,7 +32,7 @@
.\" @(#)mount.2 8.3 (Berkeley) 5/24/95
.\" $FreeBSD$
.\"
.Dd May 24, 1995
.Dd June 30, 2003
.Dt MOUNT 2
.Os
.Sh NAME
@ -105,6 +105,13 @@ Do not interpret special files on the file system.
This flag is set automatically when the caller is not the super-user.
.It Dv MNT_SUIDDIR
Directories with the SUID bit set chown new files to their own owner.
This flag requires the SUIDDIR option to have been compiled into the kernel
to have any effect.
See the
.Xr mount 8
and
.Xr chmod 2
pages for more information.
.It Dv MNT_SYNCHRONOUS
All I/O to the file system should be done synchronously.
.It Dv MNT_ASYNC
@ -112,6 +119,12 @@ All I/O to the file system should be done asynchronously.
.It Dv MNT_FORCE
Force a read-write mount even if the file system appears to be unclean.
Dangerous.
Together with
.Dv MNT_UPDATE
and
.Dv MNT_RDONLY ,
specify that the file system is to be forcibly downgraded to a read-only
mount even if some files are open for writing.
.It Dv MNT_NOCLUSTERR
Disable read clustering.
.It Dv MNT_NOCLUSTERW
@ -163,24 +176,13 @@ mount point
.Pp
The
.Fa flags
argument may specify
argument may include
.Dv MNT_FORCE
to specify that the file system should be forcibly unmounted or made read-only
(if MNT_UPDATE and MNT_RDONLY are also specified)
to specify that the file system should be forcibly unmounted
even if files are still active.
Active special devices continue to work,
but any further accesses to any other active files result in errors
even if the file system is later remounted.
.Pp
The
.Dv MNT_SUIDDIR
option requires the SUIDDIR option to have been compiled into the kernel
to have any effect.
See the
.Xr mount 8
and
.Xr chmod 2
pages for more information.
.Sh RETURN VALUES
.Rv -std
.Sh ERRORS