'\" t
.nh
.TH podman-image-prune 1
.SH "نام (NAME)"
podman-image-prune \- حذف تمام ایمیج‌های بلااستفاده از فضای ذخیره‌سازی محلی

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

.SH "توضیحات (DESCRIPTION)"
دستور \fBpodman image prune\fP تمام ایمیج‌های معلق (dangling) را از فضای ذخیره‌سازی محلی حذف می‌کند. با گزینه \fBall\fR،
تمام ایمیج‌های بلااستفاده حذف می‌شوند (یعنی ایمیج‌هایی که توسط هیچ کانتینری استفاده نمی‌شوند).

.PP
دستور image prune ایمیج‌های کَش (cache) را که فقط از لایه‌های مورد نیاز سایر ایمیج‌ها استفاده می‌کنند حذف نمی‌کند.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--all\fP, \fB-a\fP
حذف ایمیج‌های معلق و ایمیج‌هایی که هیچ کانتینر مرتبطی ندارند.

.SS \fB--build-cache\fP
حذف کَش ساخت پایدار ایجادشده برای \fB--mount=type=cache\fR\&.

.SS \fB--external\fP
حذف ایمیج‌ها حتی زمانی که توسط کانتینرهای خارجی (مانند کانتینرهای ساخت) استفاده می‌شوند.

.SS \fB--filter\fP=\fIfilters\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
label	T{
فقط ایمیج‌های دارای برچسب‌های مشخص‌شده (یا فاقد آن‌ها، در صورتی که از [...]!=label استفاده شود) را حذف می‌کند.
T}
until	T{
فقط ایمیج‌هایی را که قبل از برچسب زمانی داده‌شده ایجاد شده‌اند حذف می‌کند.
T}
.TE

.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) باشد که نسبت به زمان جاری ماشین محاسبه می‌شوند.

.SS \fB--force\fP, \fB-f\fP
درخواست تایید تعاملی برای حذف ایمیج‌ها نمایش داده نمی‌شود.

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

.SH "مثال‌ها (EXAMPLES)"
حذف تمام ایمیج‌های معلق از فضای ذخیره‌سازی محلی:

.EX
$ sudo podman image prune

WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N] y
f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907
.EE

.PP
حذف تمام ایمیج‌های بلااستفاده از فضای ذخیره‌سازی محلی بدون نیاز به تایید:

.EX
$ sudo podman image prune -a -f
f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907
6125002719feb1ddf3030acab1df6156da7ce0e78e571e9b6e9c250424d6220c
91e732da5657264c6f4641b8d0c4001c218ae6c1adb9dcef33ad00cafd37d8b6
e4e5109420323221f170627c138817770fb64832da7d8fe2babd863148287fca
77a57fa8285e9656dbb7b23d9efa837a106957409ddd702f995605af27a45ebe

.EE

.PP
حذف تمام ایمیج‌های بلااستفاده از فضای ذخیره‌سازی محلی از زمان/ساعت داده‌شده به بعد:

.EX
$ sudo podman image prune -a --filter until=2019-11-14T06:15:42.937792374Z

WARNING! This will remove all dangling images.
Are you sure you want to continue? [y/N] y
e813d2135f17fadeffeea8159a34cfdd4c30b98d8111364b913a91fd930643e9
5e6572320437022e2746467ddf5b3561bf06e099e8e6361df27e0b2a7ed0b17b
58fda2abf5042b35dfe04e5f8ee458a3cc26375bf309efb42c078b551a2055c7
6d2bd30fe924d3414b64bd3920760617e6ced872364bc3bc6959a623252da002
33d1c829be64a1e1d379caf4feec1f05a892c3ef7aa82c0be53d3c08a96c59c5
f9f0a8a58c9e02a2b3250b88cc5c95b1e10245ca2c4161d19376580aaa90f55c
1ef14d5ede80db78978b25ad677fd3e897a578c3af614e1fda608d40c8809707
45e1482040e441a521953a6da2eca9bafc769e15667a07c23720d6e0cafc3ab2

$ sudo podman image prune -f --filter until=10h
f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907
.EE

.PP
حذف تمام ایمیج‌های بلااستفاده از فضای ذخیره‌سازی محلی با برچسب نسخه 1.0:

.EX
$ sudo podman image prune -a -f --filter label=version=1.0
e813d2135f17fadeffeea8159a34cfdd4c30b98d8111364b913a91fd930643e9
5e6572320437022e2746467ddf5b3561bf06e099e8e6361df27e0b2a7ed0b17b
58fda2abf5042b35dfe04e5f8ee458a3cc26375bf309efb42c078b551a2055c7
6d2bd30fe924d3414b64bd3920760617e6ced872364bc3bc6959a623252da002
33d1c829be64a1e1d379caf4feec1f05a892c3ef7aa82c0be53d3c08a96c59c5
f9f0a8a58c9e02a2b3250b88cc5c95b1e10245ca2c4161d19376580aaa90f55c
1ef14d5ede80db78978b25ad677fd3e897a578c3af614e1fda608d40c8809707
45e1482040e441a521953a6da2eca9bafc769e15667a07c23720d6e0cafc3ab2
.EE

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

.SH "تاریخچه (HISTORY)"
دسامبر ۲۰۱۸، در ابتدا توسط Brent Baude تدوین شد (bbaude at redhat dot com)
.br
دسامبر ۲۰۲۰، اطلاعات فیلترها از مستندات docs.docker.com توسط Dan Walsh تبدیل شد (dwalsh at redhat dot com)