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
       filter, 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 la- |
       |	     | bels.			  |
       +-------------+----------------------------+
       | name	     | [String]	Only remove  vol- |
       |	     | ume 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 |
       |	     | volumes	 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 vol-
       umes 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 machines
       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@red-
       hat.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+14.3.quarterly>

home | help