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

FreeBSD Manual Pages

  
 
  

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

NAME
     podman-volume-prune - Remove all unused volumes

SYNOPSIS
     podman volume prune [options]

DESCRIPTION
     Removes  unused  volumes.	By  default  all unused volumes are removed, the
     --filter flag can be used to filter specific volumes. Users are prompted to
     confirm the removal of all the unused volumes. To bypass the  confirmation,
     use the --force flag.

OPTIONS
   --filter
     Provide filter values.

     The filters argument format is of key=value. If there is more than one fil-
     ter, then pass multiple OPTIONS: --filter foo=bar --filter bif=baz.

     Supported filters:

     +-------------+-----------------------------+
     | Filter	   | Description		 |
     +-------------+-----------------------------+
     | dangling    | [Bool]  Only remove volumes |
     |		   | not referenced by any  con- |
     |		   | tainers			 |
     +-------------+-----------------------------+
     | driver	   | [String]  Only  remove vol- |
     |		   | umes with the given driver  |
     +-------------+-----------------------------+
     | label	   | [String] Only  remove  vol- |
     |		   | umes,  with (or without, in |
     |		   | the case of label!=[...] is |
     |		   | used) the specified labels. |
     +-------------+-----------------------------+
     | name	   | [String] Only remove volume |
     |		   | with the given name	 |
     +-------------+-----------------------------+
     | opt	   | [String] Only  remove  vol- |
     |		   | umes created with the given |
     |		   | options			 |
     +-------------+-----------------------------+
     | scope	   | [String]  Only  remove vol- |
     |		   | umes with the given scope	 |
     +-------------+-----------------------------+
     | until	   | [DateTime] Only remove vol- |
     |		   | umes created  before  given |
     |		   | timestamp. 		 |
     +-------------+-----------------------------+
     | after/since | [Volume]  Filter by volumes |
     |		   | created  after  the   given |
     |		   | VOLUME (name or tag)	 |
     +-------------+-----------------------------+

     The  label  filter  accepts  two  formats.  One  is  the  label=key  or la-
     bel=key=value, which removes volumes with the specified labels.  The  other
     format is the label!=key or label!=key=value, which removes volumes without
     the specified labels.

     The  until  filter can be Unix timestamps, date formatted timestamps, or Go
     duration strings (e.g. 10m, 1h30m) computed relative to the machineas time.

   --force, -f
     Do not prompt for confirmation.

   --help
     Print usage statement

EXAMPLES
     Prune all unused volumes.

     $ podman volume prune

     Prune all volumes. Note: this command will also remove all containers  that
     are using a volume.

     $ podman volume prune --force

     Prune all volumes that contain the specified label.

     $ podman volume prune --filter label=mylabel=mylabelvalue

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

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

							  podman-volume-prune(1)

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

home | help