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 re-
     moved.  If a volume is being used by a container, an error is returned  un-
     less  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 contain-
     ers 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@redhat.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+15.1.quarterly>

home | help