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

FreeBSD Manual Pages

  
 
  

home | help
podman-history(1)	    General Commands Manual	     podman-history(1)

NAME
       podman-history -	Show the history of an image

SYNOPSIS
       podman history [options]	image[:tag|@digest]

       podman image history [options] image[:tag|@digest]

DESCRIPTION
       podman  history displays	the history of an image	by printing out	infor-
       mation about each layer used in the image. The information printed  out
       for  each  layer	include	Created	(time and date), Created By, Size, and
       Comment.	The output can be truncated or not using the --no-trunc	 flag.
       If  the	--human	flag is	set, the time of creation and size are printed
       out in a	human readable format.	The --quiet flag displays  the	ID  of
       the  image only when set	and the	--format flag is used to print the in-
       formation using the Go template provided	by the user.

OPTIONS
   --format=format
       Alter the output	for a format like 'json' or a Go template.

       Valid placeholders for the Go template are listed below:

       +---------------+----------------------------+
       | Placeholder   | Description		    |
       +---------------+----------------------------+
       | .Comment      | Comment for the layer	    |
       +---------------+----------------------------+
       | .Created      | if --human,  time  elapsed |
       |	       | since	creation, otherwise |
       |	       | time stamp of creation	    |
       +---------------+----------------------------+
       | .CreatedAt    | Time when the image  layer |
       |	       | was created		    |
       +---------------+----------------------------+
       | .CreatedBy    | Command used to create	the |
       |	       | layer			    |
       +---------------+----------------------------+
       | .CreatedSince | Elapsed time since the	im- |
       |	       | age layer was created	    |
       +---------------+----------------------------+
       | .ID	       | Image ID		    |
       +---------------+----------------------------+
       | .Size	       | Size of layer on disk	    |
       +---------------+----------------------------+
       | .Tags	       | Image tags		    |
       +---------------+----------------------------+

   --help, -h
       Print usage statement

   --human, -H
       Display sizes and dates in human	readable format	(default true).

   --no-trunc
       Do not truncate the output (default false).

   --quiet, -q
       Print the numeric IDs only (default false).

EXAMPLES
       Show the	history	of the specified image:

       $ podman	history	debian
       ID	       CREATED	     CREATED BY					     SIZE	COMMENT
       b676ca55e4f2c   9 weeks ago   /bin/sh -c	#(nop) CMD ["bash"]		     0 B
       <missing>       9 weeks ago   /bin/sh -c	#(nop) ADD file:ebba725fb97cea4...   45.14 MB

       Show  the history of the	specified image	without	truncating content and
       using raw data:

       $ podman	history	--no-trunc=true	--human=false debian
       ID	       CREATED		      CREATED BY				      SIZE	 COMMENT
       b676ca55e4f2c   2017-07-24T16:52:55Z   /bin/sh -c #(nop)	CMD ["bash"]		      0
       <missing>       2017-07-24T16:52:54Z   /bin/sh -c #(nop)	ADD file:ebba725fb97cea4...   45142935

       Show the	formatted history of the specified image:

       $ podman	history	--format "{{.ID}} {{.Created}}"	debian
       b676ca55e4f2c   9 weeks ago
       <missing>       9 weeks ago

       Show the	history	in JSON	format for the specified image:

       $ podman	history	--format json debian
       [
	   {
	    "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
	    "created": "2017-07-24T16:52:55.195062314Z",
	    "createdBy": "/bin/sh -c #(nop)  CMD [\"bash\"]",
	    "size": 0,
	    "comment": ""
	   },
	   {
	    "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
	    "created": "2017-07-24T16:52:54.898893387Z",
	    "createdBy": "/bin/sh -c #(nop) ADD	file:ebba725fb97cea45d0b1b35ccc8144e766fcfc9a78530465c23b0c4674b14042 in / ",
	    "size": 45142935,
	    "comment": ""
	   }
       ]

SEE ALSO
       podman(1)

HISTORY
       July 2017, Originally compiled by Urvashi  Mohnani  umohnani@redhat.com
       <mailto:umohnani@redhat.com>

							     podman-history(1)

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

home | help