Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
podman-image-inspect(1)	    General Commands Manual    podman-image-inspect(1)

NAME
       podman-image-inspect - Display an image's configuration

SYNOPSIS
       podman image inspect [options] image [image ...]

DESCRIPTION
       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.

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).

       Valid placeholders for the Go template are listed below:

       +------------------+-------------------------------+
       | Placeholder	  | Description			  |
       +------------------+-------------------------------+
       | .Annotations ... | Annotation	information   in- |
       |		  | cluded in the image		  |
       +------------------+-------------------------------+
       | .Architecture	  | Architecture  of  software in |
       |		  | the	image			  |
       +------------------+-------------------------------+
       | .Author	  | Image author		  |
       +------------------+-------------------------------+
       | .Comment	  | Image comment		  |
       +------------------+-------------------------------+
       | .Config ...	  | Structure with config info	  |
       +------------------+-------------------------------+
       | .Created ...	  | Image creation time	 (string, |
       |		  | ISO3601)			  |
       +------------------+-------------------------------+
       | .Digest	  | Image digest (sha256:+64-char |
       |		  | hash)			  |
       +------------------+-------------------------------+
       | .GraphDriver ... | Structure  for the graph dri- |
       |		  | ver	info			  |
       +------------------+-------------------------------+
       | .HealthCheck ... | Structure  for   the   health |
       |		  | check info			  |
       +------------------+-------------------------------+
       | .History	  | History information	stored in |
       |		  | image			  |
       +------------------+-------------------------------+
       | .ID		  | Image ID (full 64-char hash)  |
       +------------------+-------------------------------+
       | .Labels ...	  | Label information included in |
       |		  | the	image			  |
       +------------------+-------------------------------+
       | .ManifestType	  | Manifest type of the image	  |
       +------------------+-------------------------------+
       | .NamesHistory	  | Name    history   information |
       |		  | stored in image		  |
       +------------------+-------------------------------+
       | .Os		  | Operating system of	 software |
       |		  | in the image		  |
       +------------------+-------------------------------+
       | .Parent	  | Parent image of the	specified |
       |		  | image			  |
       +------------------+-------------------------------+
       | .RepoDigests	  | Repository	digests	 for  the |
       |		  | image			  |
       +------------------+-------------------------------+
       | .RepoTags	  | Repository tags for	the image |
       +------------------+-------------------------------+
       | .RootFS ...	  | Structure for the  root  file |
       |		  | system info			  |
       +------------------+-------------------------------+
       | .Size		  | Size of image, in bytes	  |
       +------------------+-------------------------------+
       | .User		  | Default  user  to execute the |
       |		  | image as			  |
       +------------------+-------------------------------+
       | .Version	  | Image Version		  |
       +------------------+-------------------------------+
       | .VirtualSize	  | Virtual  size  of  image,  in |
       |		  | bytes			  |
       +------------------+-------------------------------+

EXAMPLE
       Inspect information on the specified image:

       $ podman	image inspect fedora
       [
	   {
	       "Id": "37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d",
	       "Digest": "sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
	       "RepoTags": [
		   "registry.fedoraproject.org/fedora:latest"
	       ],
	       "RepoDigests": [
		   "registry.fedoraproject.org/fedora@sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
		   "registry.fedoraproject.org/fedora@sha256:b5290db40008aae9272ad3a6bd8070ef7ecd547c3bef014b894c327960acc582"
	       ],
	       "Parent": "",
	       "Comment": "Created by Image Factory",
	       "Created": "2021-08-09T05:48:47Z",
	       "Config": {
		   "Env": [
		       "DISTTAG=f34container",
		       "FGC=f34",
		       "container=oci"
		   ],
		   "Cmd": [
		       "/bin/bash"
		   ],
		   "Labels": {
		       "license": "MIT",
		       "name": "fedora",
		       "vendor": "Fedora Project",
		       "version": "34"
		   }
	       },
	       "Version": "1.10.1",
	       "Author": "",
	       "Architecture": "amd64",
	       "Os": "linux",
	       "Size": 183852302,
	       "VirtualSize": 183852302,
	       "GraphDriver": {
		   "Name": "overlay",
		   "Data": {
		       "UpperDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/diff",
		       "WorkDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/work"
		   }
	       },
	       "RootFS": {
		   "Type": "layers",
		   "Layers": [
		       "sha256:0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2"
		   ]
	       },
	       "Labels": {
		   "license": "MIT",
		   "name": "fedora",
		   "vendor": "Fedora Project",
		   "version": "34"
	       },
	       "Annotations": {},
	       "ManifestType": "application/vnd.docker.distribution.manifest.v2+json",
	       "User": "",
	       "History": [
		   {
		       "created": "2021-08-09T05:48:47Z",
		       "comment": "Created by Image Factory"
		   }
	       ],
	       "NamesHistory": [
		   "registry.fedoraproject.org/fedora:latest"
	       ]
	   }
       ]

       Inspect image ID	for the	specified image:

       $ podman	image inspect --format '{{ .Id }}' fedora
       37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d

SEE ALSO
       podman(1), podman-image(1), podman-inspect(1)

HISTORY
       Sep   2021,   Originally	  compiled   by	 Dan  Walsh  dwalsh@redhat.com
       <mailto:dwalsh@redhat.com>

						       podman-image-inspect(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-image-inspect&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help