OS Manuals

/usr/bin/umount

Unmount filesystems

From umount 2.42.4-r2 (os), captured 2026-11-05 by running umount --help (exit 0). permalink

Usage:
 umount [-hV]
 umount -a [options]
 umount [options] <source> | <directory>

Unmount filesystems.

Options:
 -a, --all               unmount all filesystems
 -A, --all-targets       unmount all mountpoints for the given device in the
                           current namespace
 -c, --no-canonicalize   don't canonicalize paths
 -d, --detach-loop       if mounted loop device, also free this loop device
     --fake              dry run; skip the umount(2) syscall
 -f, --force             force unmount (in case of an unreachable NFS system)
 -i, --internal-only     don't call the umount.<type> helpers
 -n, --no-mtab           don't write to /etc/mtab
 -l, --lazy              detach the filesystem now, clean up things later
 -O, --test-opts <list>  limit the set of filesystems (use with -a)
 -R, --recursive         recursively unmount a target with all its children
 -r, --read-only         in case unmounting fails, try to remount read-only
 -t, --types <list>      limit the set of filesystem types
 -v, --verbose           say what is being done
 -q, --quiet             suppress 'not mounted' error messages
 -N, --namespace <ns>    perform umount in another namespace

 -h, --help              display this help
 -V, --version           display version

For more details see umount(8).
Options (18)
OptionDescriptionSource
-a, --allAll of the filesystems described in /proc/self/mountinfo (or in deprecated /etc/mtab) are unmounted, except the proc, devfs, devpts, sysfs, rpc_pipefs and nfsd filesystems.help + man
-A, --all-targetsUnmount all mountpoints in the current mount namespace for the specified filesystem.help + man
-c, --no-canonicalizeDo not canonicalize paths.help + man
-d, --detach-loopWhen the unmounted device was a loop device, also free this loop device.help + man
--fakeCauses everything to be done except for the actual system call or umount helper execution;help + man
-f, --forceForce an unmount (in case of an unreachable NFS system).help + man
-i, --internal-onlyDo not call the /sbin/umount.filesystem helper even if it exists.help + man
-n, --no-mtabUnmount without writing in /etc/mtab.help + man
-l, --lazydetach the filesystem now, clean up things laterhelp + man
-O, --test-opts listUnmount only the filesystems that have the specified option set in /etc/fstab.help + man
-R, --recursiverecursively unmount a target with all its childrenhelp + man
-r, --read-onlyWhen an unmount fails, try to remount the filesystem read-only.help + man
-t, --types listIndicate that the actions should only be taken on filesystems of the specified type.help + man
-v, --verbosesay what is being donehelp + man
-q, --quietSuppress "not mounted" error messages.help + man
-N, --namespace nsPerform umount in the mount namespace specified by ns.help + man
-h, --helpDisplay help text and exit.help + man
-V, --versionDisplay version and exit.help + man
Exit status (9) from the manual page
0success
1incorrect invocation or permissions
2system error (out of memory, cannot fork, no more loop devices)
4internal mount bug
8user interrupt
16problems writing or locking /etc/mtab
32mount failure
64some umount succeeded
126failed to execute external /sbin/umount.<type> mount helper (since util-linux v2.41)

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.