UMOUNT(S) UNIX System V UMOUNT(S)
Name
umount - unmount a file system
Syntax
int umount (file)
char *file;
Description
The umount system call requests that a previously mounted
file system contained on the block special device or
directory identified by file be unmounted. file is a
pointer to a path name. After unmounting the file system,
the directory upon which the file system was mounted reverts
to its ordinary interpretation.
The umount system call may be invoked only by the super-
user.
The umount system call will fail if one or more of the
following is true:
[EPERM] The process's effective user ID is not
super-user.
[EINVAL] file does not exist.
[ENOTBLK] file is not a block special device.
[EINVAL] file is not mounted.
[EBUSY] A file on file is busy.
[EFAULT] file points to an illegal address.
[EREMOTE] file is remote.
[ENOLINK] file is on a remote machine, and the link to
that machine is no longer active.
[EMULTIHOP] Components of the path pointed to by file
require hopping to multiple remote machines.
[ENOTDIR] A component of the path-prefix is not a
directory.
[ENOENT] The named file does not exist.
See Also
mount(S)
Diagnostics
Upon successful completion a value of 0 is returned.
Otherwise, a value of -1 is returned and errno is set to
indicate the error.
Standards Conformance
umount is conformant with:
AT&T SVID Issue 2, Select Code 307-127;
and The X/Open Portability Guide II of January 1987.
(printed 6/20/89)