mirror of
https://github.com/containers/podman.git
synced 2025-06-05 14:06:01 +08:00
d92bfd244f
The man-page cross-reference script checks the SEE ALSO section to confirm that all references are to existing man pages (#12258). However, it's a little too forgiving: it allows aliases, the short '.so' files under the 'links/' subdirectory. That means we could link to non-default command names, and were doing so. As of this PR, we no longer allow that. Any podman command referenced in SEE ALSO must be the canonical command name (and man page). Fix existing non-canonical names, and remove the exception so we don't allow this again. See #16848 for discussion of context. Signed-off-by: Ed Santiago <santiago@redhat.com>
52 lines
1.3 KiB
Markdown
52 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 will be unmounted.
|
|
|
|
#### **--force**, **-f**
|
|
|
|
Force the unmounting of specified images' 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
|
|
|
|
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)**
|