summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDaniel J Walsh <dwalsh@redhat.com>2019-06-15 06:24:42 -0400
committerDaniel J Walsh <dwalsh@redhat.com>2019-08-01 03:40:29 -0400
commit5370d9cb76a8075332f5ab6a0efef9fba28ba19b (patch)
tree5f537b4a2a70c140aeb6533657c301fc5e9e2b7e /docs
parenta622f8d345b1853401de2e533e9fbf14ef169fa2 (diff)
downloadpodman-5370d9cb76a8075332f5ab6a0efef9fba28ba19b.tar.gz
podman-5370d9cb76a8075332f5ab6a0efef9fba28ba19b.tar.bz2
podman-5370d9cb76a8075332f5ab6a0efef9fba28ba19b.zip
Add new exit codes to rm & rmi for running containers & dependencies
This enables programs and scripts wrapping the podman command to handle 'podman rm' and 'podman rmi' failures caused by paused or running containers or due to images having other child images or dependent containers. These errors are common enough that it makes sense to have a more machine readable way of detecting them than parsing the standard error output. Signed-off-by: Ondrej Zoder <ozoder@redhat.com> Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/podman-rm.1.md3
-rw-r--r--docs/podman-rmi.1.md3
2 files changed, 4 insertions, 2 deletions
diff --git a/docs/podman-rm.1.md b/docs/podman-rm.1.md
index 32a8c2943..7f39c09ad 100644
--- a/docs/podman-rm.1.md
+++ b/docs/podman-rm.1.md
@@ -69,7 +69,8 @@ podman rm -f --latest
## Exit Status
**_0_** if all specified containers removed
**_1_** if one of the specified containers did not exist, and no other failures
-**_125_** if command fails for a reason other then an container did not exist
+**_2_** if one of the specified containers is paused or running
+**_125_** if the command fails for a reason other than container did not exist or is paused/running
## SEE ALSO
podman(1), podman-image-rm(1)
diff --git a/docs/podman-rmi.1.md b/docs/podman-rmi.1.md
index 2cba8a22d..6b242c94e 100644
--- a/docs/podman-rmi.1.md
+++ b/docs/podman-rmi.1.md
@@ -43,7 +43,8 @@ podman rmi -a -f
## Exit Status
**_0_** if all specified images removed
**_1_** if one of the specified images did not exist, and no other failures
-**_125_** if command fails for a reason other then an image did not exist
+**_2_** if one of the specified images has child images or is being used by a container
+**_125_** if the command fails for a reason other than an image did not exist or is in use
## SEE ALSO
podman(1)