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>
1.3 KiB
% 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