docs: clarify that container prune excludes containers associated with pods

Fixes: #29213
Signed-off-by: Xiaowen-Yang <xiaowenyang52@gmail.com>
This commit is contained in:
Xiaowen-Yang 2026-09-03 20:48:30 +02:00
parent b6fb44a48a
commit 830c672adf
2 changed files with 6 additions and 6 deletions

View file

@ -1,13 +1,13 @@
% podman-container-prune 1
## NAME
podman\-container\-prune - Remove all stopped containers from local storage
podman\-container\-prune - Remove all stopped containers not associated with pods from local storage
## SYNOPSIS
**podman container prune** [*options*]
## DESCRIPTION
**podman container prune** removes all stopped containers from local storage.
**podman container prune** removes all stopped containers that are not associated with a pod from local storage.
## OPTIONS
#### **--filter**=*filters*
@ -41,7 +41,7 @@ Print usage statement.\
The default is **false**.
## EXAMPLES
Remove all stopped containers from local storage:
Remove all stopped containers not associated with pods from local storage:
```
$ podman container prune
WARNING! This will remove all stopped containers.
@ -54,7 +54,7 @@ fff1c5b6c3631746055ec40598ce8ecaa4b82aef122f9e3a85b03b55c0d06c23
602d343cd47e7cb3dfc808282a9900a3e4555747787ec6723bb68cedab8384d5
```
Remove all stopped containers from local storage without confirmation:
Remove all stopped containers not associated with pods from local storage without confirmation:
```
$ podman container prune -f
878392adf2e6c5c9bb1fc19b69d37d2e98c8abf9d539c0bce4b15b46bbcce471
@ -65,7 +65,7 @@ fff1c5b6c3631746055ec40598ce8ecaa4b82aef122f9e3a85b03b55c0d06c23
602d343cd47e7cb3dfc808282a9900a3e4555747787ec6723bb68cedab8384d5
```
Remove all stopped containers from local storage created before the last 10 minutes:
Remove all stopped containers not associated with pods from local storage created before the last 10 minutes:
```
$ podman container prune --filter until="10m"
WARNING! This will remove all stopped containers.

View file

@ -32,7 +32,7 @@ The container command allows management of containers
| mount | [podman-mount(1)](podman-mount.1.md) | Mount a working container's root filesystem. |
| pause | [podman-pause(1)](podman-pause.1.md) | Pause one or more containers. |
| port | [podman-port(1)](podman-port.1.md) | List port mappings for the container. |
| prune | [podman-container-prune(1)](podman-container-prune.1.md)| Remove all stopped containers from local storage. |
| prune | [podman-container-prune(1)](podman-container-prune.1.md)| Remove all stopped containers not associated with pods from local storage. |
| ps | [podman-ps(1)](podman-ps.1.md) | Print out information about containers. |
| rename | [podman-rename(1)](podman-rename.1.md) | Rename an existing container. |
| restart | [podman-restart(1)](podman-restart.1.md) | Restart one or more containers. |