.nh
.TH podman-pod-rm 1
.SH "نام (NAME)"
podman-pod-rm \- حذف یک یا چند پاد متوقف‌شده و کانتینرهای آن‌ها

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

.SH "توضیحات (DESCRIPTION)"
دستور \fBpodman pod rm\fP یک یا چند پاد متوقف‌شده و کانتینرهای آن‌ها را از سیستم میزبان حذف می‌کند. می‌توان از نام یا شناسه پاد استفاده کرد. گزینه \fB-f\fR ابتدا همه کانتینرها را متوقف کرده و سپس پیش از حذف پاد، آن‌ها را پاک می‌کند. اگر تمام کانتینرهای اضافه‌شده توسط کاربر در وضعیت خارج‌شده (exited) باشند، پاد حذف می‌شود.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--all\fP, \fB-a\fP
حذف تمام پادها. همچنین می‌تواند همراه با \fB-f\fR استفاده شود.

.SS \fB--force\fP, \fB-f\fP
متوقف کردن کانتینرهای در حال اجرا و حذف تمام کانتینرهای متوقف‌شده پیش از حذف پاد.

.SS \fB--ignore\fP, \fB-i\fP
نادیده گرفتن خطاها در صورتی که پادهای مشخص‌شده در ذخیره‌ساز کانتینر وجود نداشته باشند. ممکن است کاربر تصمیم به حذف دستی یک پاد گرفته باشد که این امر در طول دستورالعمل ExecStop یک سرویس systemd که به آن پاد ارجاع می‌دهد، منجر به خطا می‌شود.

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

.SS \fB--pod-id-file\fP=\fIfile\fP
شناسه پاد را از \fIfile\fP مشخص‌شده می‌خواند و پاد را حذف می‌کند. می‌تواند چندین بار مشخص شود.

.PP
در صورت مشخص شدن، فایل شناسه پاد (pod-id-file) همراه با پاد حذف می‌شود.

.SS \fB--time\fP, \fB-t\fP=\fIseconds\fP
مدت زمان بر حسب ثانیه برای انتظار پیش از متوقف کردن اجباری کانتینرهای در حال اجرا درون پاد.
برای انتظار نامحدود از \fB\-1\fR استفاده کنید.

.PP
برای استفاده از گزینه \fB--time\fR، گزینه \fB--force\fR باید حتماً مشخص شده باشد.

.SH "مثال‌ها (EXAMPLES)"
حذف پاد با نام داده‌شده:

.EX
podman pod rm mywebserverpod
.EE

.PP
حذف چند پاد با نام‌ها و/یا شناسه‌های داده‌شده:

.EX
podman pod rm mywebserverpod myflaskserverpod 860a4b23
.EE

.PP
حذف اجباری پاد با شناسه داده‌شده:

.EX
podman pod rm -f 860a4b23
.EE

.PP
حذف اجباری تمام پادها:

.EX
podman pod rm -f -a
podman pod rm -fa
.EE

.PP
حذف پاد با استفاده از شناسه مشخص‌شده در فایل داده‌شده:

.EX
podman pod rm --pod-id-file /path/to/id/file
.EE

.SH "وضعیت خروج (EXIT STATUS)"
\fB0\fP تمام پادهای مشخص‌شده حذف شدند

.PP
\fB1\fP یکی از پادهای مشخص‌شده وجود نداشت و هیچ خطای دیگری رخ نداد

.PP
\fB2\fP یکی از پادهای مشخص‌شده به یک کانتینر متصل است

.PP
\fB125\fP دستور به هر دلیل دیگری با شکست مواجه شد

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

.SH "تاریخچه (HISTORY)"
ژوئیه ۲۰۱۸، در ابتدا توسط پیتر هانت (Peter Hunt) گردآوری شد pehunt@redhat.com
\[la]mailto:pehunt@redhat.com\[ra]