'\" t .nh .TH podman-pod-ps 1 .SH "نام (NAME)" podman-pod-ps \- نمایش اطلاعات مربوط به پادها .SH "خلاصه دستور (SYNOPSIS)" \fBpodman pod ps\fP [\fIoptions\fP] .SH "توضیحات (DESCRIPTION)" دستور \fBpodman pod ps\fP تمام پادهای موجود روی سیستم را فهرست می‌کند. به‌طور پیش‌فرض موارد زیر فهرست می‌شوند: .IP \(bu 2 شناسهٔ پاد .IP \(bu 2 نام پاد .IP \(bu 2 زمان ایجاد پاد .IP \(bu 2 تعداد کانتینرهای متصل به پاد .IP \(bu 2 شناسهٔ کانتینر زیرساختی (infra) پاد .IP \(bu 2 وضعیت پاد مطابق جدول زیر .TS allbox; l l l l . \fBوضعیت\fP \fBتوضیحات\fP Created T{ هیچ کانتینری در حال اجرا یا متوقف‌شده نیست T} Running T{ حداقل یک کانتینر در حال اجرا است T} Stopped T{ حداقل یک کانتینر متوقف شده و هیچ کانتینری در حال اجرا نیست T} Exited همهٔ کانتینرهای درون پاد متوقف شده‌اند Dead خطا در دریافت وضعیت .TE .SH "گزینه‌ها (OPTIONS)" .SS \fB--ctr-ids\fP نمایش شناسه‌های کانتینر .SS \fB--ctr-names\fP نمایش نام‌های کانتینر .SS \fB--ctr-status\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 ctr-ids T{ فیلتر بر اساس شناسهٔ کانتینر درون پاد. (تطابق پیشوند CID به‌صورت پیش‌فرض؛ عبارت باقاعده را نیز می‌پذیرد) T} ctr-names T{ فیلتر بر اساس نام کانتینر درون پاد. T} ctr-number T{ فیلتر بر اساس تعداد کانتینرهای موجود در پاد. T} ctr-status T{ فیلتر بر اساس وضعیت کانتینر درون پاد. T} id T{ فیلتر بر اساس شناسهٔ پاد. (تطابق پیشوند به‌صورت پیش‌فرض؛ عبارت باقاعده را نیز می‌پذیرد) T} label T{ فیلتر بر اساس کانتینرهای دارای برچسب‌های مشخص‌شده (یا فاقد آن‌ها، در صورتی که از \fBlabel!=...\fR استفاده شود). T} name فیلتر بر اساس نام پاد. network T{ فیلتر بر اساس نام شبکه یا شناسهٔ کامل شبکه. T} status فیلتر بر اساس وضعیت پاد. until T{ فیلتر بر اساس پادهای ایجادشده پیش از برچسب زمانی داده‌شده. T} .TE .PP فیلترهای \fBctr-ids\fR، \fBctr-names\fR، \fBid\fR و \fBname\fR قالب عبارت باقاعده (\fBregex\fR) را می‌پذیرند. .PP فیلتر \fBctr-status\fR این مقادیر را می‌پذیرد: \fBcreated\fR،‏ \fBrunning\fR،‏ \fBpaused\fR،‏ \fBstopped\fR،‏ \fBexited\fR و \fBunknown\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 فیلتر \fBuntil\fR می‌تواند برچسب زمان یونیکس (Unix timestamp)، برچسب زمان دارای فرمت تاریخ، یا رشته‌های بازه زمانی Go (مانند 10m یا 1h30m) باشد که نسبت به زمان ماشین محاسبه می‌شوند. .PP فیلتر \fBstatus\fR این مقادیر را می‌پذیرد: \fBstopped\fR،‏ \fBrunning\fR،‏ \fBpaused\fR،‏ \fBexited\fR،‏ \fBdead\fR،‏ \fBcreated\fR و \fBdegraded\fR\&. .SS \fB--format\fP=\fIformat\fP چاپ زیبای کانتینرها در قالب JSON یا با استفاده از یک الگوی Go .PP جای‌نماهای معتبر برای الگوی Go در زیر فهرست شده‌اند: .TS allbox; l l l l . \fBجای‌نما\fP \fBتوضیحات\fP \&.Cgroup مسیر Cgroup پاد \&.ContainerIds T{ فهرست جداشده با ویرگول شناسه‌های کانتینرهای درون پاد T} \&.ContainerNames T{ فهرست جداشده با ویرگول نام‌های کانتینرهای درون پاد T} \&.ContainerStatuses T{ فهرست جداشده با ویرگول وضعیت‌های کانتینرهای درون پاد T} \&.Created زمان ایجاد پاد \&.ID شناسهٔ کانتینر \&.InfraID شناسهٔ کانتینر زیرساختی پاد \&.Label \fIstring\fP برچسب مشخص‌شدهٔ پاد \&.Labels T{ همهٔ برچسب‌های اختصاص‌یافته به پاد T} \&.Name نام پاد \&.Networks T{ نمایش تمام شبکه‌های متصل به کانتینر زیرساختی T} \&.NumberOfContainers T{ نمایش تعداد کانتینرهای متصل به پاد T} \&.Restarts T{ نمایش تعداد کل راه‌اندازی‌های مجدد کانتینر درون یک پاد T} \&.Status وضعیت پاد .TE .SS \fB--help\fP, \fB-h\fP چاپ راهنمای استفاده و خلاصهٔ دستور .SS \fB--latest\fP, \fB-l\fP نمایش آخرین پاد ایجادشده (در تمام وضعیت‌ها) (این گزینه در کلاینت ریموت Podman، از جمله ماشین‌های Mac و Windows (به‌استثنای WSL2) در دسترس نیست) .SS \fB--namespace\fP, \fB--ns\fP نمایش اطلاعات فضای نام (namespace) پاد .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 مرتب‌سازی بر اساس created،‏ ID،‏ name،‏ status یا number of containers .PP پیش‌فرض: created .SH "مثال‌ها (EXAMPLES)" فهرست کردن تمام پادها: .EX $ podman pod ps POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 1 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 2 .EE .PP فهرست کردن تمام پادها به همراه نام‌های کانتینرهای درون پادها: .EX $ podman pod ps --ctr-names POD ID NAME STATUS CREATED INFRA ID NAMES 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 loving_archimedes f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a thirsty_hawking,wizardly_golick .EE .PP فهرست کردن تمام پادها به همراه وضعیت، نام‌ها و شناسه‌ها: .EX $ podman pod ps --ctr-status --ctr-names --ctr-ids POD ID NAME STATUS CREATED INFRA ID IDS NAMES STATUS 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 ba465ab0a3a4 loving_archimedes running f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 331693bff40a,8e428daeb89e thirsty_hawking,wizardly_golick configured,configured .EE .PP فهرست کردن تمام پادها و چاپ شناسه، نام‌های کانتینر و cgroupها: .EX $ podman pod ps --format "{{.ID}} {{.ContainerNames}} {{.Cgroup}}" 00dfd6fa02c0 loving_archimedes /libpod_parent f4df8692e116 thirsty_hawking,wizardly_golick /libpod_parent .EE .PP فهرست کردن تمام پادهای دارای دو کانتینر با مرتب‌سازی بر اساس شناسهٔ پاد: .EX $ podman pod ps --sort id --filter ctr-number=2 POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 2 .EE .PP فهرست کردن تمام پادها به همراه شناسه‌های کانتینرهای آن‌ها: .EX $ podman pod ps --ctr-ids POD ID NAME STATUS CREATED INFRA ID IDS 00dfd6fa02c0 jolly_goldstine Running 31 hours ago ba465ab0a3a4 ba465ab0a3a4 f4df8692e116 nifty_torvalds Created 10 minutes ago 331693bff40a 331693bff40a,8e428daeb89e .EE .PP فهرست کردن تمام پادها با شناسه‌های کانتینر بدون کوتاه‌سازی شناسه‌ها: .EX $ podman pod ps --no-trunc --ctr-ids POD ID NAME STATUS CREATED INFRA ID IDS 00dfd6fa02c0a2daaedfdf8fcecd06f22ad114d46d167d71777224735f701866 jolly_goldstine Running 31 hours ago ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050 ba465ab0a3a4e15e3539a1e79c32d1213a02b0989371e274f98e0f1ae9de7050 f4df8692e116a3e6d1d62572644ed36ca475d933808cc3c93435c45aa139314b nifty_torvalds Created 10 minutes ago 331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0 331693bff40a926b6d52b184e116afd15497610c378d5d4c42945dd6e33b75b0,8e428daeb89e69b71e7916a13accfb87d122889442b5c05c2d99cf94a3230e9d .EE .PP فهرست کردن تمام پادها با نام‌های کانتینر: .EX $ podman pod ps --ctr-names POD ID NAME STATUS CREATED INFRA ID NAMES 314f4da82d74 hi Created 17 hours ago a9f2d2165675 jovial_jackson,hopeful_archimedes,vibrant_ptolemy,heuristic_jennings,keen_raman,hopeful_newton,mystifying_bose,silly_lalande,serene_lichterman ... .EE .PP فهرست کردن پادهای حاوی شناسهٔ کانتینر مشخص‌شده: .EX $ podman pod ps --filter ctr-ids=aceb3b775797 POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS 952330c7cff0 web-app Running 3 minutes ago b0f247c49669 3 .EE .PP فهرست کردن تمام پادها با دقیقاً ۲ کانتینر: .EX $ podman pod ps --filter ctr-number=2 POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS b2ae050d17be labeled-pod Running 2 minutes ago fda2a486b939 2 .EE .PP فهرست کردن پادهای دارای کانتینرهایی در وضعیت \fBexited\fR: .EX $ podman pod ps --filter ctr-status=exited POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS 06c3a107763a maintenance Degraded 4 minutes ago 67e500cbb678 3 1e3424d7e9c0 db-cluster Degraded 4 minutes ago d6650a490b69 3 .EE .PP فیلتر کردن پاد بر اساس شناسه: .EX $ podman pod ps --filter id=95938982244d POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS 95938982244d nettest Running 4 minutes ago a28d133e8c63 3 .EE .PP فیلتر کردن پاد بر اساس برچسب: .EX $ podman pod ps --filter label=tier=frontend POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS b2ae050d17be labeled-pod Running 1 second ago fda2a486b939 2 .EE .PP فیلتر کردن پاد بر اساس نام: .EX $ podman pod ps --filter name=db-cluster POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS 1e3424d7e9c0 db-cluster Degraded 4 minutes ago d6650a490b69 3 .EE .PP فیلتر کردن پاد بر اساس وضعیت پاد (مانند Degraded): .EX $ podman pod ps --filter status=degraded POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS 95938982244d nettest Degraded 7 minutes ago a28d133e8c63 3 06c3a107763a maintenance Degraded 8 minutes ago 67e500cbb678 3 1e3424d7e9c0 db-cluster Degraded 8 minutes ago d6650a490b69 3 952330c7cff0 web-app Degraded 8 minutes ago b0f247c49669 3 .EE .PP فیلتر کردن پادهای ایجادشده پیش از یک آستانهٔ زمانی (\fB--until\fR): .EX $ podman pod ps --filter until=2m POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS b2ae050d17be labeled-pod Running 3 minutes ago fda2a486b939 2 95938982244d nettest Degraded 8 minutes ago a28d133e8c63 3 deee8956522e utility Running 8 minutes ago 6b730e3ac334 3 06c3a107763a maintenance Degraded 8 minutes ago 67e500cbb678 3 1e3424d7e9c0 db-cluster Degraded 8 minutes ago d6650a490b69 3 952330c7cff0 web-app Degraded 8 minutes ago b0f247c49669 3 .EE .SH "pod ps" چاپ فهرستی از پادها .SH "همچنین ببینید (SEE ALSO)" \fBpodman(1)\fP, \fBpodman-pod(1)\fP .SH "تاریخچه (HISTORY)" ژوئیه ۲۰۱۸، در ابتدا توسط Peter Hunt به نشانی pehunt@redhat.com گردآوری شد \[la]mailto:pehunt@redhat.com\[ra]