diff options
author | baude <bbaude@redhat.com> | 2019-10-24 14:54:57 -0500 |
---|---|---|
committer | baude <bbaude@redhat.com> | 2019-10-31 12:31:39 -0500 |
commit | 52b92023edeba3a5e2c466d92d742e54b14a85cb (patch) | |
tree | 44e6193d49afd1277b7d07b0df41fc80d31b3adb /docs/podman-history.1.md | |
parent | 5af166ff513265b17aee92a9ce3a1522090d7dec (diff) | |
download | podman-52b92023edeba3a5e2c466d92d742e54b14a85cb.tar.gz podman-52b92023edeba3a5e2c466d92d742e54b14a85cb.tar.bz2 podman-52b92023edeba3a5e2c466d92d742e54b14a85cb.zip |
Restructure documentation dir
Restructuring the docs dir to make integration with sphinx easier. man
pages now exist in docs/source/man and the sphinx make files exists in
docs.
Signed-off-by: baude <bbaude@redhat.com>
Diffstat (limited to 'docs/podman-history.1.md')
-rw-r--r-- | docs/podman-history.1.md | 98 |
1 files changed, 0 insertions, 98 deletions
diff --git a/docs/podman-history.1.md b/docs/podman-history.1.md deleted file mode 100644 index a67cb0286..000000000 --- a/docs/podman-history.1.md +++ /dev/null @@ -1,98 +0,0 @@ -% 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 information -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 information using the Go template provided by the user. - -Valid placeholders for the Go template are listed below: - -| **Placeholder** | **Description** | -| --------------- | ----------------------------------------------------------------------------- | -| .ID | Image ID | -| .Created | if **--human**, time elapsed since creation, otherwise time stamp of creation | -| .CreatedBy | Command used to create the layer | -| .Size | Size of layer on disk | -| .Comment | Comment for the layer | - -## OPTIONS - -**--human**, **-H** - -Display sizes and dates in human readable format - -**--no-trunc** - -Do not truncate the output - -**--quiet**, **-q** - -Print the numeric IDs only - -**--format**=*format* - -Alter the output for a format like 'json' or a Go template. - -**--help**, **-h** - -Print usage statement - -## EXAMPLES - -``` -$ 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 -``` - -``` -$ 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 -``` - -``` -$ podman history --format "{{.ID}} {{.Created}}" debian -b676ca55e4f2c 9 weeks ago -<missing> 9 weeks ago -``` - -``` -$ 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> |