mirror of
https://github.com/containers/podman.git
synced 2025-10-17 11:14:40 +08:00
6ce70a33c5
Inspect should be able to inspect one or more containers depending on the user input. Therefore, inspect output should be in array format so the consumer could potentially iterate it. This PR allows users to specify one more or containers|images|or a mix for inspection. The output, as stated, is therefore in array form. This holds true even for a singular image. In the case that the user enters an invalid container|image "name", we handle that gracefully. Podman will output json for the valid names until it reaches the invalid one. For example: In this case, podman will out the json for alpine and then print an error about 123 being invalid. It will not continute onto busybox. This behavior imatates docker. This addresses issue #360 Signed-off-by: baude <bbaude@redhat.com> Closes: #371 Approved by: baude
99 lines
3.0 KiB
Markdown
99 lines
3.0 KiB
Markdown
% podman(1) podman-inspect - Display a container or image's configuration
|
|
% Dan Walsh
|
|
# podman-inspect "1" "July 2017" "podman"
|
|
|
|
## NAME
|
|
podman inspect - Display a container or image's configuration
|
|
|
|
## SYNOPSIS
|
|
**podman** **inspect** [*options* [...]] name [...]
|
|
|
|
## 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 data on items of the specified type. Type can be 'container', 'image' or 'all' (default: all)
|
|
|
|
**--format, -f="FORMAT"**
|
|
|
|
Format the output using the given Go template
|
|
|
|
**--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.
|
|
|
|
**--size**
|
|
|
|
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",
|
|
"ContainerConfig": {
|
|
"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
|
|
```
|
|
|
|
```
|
|
$ sudo podman inspect a04 --format "{{.GraphDriver.Name}}"
|
|
overlay
|
|
```
|
|
|
|
## SEE ALSO
|
|
podman(1)
|
|
|
|
## HISTORY
|
|
July 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>
|