Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
podman-pod-rm(1)	    General Commands Manual	      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	removes	 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. If  all  con-
       tainers added by	the user are in	an exited state, the pod is removed.

OPTIONS
   --all, -a
       Remove all pods.	 Can be	used in	conjunction with -f as well.

   --force, -f
       Stop  running  containers  and delete all stopped containers before re-
       moval of	pod.

   --ignore, -i
       Ignore errors when specified pods are not in the	 container  store.   A
       user might have decided to manually remove a pod	which leads to a fail-
       ure during the ExecStop directive of a systemd service referencing that
       pod.

   --latest, -l
       Instead	of  providing  the  pod	 name or ID, use the last created pod.
       Note: the last started pod can be from other users  of  Podman  on  the
       host  machine.	(This  option  is not available	with the remote	Podman
       client, including Mac and Windows (excluding WSL2) machines)

   --pod-id-file=file
       Read pod	ID from	the specified file and rm the pod.  Can	 be  specified
       multiple	times.

       If specified, the pod-id-file is	removed	along with the pod.

   --time, -t=seconds
       Seconds	to wait	before forcibly	stopping running containers within the
       pod.  Use -1 for	infinite wait.

       The --force option must be specified to use the --time option.

EXAMPLE
       Remove pod with a given name:

       podman pod rm mywebserverpod

       Remove multiple pods with given names and/or IDs:

       podman pod rm mywebserverpod myflaskserverpod 860a4b23

       Forcefully remove pod with a given ID:

       podman pod rm -f	860a4b23

       Forcefully remove all pods:

       podman pod rm -f	-a
       podman pod rm -fa

       Remove pod using	ID specified in	a given	file:

       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(1), podman-pod(1)

HISTORY
       July  2018,  Originally	compiled  by  Peter   Hunt   pehunt@redhat.com
       <mailto:pehunt@redhat.com>

							      podman-pod-rm(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-pod-rm&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help