1podman-volume-inspect(1)    General Commands Manual   podman-volume-inspect(1)
2
3
4

NAME

6       podman-volume-inspect - Get detailed information on one or more volumes
7
8

SYNOPSIS

10       podman volume inspect [options] volume [...]
11
12

DESCRIPTION

14       Display  detailed information on one or more volumes. The output can be
15       formatted using the --format flag and a Go template.  To  get  detailed
16       information  about  all the existing volumes, use the --all flag.  Vol‐
17       umes can be queried individually by providing  their  full  name  or  a
18       unique partial name.
19
20

OPTIONS

22   --all, -a
23       Inspect all volumes.
24
25
26   --format, -f=format
27       Format volume output using Go template
28
29
30       Valid placeholders for the Go template are listed below:
31
32
33       ┌─────────────┬──────────────────────────────┐
34       │Placeholder  │ Description                  │
35       ├─────────────┼──────────────────────────────┤
36       │.Anonymous   │ Indicates  whether volume is │
37       │             │ anonymous                    │
38       ├─────────────┼──────────────────────────────┤
39       │.CreatedAt   │ Volume creation time         │
40       ├─────────────┼──────────────────────────────┤
41       │.Driver      │ Volume driver                │
42       ├─────────────┼──────────────────────────────┤
43       │.GID         │ GID the volume  was  created │
44       │             │ with                         │
45       ├─────────────┼──────────────────────────────┤
46       │.Labels      │ Label information associated │
47       │             │ with the volume              │
48       ├─────────────┼──────────────────────────────┤
49       │.LockNumber  │ Number of the volume's  Lib‐ │
50       │             │ pod lock                     │
51       ├─────────────┼──────────────────────────────┤
52       │.MountCount  │ Number  of  times the volume │
53       │             │ is mounted                   │
54       ├─────────────┼──────────────────────────────┤
55       │.Mountpoint  │ Source of volume mount point │
56       ├─────────────┼──────────────────────────────┤
57       │.Name        │ Volume name                  │
58       ├─────────────┼──────────────────────────────┤
59       │.NeedsChown  │ Indicates volume needs to be │
60       │             │ chowned on first use         │
61       ├─────────────┼──────────────────────────────┤
62       │.NeedsCopyUp │ Indicates  volume needs dest │
63       │             │ data copied up on first use  │
64       ├─────────────┼──────────────────────────────┤
65       │.Options     │ Volume options               │
66       ├─────────────┼──────────────────────────────┤
67       │.Scope       │ Volume scope                 │
68       ├─────────────┼──────────────────────────────┤
69       │.Status      │ Status of the volume         │
70       ├─────────────┼──────────────────────────────┤
71       │.StorageID   │ StorageID of the volume      │
72       ├─────────────┼──────────────────────────────┤
73       │.Timeout     │ Timeout of the volume        │
74       ├─────────────┼──────────────────────────────┤
75       │.UID         │ UID the volume  was  created │
76       │             │ with                         │
77       └─────────────┴──────────────────────────────┘
78
79   --help
80       Print usage statement
81
82

EXAMPLES

84       $ podman volume inspect myvol
85       [
86            {
87                 "Name": "myvol",
88                 "Driver": "local",
89                 "Mountpoint": "/home/myusername/.local/share/containers/storage/volumes/myvol/_data",
90                 "CreatedAt": "2023-03-13T16:26:48.423069028-04:00",
91                 "Labels": {},
92                 "Scope": "local",
93                 "Options": {},
94                 "MountCount": 0,
95                 "NeedsCopyUp": true,
96                 "NeedsChown": true
97            }
98       ]
99
100
101
102       $ podman volume inspect --all [
103            {
104                 "Name": "myvol",
105                 "Driver": "local",
106                 "Mountpoint": "/home/myusername/.local/share/containers/stor‐
107       age/volumes/myvol/_data",
108                 "CreatedAt": "2023-03-13T16:26:48.423069028-04:00",
109                 "Labels": {},
110                 "Scope": "local",
111                 "Options": {},
112                 "MountCount": 0,
113                 "NeedsCopyUp": true,
114                 "NeedsChown": true
115            } ]
116
117
118
119
120
121       $ podman volume inspect --format "{{.Driver}} {{.Scope}}"  myvol  local
122       local ```
123
124

SEE ALSO

126       podman(1), podman-volume(1), podman-inspect(1)
127
128

HISTORY

130       November  2018,  Originally  compiled  by Urvashi Mohnani umohnani@red‐
131       hat.com ⟨mailto:umohnani@redhat.com⟩
132
133
134
135                                                      podman-volume-inspect(1)