umount(2)
umount --
unmount a file system
Synopsis
#include <sys/mount.h>
int umount(const char file);
Description
umount 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.
umount
may be invoked only by
a process with
the P_MOUNT privilege.
Return values
On success, umount returns 0.
On failure, umount returns -1 and sets errno to identify the error.
In the following conditions, umount fails and sets errno to:
EBUSY-
A file on file is busy.
EINVAL-
file
does not exist.
EINVAL-
file is not mounted.
ELOOP-
Too many symbolic links were encountered in translating the path
pointed to by file.
ENAMETOOLONG-
The length of the file argument exceeds {PATH_MAX}, or the
length of a file component exceeds {NAME_MAX} while
_POSIX_NO_TRUNC is in effect.
ENOTDIR-
file does not point to a directory.
ENOENT-
A component of the path prefix does not exist or is a null pathname.
ENOTBLK-
file
is not a block special device.
EPERM-
The calling process does not have the
P_MOUNT
privilege.
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.
References
mount(2)
Notices
umount will now resolve the mount_point argument
using
realpath(3C)
before any processing is performed.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004