Scroll to navigation

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

NAME

podman-volume-inspect - Get detailed information on one or more volumes

SYNOPSIS

podman volume inspect [options] volume [...]

DESCRIPTION

Display detailed information on one or more volumes. The output can be formatted using the --format flag and a Go template. To get detailed information about all the existing volumes, use the --all flag. Volumes can be queried individually by providing their full name or a unique partial name.

OPTIONS

--all, -a

Inspect all volumes.

--format, -f=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 the volume was created with
.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 volume needs to be chowned on first use
.NeedsCopyUp Indicates volume needs dest data copied up on first use
.Options ... Volume options
.Scope Volume scope
.Status ... Status of the volume
.StorageID StorageID of the volume
.Timeout Timeout of the volume
.UID UID the volume was created with

--help

Print usage statement

EXAMPLES

Inspect named volume.

$ podman volume inspect myvol
[

{
"Name": "myvol",
"Driver": "local",
"Mountpoint": "/home/myusername/.local/share/containers/storage/volumes/myvol/_data",
"CreatedAt": "2023-03-13T16:26:48.423069028-04:00",
"Labels": {},
"Scope": "local",
"Options": {},
"MountCount": 0,
"NeedsCopyUp": true,
"NeedsChown": true
} ]

Inspect all volumes.

$ podman volume inspect --all
[

{
"Name": "myvol",
"Driver": "local",
"Mountpoint": "/home/myusername/.local/share/containers/storage/volumes/myvol/_data",
"CreatedAt": "2023-03-13T16:26:48.423069028-04:00",
"Labels": {},
"Scope": "local",
"Options": {},
"MountCount": 0,
"NeedsCopyUp": true,
"NeedsChown": true
} ]

Inspect named volume and display its Driver and Scope field.

$ podman volume inspect --format "{{.Driver}} {{.Scope}}" myvol
local local

SEE ALSO

podman(1), podman-volume(1), podman-inspect(1)

HISTORY

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