opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2025-08-02 09:12:36 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
podman/docs/source/markdown/podman-volume-ls.1.md
Jakub Guzik 1e6d1e5c6b Add filter params description to volume list/prune docs 
Description adjusted to the standard seen in other man pages.
[CI:DOCS]

Signed-off-by: Jakub Guzik <jakubmguzik@gmail.com>
2021-08-26 17:09:06 +02:00

2.0 KiB
Raw Blame History

% 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=filter, -f

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
until Only remove volumes created before given timestamp

--format=format

Format volume output using Go template.

--help

Print usage statement.

--noheading

Omit the table headings from the listing of volumes.

--quiet, -q

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

EXAMPLES

$ 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

SEE ALSO

podman-volume(1)

HISTORY

November 2018, Originally compiled by Urvashi Mohnani umohnani@redhat.com