do not trim leading pathname from special device name
[unix-history] / usr / src / sbin / mount / mount.8
index 7328189..551b4e5 100644 (file)
@@ -1,8 +1,19 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1989 The Regents of the University of California.
+.\" All rights reserved.
 .\"
-.\"    @(#)mount.8     6.6 (Berkeley) %G%
+.\" Redistribution and use in source and binary forms are permitted
+.\" provided that the above copyright notice and this paragraph are
+.\" duplicated in all such forms and that any documentation,
+.\" advertising materials, and other materials related to such
+.\" distribution and use acknowledge that the software was developed
+.\" by the University of California, Berkeley.  The name of the
+.\" University may not be used to endorse or promote products derived
+.\" from this software without specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\"
+.\"    @(#)mount.8     6.11 (Berkeley) %G%
 .\"
 .TH MOUNT 8 ""
 .UC 4
@@ -11,21 +22,21 @@ mount, umount \- mount and dismount file systems
 .SH SYNOPSIS
 .B mount
 [
-.B \-afrw
+.B \-afrwu
 ]
 .br
 .B mount
 [
-.B \-frw
+.B \-frwu
 ]
 special | node
 .br
 .B mount
 [
-.B \-frw
+.B \-frwu
 ] [
 .B \-t
-nfs | ufs
+nfs | ufs | external_type
 ] [
 .B \-o
 options
@@ -36,9 +47,14 @@ special node
 .B umount
 [
 .B \-a
+] [
+.B \-f
 ]
 .br
 .B umount
+[
+.B \-f
+]
 special | node
 .br
 .SH DESCRIPTION
@@ -48,18 +64,66 @@ block device \fIspecial\fP or the remote node ``rhost:path''.
 The file \fInode\fP must exist already and
 it must be a directory.  It becomes the name of the newly mounted root.
 The optional arguments \fI-r\fP and \fI-w\fP indicate that the file
-system is to be mounted read-only or read-write, respectively.  If
-either \fIspecial\fP or \fIfile\fP are not provided, the appropriate
+system is to be mounted read-only or read-write, respectively.
+If either \fIspecial\fP or \fIfile\fP are not provided, the appropriate
 information is taken from the \fIfstab\fP file.  The \fI-f\fP option
 causes everything to be done except for the actual system call; if it's
 not obvious, this ``fakes'' mounting the file system.
-The optional argument \fI-t\fP must be followed by \fBnfs\fP or
-\fBufs\fP to indicate the file system type. The type \fBufs\fP is
-the default.
-The \fI-o\fP argument followed by \fIoptions\fP, which is a comma
-separated string of any of the following list,
-can be used to override the defaults for an nfs mount.
+This option is useful in conjunction with the \fI-v\fP flag to
+determine what the
+.I mount
+command is trying to do.
+.PP
+The optional argument \fI-t\fP can be used
+to indicate the file system type.
+The type \fBufs\fP is the default.
+If the type is not one of the internally known types,
+mount will attempt to execute a program in
+.B /sbin/mount_XXX
+where \fBXXX\fP is replaced by the type name.
+The standard mount options (see below) are parsed and
+passed to external program via the \fI-F\fP option
+as a decimal number.
+Any additional options specific to the program can
+be passed as a comma separated list;
+these options are distinguished by starting with a \fI-\fP (dash).
+Those options that take a value are specified
+using the syntax -option=value.
+For example, the mount command:
+.br
+       mount -t mfs -o nosuid,-N,-s=4000 /dev/dk0b /tmp
+.br
+causes mount to attempt to execute:
+.br
+       /sbin/mount_mfs -F 8 -N -s 4000 /dev/dk0b /tmp
+.PP
+Options are specified by a \fI-o\fP argument
+followed by a comma separated string of options.
+The following options apply to any file system that is being mounted:
+.IP "noexec" 12
+Do not allow execution of any binaries on the mounted file system.
+This options is useful for a server that has file systems containing
+binaries for architectures other than its own.
+.IP "nosuid" 12
+Do not allow set-user-identifier or set-group-identifier bits to take effect.
+.IP "nodev" 12
+Do not interpret character or block special devices on the file system.
+This options is useful for a server that has file systems containing
+special devices for architectures other than its own.
+.IP "synchronous" 12
+All I/O to the file system should be done synchronously.
+.PP
+The \fI-u\fP flag indicates that the status of an already mounted file
+system should be changed.
+Any of the options above may be changed;
+also a file system can be changed from read-only to read-write.
+The set of options is determined by first extracting the options
+for the file system from the \fIfstab\fP table,
+then applying any options specified by the \fI-o\fP argument,
+and finally applying the \fI-r\fP or \fI-w\fP option.
 .PP
+The following list can be used to override
+the defaults for an nfs mount:
 .IP "hard" 12
 I/O system calls will retry until the server responds (default)
 .IP "soft" 12
@@ -85,6 +149,12 @@ Set initial nfs timeout to \fI#\fP in 0.1 sec intervals.
 announces to the system that the removable file system \fInode\fP
 or whatever removable file system was previously mounted on device
 \fIspecial\fP should be removed.
+If the \fI-f\fP option is specified for
+.IR umount ,
+the file system is forcibly unmounted.
+Active special devices continue to work,
+but all other files return errors if further accesses are attempted.
+The root file system cannot be forcibly unmounted.
 .PP
 If the \fI-a\fP option is present for either
 .I mount
@@ -94,7 +164,7 @@ all of the file systems described in
 .I fstab
 are mounted or unmounted.
 .PP
-The system maintains a list of currently mounted filesystems.
+The system maintains a list of currently mounted file systems.
 If invoked without an argument,
 .I mount
 prints the list.
@@ -106,9 +176,9 @@ whether or not any explicit write is attempted.
 .SH FILES
 /etc/fstab     file system table
 .SH "SEE ALSO"
-mount(2), fstab(5)
+mount(2), unmount(2), fstab(5)
 .SH BUGS
 Mounting garbaged file systems will crash the system.
 .PP
 Mounting a root directory on a non-directory
-makes some apparently good pathnames invalid.
+makes some apparently good path names invalid.