1podman-history(1)           General Commands Manual          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 in‐
24       formation using the Go template provided by the user.
25
26

OPTIONS

28   --format=format
29       Alter the output for a format like 'json' or a Go template.
30
31
32       Valid placeholders for the Go template are listed below:
33
34
35       ┌──────────────┬────────────────────────────┐
36Placeholder   Description                
37       ├──────────────┼────────────────────────────┤
38       │.ID           │ Image ID                   │
39       ├──────────────┼────────────────────────────┤
40       │.Created      │ if --human,  time  elapsed │
41       │              │ since  creation, otherwise │
42       │              │ time stamp of creation     │
43       ├──────────────┼────────────────────────────┤
44       │.CreatedAt    │ Time when the image  layer │
45       │              │ was created                │
46       ├──────────────┼────────────────────────────┤
47       │.CreatedBy    │ Command used to create the │
48       │              │ layer                      │
49       ├──────────────┼────────────────────────────┤
50       │.CreatedSince │ Elapsed time since the im‐ │
51       │              │ age layer was created      │
52       ├──────────────┼────────────────────────────┤
53       │.Size         │ Size of layer on disk      │
54       ├──────────────┼────────────────────────────┤
55       │.Comment      │ Comment for the layer      │
56       ├──────────────┼────────────────────────────┤
57       │.Tags         │ Image tags                 │
58       └──────────────┴────────────────────────────┘
59
60   --help, -h
61       Print usage statement
62
63
64   --human, -H
65       Display sizes and dates in human readable format (default true).
66
67
68   --no-trunc
69       Do not truncate the output (default false).
70
71
72   --quiet, -q
73       Print the numeric IDs only (default false).
74
75

EXAMPLES

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

SEE ALSO

118       podman(1)
119
120

HISTORY

122       July  2017,  Originally compiled by Urvashi Mohnani umohnani@redhat.com
123       ⟨mailto:umohnani@redhat.com⟩
124
125
126
127                                                             podman-history(1)
Impressum