mirror of
https://github.com/containers/podman.git
synced 2025-11-02 23:39:52 +08:00
22474095ab
In podman containers rm and podman images rm, the commands exit with error code 1 if the object does not exists. This PR implements similar functionality to volumes, networks, and Pods. Similarly if volumes or Networks are in use by other containers, and return exit code 2. Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
66 lines
1.6 KiB
Markdown
66 lines
1.6 KiB
Markdown
% podman-pod-rm(1)
|
|
|
|
## NAME
|
|
podman\-pod\-rm - Remove one or more stopped pods and containers
|
|
|
|
## SYNOPSIS
|
|
**podman pod rm** [*options*] *pod*
|
|
|
|
## DESCRIPTION
|
|
**podman pod rm** will remove one or more stopped pods and their containers from the host. The pod name or ID can be used. The \-f option stops all containers and then removes them before removing the pod.
|
|
|
|
## OPTIONS
|
|
|
|
**--all**, **-a**
|
|
|
|
Remove all pods. Can be used in conjunction with \-f as well.
|
|
|
|
**--ignore**, **-i**
|
|
|
|
Ignore errors when specified pods are not in the container store. A user might
|
|
have decided to manually remove a pod which would lead to a failure during the
|
|
ExecStop directive of a systemd service referencing that pod.
|
|
|
|
**--latest**, **-l**
|
|
|
|
Instead of providing the pod name or ID, remove the last created pod.
|
|
|
|
The latest option is not supported on the remote client.
|
|
|
|
**--force**, **-f**
|
|
|
|
Stop running containers and delete all stopped containers before removal of pod.
|
|
|
|
**--pod-id-file**
|
|
|
|
Read pod ID from the specified file and remove the pod. Can be specified multiple times.
|
|
|
|
## EXAMPLE
|
|
|
|
podman pod rm mywebserverpod
|
|
|
|
podman pod rm mywebserverpod myflaskserverpod 860a4b23
|
|
|
|
podman pod rm -f 860a4b23
|
|
|
|
podman pod rm -f -a
|
|
|
|
podman pod rm -fa
|
|
|
|
podman pod rm --pod-id-file /path/to/id/file
|
|
|
|
## Exit Status
|
|
**0** All specified pods removed
|
|
|
|
**1** One of the specified pods did not exist, and no other failures
|
|
|
|
**2** One of the specified pods is attached to a container
|
|
|
|
**125** The command fails for any other reason
|
|
|
|
## SEE ALSO
|
|
podman-pod(1)
|
|
|
|
## HISTORY
|
|
July 2018, Originally compiled by Peter Hunt <pehunt@redhat.com>
|