.nh
.TH buildah-rmi "1" "March 2017" "buildah"
.SH "نام (NAME)"
.PP
buildah-rmi \- حذف یک یا چند ایمیج کانتینر از حافظه محلی

.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBbuildah rmi\fP [\fIimage\fP ...]

.SH "توضیحات (DESCRIPTION)"
.PP
یک یا چند ایمیج ذخیره‌شده محلی را حذف می‌کند.
ارسال آرگومان \fIimage\fP آن را همراه با هر یک از ایمیج‌های والد معلق (بدون برچسب) حذف می‌کند.

.SH "محدودیت‌ها (LIMITATIONS)"
.RS
.IP \(bu 2
اگر ایمیج با استفاده از انتقال‌دهنده 'dir:' به یک مسیر دایرکتوری ارسال (push) شده باشد، دستور rmi قادر به حذف آن نخواهد بود. در عوض، باید از دستورات استاندارد سیستم فایل استفاده شود.
.IP \(bu 2
اگر \fIimageID\fP یک نام باشد اما شامل نام رجیستری نباشد، buildah تلاش خواهد کرد ایمیج نام‌برده را با استفاده از نام رجیستری \fIlocalhost\fP پیدا و حذف کند؛ در صورتی که چنین ایمیجی پیدا نشود، با بسط دادن نام ارائه‌شده با استفاده از نام رجیستری‌های موجود در فایل پیکربندی رجیستری‌های سیستم (registries.conf)، به دنبال ایمیج مورد نظر خواهد گشت.
.IP \(bu 2
اگر \fIimageID\fP به یک \fImanifest list\fP یا \fIimage index\fP اشاره کند، این دستور آنچه انتظار دارید را انجام \fB\fIنخواهد\fR داد! این دستور ایمیج‌های مرتبط با \fImanifest list\fP یا \fIindex\fP را حذف خواهد کرد (نه خودِ لیست مانیفست/ایندکس ایمیج را). برای حذف آن، به جای این کار از زیردستور \fBbuildah manifest rm\fR استفاده کنید.

.RE

.SH "گزینه‌ها (OPTIONS)"
.PP
\fB--all\fP, \fB-a\fP

.PP
تمام ایمیج‌های محلی از سیستم حذف خواهند شد، به جز مواردی که کانتینری از آن‌ها به عنوان ایمیج مرجع استفاده می‌کند.
هنگام استفاده از این گزینه، نمی‌توان نام یا شناسه ایمیج را تعیین کرد. ایمیج‌های فقط‌خواندنی که با ویرایش "additionalimagestores" در فایل /etc/containers/storage.conf پیکربندی شده‌اند، قابل حذف نیستند.

.PP
\fB--force\fP, \fB-f\fP

.PP
این گزینه باعث می‌شود که Buildah پیش از حذف ایمیج از سیستم، تمام کانتینرهایی را که از آن ایمیج استفاده می‌کنند حذف کند.

.PP
\fB--prune\fP, \fB-p\fP

.PP
تمام ایمیج‌های محلی که فاقد برچسب هستند و هیچ ایمیج فرزندی به آن‌ها اشاره نمی‌کند، از سیستم حذف خواهند شد.
هنگام استفاده از این گزینه، نمی‌توان نام یا شناسه ایمیج را تعیین کرد.

.SH "مثال (EXAMPLE)"
.PP
buildah rmi imageID

.PP
buildah rmi --all

.PP
buildah rmi --all --force

.PP
buildah rmi --prune

.PP
buildah rmi --force imageID

.PP
buildah rmi imageID1 imageID2 imageID3

.SH "فایل‌ها (FILES)"
.PP
\fBregistries.conf\fP (\fB/etc/containers/registries.conf\fR)

.PP
فایل registries.conf فایل پیکربندی است که مشخص می‌کند هنگام تکمیل نام ایمیج‌هایی که فاقد بخش رجیستری یا دامنه هستند، به کدام رجیستری‌های کانتینر مراجعه شود.

.PP
\fBstorage.conf\fP (\fB/etc/containers/storage.conf\fR)

.PP
فایل storage.conf فایل پیکربندی ذخیره‌سازی برای تمام ابزارهایی است که از containers/storage استفاده می‌کنند.

.PP
فایل پیکربندی ذخیره‌سازی تمام گزینه‌های ذخیره‌سازی موجود کانتینر را برای ابزارهایی که از ذخیره‌سازی مشترک کانتینر استفاده می‌کنند، مشخص می‌سازد.

.SH "همچنین ببینید (SEE ALSO)"
.PP
buildah(1), containers-registries.conf(5), containers-storage.conf(5)