containers
/
podman
mirror of https://github.com/containers/podman.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

man pages: document some --format options: images 

Baby steps toward merging #14046: document Go format options
for podman images.

Signed-off-by: Ed Santiago <santiago@redhat.com>
This commit is contained in:
Ed Santiago 2022-09-19 13:30:05 -06:00
parent 84c85f4d94
commit 0e4eeb52ec
1 changed files with 26 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
docs/source/markdown/podman-images.1.md
View File

@ -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**