.nh
.TH podman-volume-ls 1
.SH NAME
.PP
podman-volume-ls - List all the available volumes

.SH SYNOPSIS
.PP
\fBpodman volume ls\fP [\fIoptions\fP]

.SH DESCRIPTION
.PP
Lists all the volumes that exist. The output can be filtered using the \fB--filter\fP
flag and can be formatted to either JSON or a Go template using the \fB--format\fP
flag. Use the \fB--quiet\fP flag to print only the volume names.

.SH OPTIONS
.SS \fB--filter\fP, \fB-f\fP=\fIfilter\fP
.PP
Volumes can be filtered by the following attributes:

.TS
allbox;
l l 
l l .
\fB\fC\fBFilter\fP\fR	\fB\fC\fBDescription\fP\fR
dangling	T{
[Dangling] Matches all volumes not referenced by any containers
T}
driver	T{
[Driver] Matches volumes based on their driver
T}
label	T{
[Key] or [Key=Value] Label assigned to a volume
T}
name	T{
[Name] Volume name (accepts regex)
T}
opt	T{
Matches a storage driver options
T}
scope	Filters volume by scope
until	T{
Only remove volumes created before given timestamp
T}
.TE

.SS \fB--format\fP=\fIformat\fP
.PP
Format volume output using Go template.

.SS \fB--help\fP
.PP
Print usage statement.

.SS \fB--noheading\fP
.PP
Omit the table headings from the listing of volumes.

.SS \fB--quiet\fP, \fB-q\fP
.PP
Print volume output in quiet mode. Only print the volume names.

.SH EXAMPLES
.PP
.RS

.nf
$ podman volume ls

$ podman volume ls --format json

$ podman volume ls --format "{{.Driver}} {{.Scope}}"

$ podman volume ls --filter name=foo,label=blue

$ podman volume ls --filter label=key=value

.fi
.RE

.SH SEE ALSO
.PP
\fBpodman(1)\fP, \fBpodman-volume(1)\fP

.SH HISTORY
.PP
November 2018, Originally compiled by Urvashi Mohnani umohnani@redhat.com
\[la]mailto:umohnani@redhat.com\[ra]