.nh
.TH umoci-stat(1) # umoci stat - Display status information about an image tag
Aleksa Sarai
OCTOBER 2025

.SH "نام (NAME)"
umoci stat \- نمایش اطلاعات وضعیت دربارهٔ برچسب یک تصویر


.SH "خلاصه دستور (SYNOPSIS)"
\fBumoci stat\fP
\fB--image\fP=\fIimage\fP[:\fItag\fP]
[\fB--json\fP]


.SH "توضیحات (DESCRIPTION)"
اطلاعات وضعیت گوناگونی را دربارهٔ برچسب یک تصویر، از جمله تاریخچهٔ تصویر تولید می‌کند.

.PP
\fBهشدار\fP: به خروجی این ابزار وابسته نشوید. پیش‌تر استفاده از \fB--json\fP را به عنوان رابط «پایدار» توصیه می‌کردیم، اما این رابط در آینده بازطراحی خواهد شد.


.SH "گزینه‌ها (OPTIONS)"
گزینه‌های سراسری در \fBumoci\fP(1) تعریف شده‌اند.

.PP
\fB--image\fP=\fIimage\fP[:\fItag\fP]
  برچسب تصویر OCI که اطلاعات آن باید نمایش داده شود. \fIimage\fP باید مسیری به یک تصویر OCI معتبر و \fItag\fP باید برچسبی معتبر درون تصویر باشد. اگر \fItag\fP مشخص نشود، مقدار پیش‌فرض آن "latest" خواهد بود.

.PP
\fB--json\fP
  خروجی دادن اطلاعات وضعیت به صورت یک blob کُدگذاری‌شده با JSON.


.SH "قالب (FORMAT)"
قالب blob حاصل از \fB--json\fP به صورت زیر است. بسیاری از این فیلدها از مشخصات تصویر OCI برگرفته شده‌اند:
\[la]https://github.com/opencontainers/image\-spec\[ra]\&.

.EX
{
  # This is the manifest blob of the image.
  "manifest": {
    "descriptor": <descriptor of manifest blob>,
    "blob": <raw manifest blob>
  },

  # This is the configuration blob of the image.
  "config": {
    "descriptor": <descriptor of config blob>,
    "blob": <raw config blob>
  },

  # This is the set of history entries for the image.
  "history": [
    {
      "layer":       <descriptor>, # null if empty_layer is true
      "diff_id":     <diffid>,
      "created":     <created>,
      "created_by":  <created_by>,
      "author":      <author>,
      "empty_layer": <empty_layer>
    }...
  ]
}
.EE

.PP
در نسخه‌های آیندهٔ \fBumoci\fP(1) ممکن است فیلدهای بیشتری به ساختار بالا افزوده شود. با این حال، فیلدهایی که در حال حاضر تعریف شده‌اند همواره مقداردهی خواهند شد (تا زمانی که نسخه‌ای ناسازگار با نسخه‌های پیشین عرضه شود).


.SH "مثال‌ها (EXAMPLES)"
دستور زیر، اطلاعات تصویری را که با استفاده از \fBskopeo\fP(1) از یک رجیستری \fBdocker\fP(1) بارگیری شده است، دریافت می‌کند.

.EX
% skopeo copy docker://registry.opensuse.org/opensuse/tumbleweed:latest oci:image:latest
% umoci stat --image image
== MANIFEST ==
Schema Version: 2
Media Type: application/vnd.oci.image.manifest.v1+json
Config:
        Descriptor:
                Media Type: application/vnd.oci.image.config.v1+json
                Digest: sha256:d06b5a49f4d4b8f5f39c1a6d798c7b2b1611747d5a1ee3bcfb5dc48d1b52f1e1
                Size: 2.175kB
Layers:
        Descriptor:
                Media Type: application/vnd.oci.image.layer.v1.tar+gzip
                Digest: sha256:34198bffb2664ac16017024a9f8e3e29e73efd98137894d033d41e308728ae56
                Size: 38.82MB
Descriptor:
        Media Type: application/vnd.oci.image.manifest.v1+json
        Digest: sha256:cc559b926ba5cccd0d95058279dd0120588576c64ba6667f2221bc554b9f0621
        Size: 407B
        Annotations:
                org.opencontainers.image.ref.name: latest

== CONFIG ==
Created: 2025-10-14T07:39:53Z
Author: "Fabian Vogt <fvogt@suse.com>"
Platform:
        OS: linux
        Architecture: amd64
Image Config:
        User: ""
        Command:
                /bin/bash
        Labels:
                org.openbuildservice.disturl: obs://build.opensuse.org/openSUSE:Factory/images/06574e385a3d2455c90f69f65ffa3e80-opensuse-tumbleweed-image:docker
                org.opencontainers.image.created: 2025-10-14T07:39:47.127067859Z
                org.opencontainers.image.description: "Image containing a minimal environment for containers based on openSUSE Tumbleweed."
                org.opencontainers.image.source: https://build.opensuse.org/package/show/openSUSE:Factory/opensuse-tumbleweed-image?rev=06574e385a3d2455c90f69f65ffa3e80
                org.opencontainers.image.title: "openSUSE Tumbleweed Base Container"
                org.opencontainers.image.url: https://www.opensuse.org
                org.opencontainers.image.vendor: "openSUSE Project"
                org.opencontainers.image.version: 20251013.34.298
                org.opensuse.base.created: 2025-10-14T07:39:47.127067859Z
                org.opensuse.base.description: "Image containing a minimal environment for containers based on openSUSE Tumbleweed."
                org.opensuse.base.disturl: obs://build.opensuse.org/openSUSE:Factory/images/06574e385a3d2455c90f69f65ffa3e80-opensuse-tumbleweed-image:docker
                org.opensuse.base.lifecycle-url: https://en.opensuse.org/Lifetime
                org.opensuse.base.reference: registry.opensuse.org/opensuse/tumbleweed:20251013.34.298
                org.opensuse.base.source: https://build.opensuse.org/package/show/openSUSE:Factory/opensuse-tumbleweed-image?rev=06574e385a3d2455c90f69f65ffa3e80
                org.opensuse.base.title: "openSUSE Tumbleweed Base Container"
                org.opensuse.base.url: https://www.opensuse.org
                org.opensuse.base.vendor: "openSUSE Project"
                org.opensuse.base.version: 20251013.34.298
                org.opensuse.lifecycle-url: https://en.opensuse.org/Lifetime
                org.opensuse.reference: registry.opensuse.org/opensuse/tumbleweed:20251013.34.298
Descriptor:
        Media Type: application/vnd.oci.image.config.v1+json
        Digest: sha256:d06b5a49f4d4b8f5f39c1a6d798c7b2b1611747d5a1ee3bcfb5dc48d1b52f1e1
        Size: 2.175kB

== HISTORY ==
LAYER                                                                   CREATED              CREATED BY   SIZE    COMMENT
sha256:34198bffb2664ac16017024a9f8e3e29e73efd98137894d033d41e308728ae56 2025-10-14T07:39:53Z KIWI 10.2.32 38.82MB openSUSE Tumbleweed 20251013 Base Container
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBumoci\fP(1)