81 lines
2.1 KiB
Groff
81 lines
2.1 KiB
Groff
.nh
|
|
.TH podman-unmount 1
|
|
.SH NAME
|
|
podman-unmount \- Unmount a working container's root filesystem
|
|
|
|
.SH SYNOPSIS
|
|
\fBpodman unmount\fP [\fIoptions\fP] \fIcontainer\fP [...]
|
|
|
|
.PP
|
|
\fBpodman umount\fP [\fIoptions\fP] \fIcontainer\fP [...]
|
|
|
|
.PP
|
|
\fBpodman container unmount\fP [\fIoptions\fP] \fIcontainer\fP [...]
|
|
|
|
.PP
|
|
\fBpodman container umount\fP [\fIoptions\fP] \fIcontainer\fP [...]
|
|
|
|
.SH DESCRIPTION
|
|
Unmounts the specified containers' root file system, if no other processes
|
|
are using it.
|
|
|
|
.PP
|
|
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.
|
|
|
|
.PP
|
|
Note: Podman can be used to unmount Podman containers as well as external containers.
|
|
External containers are containers created in container/storage by other tools like
|
|
Buildah and CRI-O.
|
|
|
|
.SH OPTIONS
|
|
.SS \fB--all\fP, \fB-a\fP
|
|
All of the currently mounted containers are unmounted.
|
|
|
|
.SS \fB--force\fP, \fB-f\fP
|
|
Force the unmounting of specified containers' root file system, even if other
|
|
processes have mounted it.
|
|
|
|
.PP
|
|
Note: Other processes can fail if the mount point they are using is removed without their knowledge.
|
|
|
|
.SS \fB--latest\fP, \fB-l\fP
|
|
Instead of providing the container name or ID, use the last created container.
|
|
Note: the last started container can be from other users of Podman on the host machine.
|
|
(This option is not available with the remote Podman client, including Mac and Windows
|
|
(excluding WSL2) machines)
|
|
|
|
.SH EXAMPLE
|
|
Unmount container with a given ID:
|
|
|
|
.EX
|
|
podman container unmount containerID
|
|
.EE
|
|
|
|
.PP
|
|
Unmount multiple containers with given IDs:
|
|
|
|
.EX
|
|
podman unmount containerID1 containerID2 containerID3
|
|
.EE
|
|
|
|
.PP
|
|
Unmount all containers:
|
|
|
|
.EX
|
|
podman unmount --all
|
|
.EE
|
|
|
|
.PP
|
|
Force umount container with given ID:
|
|
|
|
.EX
|
|
podman umount --force containerID
|
|
.EE
|
|
|
|
.SH SEE ALSO
|
|
\fBpodman(1)\fP, \fBpodman-mount(1)\fP, \fBpodman-image-mount(1)\fP
|