Scroll to navigation

podman-volume-ls(1) General Commands Manual podman-volume-ls(1)

NAME

podman-volume-ls - List all the available volumes

SYNOPSIS

podman volume ls [options]

DESCRIPTION

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

OPTIONS

--filter, -f=filter

Filter what volumes are shown in the output. Multiple filters can be given with multiple uses of the --filter flag. Filters with the same key work inclusive, with the only exception being label which is exclusive. Filters with different keys always work exclusive.

Volumes can be filtered by the following attributes:

Filter Description
dangling [Dangling] Matches all volumes not referenced by any containers
driver [Driver] Matches volumes based on their driver
label [Key] or [Key=Value] Label assigned to a volume
name [Name] Volume name (accepts regex)
opt Matches a storage driver options
scope Filters volume by scope
after/since Filter by volumes created after the given VOLUME (name or tag)
until Only remove volumes created before given timestamp

--format=format

Format volume output using Go template.

Valid placeholders for the Go template are listed below:

Placeholder Description
.Anonymous Indicates whether volume is anonymous
.CreatedAt ... Volume creation time
.Driver Volume driver
.GID GID of volume
.InspectVolumeData ... Don't use
.Labels ... Label information associated with the volume
.LockNumber Number of the volume's Libpod lock
.MountCount Number of times the volume is mounted
.Mountpoint Source of volume mount point
.Name Volume name
.NeedsChown Indicates whether volume needs to be chowned
.NeedsCopyUp Indicates if volume needs to be copied up to
.Options ... Volume options
.Scope Volume scope
.Status ... Status of the volume
.StorageID StorageID of the volume
.Timeout Timeout of the volume
.UID UID of volume
.VolumeConfigResponse ... Don't use

--help

Print usage statement.

--noheading, -n

Omit the table headings from the listing.

--quiet, -q

Print volume output in quiet mode. Only print the volume names.

EXAMPLES

List all volumes.

$ podman volume ls

List all volumes and display content as json format.

$ podman volume ls --format json

List all volumes and display their Driver and Scope fields

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

List volumes with the name foo and label blue.

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

List volumes with the label key=value.

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

SEE ALSO

podman(1), podman-volume(1)

HISTORY

November 2018, Originally compiled by Urvashi Mohnani umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