FreeBSD Manual Pages
podman-inspect(1) General Commands Manual podman-inspect(1) NAME podman-inspect - Display artifact, container, image, volume, network, or pod's configuration SYNOPSIS podman inspect [options] name [...] DESCRIPTION This displays the low-level information on artifacts, containers, and images identified by name or ID. By default, this renders all results in a JSON array. If the inspect type is all, the order of inspection is: containers, images, volumes, network, pods, artifacts. If a container has the same name as an image, then the container JSON is returned, and so on. If a format is specified, the given template is executed for each re- sult. For more inspection options, see also podman-artifact-inspect(1), pod- man-container-inspect(1), podman-image-inspect(1), podman-network-in- spect(1), podman-pod-inspect(1), and podman-volume-inspect(1). OPTIONS --format, -f=format Format the output using the given Go template. The keys of the re- turned JSON can be used as the values for the --format flag (see exam- ples below). --latest, -l Instead of providing the container name or ID, use the last created container. Note: the last started container can be from other users of Podman on the host machine. (This option is not available with the re- mote Podman client, including Mac and Windows (excluding WSL2) ma- chines) --size, -s In addition to normal output, display the total file size if the type is a container. --type, -t=type Return JSON for the specified type. Type can be 'artifact', 'con- tainer', 'image', 'volume', 'network', 'pod', or 'all' (default: all) (Only meaningful when invoked as podman inspect) EXAMPLES Inspect the fedora image: # podman inspect fedora [ { "Id": "f0858ad3febdf45bb2e5501cb459affffacef081f79eaa436085c3b6d9bd46ca", "Digest": "sha256:d4f7df6b691d61af6cee7328f82f1d8afdef63bc38f58516858ae3045083924a", "RepoTags": [ "docker.io/library/fedora:latest" ], "RepoDigests": [ "docker.io/library/fedora@sha256:8fa60b88e2a7eac8460b9c0104b877f1aa0cea7fbc03c701b7e545dacccfb433", "docker.io/library/fedora@sha256:d4f7df6b691d61af6cee7328f82f1d8afdef63bc38f58516858ae3045083924a" ], "Parent": "", "Comment": "", "Created": "2019-10-29T03:23:37.695123423Z", "Config": { "Env": [ "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin", "DISTTAG=f31-updates-candidatecontainer", "FGC=f31-updates-candidate", "FBR=f31-updates-candidate" ], "Cmd": [ "/bin/bash" ], "Labels": { "maintainer": "Clement Verna \u003ccverna@fedoraproject.org\u003e" } }, "Version": "18.06.1-ce", "Author": "", "Architecture": "amd64", "Os": "linux", "Size": 201096840, "VirtualSize": 201096840, "GraphDriver": { "Name": "overlay", "Data": { "UpperDir": "/home/user/.local/share/containers/storage/overlay/2ae3cee18c8ef9e0d448649747dab81c4f1ca2714a8c4550eff49574cab262c9/diff", "WorkDir": "/home/user/.local/share/containers/storage/overlay/2ae3cee18c8ef9e0d448649747dab81c4f1ca2714a8c4550eff49574cab262c9/work" } }, "RootFS": { "Type": "layers", "Layers": [ "sha256:2ae3cee18c8ef9e0d448649747dab81c4f1ca2714a8c4550eff49574cab262c9" ] }, "Labels": { "maintainer": "Clement Verna \u003ccverna@fedoraproject.org\u003e" }, "Annotations": {}, "ManifestType": "application/vnd.docker.distribution.manifest.v2+json", "User": "", "History": [ { "created": "2019-01-16T21:21:55.569693599Z", "created_by": "/bin/sh -c #(nop) LABEL maintainer=Clement Verna \u003ccverna@fedoraproject.org\u003e", "empty_layer": true }, { "created": "2019-09-27T21:21:07.784469821Z", "created_by": "/bin/sh -c #(nop) ENV DISTTAG=f31-updates-candidatecontainer FGC=f31-updates-candidate FBR=f31-updates-candidate", "empty_layer": true }, { "created": "2019-10-29T03:23:37.355187998Z", "created_by": "/bin/sh -c #(nop) ADD file:298f828afc880ccde9205fc4418435d5e696ad165e283f0530d0b1a74326d6dc in / " }, { "created": "2019-10-29T03:23:37.695123423Z", "created_by": "/bin/sh -c #(nop) CMD [\"/bin/bash\"]", "empty_layer": true } ], "NamesHistory": [] } ] Inspect the specified image with the ImageName format specifier: # podman inspect a04 --format "{{.ImageName}}" fedora Inspect the specified image for GraphDriver format specifier: # podman inspect a04 --format "{{.GraphDriver.Name}}" overlay Inspect the specified image for its Size format specifier: # podman image inspect --format "size: {{.Size}}" alpine size: 4405240 Inspect the latest container created for EffectiveCaps format speci- fier. (This option is not available with the remote Podman client, in- cluding Mac and Windows (excluding WSL2) machines): podman container inspect --latest --format {{.EffectiveCaps}} [CAP_CHOWN CAP_DAC_OVERRIDE CAP_FSETID CAP_FOWNER CAP_SETGID CAP_SETUID CAP_SETFCAP CAP_SETPCAP CAP_NET_BIND_SERVICE CAP_KILL] Inspect the specified pod for the Name format specifier: # podman inspect myPod --type pod --format "{{.Name}}" myPod Inspect the specified volume for the Name format specifier: # podman inspect myVolume --type volume --format "{{.Name}}" myVolume Inspect the specified network for the Name format specifier: # podman inspect nyNetwork --type network --format "{{.name}}" myNetwork Inspect the specified artifact: # podman inspect quay.io/myimage/myartifact:latest --type artifact { "Manifest": { "schemaVersion": 2, "mediaType": "application/vnd.oci.image.manifest.v1+json", ... }, "Name": "quay.io/myimage/myartifact:latest", "Digest": "sha256:..." } SEE ALSO podman(1), podman-artifact-inspect(1), podman-container-inspect(1), podman-image-inspect(1), podman-network-inspect(1), podman-pod-in- spect(1), podman-volume-inspect(1) HISTORY July 2017, Originally compiled by Dan Walsh dwalsh@redhat.com <mailto:dwalsh@redhat.com> podman-inspect(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | HISTORY
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-inspect&sektion=1&manpath=FreeBSD+Ports+15.0.quarterly>