.nh
.TH podman-wait 1
.SH "نام (NAME)"
podman-wait \- منتظر ماندن برای متوقف شدن یک یا چند کانتینر و چاپ کدهای خروج آن‌ها

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman wait\fP [\fIگزینه‌ها\fP] \fIکانتینر\fP [...]

.PP
\fBpodman container wait\fP [\fIگزینه‌ها\fP] \fIکانتینر\fP [...]

.SH "توضیحات (DESCRIPTION)"
منتظر متوقف شدن یک یا چند کانتینر می‌ماند. کانتینر می‌تواند با نام یا شناسه (ID) آن مشخص شود. در صورت وجود چندین کانتینر، پادمن به صورت متوالی برای هر یک منتظر می‌ماند. پس از برآورده شدن تمامی شرایط، کدهای بازگشتی کانتینرها با خط جدید از یکدیگر جدا شده و با همان ترتیبی که به دستور داده شده بودند چاپ می‌شوند. برای تمام شرایط به غیر از "stopped" و "exited"، کد خروج -1 برگردانده می‌شود.

.PP
هنگام انتظار برای کانتینرهایی با سیاست راه‌اندازی مجدد \fBalways\fR یا \fBon-failure\fR، مانند کانتینرهایی که توسط \fBpodman kube play\fR ایجاد شده‌اند، ممکن است کانتینرها مکرراً خارج شده و دوباره راه‌اندازی شوند که احتمالاً با کدهای خروج متفاوتی همراه خواهد بود. \fBpodman wait\fR فقط اولین خروج پس از شروع اجرای دستور انتظار را شناسایی و نمایش می‌دهد.

.PP
هنگام اجرای یک کانتینر با دستور
.BR "podman run --rm" ،
دستور wait منتظر حذف کامل کانتینر نمی‌ماند. برای انتظار جهت حذف کانتینر از
\fB--condition=removing\fR\&
استفاده کنید.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--condition\fP=\fIstate\fP
وضعیت یا شرط کانتینر برای منتظر ماندن. این گزینه می‌تواند چندین بار مشخص شود و در این صورت، برآورده شدن حداقل یکی از شرایط برای بازگشت دستور کافی خواهد بود. مقادیر پشتیبانی‌شده عبارتند از: "configured" ،"created" ،"exited" ،"healthy" ،"initialized" ،"paused" ،"removing" ،"running" ،"stopped" ،"stopping" و "unhealthy". شرط پیش‌فرض "stopped" است.

.SS \fB--exit-first-match\fP
تنها منتظر خروج اولین کانتینری می‌ماند که با شرایط مطابقت دارد و سایر کانتینرها را نادیده می‌گیرد.

.SS \fB--help\fP, \fB-h\fP
چاپ راهنمای استفاده از دستور

.SS \fB--ignore\fP
در صورت مفقود بودن یا یافت نشدن کانتینر مشخص‌شده، از خطاها چشم‌پوشی کرده و کد بازگشتی آن را برابر با -1 ثبت می‌کند.

.SS \fB--interval\fP, \fB-i\fP=\fIduration\fP
بازه زمانی انتظار پیش از بررسی مجدد وضعیت (polling). رشته مدت زمان، دنباله‌ای از اعداد ده‌دهی است که هر کدام می‌توانند دارای بخش کسری و پسوند واحد زمانی باشند؛ مانند "300ms"، "-1.5h" یا "2h45m". واحدهای زمانی معتبر عبارتند از "ns"، "us" (یا "µs")، "ms"، "s"، "m" و "h". واحد زمانی پیش‌فرض "ms" است.

.SS \fB--latest\fP, \fB-l\fP
به جای ارائه نام یا شناسه کانتینر، از آخرین کانتینر ایجادشده استفاده می‌کند.
توجه: آخرین کانتینر راه‌اندازی‌شده می‌تواند متعلق به کاربران دیگر پادمن بر روی رایانه میزبان باشد.
(این گزینه در کلاینت ریموت پادمن، از جمله سیستم‌های مک و ویندوز (به استثنای WSL2)، در دسترس نیست).

.SH "مثال‌ها (EXAMPLES)"
انتظار برای خروج کانتینر مشخص‌شده:

.EX
$ podman wait mywebserver
0
.EE

.PP
انتظار برای خروج آخرین کانتینر (این گزینه در کلاینت ریموت پادمن، از جمله سیستم‌های مک و ویندوز (به استثنای WSL2)، در دسترس نیست):

.EX
$ podman wait --latest
0
.EE

.PP
انتظار برای خروج کانتینر با بررسی وضعیت در هر دو ثانیه:

.EX
$ podman wait --interval 2s mywebserver
0
.EE

.PP
انتظار برای کانتینر بر اساس شناسه؛ این کانتینر با وضعیت خطای ۱ خارج می‌شود:

.EX
$ podman wait 860a4b23
1
.EE

.PP
انتظار برای خروج هر دو کانتینر مشخص‌شده:

.EX
$ podman wait mywebserver myftpserver
0
125
.EE

.PP
انتظار برای خروج کانتینر نام‌برده، بدون شکست در صورت عدم وجود کانتینر:

.EX
$ podman wait --ignore does-not-exist
-1
.EE

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

.SH "تاریخچه (HISTORY)"
سپتامبر ۲۰۱۷، در ابتدا توسط Brent Baude گردآوری شد:
\[la]mailto:bbaude@redhat.com\[ra]