'\" t
.nh
.TH podman-system-prune 1
.SH "نام (NAME)"
podman-system-prune \- پاکسازی تمامی پادها، کانتینرها، ایمیج‌ها، شبکه‌ها و داده‌های حجم بدون استفاده

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

.SH "توضیحات (DESCRIPTION)"
دستور
\fBpodman system prune\fP
تمامی کانتینرهای بدون استفاده (اعم از معلق/dangling و بدون ارجاع)، کانتینرهای ساخت (build containers)، پادها، شبکه‌ها و در صورت تمایل، حجم‌ها را از فضای ذخیره‌سازی محلی پاکسازی و حذف می‌کند.

.PP
برای حذف تمام ایمیج‌های بدون استفاده از گزینه
\fB--all\fP
استفاده کنید. ایمیج‌های بدون استفاده شامل ایمیج‌های معلق و همچنین هر ایمیجی هستند که هیچ کانتینری بر اساس آن ایجاد نشده باشد.

.PP
به‌طور پیش‌فرض، حجم‌ها (volumes) حذف نمی‌شوند تا در صورتی که در حال حاضر هیچ کانتینری از حجم استفاده نمی‌کند، از پاک شدن داده‌های مهم جلوگیری شود. هنگام اجرای دستور، از فلگ
\fB--volumes\fP
برای پاکسازی حجم‌ها نیز استفاده کنید.

.PP
به‌طور پیش‌فرض، کانتینرهای ساخت حذف نمی‌شوند تا از تداخل با ساخت‌های در حال انجام جلوگیری شود. هنگام اجرای دستور، از فلگ
\fB--build\fP
برای حذف کانتینرهای ساخت نیز استفاده نمایید.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--all\fP, \fB-a\fP
حذف بازگشتی تمامی پادها، کانتینرها، ایمیج‌ها، شبکه‌ها و داده‌های حجم بدون استفاده (حداکثر ۵۰ تکرار).

.SS \fB--build\fP
حذف هرگونه کانتینر ساختی که در حین فرآیند ساخت ایجاد شده، اما به دلیل خاتمه غیرمنتظره ساخت حذف نشده است.

.PP
توجه:
\fBاین یک عملیات امن نیست و تنها زمانی باید اجرا شود که هیچ فرآیند ساختی در حال انجام نباشد؛ زیرا می‌تواند در فرآیندهای ساخت در حال اجرا تداخل ایجاد کند.\fP

.SS \fB--external\fP
تلاش برای پاکسازی بقایای کانتینرها یا لایه‌های قبلی که در فایل‌های json فضای ذخیره‌سازی ارجاع داده نشده‌اند. این موارد ممکن است در هنگام خاموش شدن‌های نادرست یا راه‌اندازی‌های مجدد متداول در حالت ذخیره‌سازی گذرا (transient storage mode) رخ دهند.

.PP
با این حال، هنگام استفاده از حالت ذخیره‌سازی گذرا، پایگاه‌داده پودمن پایدار باقی نمی‌ماند. این بدان معناست که کانتینرها پس از راه‌اندازی مجدد، لایه‌های قابل‌نوشتن را روی دیسک باقی می‌گذارند. هنگام استفاده از حافظه گذرا، توصیه می‌شود دستور
\fBpodman system prune --external\fP
در حین بوت سیستم اجرا شود.

.PP
این گزینه با
\fB--all\fP
و
\fB--filter\fP
ناسازگار است و رفتار پیش‌فرض مبنی بر حذف منابع بدون استفاده را لغو می‌کند.

.SS \fB--filter\fP=\fIفیلترها\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\fBفیلتر\fP\fP	\fB\fBتوضیحات\fP\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
می‌تواند برچسب‌های زمانی یونیکس، برچسب‌های زمانی با فرمت تاریخ، یا رشته‌های مدت‌زمان زبان Go (مانند 10m یا 1h30m) باشد که نسبت به زمان ماشین محاسبه می‌شوند.

