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>
89 lines
2.9 KiB
Markdown
89 lines
2.9 KiB
Markdown
% podman-image-tree(1)
|
|
|
|
## NAME
|
|
podman\-image\-tree - Prints layer hierarchy of an image in a tree format
|
|
|
|
## SYNOPSIS
|
|
**podman image tree** [*image*:*tag*]|[*image-id*]
|
|
[**--help**|**-h**]
|
|
|
|
## DESCRIPTION
|
|
Prints layer hierarchy of an image in a tree format.
|
|
If you do not provide a *tag*, podman will default to `latest` for the *image*.
|
|
Layers are indicated with image tags as `Top Layer of`, when the tag is known locally.
|
|
## OPTIONS
|
|
|
|
**--help**, **-h**
|
|
|
|
Print usage statement
|
|
|
|
**--whatrequires**
|
|
|
|
Show all child images and layers of the specified image
|
|
|
|
## EXAMPLES
|
|
|
|
```
|
|
$ podman pull docker.io/library/wordpress
|
|
$ podman pull docker.io/library/php:7.2-apache
|
|
|
|
$ podman image tree docker.io/library/wordpress
|
|
Image ID: 6e880d17852f
|
|
Tags: [docker.io/library/wordpress:latest]
|
|
Size: 429.9MB
|
|
Image Layers
|
|
├── ID: 3c816b4ead84 Size: 58.47MB
|
|
├── ID: e39dad2af72e Size: 3.584kB
|
|
├── ID: b2d6a702383c Size: 213.6MB
|
|
├── ID: 94609408badd Size: 3.584kB
|
|
├── ID: f4dddbf86725 Size: 43.04MB
|
|
├── ID: 8f695df43a4c Size: 11.78kB
|
|
├── ID: c29d67bf8461 Size: 9.728kB
|
|
├── ID: 23f4315918f8 Size: 7.68kB
|
|
├── ID: d082f93a18b3 Size: 13.51MB
|
|
├── ID: 7ea8bedcac69 Size: 4.096kB
|
|
├── ID: dc3bbf7b3dc0 Size: 57.53MB
|
|
├── ID: fdbbc6404531 Size: 11.78kB
|
|
├── ID: 8d24785437c6 Size: 4.608kB
|
|
├── ID: 80715f9e8880 Size: 4.608kB Top Layer of: [docker.io/library/php:7.2-apache]
|
|
├── ID: c93cbcd6437e Size: 3.573MB
|
|
├── ID: dece674f3cd1 Size: 4.608kB
|
|
├── ID: 834f4497afda Size: 7.168kB
|
|
├── ID: bfe2ce1263f8 Size: 40.06MB
|
|
└── ID: 748e99b214cf Size: 11.78kB Top Layer of: [docker.io/library/wordpress:latest]
|
|
|
|
$ podman pull docker.io/circleci/ruby:latest
|
|
$ podman pull docker.io/library/ruby:latest
|
|
|
|
$ podman image tree ae96a4ad4f3f --whatrequires
|
|
Image ID: ae96a4ad4f3f
|
|
Tags: [docker.io/library/ruby:latest]
|
|
Size: 894.2MB
|
|
Image Layers
|
|
└── ID: 9c92106221c7 Size: 2.56kB Top Layer of: [docker.io/library/ruby:latest]
|
|
├── ID: 1b90f2b80ba0 Size: 3.584kB
|
|
│ ├── ID: 42b7d43ae61c Size: 169.5MB
|
|
│ ├── ID: 26dc8ba99ec3 Size: 2.048kB
|
|
│ ├── ID: b4f822db8d95 Size: 3.957MB
|
|
│ ├── ID: 044e9616ef8a Size: 164.7MB
|
|
│ ├── ID: bf94b940200d Size: 11.75MB
|
|
│ ├── ID: 4938e71bfb3b Size: 8.532MB
|
|
│ └── ID: f513034bf553 Size: 1.141MB
|
|
├── ID: 1e55901c3ea9 Size: 3.584kB
|
|
├── ID: b62835a63f51 Size: 169.5MB
|
|
├── ID: 9f4e8857f3fd Size: 2.048kB
|
|
├── ID: c3b392020e8f Size: 3.957MB
|
|
├── ID: 880163026a0a Size: 164.8MB
|
|
├── ID: 8c78b2b14643 Size: 11.75MB
|
|
├── ID: 830370cfa182 Size: 8.532MB
|
|
└── ID: 567fd7b7bd38 Size: 1.141MB Top Layer of: [docker.io/circleci/ruby:latest]
|
|
|
|
```
|
|
|
|
|
|
## SEE ALSO
|
|
podman(1), crio(8)
|
|
|
|
## HISTORY
|
|
Feb 2019, Originally compiled by Kunal Kushwaha <kushwaha_kunal_v7@lab.ntt.co.jp>
|