Skip to content

Commit

Permalink
Merge pull request #15862 from edsantiago/docs_format_images
Browse files Browse the repository at this point in the history 
[CI:DOCS] man pages: document some --format options: images
  • Loading branch information
@openshift-merge-robot
openshift-merge-robot authored Oct 28, 2022
2 parents b057a6a + 0e4eeb5 commit 26e5661
Showing 1 changed file with 26 additions and 10 deletions.
36 changes: 26 additions & 10 deletions docs/source/markdown/podman-images.1.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -73,16 +73,32 @@ Change the default output format. This can be of a supported type like 'json'
or a Go template.
Valid placeholders for the Go template are listed below:

| **Placeholder** | **Description** |
| --------------- | ----------------------------------------------------------------------------- |
| .ID | Image ID |
| .Repository | Image repository |
| .Tag | Image tag |
| .Digest | Image digest |
| .CreatedSince | Elapsed time since the image was created |
| .CreatedAt | Time when the image was created |
| .Size | Size of layer on disk |
| .History | History of the image layer |
| **Placeholder** | **Description** |
|-----------------|------------------------------------------------------------|
| .Containers | Number of containers using this image |
| .Created | Elapsed time since the image was created |
| .CreatedAt | Time when the image was created, YYYY-MM-DD HH:MM:SS +nnnn |
| .CreatedSince | Same as .Created |
| .CreatedTime | Same as .CreatedAt |
| .Dangling | Same as .IsDangling |
| .Digest | Image digest |
| .History | History of the image layer |
| .ID | Image ID (truncated) |
| .Id | Image ID (full SHA) |
| .ImageSummary | Internal data structure, not actually useful |
| .IsDangling | Is image dangling? (true/false) |
| .IsReadOnly | Is unage read-only? (true/false) |
| .Labels | map[] of labels |
| .Names | Image FQIN |
| .ParentId | Full SHA of parent image ID, or null (string) |
| .ReadOnly | Same as .IsReadOnly |
| .RepoDigests | map[] of zero or more repo/name@sha256:SHA strings |
| .Repository | Image repository |
| .RepoTags | map[] of zero or more FQIN strings for this image |
| .SharedSize | Always seems to be 0 |
| .Size | Size of layer on disk (human-friendly string) |
| .Tag | Image tag |
| .VirtualSize | Size of layer on disk (bytes) |

#### **--history**

Expand Down

0 comments on commit 26e5661

Please sign in to comment.