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  will be chowned on │
       │                │ next use                              │
       ├────────────────┼───────────────────────────────────────┤
       │ .NeedsCopyUp   │ Indicates  data  at  the  destination │
       │                │ will  be  copied  into  the volume on │
       │                │ next 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⟩

                                                                                        podman-volume-inspect(1)