X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/blobdiff_plain/6b301b91b6381e7d716f904580b9cb5becfd1e52..11090caca7e889664a16bb2b0c3cb4b12e403f3e:/usr/src/sbin/mount/mount.8 diff --git a/usr/src/sbin/mount/mount.8 b/usr/src/sbin/mount/mount.8 index 3781881de0..551b4e5fa1 100644 --- a/usr/src/sbin/mount/mount.8 +++ b/usr/src/sbin/mount/mount.8 @@ -1,90 +1,184 @@ -.\" 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 -mount, umount \- mount and dismount file system +mount, umount \- mount and dismount file systems .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 -.B /etc/umount +.B umount +[ .B \-a +] [ +.B \-f +] +.br +.B umount +[ +.B \-f +] +special | node +.br .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 -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 -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 /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 -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 -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 -/etc/mtab mount table -.br /etc/fstab file system table .SH "SEE ALSO" -mount(2), -mtab(5), fstab(5) +mount(2), unmount(2), fstab(5) .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 -makes some apparently good pathnames invalid. +makes some apparently good path names invalid.