FreeBSD Manual Pages
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 us- ing 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 exclu- sive. 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 (ac- | | | cepts 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 cre- | | | ated before given time- | | | stamp | +-------------+----------------------------+ --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 Lib- | | | pod 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@red- hat.com <mailto:umohnani@redhat.com> podman-volume-ls(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | HISTORY
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-volume-ls&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>