نام (NAME)

mfsgeteattr - دریافت ویژگی‌های اضافی و فراداده‌های فایل در 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)

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

دستور 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)، اندازه (length) و غیره در حافظه نهان هسته ذخیره نشوند.

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 اعداد ساده را به ترتیب بر حسب کیبی (کیلوی دودویی - ۱۰۲۴)، مبی (مگای دودویی - ۱۰۲۴^۲) و گیبی (گیگای دودویی - ۱۰۲۴^۳) نشان می‌دهند. همین نتیجه را می‌توان با تنظیم متغیر محیطی MFSHRFORMAT روی مقادیر زیر به دست آورد: 0 (اعداد دقیق)، 1 یا h (پیشوندهای دودویی)، 2 یا H (پیشوندهای SI)، 3 یا +h (اعداد دقیق و پیشوندهای دودویی)، 4 یا +H (اعداد دقیق و پیشوندهای SI). حالت پیش‌فرض، چاپ صرفاً اعداد دقیق است.

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

نکات (NOTES)

وراثت (INHERITANCE)

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

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

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

حق نشر (COPYRIGHT)

این برنامه بخشی از MooseFS است.

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

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

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

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

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