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

mfsdiagtools - ابزارهای عیب‌یابی MooseFS

mfscheckfile [-?] [-n|-h|-H|-k|-m|-g] FILE...

mfsfileinfo [-?] [-n|-h|-H|-k|-m|-g] [-q|-c|-s] [-p] [-w] FILE...

mfsfilerepair [-?] [-n|-h|-H|-k|-m|-g] [-d] FILE...

mfsdirinfo [-?] [-n|-h|-H|-k|-m|-g] [-i|-d|-f|-c|-l|-s|-r] [-p] OBJECT...

mfsfilepaths [-?] OBJECT|INODE...

دستور mfscheckfile تعداد چانک‌ها و تعداد رونوشت‌های چانک متعلق به فایل(های) مشخص‌شده را بررسی و چاپ می‌کند. از این دستور می‌توان برای هر فایلی، از جمله فایل‌های حذف‌شده (trash)، استفاده کرد.

دستور mfsfileinfo موقعیت (میزبان و پورت chunkserver) هر رونوشت چانک متعلق به فایل(های) مشخص‌شده را چاپ می‌کند. از این دستور می‌توان برای هر فایلی، از جمله فایل‌های حذف‌شده (trash)، استفاده کرد. گزینهٔ -q حالت سریع را فعال می‌کند (فقط تعداد بخش‌های EC یا رونوشت‌های معتبر). گزینهٔ -c دریافت مجموع‌های مقابله‌ای (checksum) چانک از chunkserverها را فعال می‌کند و در نهایت -s محاسبهٔ امضای فایل را (از مجموع‌های مقابله‌ای دریافت‌شده) فعال می‌سازد. گزینهٔ -p مسیر فایل چانک روی chunkserver را برای هر چانک نمایش می‌دهد. گزینهٔ -w تنها چانک‌های «نادرست» (نامعتبر، مفقود، با نسخهٔ اشتباه) را نمایش می‌دهد.

دستور mfsfilerepair با فایل‌های خراب (فایل‌هایی که در عملیات خواندن خطاهای I/O ایجاد می‌کنند) سر و کار دارد تا آن‌ها را تا حدی خواندنی کند. در صورت عدم تطابق نسخهٔ چانک، نسخهٔ چانک شناخته‌شده برای mfsmaster را روی بالاترین نسخهٔ یافت‌شده در chunkserverها تنظیم می‌کند. در صورتی که هیچ رونوشت در دسترسی از یک چانک وجود نداشته باشد (همهٔ رونوشت‌ها نامعتبر یا مفقود باشند)، چانک به عنوان «read-as-zeros» علامت‌گذاری می‌شود (عملیات خواندن صفر برمی‌گرداند و عملیات نوشتن با شکست مواجه می‌شود). هنگامی که/اگر یک chunkserver با چانک مفقود متصل شود، فایل دوباره به طور کامل در دسترس خواهد بود. اگر از گزینهٔ -d استفاده شود، چانک مفقود/نامعتبر برای همیشه صفر خواهد شد. نکته: توصیه می‌شود از هر فایلی که با این ابزار تعمیر شده است یک رونوشت (و نه یک snapshot) تهیه شود، به ویژه اگر این احتمال وجود دارد که chunkserverهایی با چانک‌های موجود بیشتر در آینده به سیستم متصل شوند (برای مثال پس از یک قطعی). این کار برای جلوگیری از ناهماهنگی محتوای چانک‌ها با نسخهٔ یکسان در یک فایل است.

دستور mfsdirinfo معادل توسعه‌یافته و اختصاصی MooseFS برای دستور du -s است. این دستور خلاصه‌ای را برای هر شیء مشخص‌شده (فایل منفرد یا درخت دایرکتوری) چاپ می‌کند. اگر تنها می‌خواهید یک پارامتر را ببینید، یکی از گزینه‌های نمایش را اضافه کنید (بخش گزینه‌های نمایش (SHOW OPTIONS) را ببینید). به طور پیش‌فرض داده‌ها از شمارنده‌های داخلی master بازگردانده می‌شوند (بسیار سریع، اما غیردقیق). تمام گره‌های تکراری (پیوندهای سخت یا hard linkها) و چانک‌ها (اسنپ‌شات‌ها یا snapshotها) چندین بار شمرده می‌شوند. برای شمارش دقیق‌تر آمار می‌توانید از سوئیچ -p استفاده کنید که یک روال بازگشتی و کُند را فعال می‌کند. در این حالت، گره‌ها و چانک‌ها تنها یک بار شمرده می‌شوند و سیستم به جای goal/labels از تعداد رونوشت‌های فعلی چانک استفاده می‌کند. مدیران سیستم می‌توانند استفاده از mfsmetadirinfo را نیز مد نظر قرار دهند (نگاه کنید به mfsmetadirinfo(8)).

ابزار mfsfilepaths می‌تواند برای یافتن تمام رخدادها (پیوندهای سخت) یک فایل مشخص در فایل‌سیستم استفاده شود. همچنین می‌تواند برای یافتن فایلی با شماره inode مشخص به کار رود. در صورت جستجو برای شماره inode، این ابزار باید درون دایرکتوری مانت‌شدهٔ mfs اجرا شود.

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

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

نمایش تعداد inodeها
نمایش تعداد دایرکتوری‌ها
نمایش تعداد فایل‌ها
نمایش تعداد چانک‌ها
نمایش طول (مجموع طول فایل‌ها)
نمایش اندازه (مجموع طول چانک‌ها)
نمایش realsize (تخمین سادهٔ مصرف دیسک سخت - معمولاً اندازه ضرب در هدف فعلی)

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

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

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

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

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

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

mfsmount(8), mfstools(1), mfsmetadirinfo(8)

May 2026 MooseFS 4.59.2-1