نام (NAME)

mfseattr - ابزارهای مدیریت مشخصه‌های اضافی MooseFS

خلاصه دستور (SYNOPSIS)

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

mfsseteattr [-?] [-r] [-n|-h|-H|-k|-m|-g] -f ATTRNAME [-f ATTRNAME ...] OBJECT...

mfsdeleattr [-?] [-r] [-n|-h|-H|-k|-m|-g] -a | -f ATTRNAME [-f ATTRNAME ...] OBJECT...

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

توضیحات (DESCRIPTION)

این ابزارها برای دریافت، تنظیم یا حذف برخی مشخصه‌ها و ویژگی‌های اضافی (فلگ‌ها) استفاده می‌شوند.

دستور mfsgeteattr مشخصه‌های اضافی شیء مشخص‌شده را نمایش می‌دهد. اگر گزینه -r استفاده شود، این ابزار آمار استفاده از تمام مشخصه‌ها را در سرتاسر درخت دایرکتوری تعیین‌شده توسط OBJECT نمایش خواهد داد.

دستور mfsseteattr مشخصه تعیین‌شده با -f را تنظیم می‌کند. گزینه -f می‌تواند بیش از یک بار استفاده شود تا چندین مشخصه با یک دستور تنظیم شوند. در صورت استفاده از گزینه -r، مشخصه‌های تعیین‌شده به صورت بازگشتی تنظیم می‌شوند.

دستور mfsdeleattr مشخصه تعیین‌شده با -f را حذف (پاک) می‌کند. گزینه -f می‌تواند بیش از یک بار به کار رود تا چند مشخصه با یک دستور حذف شوند. به عنوان روش دیگر، می‌توان از گزینه -a برای حذف همه مشخصه‌های اضافی موجود استفاده کرد. در صورت استفاده از گزینه -r، مشخصه‌های تعیین‌شده به صورت بازگشتی حذف می‌شوند.

دستور mfscopyeattr مجموعه مشخصه‌های کنونی SOURCE_OBJECT را به OBJECT کپی می‌کند. این یک کپی دقیق است؛ بنابراین هر مشخصه‌ای که OBJECT داشته باشد ولی SOURCE_OBJECT نداشته باشد پاک خواهد شد. در صورت استفاده از گزینه -r، مشخصه‌ها به صورت بازگشتی کپی می‌شوند.

گزینه‌ها (OPTIONS)

مشخصه‌ها (ATTRIBUTES)

noowner این فلگ بدین معناست که شیء مدنظر متعلق به کاربر جاری است (uid و gid برابر با مقادیر uid و gid فرایند دسترسی‌کننده هستند). فقط مدیر سیستم (ریشه با uid=0) مقادیر واقعی uid و gid را می‌بیند.

noattrcache این فلگ بدین معناست که مشخصه‌های استاندارد فایل مانند uid، gid، حالت (mode)، طول و غیره در حافظه پنهان (کَش) هسته ذخیره نخواهند شد.

noentrycache این فلگ مشابه مورد بالاست و از ذخیره شدن ورودی‌های دایرکتوری در حافظه پنهان هسته جلوگیری می‌کند.

nodatacache این فلگ مشخص می‌کند که داده‌ها هرگز نباید در حافظه پنهان هسته نگهداری شوند (مشابه فلگ باز کردن O_DIRECT).

snapshot این فلگ نشان می‌دهد که شیء از طریق دستور mfsmakesnapshot ایجاد شده است.

undeletable این فلگ مانع از حذف پیوند (unlink) می‌شود (تنها مخصوص مدیر سیستم؛ به ارث برده نمی‌شود).

appendonly شیء دارای این فلگ تنها می‌تواند داده جدید به انتهایش اضافه شود (append-only)؛ حذف پیوند و سایر تغییرات مجاز نیستند (تنها مخصوص مدیر سیستم؛ به ارث برده نمی‌شود).

immutable این فلگ از هرگونه تغییر در شیء داده‌شده جلوگیری می‌کند (تنها مخصوص مدیر سیستم؛ به ارث برده نمی‌شود).

گزینه‌های عمومی (GENERAL OPTIONS)

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

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

نکات (NOTES)

توارث (INHERITANCE)

هنگامی که شیء جدیدی در MooseFS ایجاد می‌شود، مشخصه‌های اضافی از دایرکتوری والد به ارث برده می‌شوند. یک شیء تازه ایجاد شده همواره مجموعه مشخصه‌های کنونی والد خود را به ارث می‌برد. تغییر دادن مشخصه یک دایرکتوری بر فرزندانی که قبلاً ایجاد شده‌اند تأثیری نمی‌گذارد. برای تغییر دادن یک مشخصه برای یک دایرکتوری و تمامی فرزندان آن، از گزینه -r استفاده کنید.

گزارش باگ‌ها (REPORTING BUGS)

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

حق نشر (COPYRIGHT)

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

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

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

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

همچنین ببینید (SEE ALSO)

mfsmount(8), mfstools(1), mfssnapshots(1)