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

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

.SH "توضیحات (DESCRIPTION)"
حذف حجم‌های (volumes) استفاده‌نشده. به‌طور پیش‌فرض تنها حجم‌های استفاده‌نشده‌ی \fBبی‌نام\fP (anonymous) حذف می‌شوند.
حجم‌های بی‌نام مواردی هستند که هم‌زمان با یک کانتینر ایجاد شده‌اند (مانند \fBpodman run -v /path\fP بدون تعیین نام حجم).
از گزینه \fB\-\-all\fP (یا \fB\-a\fP) برای حذف تمام حجم‌های استفاده‌نشده، شامل حجم‌های دارای نام، استفاده کنید.

.PP
می‌توان از فلگ \fB\-\-filter\fP برای محدود کردن حجم‌های مدنظر استفاده کرد. پیش از حذف، از کاربر تأییدیه گرفته می‌شود مگر آنکه از گزینه \fB\-\-force\fP استفاده شده باشد.

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

.PP
گزینه \fB\-\-all\fP می‌تواند با \fB\-\-filter\fP ترکیب شود: \fB\-\-all\fP دامنه حجم‌های کاندید را به تمام حجم‌های بلااستفاده گسترش می‌دهد و سپس فیلترها مشخص می‌کنند که کدام‌یک از آن‌ها حذف گردند. به عنوان مثال، \fB\-\-all \-\-filter label!=keep\fP هر حجم استفاده‌نشده‌ای را که برچسب \fIkeep\fP نداشته باشد حذف می‌کند.

.SS \fB\-\-dry-run\fP
نمایش حجم‌هایی که بدون حذف واقعی، هرس و پاکسازی خواهند شد.

.SS \fB\-\-filter\fP
ارائه مقادیر فیلتر.

.PP
در صورت وجود بیش از یک فیلتر، گزینه \fB\-\-filter\fR باید چندین بار ارسال شود: \fB\-\-filter\fP \fIlabel=test\fP \fB\-\-filter\fP \fIuntil=10m\fP\&.

.PP
فیلترهایی با کلید یکسان به صورت اجتماع (یا/inclusive) عمل می‌کنند، با این استثنای انحصاری که فیلترهای \fBlabel\fR اشتراکی (و/exclusive) هستند. فیلترها با کلیدهای متفاوت همواره به صورت اشتراکی عمل می‌کنند.

.PP
فیلترهای پشتیبانی‌شده:

.TS
allbox;
l l 
l l .
\fBفیلتر (Filter)\fP	\fBتوضیحات (Description)\fP
all	T{
[بولی] در صورت true، حذف تمام حجم‌های استفاده‌نشده (مشابه \fB\-\-all\fP). در صورت false یا تنظیم‌نشده، فقط حجم‌های بی‌نام در نظر گرفته می‌شوند.
T}
anonymous	T{
[بولی] تنها حجم‌هایی حذف شوند که بی‌نام (true) یا دارای نام (false) هستند.
T}
label	T{
[رشته] تنها حجم‌های دارای برچسب‌های مشخص‌شده (یا فاقد آن‌ها در صورت استفاده از [...]=!label) حذف شوند.
T}
label!	T{
[رشته] تنها حجم‌های فاقد برچسب‌های مشخص‌شده حذف شوند.
T}
until	T{
[تاریخ/زمان] تنها حجم‌هایی حذف شوند که پیش از برچسب زمانی داده‌شده ایجاد شده‌اند.
T}
after/since	T{
[حجم] فیلتر بر اساس حجم‌هایی که پس از VOLUME داده‌شده (نام یا تگ) ایجاد شده‌اند.
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
\fBنکته:\fP فیلترهای \fB!label\fR با عملگر \fBAND\fP با یکدیگر ترکیب می‌شوند تا رفتاری همگام و سازگار با \fBlabel\fR داشته باشند، در حالی که در داکر با عملگر \fBOR\fP ترکیب می‌شوند\&.

.PP
فیلتر \fBuntil\fR می‌تواند برچسب‌های زمانی یونیکس (Unix timestamps)، برچسب‌های زمانی با فرمت تاریخ، یا رشته‌های بازه زمانی گو (مانند 10m یا 1h30m) باشد که نسبت به زمان سیستم محاسبه می‌شوند.

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

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

.SH "مثال‌ها (EXAMPLES)"
هرس و پاکسازی تنها حجم‌های بی‌نام و استفاده‌نشده (پیش‌فرض).

.EX
$ podman volume prune
.EE

.PP
هرس تنها حجم‌های بی‌نام و استفاده‌نشده بدون درخواست تأییدیه.

.EX
$ podman volume prune --force
.EE

.PP
حذف تمام حجم‌های استفاده‌نشده (بی‌نام و دارای نام).

.EX
$ podman volume prune --all --force
.EE

.PP
حذف تمام حجم‌های استفاده‌نشده به‌جز آن‌هایی که برچسب خاصی دارند (ترکیب \fB\-\-all\fP با یک فیلتر).

.EX
$ podman volume prune --all --force --filter label!=keep
.EE

.PP
حذف تمامی حجم‌های استفاده‌نشده با استفاده از فیلتر (معادل با \fB\-\-all\fP).

.EX
$ podman volume prune --filter all=true --force
.EE

.PP
حذف حجم‌های استفاده‌نشده‌ای که برچسب مشخص‌شده را دارند.

.EX
$ podman volume prune --filter label=mylabel=mylabelvalue
.EE

.PP
حذف حجم‌های استفاده‌نشده‌ای که کلید/مقدار برچسب مشخص‌شده را ندارند:

.EX
$ podman volume prune --filter label!=mylabel=mylabelvalue
.EE

.PP
حذف حجم‌های استفاده‌نشده‌ای که یک کلید برچسب مشخص را دارند (صرف‌نظر از مقدار آن):

.EX
$ podman volume prune --filter label=environment
.EE

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

.EX
$ podman volume prune --filter label!=environment
.EE

.PP
پیش‌نمایش تمام حجم‌های بلااستفاده بدون حذف واقعی آن‌ها.

.EX
$ podman volume prune --all --dry-run
.EE

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

.SH "تاریخچه (HISTORY)"
نوامبر ۲۰۱۸، نگارش اولیه توسط Urvashi Mohnani umohnani@redhat.com
\[la]mailto:umohnani@redhat.com\[ra]