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

FreeBSD Manual Pages

  
 
  

home | help
podman-volume-rm(1)	    General Commands Manual	   podman-volume-rm(1)

NAME
       podman-volume-rm	- Remove one or	more volumes

SYNOPSIS
       podman volume rm	[options] volume [...]

DESCRIPTION
       Removes	one  or	more volumes. Only volumes that	are not	being used are
       removed.	 If a volume is	being used by a	container,  an	error  is  re-
       turned  unless  the  --force flag is being used.	To remove all volumes,
       use the --all flag.  Volumes can	be removed individually	 by  providing
       their full name or a unique partial name.

OPTIONS
   --all, -a
       Remove all volumes.

   --force, -f
       Remove  a volume	by force.  If it is being used by containers, the con-
       tainers are removed first.

   --help
       Print usage statement

   --time, -t=seconds
       Seconds to wait before forcibly stopping	running	 containers  that  are
       using the specified volume. The --force option must be specified	to use
       the --time option. Use -1 for infinite wait.

EXAMPLES
       Remove multiple specified volumes.

       $ podman	volume rm myvol1 myvol2

       Remove all volumes.

       $ podman	volume rm --all

       Remove  the  specified  volume even if it is in use. Note, this removes
       all containers using the	volume.

       $ podman	volume rm --force myvol

Exit Status
       0   All specified volumes removed

       1   One of the specified	volumes	did not	exist, and no other failures

       2   One of the specified	volumes	is being used by a container

       125 The command fails for any other reason

SEE ALSO
       podman(1), podman-volume(1)

HISTORY
       November	2018, Originally compiled  by  Urvashi	Mohnani	 umohnani@red-
       hat.com <mailto:umohnani@redhat.com>

							   podman-volume-rm(1)

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

home | help