'\" t .nh .TH podman-images 1 .SH "نام (NAME)" podman-images \- فهرست کردن ایمیج‌ها در فضای ذخیره‌سازی محلی .SH "خلاصه دستور (SYNOPSIS)" \fBpodman images\fP [\fIگزینه‌ها\fP] [\fIایمیج\fP] .PP \fBpodman image list\fP [\fIگزینه‌ها\fP] [\fIایمیج\fP] .PP \fBpodman image ls\fP [\fIگزینه‌ها\fP] [\fIایمیج\fP] .SH "توضیحات (DESCRIPTION)" ایمیج‌های ذخیره‌شده در سیستم محلی، نام‌ها و شناسه‌های (ID) آن‌ها را نمایش می‌دهد. .SH "گزینه‌ها (OPTIONS)" .SS \fB--all\fP, \fB-a\fP نمایش تمام ایمیج‌ها (به‌طور پیش‌فرض لایه‌های میانی ایمیج فیلتر می‌شوند). مقدار پیش‌فرض false است. .SS \fB--digests\fP نمایش دایجست‌های (چکیده‌های) ایمیج. .SS \fB--filter\fP, \fB-f\fP=\fIfilter\fP ارائه مقادیر فیلتر. .PP اگر بیش از یک فیلتر وجود داشته باشد، گزینه \fB--filter\fR باید چندین بار ارسال شود: \fB--filter\fP \fIlabel=test\fP \fB--filter\fP \fIuntil=10m\fP\&. .PP فیلترهای پشتیبانی‌شده: .TS allbox; l l l l . \fBفیلتر\fP \fBتوضیحات\fP id فیلتر بر اساس شناسه ایمیج. before T{ فیلتر بر اساس ایمیج‌های ایجادشده قبل از ایمیج داده‌شده (نام یا تگ). T} containers T{ فیلتر بر اساس ایمیج‌هایی که کانتینر در حال اجرا دارند. T} dangling T{ فیلتر بر اساس ایمیج‌های معلق (بلااستفاده). T} digest فیلتر بر اساس دایجست (چکیده). intermediate T{ فیلتر بر اساس ایمیج‌هایی که معلق بوده و هیچ فرزندی ندارند. T} label T{ فیلتر بر اساس ایمیج‌های دارای برچسب‌های مشخص‌شده (یا فاقد آن‌ها، در صورتی که از [...]!=label استفاده شود). T} manifest T{ فیلتر بر اساس ایمیج‌هایی که فهرست مانیفست هستند. T} readonly T{ فیلتر بر اساس ایمیج‌های فقط‌خواندنی یا خواندنی/نوشتنی. T} reference فیلتر بر اساس نام ایمیج. after/since T{ فیلتر بر اساس ایمیج‌های ایجادشده پس از ایمیج داده‌شده (نام یا تگ). T} until T{ فیلتر بر اساس ایمیج‌های ایجادشده تا مدت‌زمان یا زمان داده‌شده. T} .TE .PP فیلتر \fBid\fR رشته شناسه ایمیج را می‌پذیرد. .PP فیلتر \fBbefore\fR این قالب‌ها را می‌پذیرد: \fB[:]\fR، \fB\fR یا \fB\fR\&. .PP فیلتر \fBcontainers\fR ایمیج‌هایی را نشان می‌دهد که کانتینری در حال اجرا بر اساس آن ایمیج دارند. .PP فیلتر \fBdangling\fR ایمیج‌هایی را نشان می‌دهد که فضای دیسک را اشغال کرده و هیچ هدفی ندارند. یک ایمیج معلق (dangling)، لایه‌ای از سیستم‌فایل است که در ساخت قبلی یک ایمیج استفاده شده و دیگر توسط هیچ ایمیجی ارجاع داده نمی‌شود. این ایمیج‌ها با تگ \fB\fR مشخص می‌شوند، فضای دیسک را مصرف می‌کنند و کاربرد فعالی ندارند. .PP فیلتر \fBdigest\fR رشته دایجست ایمیج را می‌پذیرد. .PP فیلتر \fBintermediate\fR ایمیج‌هایی را نشان می‌دهد که معلق هستند و هیچ فرزندی ندارند. .PP فیلتر \fBlabel\fR دو قالب را می‌پذیرد. یکی \fBlabel\fR=\fIkey\fP یا \fBlabel\fR=\fIkey\fP=\fIvalue\fP است که ایمیج‌های دارای برچسب‌های مشخص‌شده را نشان می‌دهد. قالب دیگر \fBlabel!\fR=\fIkey\fP یا \fBlabel!\fR=\fIkey\fP=\fIvalue\fP است که ایمیج‌های فاقد برچسب‌های مشخص‌شده را نمایش می‌دهد. .PP فیلتر \fBreadonly\fR مقادیر \fBtrue\fR یا \fBfalse\fR را می‌پذیرد. .PP فیلتر \fBreference\fR عبارات منظم مانند \fBimage:.*-alpine\fR را می‌پذیرد. .PP فیلتر \fBafter/since\fR این قالب‌ها را می‌پذیرد: \fB[:]\fR، \fB\fR یا \fB\fR\&. .PP فیلتر \fBuntil\fR ایمیج‌های ایجادشده پیش از تاریخ/زمان داده‌شده را نشان می‌دهد. مقدار \fB\fR می‌تواند برچسب‌های زمانی یونیکس (Unix timestamp)، برچسب‌های زمانی با فرمت تاریخ (مانند \fB2020-12-31\fR، \fB2021-01-01T10:00:00\fR) یا رشته‌های مدت‌زمان در زبان Go (مانند \fB10m\fR، \fB1h30m\fR) باشد. .PP فیلتر \fBlabel\fR دو قالب را می‌پذیرد. یکی \fBlabel\fR=\fIkey\fP یا \fBlabel\fR=\fIkey\fP=\fIvalue\fP است که ایمیج‌های دارای برچسب‌های مشخص‌شده را نشان می‌دهد. قالب دیگر \fBlabel!\fR=\fIkey\fP یا \fBlabel!\fR=\fIkey\fP=\fIvalue\fP است که ایمیج‌های فاقد برچسب‌های مشخص‌شده را نمایش می‌دهد. .PP فیلتر \fBmanifest\fR ایمیج‌هایی را نشان می‌دهد که فهرست مانیفست هستند. .PP فیلتر \fBreadonly\fR به‌طور پیش‌فرض هم ایمیج‌های فقط‌خواندنی و هم خواندنی/نوشتنی را نشان می‌دهد. ایمیج‌های فقط‌خواندنی را می‌توان با تغییر \fBadditionalimagestores\fR در فایل \fB/etc/containers/storage.conf\fR پیکربندی کرد. .PP فیلتر \fBreference\fR الگوی ارجاع یک ایمیج را به صورت \fB[:]\fR می‌پذیرد. .PP فیلتر \fBafter\fR یا \fBsince\fR این قالب‌ها را می‌پذیرد: \fB[:]\fR، \fB\fR یا \fB\fR\&. .PP فیلتر \fBuntil\fR قالب‌های: مدت‌زمان زبان Go، زمان RFC3339 یا برچسب زمانی یونیکس را می‌پذیرد و تمام ایمیج‌هایی را که تا آن زمان ایجاد شده‌اند نشان می‌دهد. .SS \fB--format\fP=\fIformat\fP تغییر قالب پیش‌فرض خروجی. این مقدار می‌تواند یکی از انواع پشتیبانی‌شده مانند 'json' یا یک الگوی زبان Go باشد. متغیرهای جایگزین معتبر برای الگوی Go در جدول زیر فهرست شده‌اند: .TS allbox; l l l l . \fB\fBمتغیر جایگزین\fP\fP \fB\fBتوضیحات\fP\fP \&.Containers T{ تعداد کانتینرهایی که از این ایمیج استفاده می‌کنند T} \&.Created T{ زمان سپری‌شده از زمان ایجاد ایمیج T} \&.CreatedAt T{ زمان ایجاد ایمیج، YYYY-MM-DD HH:MM:SS +nnnn T} \&.CreatedSince همانند Created. \&.CreatedTime همانند CreatedAt. \&.Dangling همانند IsDangling. \&.Digest دایجست ایمیج \&.History تاریخچه لایه ایمیج \&.ID شناسه ایمیج (کوتاه‌شده) \&.Id شناسه ایمیج (SHA کامل) \&.IsDangling T{ آیا ایمیج معلق است؟ (true/false) T} \&.IsReadOnly T{ آیا ایمیج فقط‌خواندنی است؟ (true/false) T} \&.Labels ... آرایه نگاشت []map از برچسب‌ها \&.Names نام کامل ایمیج (FQIN) \&.ParentId T{ شناسه کامل SHA ایمیج والد، یا null (رشته) T} \&.ReadOnly همانند IsReadOnly. \&.RepoDigests T{ آرایه نگاشت []map از صفر یا چند رشته repo/name@sha256:SHA T} \&.Repository مخزن ایمیج \&.RepoTags T{ آرایه نگاشت []map از صفر یا چند رشته FQIN برای این ایمیج T} \&.SharedSize همیشه برابر با 0 به نظر می‌رسد \&.Size T{ اندازه لایه روی دیسک (رشته خوانا برای انسان) T} \&.Tag تگ ایمیج \&.VirtualSize اندازه لایه روی دیسک (بایت) .TE .SS \fB--history\fP نمایش تاریخچه نام‌های ایمیج. اگر یک ایمیج مجدداً تگ‌گذاری شود یا تگ آن برداشته شود، تاریخچه نام ایمیج در ابتدای فهرست اضافه می‌شود (جدیدترین ایمیج در ابتدا). این گزینه به‌ویژه هنگام لغو عملیات تگ‌گذاری یا زمانی که یک ایمیج به دلیل برداشته شدن تگ فاقد نام است بسیار مفید است. .SS \fB--no-trunc\fP خروجی کوتاه نشود (پیش‌فرض \fIfalse\fP). .SS \fB--noheading\fP, \fB-n\fP حذف سرستون‌های جدول از خروجی فهرست. .SS \fB--quiet\fP, \fB-q\fP فقط شناسه‌های ایمیج فهرست می‌شوند. .SS \fB--sort\fP=\fIsort\fP مرتب‌سازی بر اساس \fIcreated\fP، \fIid\fP، \fIrepository\fP، \fIsize\fP یا \fItag\fP (پیش‌فرض: \fBcreated\fP). هنگام مرتب‌سازی بر اساس \fIrepository\fP، برای ارائه خروجی پایدار، به عنوان معیار دوم بر اساس \fItag\fP نیز مرتب‌سازی انجام می‌شود. .SH "مثال‌ها (EXAMPLES)" فهرست کردن تمام ایمیج‌های غیرمعلق در فضای ذخیره‌سازی محلی: .EX $ podman images REPOSITORY TAG IMAGE ID CREATED SIZE quay.io/podman/stable latest e0b7dabc3352 22 hours ago 331 MB docker.io/library/alpine latest 9c6f07244728 5 days ago 5.83 MB registry.fedoraproject.org/fedora latest 2ecb6df95994 3 weeks ago 169 MB quay.io/libpod/testimage 20220615 f26aa69bb3f3 2 months ago 8.4 MB .EE .PP فهرست کردن تمام ایمیج‌های منطبق با نام مشخص‌شده: .EX $ podman images stable REPOSITORY TAG IMAGE ID CREATED SIZE quay.io/podman/stable latest e0b7dabc3352 22 hours ago 331 MB .EE .PP فهرست کردن شناسه‌های تمام ایمیج‌ها در فضای ذخیره‌سازی کانتینرها: .EX # podman image ls --quiet e3d42bcaf643 ebb91b73692b 4526339ae51c .EE .PP فهرست کردن تمام ایمیج‌ها بدون نمایش سرستون‌ها: .EX # podman images --noheading docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251 kB ebb91b73692b 4 weeks ago 27.2 MB docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126 MB .EE .PP فهرست کردن تمام ایمیج‌ها بدون کوتاه کردن خروجی: .EX # podman image list --no-trunc REPOSITORY TAG IMAGE ID CREATED SIZE docker.io/kubernetes/pause latest sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27 3 years ago 251 kB sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9 4 weeks ago 27.2 MB docker.io/library/ubuntu latest sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a 6 weeks ago 126 MB .EE .PP فهرست کردن محتوای تمام ایمیج‌ها با قالب‌بندی مشخص: .EX # podman images --format "table {{.ID}} {{.Repository}} {{.Tag}}" IMAGE ID REPOSITORY TAG e3d42bcaf643 docker.io/kubernetes/pause latest ebb91b73692b 4526339ae51c docker.io/library/ubuntu latest .EE .PP فهرست کردن ایمیج‌هایی که نام‌گذاری نشده‌اند (معلق یا dangling): .EX # podman images --filter dangling=true REPOSITORY TAG IMAGE ID CREATED SIZE ebb91b73692b 4 weeks ago 27.2 MB .EE .PP فهرست کردن تمام ایمیج‌ها در قالب JSON: .EX # podman images --format json [ { "id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27", "names": [ "docker.io/kubernetes/pause:latest" ], "digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423", "created": "2014-07-19T07:02:32.267701596Z", "size": 250665 }, { "id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9", "names": [ "\\u003cnone\\u003e" ], "digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032", "created": "2017-10-26T03:07:22.796184288Z", "size": 27170520 }, { "id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a", "names": [ "docker.io/library/ubuntu:latest" ], "digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753", "created": "2017-10-10T20:59:05.10196344Z", "size": 126085200 } ] .EE .PP فهرست کردن تمام ایمیج‌ها مرتب‌شده بر اساس ستون مشخص‌شده: .EX # podman images --sort repository REPOSITORY TAG IMAGE ID CREATED SIZE 2460217d76fc About a minute ago 4.41 MB docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB localhost/myapp latest b2e0ad03474a About a minute ago 4.41 MB registry.access.redhat.com/rhel7 latest 7a840db7f020 2 weeks ago 211 MB registry.fedoraproject.org/fedora 27 801894bc0e43 6 weeks ago 246 MB .EE .PP نمایش تفاوت بین ایمیج‌های فهرست‌شده در حال استفاده در مقایسه با تمام ایمیج‌ها، از جمله ایمیج‌های معلق: .EX # podman images REPOSITORY TAG IMAGE ID CREATED SIZE localhost/test latest 18f0c080cd72 4 seconds ago 4.42 MB docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB # podman images -a REPOSITORY TAG IMAGE ID CREATED SIZE localhost/test latest 18f0c080cd72 6 seconds ago 4.42 MB 270e70dc54c0 7 seconds ago 4.42 MB 4ed6fbe43414 8 seconds ago 4.41 MB 6b0df8e71508 8 seconds ago 4.41 MB docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB .EE .SH "همچنین ببینید (SEE ALSO)" \fBpodman(1)\fP, \fBcontainers-storage.conf(5)\fP .SS عیب‌یابی (Troubleshooting) برای راه‌حل‌های مربوط به مشکلات رایج به \fBpodman-troubleshooting(7)\fP مراجعه کنید. .SH "تاریخچه (HISTORY)" مارس ۲۰۱۷، در ابتدا توسط Dan Walsh تدوین شد \fB\fR