github.com/containers/podman/v2@v2.2.2-0.20210501105131-c1e07d070c4c/docs/source/markdown/podman-history.1.md (about)

     1  % podman-history(1)
     2  
     3  ## NAME
     4  podman\-history - Show the history of an image
     5  
     6  ## SYNOPSIS
     7  **podman history** [*options*] *image*[:*tag*|@*digest*]
     8  
     9  **podman image history** [*options*] *image*[:*tag*|@*digest*]
    10  
    11  ## DESCRIPTION
    12  **podman history** displays the history of an image by printing out information
    13  about each layer used in the image. The information printed out for each layer
    14  include Created (time and date), Created By, Size, and Comment. The output can
    15  be truncated or not using the **--no-trunc** flag. If the **--human** flag is
    16  set, the time of creation and size are printed out in a human readable format.
    17  The **--quiet** flag displays the ID of the image only when set and the **--format**
    18  flag is used to print the information using the Go template provided by the user.
    19  
    20  Valid placeholders for the Go template are listed below:
    21  
    22  | **Placeholder** | **Description**                                                               |
    23  | --------------- | ----------------------------------------------------------------------------- |
    24  | .ID             | Image ID                                                                      |
    25  | .Created        | if --human, time elapsed since creation, otherwise time stamp of creation     |
    26  | .CreatedBy      | Command used to create the layer                                              |
    27  | .Size           | Size of layer on disk                                                         |
    28  | .Comment        | Comment for the layer                                                         |
    29  
    30  ## OPTIONS
    31  
    32  #### **--human**, **-H**=*true|false*
    33  
    34  Display sizes and dates in human readable format (default *true*).
    35  
    36  #### **--no-trunc**=*true|false*
    37  
    38  Do not truncate the output (default *false*).
    39  
    40  #### **--notruncate**
    41  
    42  Do not truncate the output
    43  
    44  #### **--quiet**, **-q**=*true|false*
    45  
    46  Print the numeric IDs only (default *false*).
    47  #### **--format**=*format*
    48  
    49  Alter the output for a format like 'json' or a Go template.
    50  
    51  #### **--help**, **-h**
    52  
    53  Print usage statement
    54  
    55  ## EXAMPLES
    56  
    57  ```
    58  $ podman history debian
    59  ID              CREATED       CREATED BY                                      SIZE       COMMENT
    60  b676ca55e4f2c   9 weeks ago   /bin/sh -c #(nop) CMD ["bash"]                  0 B
    61  <missing>       9 weeks ago   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45.14 MB
    62  ```
    63  
    64  ```
    65  $ podman history --no-trunc=true --human=false debian
    66  ID              CREATED                CREATED BY                                      SIZE       COMMENT
    67  b676ca55e4f2c   2017-07-24T16:52:55Z   /bin/sh -c #(nop) CMD ["bash"]                  0
    68  <missing>       2017-07-24T16:52:54Z   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45142935
    69  ```
    70  
    71  ```
    72  $ podman history --format "{{.ID}} {{.Created}}" debian
    73  b676ca55e4f2c   9 weeks ago
    74  <missing>       9 weeks ago
    75  ```
    76  
    77  ```
    78  $ podman history --format json debian
    79  [
    80      {
    81  	"id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
    82  	"created": "2017-07-24T16:52:55.195062314Z",
    83  	"createdBy": "/bin/sh -c #(nop)  CMD [\"bash\"]",
    84  	"size": 0,
    85  	"comment": ""
    86      },
    87      {
    88  	"id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
    89  	"created": "2017-07-24T16:52:54.898893387Z",
    90  	"createdBy": "/bin/sh -c #(nop) ADD file:ebba725fb97cea45d0b1b35ccc8144e766fcfc9a78530465c23b0c4674b14042 in / ",
    91  	"size": 45142935,
    92  	"comment": ""
    93      }
    94  ]
    95  ```
    96  
    97  ## SEE ALSO
    98  podman(1)
    99  
   100  ## HISTORY
   101  July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>