mirror of
https://github.com/containers/podman.git
synced 2025-11-01 02:42:11 +08:00
51 lines
1.3 KiB
Markdown
51 lines
1.3 KiB
Markdown
% podman-image-unmount 1
|
|
|
|
## NAME
|
|
podman\-image\-unmount - Unmount an image's root filesystem
|
|
|
|
## SYNOPSIS
|
|
**podman image unmount** [*options*] *image* [...]
|
|
|
|
**podman image umount** [*options*] *image* [...]
|
|
|
|
## DESCRIPTION
|
|
Unmounts the specified images' root file system, if no other processes
|
|
are using it.
|
|
|
|
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.
|
|
|
|
## OPTIONS
|
|
#### **--all**, **-a**
|
|
|
|
All of the currently mounted images are unmounted.
|
|
|
|
#### **--force**, **-f**
|
|
|
|
Force the unmounting of specified images' root file system, even if other
|
|
processes have mounted it.
|
|
|
|
Note: Other processes using the file system can fail if the mount point is removed without their knowledge.
|
|
|
|
## EXAMPLE
|
|
|
|
Unmount image with a given ID:
|
|
```
|
|
podman image unmount imageID
|
|
```
|
|
|
|
Unmount multiple images with given IDs:
|
|
```
|
|
podman image unmount imageID1 imageID2 imageID3
|
|
```
|
|
|
|
Unmount all images:
|
|
```
|
|
podman image unmount --all
|
|
```
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-image-mount(1)](podman-image-mount.1.md)**, **[podman-mount(1)](podman-mount.1.md)**
|