podman-volume-inspect

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 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 vol‐ │
   │                │ ume 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