umount(2)umount(2)NAMEumount(), umount2() - unmount a file system
SYNOPSISDESCRIPTION
requests that a previously mounted file system contained on the block
special device identified by name be unmounted.
requests that a previously mounted file system contained on the block
special device identified by name be unmounted in the manner described
in flags.
name is a pointer to a path name.
flags is a bitmask of flags, specified in that are combined to describe
the type of unmount to be performed. Valid flags are:
perform a normal unmount
perform a forced unmount
MS_NORMAL and MS_FORCE are mutually exclusive.
A forced unmount is one which will occur regardless of activity on the
file system.
After unmounting the file system, the directory upon which the file
system was mounted reverts to its ordinary interpretation.
and 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.
and 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, and return a value of Otherwise, they return a value of
−1 and set to indicate the error.
ERRORS
and fail if one or more of the following are true:
A component of the path prefix of
name denies search permission.
A file on name is busy.
name points outside the allocated address space of the
process. Reliable detection of this error is implemen‐
tation dependent.
name is not mounted.
flags is not a valid combination of flags.
Too many symbolic links were encountered in translating the path
name.
name exceeds bytes, or a component of name exceeds bytes
while is in effect.
name does not exist.
name is null.
A forced unmount was requested on a file system that does not
support it.
name is not a block special device.
A component of name is not a directory.
The device associated with
name does not exist.
The effective user ID of the process
is not that of a user with appropriate privileges.
SEE ALSOmount(1M), mount(2), privileges(5).
STANDARDS CONFORMANCEumount(2)
