Annotation of 43BSDReno/sbin/mount/mount.8, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980, 1989 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"    @(#)mount.8     6.15 (Berkeley) 6/24/90
                     19: .\"
                     20: .TH MOUNT 8 "June 24, 1990"
                     21: .UC 4
                     22: .SH NAME
                     23: mount, umount \- mount and dismount file systems
                     24: .SH SYNOPSIS
                     25: .B mount
                     26: [
                     27: .B \-afrwu
                     28: ] [
                     29: .B \-t
                     30: nfs | ufs | external_type
                     31: ]
                     32: .br
                     33: .B mount
                     34: [
                     35: .B \-frwu
                     36: ]
                     37: special | node
                     38: .br
                     39: .B mount
                     40: [
                     41: .B \-frwu
                     42: ] [
                     43: .B \-t
                     44: nfs | ufs | external_type
                     45: ] [
                     46: .B \-o
                     47: options
                     48: ]
                     49: special node
                     50: .br
                     51: .PP
                     52: .B umount
                     53: [
                     54: .B \-af
                     55: ] [
                     56: .B \-t
                     57: nfs | ufs | external_type
                     58: ]
                     59: .br
                     60: .B umount
                     61: [
                     62: .B \-f
                     63: ]
                     64: special | node
                     65: .br
                     66: .SH DESCRIPTION
                     67: .I Mount
                     68: announces to the system that a removable file system is present on the
                     69: block device \fIspecial\fP or the remote node ``rhost:path''. 
                     70: The file \fInode\fP must exist already and
                     71: it must be a directory.  It becomes the name of the newly mounted root.
                     72: The optional arguments \fI-r\fP and \fI-w\fP indicate that the file
                     73: system is to be mounted read-only or read-write, respectively.
                     74: If either \fIspecial\fP or \fIfile\fP are not provided, the appropriate
                     75: information is taken from the \fIfstab\fP file.  The \fI-f\fP option
                     76: causes everything to be done except for the actual system call; if it's
                     77: not obvious, this ``fakes'' mounting the file system.
                     78: This option is useful in conjunction with the \fI-v\fP flag to
                     79: determine what the
                     80: .I mount
                     81: command is trying to do.
                     82: .PP
                     83: The optional argument \fI-t\fP can be used
                     84: to indicate the file system type.
                     85: The type \fBufs\fP is the default.
                     86: If the type is not one of the internally known types,
                     87: mount will attempt to execute a program in
                     88: .B /sbin/mount_XXX
                     89: where \fBXXX\fP is replaced by the type name.
                     90: The standard mount options (see below) are parsed and
                     91: passed to external program via the \fI-F\fP option
                     92: as a decimal number.
                     93: Any additional options specific to the program can
                     94: be passed as a comma separated list;
                     95: these options are distinguished by starting with a \fI-\fP (dash).
                     96: Those options that take a value are specified
                     97: using the syntax -option=value.
                     98: For example, the mount command:
                     99: .br
                    100:        mount -t mfs -o nosuid,-N,-s=4000 /dev/dk0b /tmp
                    101: .br
                    102: causes mount to attempt to execute:
                    103: .br
                    104:        /sbin/mount_mfs -F 8 -N -s 4000 /dev/dk0b /tmp
                    105: .PP
                    106: Options are specified by a \fI-o\fP argument
                    107: followed by a comma separated string of options.
                    108: The following options apply to any file system that is being mounted:
                    109: .IP "noexec" 12
                    110: Do not allow execution of any binaries on the mounted file system.
                    111: This options is useful for a server that has file systems containing
                    112: binaries for architectures other than its own.
                    113: .IP "nosuid" 12
                    114: Do not allow set-user-identifier or set-group-identifier bits to take effect.
                    115: .IP "nodev" 12
                    116: Do not interpret character or block special devices on the file system.
                    117: This options is useful for a server that has file systems containing
                    118: special devices for architectures other than its own.
                    119: .IP "synchronous" 12
                    120: All I/O to the file system should be done synchronously.
                    121: .PP
                    122: The \fI-u\fP flag indicates that the status of an already mounted file
                    123: system should be changed.
                    124: Any of the options above may be changed;
                    125: also a file system can be changed from read-only to read-write.
                    126: The set of options is determined by first extracting the options
                    127: for the file system from the \fIfstab\fP table,
                    128: then applying any options specified by the \fI-o\fP argument,
                    129: and finally applying the \fI-r\fP or \fI-w\fP option.
                    130: .PP
                    131: The following list can be used to override
                    132: the defaults for an nfs mount:
                    133: .IP "hard" 12
                    134: I/O system calls will retry until the server responds (default)
                    135: .IP "soft" 12
                    136: I/O system calls will fail and return errno after \fIretrans\fP request
                    137: retransmissions
                    138: .IP "spongy" 12
                    139: Soft semantics for the stat, lookup, fsstat, readlink and readdir
                    140: filesystem operations and hard semantics for the others.
                    141: This option is meant to be similar to hard,
                    142: except that processes will not be hung forever when
                    143: they trip over mount points to dead servers.
                    144: .IP "bg" 12
                    145: If the first mount request times out, do retries in background
                    146: .IP "intr" 12
                    147: I/O system calls can be interrupted.
                    148: .IP "noconn" 12
                    149: Do not connect the socket.
                    150: Used for UDP servers that send replies from a
                    151: socket other than the nfs server socket.
                    152: .IP "tcp" 12
                    153: Use TCP transport instead of UDP.
                    154: .IP "rsize=#" 12
                    155: Set read size to \fI#\fP bytes.
                    156: .IP "wsize=#" 12
                    157: Set write size to \fI#\fP bytes.
                    158: .IP "retry=#" 12
                    159: Set mount retry count to \fI#\fP.
                    160: .IP "retrans=#" 12
                    161: Set retransmission count for nfs rpc's to \fI#\fP.
                    162: .IP "timeo=#" 12
                    163: Set initial nfs timeout to \fI#\fP in 0.1 sec intervals.
                    164: .fi
                    165: .PP
                    166: .I Umount
                    167: announces to the system that the removable file system \fInode\fP
                    168: or whatever removable file system was previously mounted on device
                    169: \fIspecial\fP should be removed.
                    170: If the \fI-f\fP option is specified for
                    171: .IR umount ,
                    172: the file system is forcibly unmounted.
                    173: Active special devices continue to work,
                    174: but all other files return errors if further accesses are attempted.
                    175: The root file system cannot be forcibly unmounted.
                    176: .PP
                    177: If the \fI-a\fP option is present for either
                    178: .I mount
                    179: or
                    180: .I umount,
                    181: all of the file systems described in
                    182: .I fstab
                    183: are mounted or unmounted.
                    184: The optional argument \fI-t\fP can be used
                    185: to indicate that the actions should only be taken on
                    186: filesystems of the specified type.
                    187: More than one type may be specified in a comma separated list.
                    188: The list of filesystem types can be prefixed with ``no'' to
                    189: specify the filesystem types on which no action should be taken.
                    190: For example, the mount command:
                    191: .br
                    192:        mount -a -t nonfs,mfs
                    193: .br
                    194: mounts all filesystems except those of type NFS and MFS.
                    195: .PP
                    196: The system maintains a list of currently mounted file systems.
                    197: If invoked without an argument,
                    198: .I mount
                    199: prints the list.
                    200: The optional argument \fI-t\fP can be used
                    201: to indicate that only filesystems of the specified type
                    202: should be listed.
                    203: More than one type may be specified in a comma separated list.
                    204: The list of filesystem types can be prefixed with ``no'' to
                    205: indicate the types of filesystems to be excluded from the listing.
                    206: .PP
                    207: Physically write-protected and magnetic tape file
                    208: systems must be mounted read-only
                    209: or errors will occur when access times are updated,
                    210: whether or not any explicit write is attempted.
                    211: .SH FILES
                    212: /etc/fstab     file system table
                    213: .SH "SEE ALSO"
                    214: mount(2), unmount(2), fstab(5)
                    215: .SH BUGS
                    216: Mounting garbaged file systems will crash the system.
                    217: .PP
                    218: Mounting a root directory on a non-directory
                    219: makes some apparently good path names invalid.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.