mirror of
https://github.com/containers/podman.git
synced 2025-07-28 10:52:35 +08:00
beb71323b1
podman-generate and -play had the wrong NAMEs.
podman-restart and -volume-prune the wrong SYNOPSIS.
All the rest are varying degrees of minor:
- missing a space between the NAME and description
- multi-line SYNOPSIS that could be collapsed into one
- use of UPPER CASE in synopsis instead of *asterisks*
- improper use of **double asterisks** for options
- varlink and version were transposed in podman-1
- fixed inconsistencies between the description in
the man page and that in the parent manpage. These
are too numerous for me to fix all.
Added: script that could be used in CI to prevent future
such inconsistencies. It cannot be enabled yet because
there are still 35+ inconsistencies in need of cleaning.
This will be difficult to review on github. I suggest
pulling the PR and running 'git log -1 -p | cdif | less'
'cdif' is a handy tool for colorizing individual diffs between
lines:
http://kaz-utashiro.github.io/cdif/
There are other such tools; use your favorite. Comparing
without visual highlights may be painful.
I also encourage you to run hack/man-page-checker and suggest
more fixes for the problems it's finding.
Signed-off-by: Ed Santiago <santiago@redhat.com>
97 lines
3.1 KiB
Markdown
97 lines
3.1 KiB
Markdown
% podman-history(1)
|
|
|
|
## NAME
|
|
podman\-history - Show the history of an image
|
|
|
|
## SYNOPSIS
|
|
**podman 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**
|
|
|
|
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), crio(8)
|
|
|
|
## HISTORY
|
|
July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>
|