mfstrashretention(1) This is part of MooseFS mfstrashretention(1)

mfstrashretention - ابزارهای مدیریت مدت نگهداری در سطل زباله MooseFS

mfsgettrashretention [-?] [-r] [-n|-h|-H|-k|-m|-g] OBJECT...

mfssettrashretention [-?] [-r] [-n|-h|-H|-k|-m|-g] TIME[+|-] OBJECT...

mfscopytrashretention [-?] [-r] [-n|-h|-H|-k|-m|-g] SOURCE_OBJECT OBJECT...

این ابزارها بر روی مقدار مدت نگهداری در سطل زباله (trash retention) یک شیء سیستم‌فایل (فایل، فایل ویژه یا دایرکتوری) عمل می‌کنند، یعنی مدت زمانی که فایل در دایرکتوری ویژه سطل زباله (trash) نگهداری می‌شود پیش از آنکه در نهایت از سیستم‌فایل حذف گردد. مقدار trash retention باید یک عدد صحیح نامنفی باشد.

دستور mfsgettrashretention مقدار فعلی trash retention شیء (یا اشیاء) داده‌شده را چاپ می‌کند. گزینه -r حالت بازگشتی را فعال می‌سازد که برای هر فایل داده‌شده مانند معمول عمل می‌کند، اما برای هر دایرکتوری داده‌شده، علاوه بر خود آن، مقدار فعلی trash retention تمام اشیاء درون آن (فایل‌ها و دایرکتوری‌ها) را نیز چاپ می‌نماید.

دستور mfssettrashretention مقدار فعلی trash retention شیء (یا اشیاء) داده‌شده را تغییر می‌دهد. اگر مقدار جدید به صورت TIME+ مشخص شود، مقدار trash retention برای اشیائی با مقدار کمتر به TIME افزایش می‌یابد و برای سایر اشیاء بدون تغییر می‌ماند. به همین ترتیب، اگر مقدار جدید به صورت TIME- مشخص شود، مقدار trash retention برای اشیائی با مقدار بیشتر به TIME کاهش یافته و برای سایر اشیاء بدون تغییر باقی می‌ماند. گزینه -r حالت بازگشتی را فعال می‌کند. این ابزارها را می‌توان بر روی هر فایل، دایرکتوری یا فایل حذف‌شده (trash) استفاده کرد.

ابزار mfscopytrashretention برای کپی کردن مقدار trash retention از یک شیء به شیء دیگر به کار می‌رود.

پارامتر TIME به صورت یک مقدار کلی از نوع زمان مشخص می‌شود که حداقل واحد آن ساعت است و امکان افزودن علامت + یا - در انتهای آن وجود دارد؛ برای جزئیات درباره قالب زمان، بخش TIME را ببینید.

بیشتر ابزارهای MooseFS از گزینه‌های -n، -h، -H، -k، -m و -g برای انتخاب قالب نمایش اعداد استفاده می‌کنند. -n باعث چاپ اعداد دقیق می‌شود، -h از پیشوندهای دودویی (Ki، Mi، Gi به صورت ۲^۱۰، ۲^۲۰ و غیره) استفاده می‌کند در حالی که -H از پیشوندهای SI (k، M، G به صورت ۱۰^۳، ۱۰^۶ و غیره) استفاده می‌نماید. گزینه‌های -k، -m و -g اعداد ساده را به ترتیب در قالب کیبی (کیلوی دودویی - ۱۰۲۴)، مبی (مگای دودویی - ۱۰۲۴^۲) و گیبی (گیگای دودویی - ۱۰۲۴^۳) نمایش می‌دهند. همین نتیجه را می‌توان با تنظیم متغیر محیطی MFSHRFORMAT روی مقادیر زیر به دست آورد: 0 (اعداد دقیق)، 1 یا h (پیشوندهای دودویی)، 2 یا H (پیشوندهای SI)، 3 یا h+ (اعداد دقیق و پیشوندهای دودویی)، 4 یا H+ (اعداد دقیق و پیشوندهای SI). حالت پیش‌فرض فقط چاپ اعداد دقیق است.

گزینه -? پیام کوتاه راهنمای استفاده را نمایش می‌دهد.

برای متغیرهای زمان، مقدار آن‌ها می‌تواند بسته به حداقل واحد متغیر به صورت تعداد ثانیه یا ساعت (عدد صحیح) تعریف شود، یا به عنوان یک بازه زمانی در یکی از دو قالب ممکن زیر مشخص گردد:

قالب اول: #.#T که در آن T یکی از این موارد است: s (ثانیه)، m (دقیقه)، h (ساعت)، d (روز) یا w (هفته)؛ بخش‌های کسریِ حداقل واحد به مقدار عدد صحیح گرد خواهند شد.

قالب دوم: #w#d#h#m#s، هر تعداد از تعاریف را می‌توان حذف کرد، اما تعاریف باقی‌مانده باید دارای ترتیب باشند (بنابراین #d#m همچنان یک تعریف معتبر است، اما #m#d معتبر نیست)؛ محدوده‌ها: s و m از 0 تا 59، h از 0 تا 23، d از 0 تا 6، مقدار w نامحدود است و اولین تعریف نیز همواره نامحدود است (یعنی برای #d#h#m مقدار d نامحدود خواهد بود).

اگر حداقل واحد یک متغیر بزرگ‌تر از ثانیه باشد، واحدهای پایین‌تر از آن واحد پذیرفته نخواهند شد. به عنوان مثال، متغیری که دارای حداقل واحد ساعت است، واحدهای s و m را نمی‌پذیرد.

مثال‌ها:

مقدار 1.5d همان 1d12h و برابر با 36h است.

مقدار 2.5w همان 2w3d12h و برابر با 420h است؛ 2w84h یک بازه زمانی معتبر نیست (زیرا h اولین تعریف نیست، بنابراین به محدوده 0 تا 23 محدود است).

هنگامی که شیء جدیدی در MooseFS ایجاد می‌شود، مدت نگهداری در سطل زباله (trash retention) از دایرکتوری والد به ارث برده می‌شود. یک شیء تازه‌ساخته‌شده همواره مقدار فعلی trash retention والد خود را به ارث می‌برد. تغییر دادن trash retention یک دایرکتوری، تاثیری بر فرزندانی که قبلاً ایجاد شده‌اند نخواهد داشت. برای تغییر دادن trash retention برای یک دایرکتوری و تمام فرزندان آن، از گزینه -r استفاده کنید.

گزارش باگ‌ها را به <bugs@moosefs.com> ارسال کنید.

Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA

این فایل بخشی از MooseFS است.

نرم‌افزار MooseFS یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) نسخه ۲ (صرفاً) منتشر شده توسط بنیاد نرم‌افزارهای آزاد، بازتوزیع کرده یا تغییر دهید.

نرم‌افزار MooseFS به این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانتی؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

شما باید همراه با این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به https://www.gnu.org/licenses مراجعه نمایید.

mfsmount(8), mfstools(1)

May 2026 MooseFS 4.59.2-1