do not trim leading pathname from special device name
[unix-history] / usr / src / sbin / mount / mount.8
index 3781881..551b4e5 100644 (file)
-.\" 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     5.1 (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.
 .\"
 .\"
-.TH MOUNT 8  "4 February 1983"
+.\"    @(#)mount.8     6.11 (Berkeley) %G%
+.\"
+.TH MOUNT 8 ""
 .UC 4
 .SH NAME
 .UC 4
 .SH NAME
-mount, umount \- mount and dismount file system
+mount, umount \- mount and dismount file systems
 .SH SYNOPSIS
 .SH SYNOPSIS
-.B /etc/mount
-[ special name [
-.B \-r
-] ]
-.PP
-.B /etc/mount
-.B \-a
-.PP
-.B /etc/umount
-special
+.B mount
+[
+.B \-afrwu
+]
+.br
+.B mount
+[
+.B \-frwu
+]
+special | node
+.br
+.B mount
+[
+.B \-frwu
+] [
+.B \-t
+nfs | ufs | external_type
+] [
+.B \-o
+options
+]
+special node
+.br
 .PP
 .PP
-.B /etc/umount
+.B umount
+[
 .B \-a
 .B \-a
+] [
+.B \-f
+]
+.br
+.B umount
+[
+.B \-f
+]
+special | node
+.br
 .SH DESCRIPTION
 .I Mount
 .SH DESCRIPTION
 .I Mount
-announces to the system that a removable file system
-is present on the device
-.I special.
-The file
-.I name
-must exist already; it
-must be a directory (unless the root of the
-mounted file system is not a directory).
-It becomes the name of the newly mounted root.
-The optional argument
-.B \-r
-indicates that the file system
-is to be mounted read-only.
+announces to the system that a removable file system is present on the
+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
+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.
+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
+I/O system calls will fail and return errno after \fIretrans\fP request
+retransmissions
+.IP "bg" 12
+If the first mount request times out, do retries in background
+.IP "intr" 12
+I/O system calls can be interrupted.
+.IP "rsize=#" 12
+Set read size to \fI#\fP bytes.
+.IP "wsize=#" 12
+Set write size to \fI#\fP bytes.
+.IP "retry=#" 12
+Set mount retry count to \fI#\fP.
+.IP "retrans=#" 12
+Set retransmission count for nfs rpc's to \fI#\fP.
+.IP "timeo=#" 12
+Set initial nfs timeout to \fI#\fP in 0.1 sec intervals.
+.fi
 .PP
 .I Umount
 .PP
 .I Umount
-announces to the system that the removable file system previously
-mounted on device
-.I special
-is to be removed.
+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
 .PP
-If the
-.B \-a
-option is present for either
+If the \fI-a\fP option is present for either
 .I mount
 or
 .I umount,
 all of the file systems described in
 .I mount
 or
 .I umount,
 all of the file systems described in
-.I /etc/fstab
-are attempted to be mounted or unmounted.
-In this case,
-.I special
-and
-.I name
-are taken from
-.I /etc/fstab.
-The
-.I special
-file name from
-.I /etc/fstab
-is the block special name.
+.I fstab
+are mounted or unmounted.
 .PP
 .PP
-These commands
-maintain a table of mounted devices in
-.I /etc/mtab.
+The system maintains a list of currently mounted file systems.
 If invoked without an argument,
 .I mount
 If invoked without an argument,
 .I mount
-prints the table.
+prints the list.
 .PP
 Physically write-protected and magnetic tape file
 systems must be mounted read-only
 or errors will occur when access times are updated,
 whether or not any explicit write is attempted.
 .SH FILES
 .PP
 Physically write-protected and magnetic tape file
 systems must be mounted read-only
 or errors will occur when access times are updated,
 whether or not any explicit write is attempted.
 .SH FILES
-/etc/mtab      mount table
-.br
 /etc/fstab     file system table
 .SH "SEE ALSO"
 /etc/fstab     file system table
 .SH "SEE ALSO"
-mount(2),
-mtab(5), fstab(5)
+mount(2), unmount(2), fstab(5)
 .SH BUGS
 .SH BUGS
-Mounting file systems full of garbage will crash the system.
-.br
+Mounting garbaged file systems will crash the system.
+.PP
 Mounting a root directory on a non-directory
 Mounting a root directory on a non-directory
-makes some apparently good pathnames invalid.
+makes some apparently good path names invalid.