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

     1  % podman-volume-ls(1)
     2  
     3  ## NAME
     4  podman\-volume\-ls - List all the available volumes
     5  
     6  ## SYNOPSIS
     7  **podman volume ls** [*options*]
     8  
     9  ## DESCRIPTION
    10  
    11  Lists all the volumes that exist. The output can be filtered using the **--filter**
    12  flag and can be formatted to either JSON or a Go template using the **--format**
    13  flag. Use the **--quiet** flag to print only the volume names.
    14  
    15  ## OPTIONS
    16  
    17  #### **--filter**=*filter*, **-f**
    18  
    19  Volumes can be filtered by the following attributes:
    20  
    21  | **Filter** | **Description**                                                                       |
    22  | ---------- | ------------------------------------------------------------------------------------- |
    23  | dangling   | [Dangling] Matches all volumes not referenced by any containers                       |
    24  | driver     | [Driver] Matches volumes based on their driver                                        |
    25  | label      | [Key] or [Key=Value] Label assigned to a volume                                       |
    26  | name       | [Name] Volume name (accepts regex)                                                    |
    27  | opt        | Matches a storage driver options                                                      |
    28  | scope      | Filters volume by scope                                                               |
    29  | until      | Only remove volumes created before given timestamp                                    |
    30  
    31  #### **--format**=*format*
    32  
    33  Format volume output using Go template.
    34  
    35  #### **--help**
    36  
    37  Print usage statement.
    38  
    39  #### **--noheading**
    40  
    41  Omit the table headings from the listing of volumes.
    42  
    43  #### **--quiet**, **-q**
    44  
    45  Print volume output in quiet mode. Only print the volume names.
    46  
    47  ## EXAMPLES
    48  
    49  ```
    50  $ podman volume ls
    51  
    52  $ podman volume ls --format json
    53  
    54  $ podman volume ls --format "{{.Driver}} {{.Scope}}"
    55  
    56  $ podman volume ls --filter name=foo,label=blue
    57  
    58  $ podman volume ls --filter label=key=value
    59  ```
    60  
    61  ## SEE ALSO
    62  **[podman(1)](podman.1.md)**, **[podman-volume(1)](podman-volume.1.md)**
    63  
    64  ## HISTORY
    65  November 2018, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>