--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 │ Filtersvolumebyscope │
├─────────────┼───────────────────────────────────────┤
│ 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... │ Volumecreationtime │
├───────────────────────────┼───────────────────────────────────────┤
│ .Driver │ Volumedriver │
├───────────────────────────┼───────────────────────────────────────┤
│ .GID │ GIDofvolume │
├───────────────────────────┼───────────────────────────────────────┤
│ .InspectVolumeData... │ Don'tuse │
├───────────────────────────┼───────────────────────────────────────┤
│ .Labels... │ Label information associated with the │
│ │ volume │
├───────────────────────────┼───────────────────────────────────────┤
│ .LockNumber │ Number of the volume's Libpod lock │
├───────────────────────────┼───────────────────────────────────────┤
│ .MountCount │ Number of times the volume is mounted │
├───────────────────────────┼───────────────────────────────────────┤
│ .Mountpoint │ Sourceofvolumemountpoint │
├───────────────────────────┼───────────────────────────────────────┤
│ .Name │ Volumename │
├───────────────────────────┼───────────────────────────────────────┤
│ .NeedsChown │ Indicates whether volume needs to be │
│ │ chowned │
├───────────────────────────┼───────────────────────────────────────┤
│ .NeedsCopyUp │ Indicates if volume needs to be │
│ │ copied up to │
├───────────────────────────┼───────────────────────────────────────┤
│ .Options... │ Volumeoptions │
├───────────────────────────┼───────────────────────────────────────┤
│ .Scope │ Volumescope │
├───────────────────────────┼───────────────────────────────────────┤
│ .Status... │ Statusofthevolume │
├───────────────────────────┼───────────────────────────────────────┤
│ .StorageID │ StorageIDofthevolume │
├───────────────────────────┼───────────────────────────────────────┤
│ .Timeout │ Timeoutofthevolume │
├───────────────────────────┼───────────────────────────────────────┤
│ .UID │ UIDofvolume │
├───────────────────────────┼───────────────────────────────────────┤
│ .VolumeConfigResponse... │ Don'tuse │
└───────────────────────────┴───────────────────────────────────────┘
--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.