64 lines
1.4 KiB
Groff
64 lines
1.4 KiB
Groff
.nh
|
|
.TH podman-image-unmount 1
|
|
.SH NAME
|
|
podman-image-unmount \- Unmount an image's root filesystem
|
|
|
|
.SH SYNOPSIS
|
|
\fBpodman image unmount\fP [\fIoptions\fP] \fIimage\fP [...]
|
|
|
|
.PP
|
|
\fBpodman image umount\fP [\fIoptions\fP] \fIimage\fP [...]
|
|
|
|
.SH DESCRIPTION
|
|
Unmounts the specified images' root file system, if no other processes
|
|
are using it.
|
|
|
|
.PP
|
|
Image storage increments a mount counter each time an image is mounted.
|
|
When an image is unmounted, the mount counter is decremented, and the
|
|
image'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.
|
|
|
|
.SH OPTIONS
|
|
.SS \fB--all\fP, \fB-a\fP
|
|
All of the currently mounted images are unmounted.
|
|
|
|
.SS \fB--force\fP, \fB-f\fP
|
|
Force the unmounting of specified images' root file system, even if other
|
|
processes have mounted it.
|
|
|
|
.PP
|
|
Note: Other processes using the file system can fail if the mount point is removed without their knowledge.
|
|
|
|
.SH EXAMPLE
|
|
Unmount image with a given ID:
|
|
|
|
.EX
|
|
podman image unmount imageID
|
|
.EE
|
|
|
|
.PP
|
|
Unmount multiple images with given IDs:
|
|
|
|
.EX
|
|
podman image unmount imageID1 imageID2 imageID3
|
|
.EE
|
|
|
|
.PP
|
|
Unmount all images:
|
|
|
|
.EX
|
|
podman image unmount --all
|
|
.EE
|
|
|
|
.PP
|
|
Force unmount image with a given ID:
|
|
|
|
.EX
|
|
podman image unmount --force imageID
|
|
.EE
|
|
|
|
.SH SEE ALSO
|
|
\fBpodman(1)\fP, \fBpodman-image-mount(1)\fP, \fBpodman-mount(1)\fP
|