.TH mfstrashretention "1" "May 2026" "MooseFS 4.59.2-1" "This is part of MooseFS" .ss 12 0 .SH "نام (NAME)" mfstrashretention \- ابزارهای مدیریت مدت نگهداری در سطل زباله 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] \fIOBJECT\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] \fITIME\fP[\fB+\fP|\fB-\fP] \fIOBJECT\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] \fISOURCE_OBJECT\fP \fIOBJECT\fP... .SH "توضیحات (DESCRIPTION)" این ابزارها بر روی مقدار \fIمدت نگهداری در سطل زباله\fP (\fItrash retention\fP) یک شیء سیستم‌فایل (فایل، فایل ویژه یا دایرکتوری) عمل می‌کنند، یعنی مدت زمانی که فایل در دایرکتوری ویژه سطل زباله (\fItrash\fP) نگهداری می‌شود پیش از آنکه در نهایت از سیستم‌فایل حذف گردد. مقدار \fItrash retention\fP باید یک عدد صحیح نامنفی باشد. .PP دستور \fBmfsgettrashretention\fP مقدار فعلی \fItrash retention\fP شیء (یا اشیاء) داده‌شده را چاپ می‌کند. گزینه \fB-r\fP حالت بازگشتی را فعال می‌سازد که برای هر فایل داده‌شده مانند معمول عمل می‌کند، اما برای هر دایرکتوری داده‌شده، علاوه بر خود آن، مقدار فعلی \fItrash retention\fP تمام اشیاء درون آن (فایل‌ها و دایرکتوری‌ها) را نیز چاپ می‌نماید. .PP دستور \fBmfssettrashretention\fP مقدار فعلی \fItrash retention\fP شیء (یا اشیاء) داده‌شده را تغییر می‌دهد. اگر مقدار جدید به صورت \fITIME\fP\fB+\fP مشخص شود، مقدار \fItrash retention\fP برای اشیائی با مقدار کمتر به \fITIME\fP افزایش می‌یابد و برای سایر اشیاء بدون تغییر می‌ماند. به همین ترتیب، اگر مقدار جدید به صورت \fITIME\fP\fB\-\fP مشخص شود، مقدار \fItrash retention\fP برای اشیائی با مقدار بیشتر به \fITIME\fP کاهش یافته و برای سایر اشیاء بدون تغییر باقی می‌ماند. گزینه \fB-r\fP حالت بازگشتی را فعال می‌کند. این ابزارها را می‌توان بر روی هر فایل، دایرکتوری یا فایل حذف‌شده (\fItrash\fP) استفاده کرد. .PP ابزار \fBmfscopytrashretention\fP برای کپی کردن مقدار \fItrash retention\fP از یک شیء به شیء دیگر به کار می‌رود. .PP پارامتر \fITIME\fP به صورت یک مقدار کلی از نوع زمان مشخص می‌شود که حداقل واحد آن ساعت است و امکان افزودن علامت + یا \- در انتهای آن وجود دارد؛ برای جزئیات درباره قالب زمان، بخش TIME را ببینید. .SH "گزینه‌ها (OPTIONS)" بیشتر ابزارهای \fBMooseFS\fP از گزینه‌های \fB-n\fP، \fB-h\fP، \fB-H\fP، \fB-k\fP، \fB-m\fP و \fB-g\fP برای انتخاب قالب نمایش اعداد استفاده می‌کنند. \fB-n\fP باعث چاپ اعداد دقیق می‌شود، \fB-h\fP از پیشوندهای دودویی (Ki، Mi، Gi به صورت ۲^۱۰، ۲^۲۰ و غیره) استفاده می‌کند در حالی که \fB-H\fP از پیشوندهای SI (k، M، G به صورت ۱۰^۳، ۱۰^۶ و غیره) استفاده می‌نماید. گزینه‌های \fB-k\fP، \fB-m\fP و \fB-g\fP اعداد ساده را به ترتیب در قالب کیبی (کیلوی دودویی - ۱۰۲۴)، مبی (مگای دودویی - ۱۰۲۴^۲) و گیبی (گیگای دودویی - ۱۰۲۴^۳) نمایش می‌دهند. همین نتیجه را می‌توان با تنظیم متغیر محیطی \fBMFSHRFORMAT\fP روی مقادیر زیر به دست آورد: \fB0\fP (اعداد دقیق)، \fB1\fP یا \fBh\fP (پیشوندهای دودویی)، \fB2\fP یا \fBH\fP (پیشوندهای SI)، \fB3\fP یا \fBh+\fP (اعداد دقیق و پیشوندهای دودویی)، \fB4\fP یا \fBH+\fP (اعداد دقیق و پیشوندهای SI). حالت پیش‌فرض فقط چاپ اعداد دقیق است. .PP گزینه \fB-?\fP پیام کوتاه راهنمای استفاده را نمایش می‌دهد. .SH "نکات (NOTES)" .SS TIME .PP برای متغیرهای زمان، مقدار آن‌ها می‌تواند بسته به حداقل واحد متغیر به صورت تعداد ثانیه یا ساعت (عدد صحیح) تعریف شود، یا به عنوان یک بازه زمانی در یکی از دو قالب ممکن زیر مشخص گردد: .PP قالب اول: #.#T که در آن T یکی از این موارد است: s (ثانیه)، m (دقیقه)، h (ساعت)، d (روز) یا w (هفته)؛ بخش‌های کسریِ حداقل واحد به مقدار عدد صحیح گرد خواهند شد. .PP قالب دوم: #w#d#h#m#s، هر تعداد از تعاریف را می‌توان حذف کرد، اما تعاریف باقی‌مانده باید دارای ترتیب باشند (بنابراین #d#m همچنان یک تعریف معتبر است، اما #m#d معتبر نیست)؛ محدوده‌ها: s و m از 0 تا 59، h از 0 تا 23، d از 0 تا 6، مقدار w نامحدود است و اولین تعریف نیز همواره نامحدود است (یعنی برای #d#h#m مقدار d نامحدود خواهد بود). .PP اگر حداقل واحد یک متغیر بزرگ‌تر از ثانیه باشد، واحدهای پایین‌تر از آن واحد پذیرفته نخواهند شد. به عنوان مثال، متغیری که دارای حداقل واحد ساعت است، واحدهای s و m را نمی‌پذیرد. .PP مثال‌ها: .PP مقدار 1.5d همان 1d12h و برابر با 36h است. .PP مقدار 2.5w همان 2w3d12h و برابر با 420h است؛ 2w84h یک بازه زمانی معتبر نیست (زیرا h اولین تعریف نیست، بنابراین به محدوده 0 تا 23 محدود است). .SS INHERITANCE هنگامی که شیء جدیدی در MooseFS ایجاد می‌شود، مدت نگهداری در سطل زباله (trash retention) از دایرکتوری والد به ارث برده می‌شود. یک شیء تازه‌ساخته‌شده همواره مقدار فعلی trash retention والد خود را به ارث می‌برد. تغییر دادن trash retention یک دایرکتوری، تاثیری بر فرزندانی که قبلاً ایجاد شده‌اند نخواهد داشت. برای تغییر دادن trash retention برای یک دایرکتوری و تمام فرزندان آن، از گزینه \fB-r\fP استفاده کنید. .SH "گزارش باگ‌ها (REPORTING BUGS)" گزارش باگ‌ها را به ارسال کنید. .SH "حق نشر (COPYRIGHT)" Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA .PP این فایل بخشی از MooseFS است. .PP نرم‌افزار MooseFS یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) نسخه ۲ (صرفاً) منتشر شده توسط بنیاد نرم‌افزارهای آزاد، بازتوزیع کرده یا تغییر دهید. .PP نرم‌افزار MooseFS به این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانتی؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید. .PP شما باید همراه با این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به مراجعه نمایید. .SH "همچنین ببینید (SEE ALSO)" .BR mfsmount (8), .BR mfstools (1)