Annotation of cci/usr/src/man/man2/mount.2, revision 1.1.1.2

1.1       root        1: .TH MOUNT 2 "27 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: mount, umount \- mount or remove file system
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .ft B
                      8: mount(special, name, rwflag)
                      9: char *special, *name;
                     10: int rwflag;
                     11: .PP
                     12: .ft B
                     13: umount(special)
                     14: char *special;
                     15: .fi
                     16: .SH DESCRIPTION
                     17: .I Mount
                     18: announces to the system that a removable file system has
                     19: been mounted on
                     20: the block-structured special file
                     21: .I special;
                     22: from now on, references to file
                     23: .I name
1.1.1.2 ! root       24: refers to
1.1       root       25: the root file on the newly mounted file system.
                     26: .I Special
                     27: and
                     28: .I name
                     29: are pointers to null-terminated strings
                     30: containing the appropriate path names.
                     31: .PP
                     32: .I Name
                     33: must exist already. 
                     34: .I Name
                     35: must be a directory.
                     36: Its old contents
                     37: are inaccessible while the file system
                     38: is mounted.
                     39: .PP
                     40: The
                     41: .I rwflag
                     42: argument determines whether
                     43: the file system can be written on; if it is 0 writing
                     44: is allowed, if non-zero no writing is done.
                     45: Physically write-protected and magnetic
                     46: tape file systems must be mounted read-only or
1.1.1.2 ! root       47: errors occur when access times are updated,
1.1       root       48: whether or not any
                     49: explicit write or file removal is attempted.
                     50: Setting the write-protected button alone is not 
                     51: sufficient to notify the system of the intent.
                     52: .PP
                     53: .I Umount
                     54: announces to the system that the
                     55: .I special
                     56: file is no longer to contain a removable file system.
                     57: The associated file reverts to its ordinary interpretation.
                     58: .SH "RETURN VALUE
                     59: .I Mount
                     60: returns 0 if the action occurred, \-1 if
                     61: .I special
                     62: is inaccessible or not an appropriate file, if
                     63: .I name
                     64: does not exist, if
                     65: .I special
                     66: is already mounted, if
                     67: .I name
                     68: is in use, or if
                     69: there are already too many
                     70: file systems mounted.
                     71: .PP
                     72: .I Umount
                     73: returns 0 if the action occurred; \-1 if
1.1.1.2 ! root       74: the special file is inaccessible or,
1.1       root       75: does not have a mounted file system,
                     76: or if there are active files in the mounted 
                     77: file system.
                     78: .SH ERRORS
                     79: .I Mount
1.1.1.2 ! root       80: fails when one of the following occurs:
1.1       root       81: .TP 15
                     82: [NODEV]
                     83: The caller is not the super-user.
                     84: .TP 15
                     85: [NODEV]
                     86: .I Special
                     87: does not exist.
                     88: .TP 15
                     89: [ENOTBLK]
                     90: .I Special
                     91: is not a block device.
                     92: .TP 15
                     93: [ENXIO]
                     94: The major device number of 
                     95: .I special
                     96: is out of range (this indicates no device driver exists
                     97: for the associated hardware).
                     98: .TP 15
                     99: [EPERM]
                    100: The pathname contains a character with the high-order bit set.
                    101: .TP 15
                    102: [ENOTDIR]
                    103: A component of the path prefix in
                    104: .I name
                    105: is not a directory.
                    106: .TP 15
                    107: [EROFS]
                    108: .I Name
                    109: resides on a read-only file system.
                    110: .TP 15
                    111: [EBUSY]
                    112: .I Name
                    113: is not a directory, or another process currently
                    114: holds a reference to it.
                    115: .TP 15
                    116: [EBUSY]
                    117: No space remains in the mount table.
                    118: .TP 15
                    119: [EBUSY]
                    120: The super block for the file system had a bad magic
                    121: number or an out of range block size.
                    122: .TP 15
                    123: [EBUSY]
                    124: Not enough memory was available to read the cylinder
                    125: group information for the file system.
                    126: .TP 15
                    127: [EBUSY]
                    128: An i/o error occurred while reading the super block or
                    129: cylinder group information.
                    130: .PP
                    131: .I Umount
                    132: may fail with one of the following errors:
                    133: .TP 15
                    134: [NODEV]
                    135: The caller is not the super-user.
                    136: .TP 15
                    137: [NODEV]
                    138: .I Special
                    139: does not exist.
                    140: .TP 15
                    141: [ENOTBLK]
                    142: .I Special
                    143: is not a block device.
                    144: .TP 15
                    145: [ENXIO]
                    146: The major device number of 
                    147: .I special
                    148: is out of range (this indicates no device driver exists
                    149: for the associated hardware).
                    150: .TP 15
                    151: [EINVAL]
                    152: The requested device is not in the mount table.
                    153: .TP 15
                    154: [EBUSY]
                    155: A process is holding a reference to a file located
                    156: on the file system.
                    157: .SH "SEE ALSO"
                    158: mount(8), umount(8)
                    159: .SH BUGS
                    160: The error codes are in a state of disarray; too many errors
                    161: appear to the caller as one value.

unix.superglobalmegacorp.com

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