|
|
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 ! 24: will refer to ! 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 ! 47: errors will occur when access times are updated, ! 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 ! 74: if the special file is inaccessible or ! 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 ! 80: will fail when one of the following occurs: ! 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.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.