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

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

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

       $ 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)