.TH mfssettrashretention "1" "May 2026" "MooseFS 4.59.2-1" "This is part of MooseFS"
.ss 12 0
.SH "نام (NAME)"
mfssettrashretention \- تنظیم مدت زمان نگهداری فایل‌ها در سطل زباله MooseFS
.SH "خلاصه دستور (SYNOPSIS)"
.B mfsgettrashretention
[\fB\-?\fP] [\fB\-r\fP] [\fB\-n\fP|\fB\-h\fP|\fB\-H\fP|\fB\-k\fP|\fB\-m\fP|\fB\-g\fP] \fIشیء\fP...
.PP
.B mfssettrashretention
[\fB\-?\fP] [\fB\-r\fP] [\fB\-n\fP|\fB\-h\fP|\fB\-H\fP|\fB\-k\fP|\fB\-m\fP|\fB\-g\fP] \fIزمان\fP[\fB+\fP|\fB\-\fP] \fIشیء\fP...
.PP
.B mfscopytrashretention
[\fB\-?\fP] [\fB\-r\fP] [\fB\-n\fP|\fB\-h\fP|\fB\-H\fP|\fB\-k\fP|\fB\-m\fP|\fB\-g\fP] \fIشیء_مبدأ\fP \fIشیء\fP...
.SH "توضیحات (DESCRIPTION)"
این ابزارها بر روی مقدار زمان نگهداری در سطل زباله (\fItrash retention\fP) یک شیء در سیستم‌فایل (فایل، فایل ویژه یا دایرکتوری) عمل می‌کنند؛ یعنی مدت زمانی که فایل پیش از حذف نهایی از سیستم‌فایل، در دایرکتوری ویژه سطل زباله (\fItrash\fP) نگهداری می‌شود.
مقدار \fItrash retention\fP باید یک عدد صحیح نامنفی باشد.
.PP
ابزار
.B mfsgettrashretention
مقدار فعلی \fItrash retention\fP شیء یا اشیاء داده‌شده را چاپ می‌کند.
گزینه
.B \-r
حالت بازگشتی را فعال می‌سازد که برای هر فایل داده‌شده مانند معمول عمل می‌کند، اما برای هر دایرکتوری داده‌شده، علاوه بر خود آن، مقدار فعلی \fItrash retention\fP تمام اشیاء درون آن (فایل‌ها و دایرکتوری‌ها) را نیز چاپ می‌کند.
.PP
ابزار
.B mfssettrashretention
مقدار فعلی \fItrash retention\fP شیء یا اشیاء داده‌شده را تغییر می‌دهد.
اگر مقدار جدید به صورت \fIزمان\fP\fB+\fP مشخص شود، مقدار \fItrash retention\fP برای اشیائی که مقدار کمتری دارند به \fIزمان\fP افزایش می‌یابد و برای بقیه بدون تغییر می‌ماند. به همین ترتیب، اگر مقدار جدید به صورت \fIزمان\fP\fB\-\fP مشخص شود، مقدار \fItrash retention\fP برای اشیائی که مقدار بیشتری دارند به \fIزمان\fP کاهش می‌یابد و برای بقیه بدون تغییر می‌ماند. گزینه
.B \-r
حالت بازگشتی را فعال می‌کند.
این ابزارها را می‌توان روی هر فایل، دایرکتوری یا فایل حذف‌شده (\fItrash\fP) استفاده کرد.
.PP
ابزار
.B mfscopytrashretention
برای کپی کردن مقدار \fItrash retention\fP از یک شیء به شیء دیگر استفاده می‌شود.
.PP
پارامتر \fIزمان\fP (\fITIME\fP) به عنوان یک مقدار زمان عمومی مشخص می‌شود که حداقل واحد آن ساعت است و امکان افزودن علامت + یا \- در انتهای آن وجود دارد؛ برای جزئیات بیشتر درباره قالب زمان به بخش
.B زمان (TIME)
مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
بیشتر ابزارهای
.B MooseFS
از گزینه‌های
.BR \-n ،
.BR \-h ،
.BR \-H ،
.BR \-k ،
.B \-m
و
.B \-g
برای انتخاب قالب نمایش اعداد استفاده می‌کنند. گزینه
.B \-n
باعث چاپ اعداد دقیق می‌شود،
.B \-h
از پیشوندهای دودویی (Ki، Mi، Gi به صورت ۲^۱۰، ۲^۲۰ و غیره) استفاده می‌کند در حالی که
.B \-H
از پیشوندهای SI (k، M، G به صورت ۱۰^۳، ۱۰^۶ و غیره) استفاده می‌نماید. گزینه‌های
.BR \-k ،
.B \-m
و
.B \-g
اعداد ساده را به ترتیب در قالب کیبی (کیلوی دودویی - ۱۰۲۴)، مبی (مگای دودویی - ۱۰۲۴^۲) و گیبی (گیگای دودویی - ۱۰۲۴^۳) نمایش می‌دهند.
.PP
همین رفتار را می‌توان با تنظیم متغیر محیطی
.B MFSHRFORMAT
روی مقادیر زیر نیز به دست آورد:
\fB0\fP (اعداد دقیق)، \fB1\fP یا \fBh\fP (پیشوندهای دودویی)، \fB2\fP یا \fBH\fP (پیشوندهای SI)، \fB3\fP یا \fBh+\fP (اعداد دقیق و پیشوندهای دودویی)، \fB4\fP یا \fBH+\fP (اعداد دقیق و پیشوندهای SI). حالت پیش‌فرض، چاپ اعداد دقیق است.
.PP
گزینه
.B \-?
پیام کوتاه راهنمای استفاده را نمایش می‌دهد.
.SH "نکات (NOTES)"
.SS "زمان (TIME)"
.PP
برای متغیرهای زمان، مقدار آن‌ها می‌تواند به صورت تعداد ثانیه‌ها یا ساعت‌ها (عدد صحیح)، بسته به حداقل واحد متغیر، یا به عنوان یک بازه زمانی در یکی از دو قالب ممکن تعریف شود:
.PP
قالب نخست: \fB#.#T\fP که در آن \fBT\fP یکی از این موارد است: \fBs\fP-ثانیه، \fBm\fP-دقیقه، \fBh\fP-ساعت، \fBd\fP-روز یا \fBw\fP-هفته؛ بخش‌های اعشاری حداقل واحد به مقدار عدد صحیح گرد خواهند شد.
.PP
قالب دوم: \fB#w#d#h#m#s\fP که در آن می‌توان هر تعداد از تعاریف را حذف کرد، اما تعاریف باقی‌مانده باید به ترتیب باشند (بنابراین \fB#d#m\fP یک تعریف معتبر است، اما \fB#m#d\fP معتبر نیست)؛ محدوده‌ها: \fBs,m\fP از ۰ تا ۵۹، \fBh\fP از ۰ تا ۲۳، \fBd\fP از ۰ تا ۶، \fBw\fP نامحدود است و اولین تعریف نیز همواره نامحدود است (به عنوان مثال برای \fB#d#h#m\fP مقدار \fBd\fP نامحدود خواهد بود).
.PP
اگر حداقل واحد یک متغیر بزرگ‌تر از ثانیه باشد، واحدهای کوچک‌تر از آن حداقل پذیرفته نخواهند شد. به عنوان نمونه، متغیری که حداقل واحد آن ساعت است، واحدهای \fBs\fP و \fBm\fP را نمی‌پذیرد.
.PP
مثال‌ها:
.PP
مقدار \fB1.5d\fP همانند \fB1d12h\fP و برابر با \fB36h\fP است.
.PP
مقدار \fB2.5w\fP همانند \fB2w3d12h\fP و برابر با \fB420h\fP است؛ \fB2w84h\fP یک بازه زمانی معتبر نیست (چون \fBh\fP اولین تعریف نیست، بنابراین در محدوده ۰ تا ۲۳ محدود شده است).
.SS "توارث (INHERITANCE)"
هنگامی که شیء جدیدی در MooseFS ایجاد می‌شود، مدت زمان نگهداری در سطل زباله از دایرکتوری والد به ارث برده می‌شود. یک شیء تازه‌ساخته‌شده همواره مقدار فعلی مدت زمان نگهداری والد خود را به ارث می‌برد. تغییر دادن مدت زمان نگهداری یک دایرکتوری اثری بر روی فرزندان پیش‌تر ایجادشده آن نمی‌گذارد. برای تغییر مدت زمان نگهداری یک دایرکتوری و تمام فرزندان آن، از گزینه
.B \-r
استفاده کنید.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها را به <bugs@moosefs.com> ارسال کنید.
.SH "حق نشر (COPYRIGHT)"
Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA
.PP
این فایل بخشی از MooseFS است.
.PP
MooseFS یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) نسخه ۲ (صرفاً) منتشر شده توسط بنیاد نرم‌افزارهای آزاد، بازتوزیع کرده یا تغییر دهید.
.PP
MooseFS به این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانتی؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.
.PP
شما باید همراه با این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به
<https://www.gnu.org/licenses>
مراجعه نمایید.
.SH "همچنین ببینید (SEE ALSO)"
.BR mfsmount (8),
.BR mfstrashretention (1),
.BR mfstools (1)