.SS \fB--force\fP, \fB-f\fP
عدم درخواست تایید از کاربر.

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

.SS \fB--volumes\fP
پاکسازی حجم‌هایی که در حال حاضر توسط هیچ کانتینری استفاده نمی‌شوند.

.SH "مثال‌ها (EXAMPLES)"
پاکسازی تمام کانتینرها، پادها، شبکه‌ها و ایمیج‌های معلق:

.EX
$ podman system prune
WARNING! This command removes:
	- all stopped containers
	- all networks not used by at least one container
	- all dangling images
	- all dangling build cache

Are you sure you want to continue? [y/N] y
Total reclaimed space: 0B
.EE

.PP
پاکسازی تمام کانتینرها، پادها و شبکه‌هایی که در حال استفاده نیستند:

.EX
$ podman system prune --all
WARNING! This command removes:
	- all stopped containers
	- all networks not used by at least one container
	- all images without at least one container associated with them
	- all build cache

Are you sure you want to continue? [y/N] y
Deleted Images
ce21f047f73644dcb9cd55ad247433fb47ade48ad4f4e676881fbcb2d5735c76
c874afc1f445044eaa821da0c32328707406e546a688d8c4c22587a5f88a1992
2fce09cfad57c6de112654eeb6f6da1851f3ced1cff7ac0002378642c2c7ca84
0cd6d2e072175191823999cd189f8d262ba5e460271095570d8cffb1d9072e9a
172bdaffe628cc7b7f8b7b6695438afc612a9833382f5968a06740a3804c3b64
bf07fec943ec23054f3b81c0e65926a1c83dc82c50933dc6372c60e09fdb2d4f
b2f735cbb571dd6a28e66455af0623ecc81f9c5b74259d3e04b3bac3b178e965
cea2ff433c610f5363017404ce989632e12b953114fefc6f597a58e813c15d61
Deleted Networks
podman-default-kube-network
Total reclaimed space: 3.372GB
.EE

.PP
پاکسازی تمامی کانتینرها، کانتینرهای ساخت، پادها، شبکه‌ها و ایمیج‌های معلق:

.EX
$ podman system prune --build
WARNING! This command removes:
	- all stopped containers
	- all networks not used by at least one container
	- all build containers
	- all dangling images
	- all dangling build cache

Are you sure you want to continue? [y/N] y
Deleted Containers
a8bfed41990114767c933d27bf5508b01cdc0f641dc36037b349648347c6ea64
Deleted Images
055733a33e7a78efa27d3c682df97a9e0489133bef071745144c8d0edda2d708
Total reclaimed space: 1.4GB
.EE

.PP
پاکسازی کانتینرها بر اساس برچسب:

.EX
$ podman system prune --filter label=role=cleanup
WARNING! This command removes:
        - all stopped containers
        - all networks not used by at least one container
        - all dangling images
        - all dangling build cache

Are you sure you want to continue? [y/N] y
Deleted Containers
5cd96fb787274db888f8b587c3690be1edea25b7f66b030037c528e2cea10b34
Total reclaimed space: 24.55kB
.EE

.PP
پاکسازی کانتینرها با فیلتر until:

.EX
$ podman system prune --filter until=2m
WARNING! This command removes:
        - all stopped containers
        - all networks not used by at least one container
        - all dangling images
        - all dangling build cache

Are you sure you want to continue? [y/N] y
Deleted Containers
a12f9f6f2d901bc145c1e2c27dc8e5e2d04050854f4d9e01a6e10b1019e2d345
0d08f2e467cbff04b63ccd83efeb6ccc6161f54c27d5100d1194defe7ea73cf7
815dc403e1bc85bfa4a9d3184cbbe77fd019ea66780bf0b42e8726d5956d9bd3
Total reclaimed space: 74.14kB
.EE

.PP
پاکسازی همراه با فلگ
.BR \-\-force :

.EX
$ podman system prune --force
Total reclaimed space: 0B
.EE

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

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