mirror of
https://github.com/containers/podman.git
synced 2025-05-22 09:36:57 +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>
63 lines
1.7 KiB
Markdown
63 lines
1.7 KiB
Markdown
% podman-unmount 1
|
|
|
|
## NAME
|
|
podman\-unmount - Unmount a working container's root filesystem
|
|
|
|
## SYNOPSIS
|
|
**podman unmount** [*options*] *container* [...]
|
|
|
|
**podman umount** [*options*] *container* [...]
|
|
|
|
**podman container unmount** [*options*] *container* [...]
|
|
|
|
**podman container umount** [*options*] *container* [...]
|
|
|
|
## DESCRIPTION
|
|
Unmounts the specified containers' root file system, if no other processes
|
|
are using it.
|
|
|
|
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.
|
|
|
|
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.
|
|
|
|
## OPTIONS
|
|
#### **--all**, **-a**
|
|
|
|
All of the currently mounted containers will be unmounted.
|
|
|
|
#### **--force**, **-f**
|
|
|
|
Force the unmounting of specified containers' 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.
|
|
|
|
@@option latest
|
|
|
|
## EXAMPLE
|
|
|
|
Unmount container with a given ID
|
|
```
|
|
podman container unmount containerID
|
|
```
|
|
|
|
Unmount multiple containers with given IDs
|
|
```
|
|
podman unmount containerID1 containerID2 containerID3
|
|
```
|
|
|
|
Unmount all containers
|
|
```
|
|
podman unmount --all
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-mount(1)](podman-mount.1.md)**, **[podman-image-mount(1)](podman-image-mount.1.md)**
|