github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-image-inspect.1.md (about)

     1  % podman-image-inspect 1
     2  
     3  ## NAME
     4  podman\-image\-inspect - Display an image's configuration
     5  
     6  ## SYNOPSIS
     7  **podman image inspect** [*options*] *image* [*image* ...]
     8  
     9  ## DESCRIPTION
    10  
    11  This displays the low-level information on images identified by name or ID. By default, this renders all results in a JSON array.  If a format is specified, the given template is executed for each result.
    12  
    13  ## OPTIONS
    14  
    15  #### **--format**, **-f**=*format*
    16  
    17  Format the output using the given Go template.
    18  The keys of the returned JSON can be used as the values for the --format flag (see examples below).
    19  
    20  Valid placeholders for the Go template are listed below:
    21  
    22  | **Placeholder**      | **Description**                                    |
    23  | -----------------    | ------------------                                 |
    24  | .Annotations ...     | Annotation information included in the image       |
    25  | .Architecture        | Architecture of software in the image              |
    26  | .Author              | Image author                                       |
    27  | .Comment             | Image comment                                      |
    28  | .Config ...          | Structure with config info                         |
    29  | .Created ...         | Image creation time (string, ISO3601)              |
    30  | .Digest              | Image digest (sha256:+64-char hash)                |
    31  | .GraphDriver ...     | Structure for the graph driver info                |
    32  | .HealthCheck ...     | Structure for the health check info                |
    33  | .History             | History information stored in image                |
    34  | .ID                  | Image ID (full 64-char hash)                       |
    35  | .Labels ...          | Label information included in the image            |
    36  | .ManifestType        | Manifest type of the image                         |
    37  | .NamesHistory        | Name history information stored in image           |
    38  | .Os                  | Operating system of software in the image          |
    39  | .Parent              | Parent image of the specified image                |
    40  | .RepoDigests         | Repository digests for the image                   |
    41  | .RepoTags            | Repository tags for the image                      |
    42  | .RootFS ...          | Structure for the root file system info            |
    43  | .Size                | Size of image, in bytes                            |
    44  | .User                | Default user to execute the image as               |
    45  | .Version             | Image Version                                      |
    46  | .VirtualSize         | Virtual size of image, in bytes                    |
    47  
    48  ## EXAMPLE
    49  
    50  Inspect information on the specified image:
    51  ```
    52  $ podman image inspect fedora
    53  [
    54      {
    55          "Id": "37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d",
    56          "Digest": "sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
    57          "RepoTags": [
    58              "registry.fedoraproject.org/fedora:latest"
    59          ],
    60          "RepoDigests": [
    61              "registry.fedoraproject.org/fedora@sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
    62              "registry.fedoraproject.org/fedora@sha256:b5290db40008aae9272ad3a6bd8070ef7ecd547c3bef014b894c327960acc582"
    63          ],
    64          "Parent": "",
    65          "Comment": "Created by Image Factory",
    66          "Created": "2021-08-09T05:48:47Z",
    67          "Config": {
    68              "Env": [
    69                  "DISTTAG=f34container",
    70                  "FGC=f34",
    71                  "container=oci"
    72              ],
    73              "Cmd": [
    74                  "/bin/bash"
    75              ],
    76              "Labels": {
    77                  "license": "MIT",
    78                  "name": "fedora",
    79                  "vendor": "Fedora Project",
    80                  "version": "34"
    81              }
    82          },
    83          "Version": "1.10.1",
    84          "Author": "",
    85          "Architecture": "amd64",
    86          "Os": "linux",
    87          "Size": 183852302,
    88          "VirtualSize": 183852302,
    89          "GraphDriver": {
    90              "Name": "overlay",
    91              "Data": {
    92                  "UpperDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/diff",
    93                  "WorkDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/work"
    94              }
    95          },
    96          "RootFS": {
    97              "Type": "layers",
    98              "Layers": [
    99                  "sha256:0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2"
   100              ]
   101          },
   102          "Labels": {
   103              "license": "MIT",
   104              "name": "fedora",
   105              "vendor": "Fedora Project",
   106              "version": "34"
   107          },
   108          "Annotations": {},
   109          "ManifestType": "application/vnd.docker.distribution.manifest.v2+json",
   110          "User": "",
   111          "History": [
   112              {
   113                  "created": "2021-08-09T05:48:47Z",
   114                  "comment": "Created by Image Factory"
   115              }
   116          ],
   117          "NamesHistory": [
   118              "registry.fedoraproject.org/fedora:latest"
   119          ]
   120      }
   121  ]
   122  ```
   123  
   124  Inspect image ID for the specified image:
   125  ```
   126  $ podman image inspect --format '{{ .Id }}' fedora
   127  37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d
   128  ```
   129  
   130  ## SEE ALSO
   131  **[podman(1)](podman.1.md)**, **[podman-image(1)](podman-image.1.md)**, **[podman-inspect(1)](podman-inspect.1.md)**
   132  
   133  ## HISTORY
   134  Sep 2021, Originally compiled by Dan Walsh <dwalsh@redhat.com>