mirror of
https://github.com/containers/podman.git
synced 2025-06-02 10:46:09 +08:00
d3a49fdedb
On Mac and Windows systems the --latest option is not supported this PR mentions this fact in the examples section of the man page. Also added documentation and consistency to the man pages examples sections. Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
105 lines
3.5 KiB
Markdown
105 lines
3.5 KiB
Markdown
% 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 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.1.md)**, **[podman-volume(1)](podman-volume.1.md)**, **[podman-inspect(1)](podman-inspect.1.md)**
|
|
|
|
## HISTORY
|
|
November 2018, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>
|