summaryrefslogtreecommitdiff
path: root/docs/source/man/podman-umount.1.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/man/podman-umount.1.md')
-rw-r--r--docs/source/man/podman-umount.1.md55
1 files changed, 55 insertions, 0 deletions
diff --git a/docs/source/man/podman-umount.1.md b/docs/source/man/podman-umount.1.md
new file mode 100644
index 000000000..100c47b32
--- /dev/null
+++ b/docs/source/man/podman-umount.1.md
@@ -0,0 +1,55 @@
+% podman-umount(1)
+
+## NAME
+podman\-umount - Unmount a working container's root filesystem
+
+## SYNOPSIS
+**podman umount** *container* [...]
+
+**podman container umount** *container* [...]
+
+**podman container unmount** *container* [...]
+
+**podman unmount** *container* [...]
+
+## DESCRIPTION
+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.
+
+**--latest**, **-l**
+
+Instead of providing the container name or ID, use the last created container.
+If you use methods other than Podman to run containers such as CRI-O, the last
+started container could be from either of those methods.
+
+The latest option is not supported on the remote client.
+
+## EXAMPLE
+
+podman umount containerID
+
+podman umount containerID1 containerID2 containerID3
+
+podman umount --all
+
+## SEE ALSO
+podman(1), podman-mount(1)