github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-volume-prune.1.md (about)

     1  % podman-volume-prune(1)
     2  
     3  ## NAME
     4  podman\-volume\-prune - Remove all unused volumes
     5  
     6  ## SYNOPSIS
     7  **podman volume prune** [*options*]
     8  
     9  ## DESCRIPTION
    10  
    11  Removes unused volumes. By default all unused volumes will be removed, the **--filter** flag can
    12  be used to filter specific volumes. You will be prompted to confirm the removal of all the
    13  unused volumes. To bypass the confirmation, use the **--force** flag.
    14  
    15  
    16  ## OPTIONS
    17  
    18  #### **--filter**
    19  
    20  Provide filter values.
    21  
    22  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*.
    23  
    24  Supported filters:
    25  
    26  | Filter             | Description                                                                 |
    27  | :----------------: | --------------------------------------------------------------------------- |
    28  | *label*            | Only remove volumes, with (or without, in the case of label!=[...] is used) the specified labels.                  |
    29  | *until*            | Only remove volumes created before given timestamp.           |
    30  
    31  The `label` *filter* accepts two formats. One is the `label`=*key* or `label`=*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.
    32  
    33  The `until` *filter* can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) computed relative to the machine’s time.
    34  
    35  #### **--force**, **-f**
    36  
    37  Do not prompt for confirmation.
    38  
    39  #### **--help**
    40  
    41  Print usage statement
    42  
    43  
    44  ## EXAMPLES
    45  
    46  ```
    47  $ podman volume prune
    48  
    49  $ podman volume prune --force
    50  
    51  $ podman volume prune --filter label=mylabel=mylabelvalue
    52  ```
    53  
    54  ## SEE ALSO
    55  **[podman(1)](podman.1.md)**, **[podman-volume(1)](podman-volume.1.md)**
    56  
    57  ## HISTORY
    58  November 2018, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>