From 830c672adf69d2f8903786c1793e0617dc4dfe32 Mon Sep 17 00:00:00 2001 From: Xiaowen-Yang Date: Thu, 3 Sep 2026 20:48:30 +0200 Subject: [PATCH] docs: clarify that container prune excludes containers associated with pods Fixes: #29213 Signed-off-by: Xiaowen-Yang --- docs/source/markdown/podman-container-prune.1.md | 10 +++++----- docs/source/markdown/podman-container.1.md | 2 +- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/source/markdown/podman-container-prune.1.md b/docs/source/markdown/podman-container-prune.1.md index b7142f0258..35224c495d 100644 --- a/docs/source/markdown/podman-container-prune.1.md +++ b/docs/source/markdown/podman-container-prune.1.md @@ -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. diff --git a/docs/source/markdown/podman-container.1.md b/docs/source/markdown/podman-container.1.md index 43c90f2af8..973159993f 100644 --- a/docs/source/markdown/podman-container.1.md +++ b/docs/source/markdown/podman-container.1.md @@ -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. |