Provided by: podman_4.9.3+ds1-1ubuntu0.2_amd64 bug

NAME

       podman-inspect - Display a container, image, volume, network, or pod'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 renders all results in a JSON array. If the inspect  type  is  all,  the  order  of  inspection  is:
       containers, images, volumes, network, pods.
        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 result.

       For  more  inspection  options,  see  also  podman-container-inspect(1), podman-image-inspect(1), podman-
       network-inspect(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 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.  Note: the last started
       container can be from other users of Podman on the host machine.  (This option is not available with  the
       remote Podman client, including Mac and Windows (excluding WSL2) machines)

   --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 'container', 'image', 'volume', 'network', 'pod', or
       'all' (default: all) (Only meaningful when invoked as podman inspect)

EXAMPLE

       # 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": []
           }
       ]

       # 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_SETGID CAP_SETUID CAP_SETFCAP CAP_SETPCAP CAP_NET_BIND_SERVICE CAP_KILL]

       # podman inspect myPod --type pod --format "{{.Name}}"
       myPod

       # podman inspect myVolume --type volume --format "{{.Name}}"
       myVolume

       # podman inspect nyNetwork --type network --format "{{.name}}"
       myNetwork

SEE ALSO

       podman(1), podman-container-inspect(1), podman-image-inspect(1),  podman-network-inspect(1),  podman-pod-
       inspect(1), podman-volume-inspect(1)

HISTORY

       July 2017, Originally compiled by Dan Walsh dwalsh@redhat.commailto:dwalsh@redhat.compodman-inspect(1)