NAME
umount — unmount a file system
SYNOPSIS
#include <sys/mount.h>
int umount(const char *name);
DESCRIPTION
umount()
requests that a previously mounted file system
contained on the block special device identified by
name
be unmounted.
name
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()
can also request that a file system mounted
previously on the directory identified by
name
be unmounted.
After unmounting the file system,
name
reverts to its ordinary interpretation.
umount()
can be invoked only by the
user with the appropriate privilege.
NETWORKING FEATURES
NFS
path
must indicate a directory name when unmounting an
NFS
file system.
RETURN VALUE
If successful,
umount()
returns a value of
0.
Otherwise, it returns a value of -1 and sets
errno
to indicate the error.
ERRORS
umount()
fails if one or more of the following are true:
- [EPERM]
The effective user ID of the process
is not that of a
user with appropriate privileges.
- [ENOENT]
name
does not exist.
- [ENOTBLK]
name
is not a block special device.
- [EINVAL]
name
is not mounted.
- [EBUSY]
A file on
name
is busy.
- [EFAULT]
name
points outside the allocated address space of the process.
Reliable detection of this error is implementation dependent.
- [ENXIO]
The device associated with
name
does not exist.
- [ENOTDIR]
A component of
name
is not a directory.
- [ENOENT]
name
is null.
- [ENAMETOOLONG]
name
exceeds
PATH_MAX
bytes, or a component of
name
exceeds
NAME_MAX
bytes while
_POSIX_NO_TRUNC
is in effect.
- [EACCES]
A component of the path prefix of
name
denies search permission.
- [ELOOP]
Too many symbolic links were encountered in translating the path
name.
WARNINGS
If
umount()
is called from the program level (that is, not from the
mount(1M)
level), the table of mounted devices contained in
/etc/mnttab
is not updated automatically.
Updating of
/etc/mnttab
is performed by the
mount
and
syncer
commands (see
mount(1M)
and
syncer(1M)
for more information).
STANDARDS CONFORMANCE
umount(): SVID2, SVID3, XPG2