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⟩

                                                                         podman-volume-inspect(1)