From 8e1ef558eb324767ac46e452c80cc79f7ba2e9d2 Mon Sep 17 00:00:00 2001 From: Daniel J Walsh Date: Mon, 30 Jul 2018 09:04:18 -0400 Subject: Add --force to podman umount to force the unmounting of the rootfs podman umount will currently only unmount file system if not other process is using it, otherwise the umount decrements the container storage to indicate that the caller is no longer using the mount point, once the count gets to 0, the file system is actually unmounted. Signed-off-by: Daniel J Walsh Closes: #1184 Approved by: TomSweeneyRedHat --- docs/podman-umount.1.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/podman-umount.1.md b/docs/podman-umount.1.md index c13781dbf..70f30869a 100644 --- a/docs/podman-umount.1.md +++ b/docs/podman-umount.1.md @@ -7,13 +7,28 @@ podman\-umount - Unmount the specified working containers' root file system. **podman umount** *container* ... ## DESCRIPTION -Unmounts the specified containers' root file system. +Unmounts the specified containers' root file system, if no other processes +are using it. + +Container storage increments a mount counter each time a container is mounted. +When a container is unmounted, the mount counter is decremented and the +container's root filesystem is physically unmounted only when the mount +counter reaches zero indicating no other processes are using the mount. +An unmount can be forced with the --force flag. ## OPTIONS **--all, -a** All of the currently mounted containers will be unmounted. +**--force, -f** + +Force the unmounting of specified containers' root file system, even if other +processes have mounted it. + +Note: This could cause other processes that are using the file system to fail, +as the mount point could be removed without their knowledge. + ## EXAMPLE podman umount containerID -- cgit v1.2.3-54-g00ecf