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 spec-
     ified, the given template is executed for each result.

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

     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+15.1.quarterly>

home | help