'\" t
.nh
.TH podman-volume-inspect 1
.SH NAME
.PP
podman-volume-inspect - Get detailed information on one or more volumes

.SH SYNOPSIS
.PP
\fBpodman volume inspect\fP [\fIoptions\fP] \fIvolume\fP [...]

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

.SH OPTIONS
.SS \fB--all\fP, \fB-a\fP
.PP
Inspect all volumes.

.SS \fB--format\fP, \fB-f\fP=\fIformat\fP
.PP
Format volume output using Go template

.PP
Valid placeholders for the Go template are listed below:

.TS
allbox;
l l 
l l .
\fB\fBPlaceholder\fP\fP	\fB\fBDescription\fP\fP
\&.Anonymous	T{
Indicates whether volume is anonymous
T}
\&.CreatedAt	Volume creation time
\&.Driver	Volume driver
\&.GID	T{
GID the volume was created with
T}
\&.Labels	T{
Label information associated with the volume
T}
\&.LockNumber	T{
Number of the volume's Libpod lock
T}
\&.MountCount	T{
Number of times the volume is mounted
T}
\&.Mountpoint	Source of volume mount point
\&.Name	Volume name
\&.NeedsChown	T{
Indicates volume needs to be chowned on first use
T}
\&.NeedsCopyUp	T{
Indicates volume needs dest data copied up on first use
T}
\&.Options	Volume options
\&.Scope	Volume scope
\&.Status	Status of the volume
\&.StorageID	StorageID of the volume
\&.Timeout	Timeout of the volume
\&.UID	T{
UID the volume was created with
T}
.TE

.SS \fB--help\fP
.PP
Print usage statement

.SH EXAMPLES
.EX
$ 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
     }
]
.EE

.PP
$ 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
     }
]

.EX

.EE

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

.SH SEE ALSO
.PP
\fBpodman(1)\fP, \fBpodman-volume(1)\fP, \fBpodman-inspect(1)\fP

.SH HISTORY
.PP
November 2018, Originally compiled by Urvashi Mohnani umohnani@redhat.com
\[la]mailto:umohnani@redhat.com\[ra]