7d71d24440
Support the `--pod-id-file` flag in the rm, start and stop pod commands. This completes the already support flag in pod-create and is another prerequisite for generating generic systemd unit files for pods. Also add completions, docs and tests. Signed-off-by: Valentin Rothberg <rothberg@redhat.com>
1.4 KiB
% 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
SEE ALSO
podman-pod(1)
HISTORY
July 2018, Originally compiled by Peter Hunt pehunt@redhat.com