MOUNT(2) COMMAND REFERENCE MOUNT(2)
NAME
mount, umount - mount or remove file system
SYNOPSIS
mount(special, path, rwflag)
char *special, *path;
int rwflag;
umount(special)
char *special;
DESCRIPTION
Mount announces to the system that a removable file system
has been mounted on the block special file special. After
successful completion, references to file path will refer to
the root file on the newly mounted file system. Special and
path are pointers to null-terminated strings containing the
appropriate pathnames.
Path must exist already. Path must be a directory. Its old
contents are inaccessible while the file system is mounted.
The rwflag argument is used to control write permission on
the mounted file system. If rwflag is 0, writing is
allowed. If it is non-zero, no writing can be done.
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.
Umount announces to the system that the special file is no
longer to contain a removable file system. The associated
file reverts to its ordinary interpretation.
These calls are limited to the super-user.
DIAGNOSTICS
Mount and umount will fail when one of the following occurs:
[EPERM]
The caller is not the super-user.
[ENOENT]
Special or path does not exist.
[ENOENT]
A component of the path prefix of special or path does
not exist.
[ENAMETOOLONG]
The argument special or path is too long.
Printed 10/17/86 1
MOUNT(2) COMMAND REFERENCE MOUNT(2)
[ENOTBLK]
Special is not a block device.
[ENXIO]
The major device number of special is out of range (this
indicates no device driver exists for the associated
hardware).
[ENOASCII]
The pathname special or path contains a character with
the high-order bit set.
[ELOOP]
Too many symbolic links were encountered in translating
a pathname.
[EDFSREF]
Path may not reference a file system on another host.
[EIO]
An I/O error occured while reading from or writing to
the file system.
In addition, mount will fail when one or more of the
following occurs:
[ENOTDIR]
Path is not a directory.
[EBUSY]
Another process currently holds a reference to path.
[ENOMEM]
No space remains in the mount table.
[EINVAL]
The super block for the file system has a bad magic
number or an out-of-range block size.
[ENOMEM]
Not enough memory is available to read the cylinder
group information for the file system.
[EIO]
An I/O error occurred while reading the super block or
cylinder group information.
[EIO]
An I/O error occurred while accessing the device.
[EACCES]
Search permission is denied for a component of the
Printed 10/17/86 2
MOUNT(2) COMMAND REFERENCE MOUNT(2)
pathname prefix of path or special.
[EFAULT]
Special or path points outside the process's allocated
address space.
In addition, umount will fail when one or more of the
following occurs:
[EINVAL]
The requested device is not in the mount table.
[EBUSY]
A process is holding a reference to a file located on
the file system.
[EACCES]
Search permission is denied for a component of the
pathname prefix of special.
[EFAULT]
Special points outside the process's allocated address
space.
RETURN VALUE
Upon successful completion, a value of 0 is returned.
Otherwise, a value of -1 is returned and errno is set to
indicate the error.
SEE ALSO
mount(8), umount(8).
Printed 10/17/86 3
%%index%%
na:72,79;
sy:151,676;
de:827,1340;
di:2167,561;2872,1490;4506,722;
rv:5228,236;
se:5464,124;
%%index%%000000000126