1podman-volume-ls(1)()                                    podman-volume-ls(1)()
2
3
4

NAME

6       podman-volume-ls - List all the available volumes
7
8

SYNOPSIS

10       podman volume ls [options]
11
12

DESCRIPTION

14       Lists  all the volumes that exist. The output can be filtered using the
15       --filter flag and can be formatted to either JSON or a Go template  us‐
16       ing  the  --format  flag. Use the --quiet flag to print only the volume
17       names.
18
19

OPTIONS

21   --filter=filter, -f
22       Volumes can be filtered by the following attributes:
23
24
25       ┌─────────┬────────────────────────────┐
26       │Filter   │ Description                │
27       ├─────────┼────────────────────────────┤
28       │dangling │ [Dangling]   Matches   all │
29       │         │ volumes  not referenced by │
30       │         │ any containers             │
31       ├─────────┼────────────────────────────┤
32       │driver   │ [Driver]  Matches  volumes │
33       │         │ based on their driver      │
34       ├─────────┼────────────────────────────┤
35       │label    │ [Key] or [Key=Value] Label │
36       │         │ assigned to a volume       │
37       ├─────────┼────────────────────────────┤
38       │name     │ [Name]  Volume  name  (ac‐ │
39       │         │ cepts regex)               │
40       ├─────────┼────────────────────────────┤
41       │opt      │ Matches  a  storage driver │
42       │         │ options                    │
43       ├─────────┼────────────────────────────┤
44       │scope    │ Filters volume by scope    │
45       ├─────────┼────────────────────────────┤
46       │until    │ Only remove  volumes  cre‐ │
47       │         │ ated  before  given  time‐ │
48       │         │ stamp                      │
49       └─────────┴────────────────────────────┘
50
51   --format=format
52       Format volume output using Go template.
53
54
55   --help
56       Print usage statement.
57
58
59   --noheading
60       Omit the table headings from the listing of volumes.
61
62
63   --quiet, -q
64       Print volume output in quiet mode. Only print the volume names.
65
66

EXAMPLES

68              $ podman volume ls
69
70              $ podman volume ls --format json
71
72              $ podman volume ls --format "{{.Driver}} {{.Scope}}"
73
74              $ podman volume ls --filter name=foo,label=blue
75
76              $ podman volume ls --filter label=key=value
77
78
79

SEE ALSO

81       podman(1), podman-volume(1)
82
83

HISTORY

85       November 2018, Originally compiled  by  Urvashi  Mohnani  umohnani@red‐
86       hat.com ⟨mailto:umohnani@redhat.com⟩
87
88
89
90                                                         podman-volume-ls(1)()