dwww Home | Manual pages | Find package

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 in-
       formation 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  Lib- │
       │                │ pod 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 desti- │
       │                │ nation  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@red-
       hat.com ⟨mailto:umohnani@redhat.compodman-volume-inspect(1)

Generated by dwww version 1.16 on Tue Dec 16 06:02:31 CET 2025.