mirror of
https://github.com/containers/podman.git
synced 2025-05-30 15:15:20 +08:00
116 lines
3.5 KiB
Markdown
116 lines
3.5 KiB
Markdown
% podman-inspect(1)
|
|
|
|
## NAME
|
|
podman\-inspect - Display a container or image's configuration
|
|
|
|
## SYNOPSIS
|
|
**podman inspect** [*options*] *name* [...]
|
|
|
|
**podman image inspect** [*options*] *image*
|
|
|
|
**podman container inspect** [*options*] *container*
|
|
|
|
## DESCRIPTION
|
|
This displays the low-level information on containers and images identified by name or ID. By default, this will render
|
|
all results in a JSON array. If the container and image have the same name, this will return container JSON for
|
|
unspecified type. If a format is specified, the given template will be executed for each result.
|
|
|
|
## OPTIONS
|
|
|
|
**--type**, **-t**=*type*
|
|
|
|
Return JSON for the specified type. Type can be 'container', 'image' or 'all' (default: all)
|
|
(Only meaningful when invoked as *podman inspect*)
|
|
|
|
**--format**, **-f**=*format*
|
|
|
|
Format the output using the given Go template.
|
|
The keys of the returned JSON can be used as the values for the --format flag (see examples below).
|
|
|
|
**--latest**, **-l**
|
|
|
|
Instead of providing the container name or ID, use the last created container. If you use methods other than Podman
|
|
to run containers such as CRI-O, the last started container could be from either of those methods.
|
|
|
|
The latest option is not supported on the remote client or when invoked as *podman image inspect*.
|
|
|
|
**--size**, **-s**
|
|
|
|
Display the total file size if the type is a container
|
|
|
|
|
|
## EXAMPLE
|
|
|
|
```
|
|
# podman inspect fedora
|
|
{
|
|
"Id": "422dc563ca3260ad9ef5c47a1c246f5065d7f177ce51f4dd208efd82967ff182",
|
|
"Digest": "sha256:1b9bfb4e634dc1e5c19d0fa1eb2e5a28a5c2b498e3d3e4ac742bd7f5dae08611",
|
|
"RepoTags": [
|
|
"docker.io/library/fedora:latest"
|
|
],
|
|
"RepoDigests": [
|
|
"docker.io/library/fedora@sha256:1b9bfb4e634dc1e5c19d0fa1eb2e5a28a5c2b498e3d3e4ac742bd7f5dae08611"
|
|
],
|
|
"Parent": "",
|
|
"Comment": "",
|
|
"Created": "2017-11-14T21:07:08.475840838Z",
|
|
"Config": {
|
|
"Env": [
|
|
"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
|
|
"DISTTAG=f27container",
|
|
"FGC=f27",
|
|
"FBR=f27"
|
|
]
|
|
},
|
|
"Version": "17.06.2-ce",
|
|
"Author": "[Adam Miller \u003cmaxamillion@fedoraproject.org\u003e] [Patrick Uiterwijk \u003cpatrick@puiterwijk.org\u003e]",
|
|
"Architecture": "amd64",
|
|
"Os": "linux",
|
|
"Size": 251722732,
|
|
"VirtualSize": 514895140,
|
|
"GraphDriver": {
|
|
"Name": "overlay",
|
|
"Data": {
|
|
"MergedDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/merged",
|
|
"UpperDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/diff",
|
|
"WorkDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/work"
|
|
}
|
|
},
|
|
"RootFS": {
|
|
"Type": "layers",
|
|
"Layers": [
|
|
"sha256:d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516"
|
|
]
|
|
},
|
|
"Labels": null,
|
|
"Annotations": {}
|
|
}
|
|
```
|
|
|
|
```
|
|
# podman inspect a04 --format "{{.ImageName}}"
|
|
fedora
|
|
```
|
|
|
|
```
|
|
# podman inspect a04 --format "{{.GraphDriver.Name}}"
|
|
overlay
|
|
```
|
|
|
|
```
|
|
# podman image inspect --format "size: {{.Size}}" alpine
|
|
size: 4405240
|
|
```
|
|
|
|
```
|
|
podman container inspect --latest --format {{.EffectiveCaps}}
|
|
[CAP_CHOWN CAP_DAC_OVERRIDE CAP_FSETID CAP_FOWNER CAP_MKNOD CAP_NET_RAW CAP_SETGID CAP_SETUID CAP_SETFCAP CAP_SETPCAP CAP_NET_BIND_SERVICE CAP_SYS_CHROOT CAP_KILL CAP_AUDIT_WRITE]
|
|
```
|
|
|
|
## SEE ALSO
|
|
podman(1)
|
|
|
|
## HISTORY
|
|
July 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>
|