github.com/dctrud/umoci@v0.4.3-0.20191016193643-05a1d37de015/doc/man/umoci-stat.1.md (about)

     1  % umoci-stat(1) # umoci stat - Display status information about an image tag
     2  % Aleksa Sarai
     3  % DECEMBER 2016
     4  # NAME
     5  umoci stat - Display status information about an image tag
     6  
     7  # SYNOPSIS
     8  **umoci stat**
     9  **--image**=*image*[:*tag*]
    10  [**--json**]
    11  
    12  # DESCRIPTION
    13  Generates various pieces of status information about an image tag, including
    14  the history of the image.
    15  
    16  **WARNING**: Do not depend on the output of this tool unless you are using the
    17  **--json** flag. The intention of the default formatting of this tool is to
    18  make it human-readable, and might change in future versions. For parseable
    19  and stable output, use **--json**.
    20  
    21  # OPTIONS
    22  The global options are defined in **umoci**(1).
    23  
    24  **--image**=*image*[:*tag*]
    25    The OCI image tag to display information about. *image* must be a path to a
    26    valid OCI image and *tag* must be a valid tag in the image. If *tag* is not
    27    provided it defaults to "latest".
    28  
    29  **--json**
    30    Output the status information as a JSON encoded blob.
    31  
    32  # FORMAT
    33  The format of the **--json** blob is as follows. Many of these fields come from
    34  the [OCI image specification][1].
    35  
    36      {
    37        # This is the set of history entries for the image.
    38        "history": [
    39          {
    40            "layer":       <descriptor>, # null if empty_layer is true
    41            "diff_id":     <diffid>,
    42            "created":     <created>,
    43            "created_by":  <created_by>,
    44            "author":      <author>,
    45            "empty_layer": <empty_layer>
    46          }...
    47        ]
    48      }
    49  
    50  In future versions of **umoci**(1) there may be extra fields added to the above
    51  structure. However, the currently defined fields will always be set (until a
    52  backwards-incompatible release is made).
    53  
    54  # EXAMPLE
    55  
    56  The following gets information about an image downloaded from a **docker**(1)
    57  registry using **skopeo**(1).
    58  
    59  ```
    60  % skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
    61  % umoci stat --image image
    62  LAYER                                                                   CREATED                        CREATED BY                                                                                        SIZE     COMMENT
    63  <none>                                                                  2016-12-05T22:52:33.085510751Z /bin/sh -c #(nop)  MAINTAINER SUSE Containers Team <containers@suse.com>                          <none>
    64  sha256:e800e72a0a88984bd1b47f4eca1c188d3d333dc8e799bfa0a02ea5c2697216d5 2016-12-05T22:52:46.570617134Z /bin/sh -c #(nop) ADD file:6e0044405547c4c209fac622b3c6ddc75e7370682197f7920ec66e4e5e00b180 in /  49.25 MB
    65  ```
    66  
    67  # SEE ALSO
    68  **umoci**(1)
    69  
    70  [1]: https://github.com/opencontainers/image-spec