Skip to content

Commit 7fb9b5a

Browse files
committed
man: umoci-stat: update output examples
We added a bunch of new information to umoci-stat recently but did not update the man-pages to reflect the new output. Fixes: 4bf1adc ("umoci stat: include image config information") Fixes: fa4d5be ("stat: include manifest information") Signed-off-by: Aleksa Sarai <[email protected]>
1 parent a9a95c4 commit 7fb9b5a

File tree

1 file changed

+73
-5
lines changed

1 file changed

+73
-5
lines changed

doc/man/umoci-stat.1.md

Lines changed: 73 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
% umoci-stat(1) # umoci stat - Display status information about an image tag
22
% Aleksa Sarai
3-
% SEPTEMBER 2018
3+
% OCTOBER 2025
44
# NAME
55
umoci stat - Display status information about an image tag
66

@@ -33,6 +33,18 @@ The format of the **--json** blob is as follows. Many of these fields come from
3333
the [OCI image specification][1].
3434

3535
{
36+
# This is the manifest blob of the image.
37+
"manifest": {
38+
"descriptor": <descriptor of manifest blob>,
39+
"blob": <raw manifest blob>
40+
},
41+
42+
# This is the configuration blob of the image.
43+
"config": {
44+
"descriptor": <descriptor of config blob>,
45+
"blob": <raw config blob>
46+
},
47+
3648
# This is the set of history entries for the image.
3749
"history": [
3850
{
@@ -56,11 +68,67 @@ The following gets information about an image downloaded from a **docker**(1)
5668
registry using **skopeo**(1).
5769

5870
```
59-
% skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
71+
% skopeo copy docker://registry.opensuse.org/opensuse/tumbleweed:latest oci:image:latest
6072
% umoci stat --image image
61-
LAYER CREATED CREATED BY SIZE COMMENT
62-
<none> 2016-12-05T22:52:33.085510751Z /bin/sh -c #(nop) MAINTAINER SUSE Containers Team <[email protected]> <none>
63-
sha256:e800e72a0a88984bd1b47f4eca1c188d3d333dc8e799bfa0a02ea5c2697216d5 2016-12-05T22:52:46.570617134Z /bin/sh -c #(nop) ADD file:6e0044405547c4c209fac622b3c6ddc75e7370682197f7920ec66e4e5e00b180 in / 49.25 MB
73+
== MANIFEST ==
74+
Schema Version: 2
75+
Media Type: application/vnd.oci.image.manifest.v1+json
76+
Config:
77+
Descriptor:
78+
Media Type: application/vnd.oci.image.config.v1+json
79+
Digest: sha256:d06b5a49f4d4b8f5f39c1a6d798c7b2b1611747d5a1ee3bcfb5dc48d1b52f1e1
80+
Size: 2.175kB
81+
Layers:
82+
Descriptor:
83+
Media Type: application/vnd.oci.image.layer.v1.tar+gzip
84+
Digest: sha256:34198bffb2664ac16017024a9f8e3e29e73efd98137894d033d41e308728ae56
85+
Size: 38.82MB
86+
Descriptor:
87+
Media Type: application/vnd.oci.image.manifest.v1+json
88+
Digest: sha256:cc559b926ba5cccd0d95058279dd0120588576c64ba6667f2221bc554b9f0621
89+
Size: 407B
90+
Annotations:
91+
org.opencontainers.image.ref.name: latest
92+
93+
== CONFIG ==
94+
Created: 2025-10-14T07:39:53Z
95+
Author: "Fabian Vogt <[email protected]>"
96+
Platform:
97+
OS: linux
98+
Architecture: amd64
99+
Image Config:
100+
User: ""
101+
Command:
102+
/bin/bash
103+
Labels:
104+
org.openbuildservice.disturl: obs://build.opensuse.org/openSUSE:Factory/images/06574e385a3d2455c90f69f65ffa3e80-opensuse-tumbleweed-image:docker
105+
org.opencontainers.image.created: 2025-10-14T07:39:47.127067859Z
106+
org.opencontainers.image.description: "Image containing a minimal environment for containers based on openSUSE Tumbleweed."
107+
org.opencontainers.image.source: https://build.opensuse.org/package/show/openSUSE:Factory/opensuse-tumbleweed-image?rev=06574e385a3d2455c90f69f65ffa3e80
108+
org.opencontainers.image.title: "openSUSE Tumbleweed Base Container"
109+
org.opencontainers.image.url: https://www.opensuse.org
110+
org.opencontainers.image.vendor: "openSUSE Project"
111+
org.opencontainers.image.version: 20251013.34.298
112+
org.opensuse.base.created: 2025-10-14T07:39:47.127067859Z
113+
org.opensuse.base.description: "Image containing a minimal environment for containers based on openSUSE Tumbleweed."
114+
org.opensuse.base.disturl: obs://build.opensuse.org/openSUSE:Factory/images/06574e385a3d2455c90f69f65ffa3e80-opensuse-tumbleweed-image:docker
115+
org.opensuse.base.lifecycle-url: https://en.opensuse.org/Lifetime
116+
org.opensuse.base.reference: registry.opensuse.org/opensuse/tumbleweed:20251013.34.298
117+
org.opensuse.base.source: https://build.opensuse.org/package/show/openSUSE:Factory/opensuse-tumbleweed-image?rev=06574e385a3d2455c90f69f65ffa3e80
118+
org.opensuse.base.title: "openSUSE Tumbleweed Base Container"
119+
org.opensuse.base.url: https://www.opensuse.org
120+
org.opensuse.base.vendor: "openSUSE Project"
121+
org.opensuse.base.version: 20251013.34.298
122+
org.opensuse.lifecycle-url: https://en.opensuse.org/Lifetime
123+
org.opensuse.reference: registry.opensuse.org/opensuse/tumbleweed:20251013.34.298
124+
Descriptor:
125+
Media Type: application/vnd.oci.image.config.v1+json
126+
Digest: sha256:d06b5a49f4d4b8f5f39c1a6d798c7b2b1611747d5a1ee3bcfb5dc48d1b52f1e1
127+
Size: 2.175kB
128+
129+
== HISTORY ==
130+
LAYER CREATED CREATED BY SIZE COMMENT
131+
sha256:34198bffb2664ac16017024a9f8e3e29e73efd98137894d033d41e308728ae56 2025-10-14T07:39:53Z KIWI 10.2.32 38.82MB openSUSE Tumbleweed 20251013 Base Container
64132
```
65133

66134
# SEE ALSO

0 commit comments

Comments
 (0)