1podman-history(1)()                                        podman-history(1)()
2
3
4

NAME

6       podman-history - Show the history of an image
7
8

SYNOPSIS

10       podman history [options] image[:tag|@digest]
11
12
13       podman image history [options] image[:tag|@digest]
14
15

DESCRIPTION

17       podman  history displays the history of an image by printing out infor‐
18       mation about each layer used in the image. The information printed  out
19       for  each  layer include Created (time and date), Created By, Size, and
20       Comment. The output can be truncated or not using the --no-trunc  flag.
21       If  the  --human flag is set, the time of creation and size are printed
22       out in a human readable format.  The --quiet flag displays  the  ID  of
23       the  image  only  when  set  and the --format flag is used to print the
24       information using the Go template provided by the user.
25
26
27       Valid placeholders for the Go template are listed below:
28
29
30       ┌────────────────────────────────────────────────────────────────┬────────────────────────────┐
31Placeholder                                                     Description                
32       ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
33       │.ID                                                             │ Image ID                   │
34       ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
35       │.Created                                                        │ if                         │
36       ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
37--humanT{                                                       │                            │
38       ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
39       │, time elapsed since creation, otherwise time stamp of creation │                            │
40       ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
41       │T}                                                              │                            │
42       ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
43       │.CreatedBy                                                      │ Command used to create the │
44       │                                                                │ layer                      │
45       ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
46       │.Size                                                           │ Size of layer on disk      │
47       ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
48       │.Comment                                                        │ Comment for the layer      │
49       └────────────────────────────────────────────────────────────────┴────────────────────────────┘
50

OPTIONS

52       --human, -H
53
54
55       Display sizes and dates in human readable format
56
57
58       --no-trunc
59
60
61       Do not truncate the output
62
63
64       --quiet, -q
65
66
67       Print the numeric IDs only
68
69
70       --format=format
71
72
73       Alter the output for a format like 'json' or a Go template.
74
75
76       --help, -h
77
78
79       Print usage statement
80
81

EXAMPLES

83              $ podman history debian
84              ID              CREATED       CREATED BY                                      SIZE       COMMENT
85              b676ca55e4f2c   9 weeks ago   /bin/sh -c #(nop) CMD ["bash"]                  0 B
86              <missing>       9 weeks ago   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45.14 MB
87
88
89
90              $ podman history --no-trunc=true --human=false debian
91              ID              CREATED                CREATED BY                                      SIZE       COMMENT
92              b676ca55e4f2c   2017-07-24T16:52:55Z   /bin/sh -c #(nop) CMD ["bash"]                  0
93              <missing>       2017-07-24T16:52:54Z   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45142935
94
95
96
97              $ podman history --format "{{.ID}} {{.Created}}" debian
98              b676ca55e4f2c   9 weeks ago
99              <missing>       9 weeks ago
100
101
102
103              $ podman history --format json debian
104              [
105                  {
106                                                                              "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
107                                                                              "created": "2017-07-24T16:52:55.195062314Z",
108                                                                              "createdBy": "/bin/sh -c #(nop)  CMD [\"bash\"]",
109                                                                              "size": 0,
110                                                                              "comment": ""
111                  },
112                  {
113                                                                              "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
114                                                                              "created": "2017-07-24T16:52:54.898893387Z",
115                                                                              "createdBy": "/bin/sh -c #(nop) ADD file:ebba725fb97cea45d0b1b35ccc8144e766fcfc9a78530465c23b0c4674b14042 in / ",
116                                                                              "size": 45142935,
117                                                                              "comment": ""
118                  }
119              ]
120
121
122

SEE ALSO

124       podman(1)
125
126

HISTORY

128       July  2017,  Originally compiled by Urvashi Mohnani umohnani@redhat.com
129       ⟨mailto:umohnani@redhat.com⟩
130
131
132
133                                                           podman-history(1)()
Impressum