.TH mfsdiagtools "1" "May 2026" "MooseFS 4.59.2-1" "This is part of MooseFS" .ss 12 0 .SH "نام (NAME)" mfsdiagtools \- ابزارهای عیب‌یابی \fBMooseFS\fP .SH "خلاصه دستور (SYNOPSIS)" .B mfscheckfile [\fB-?\fP] [\fB-n\fP|\fB-h\fP|\fB-H\fP|\fB-k\fP|\fB-m\fP|\fB-g\fP] \fIFILE\fP... .PP .B mfsfileinfo [\fB-?\fP] [\fB-n\fP|\fB-h\fP|\fB-H\fP|\fB-k\fP|\fB-m\fP|\fB-g\fP] [\fB-q\fP|\fB-c\fP|\fB-s\fP] [\fB-p\fP] [\fB-w\fP] \fIFILE\fP... .PP .B mfsfilerepair [\fB-?\fP] [\fB-n\fP|\fB-h\fP|\fB-H\fP|\fB-k\fP|\fB-m\fP|\fB-g\fP] [\fB-d\fP] \fIFILE\fP... .PP .B mfsdirinfo [\fB-?\fP] [\fB-n\fP|\fB-h\fP|\fB-H\fP|\fB-k\fP|\fB-m\fP|\fB-g\fP] [\fB-i\fP|\fB-d\fP|\fB-f\fP|\fB-c\fP|\fB-l\fP|\fB-s\fP|\fB-r\fP] [\fB-p\fP] \fIOBJECT\fP... .PP .B mfsfilepaths [\fB-?\fP] \fIOBJECT\fP|\fIINODE\fP... .SH "توضیحات (DESCRIPTION)" دستور \fBmfscheckfile\fP تعداد چانک‌ها و تعداد رونوشت‌های چانک متعلق به فایل(های) مشخص‌شده را بررسی و چاپ می‌کند. از این دستور می‌توان برای هر فایلی، از جمله فایل‌های حذف‌شده (\fItrash\fP)، استفاده کرد. .PP دستور \fBmfsfileinfo\fP موقعیت (میزبان و پورت \fIchunkserver\fP) هر رونوشت چانک متعلق به فایل(های) مشخص‌شده را چاپ می‌کند. از این دستور می‌توان برای هر فایلی، از جمله فایل‌های حذف‌شده (\fItrash\fP)، استفاده کرد. گزینهٔ \fB-q\fP حالت سریع را فعال می‌کند (فقط تعداد بخش‌های EC یا رونوشت‌های معتبر). گزینهٔ \fB-c\fP دریافت مجموع‌های مقابله‌ای (checksum) چانک از chunkserverها را فعال می‌کند و در نهایت \fB-s\fP محاسبهٔ امضای فایل را (از مجموع‌های مقابله‌ای دریافت‌شده) فعال می‌سازد. گزینهٔ \fB-p\fP مسیر فایل چانک روی chunkserver را برای هر چانک نمایش می‌دهد. گزینهٔ \fB-w\fP تنها چانک‌های «نادرست» (نامعتبر، مفقود، با نسخهٔ اشتباه) را نمایش می‌دهد. .PP دستور \fBmfsfilerepair\fP با فایل‌های خراب (فایل‌هایی که در عملیات خواندن خطاهای I/O ایجاد می‌کنند) سر و کار دارد تا آن‌ها را تا حدی خواندنی کند. در صورت عدم تطابق نسخهٔ چانک، نسخهٔ چانک شناخته‌شده برای \fBmfsmaster\fP را روی بالاترین نسخهٔ یافت‌شده در chunkserverها تنظیم می‌کند. در صورتی که هیچ رونوشت در دسترسی از یک چانک وجود نداشته باشد (همهٔ رونوشت‌ها نامعتبر یا مفقود باشند)، چانک به عنوان «read-as-zeros» علامت‌گذاری می‌شود (عملیات خواندن صفر برمی‌گرداند و عملیات نوشتن با شکست مواجه می‌شود). هنگامی که/اگر یک chunkserver با چانک مفقود متصل شود، فایل دوباره به طور کامل در دسترس خواهد بود. اگر از گزینهٔ \fB-d\fP استفاده شود، چانک مفقود/نامعتبر برای همیشه صفر خواهد شد. نکته: توصیه می‌شود از هر فایلی که با این ابزار تعمیر شده است یک رونوشت (و نه یک snapshot) تهیه شود، به ویژه اگر این احتمال وجود دارد که chunkserverهایی با چانک‌های موجود بیشتر در آینده به سیستم متصل شوند (برای مثال پس از یک قطعی). این کار برای جلوگیری از ناهماهنگی محتوای چانک‌ها با نسخهٔ یکسان در یک فایل است. .PP دستور \fBmfsdirinfo\fP معادل توسعه‌یافته و اختصاصی MooseFS برای دستور \fBdu -s\fP است. این دستور خلاصه‌ای را برای هر شیء مشخص‌شده (فایل منفرد یا درخت دایرکتوری) چاپ می‌کند. اگر تنها می‌خواهید یک پارامتر را ببینید، یکی از گزینه‌های نمایش را اضافه کنید (بخش \fBگزینه‌های نمایش (SHOW OPTIONS)\fP را ببینید). به طور پیش‌فرض داده‌ها از شمارنده‌های داخلی master بازگردانده می‌شوند (بسیار سریع، اما غیردقیق). تمام گره‌های تکراری (پیوندهای سخت یا hard linkها) و چانک‌ها (اسنپ‌شات‌ها یا snapshotها) چندین بار شمرده می‌شوند. برای شمارش دقیق‌تر آمار می‌توانید از سوئیچ \fB-p\fP استفاده کنید که یک روال بازگشتی و کُند را فعال می‌کند. در این حالت، گره‌ها و چانک‌ها تنها یک بار شمرده می‌شوند و سیستم به جای goal/labels از تعداد رونوشت‌های فعلی چانک استفاده می‌کند. مدیران سیستم می‌توانند استفاده از \fBmfsmetadirinfo\fP را نیز مد نظر قرار دهند (نگاه کنید به \fBmfsmetadirinfo\fP(8)). .PP ابزار \fBmfsfilepaths\fP می‌تواند برای یافتن تمام رخدادها (پیوندهای سخت) یک فایل مشخص در فایل‌سیستم استفاده شود. همچنین می‌تواند برای یافتن فایلی با شماره inode مشخص به کار رود. در صورت جستجو برای شماره inode، این ابزار باید درون دایرکتوری مانت‌شدهٔ mfs اجرا شود. .SH "گزینه‌ها (OPTIONS)" .SS "گزینه‌های عمومی (GENERAL 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 به عنوان 2^10، 2^20 و غیره) استفاده می‌کند، در حالی که \fB-H\fP از پیشوندهای SI (k، M، G به عنوان 10^3، 10^6 و غیره) بهره می‌برد. گزینه‌های \fB-k\fP، \fB-m\fP و \fB-g\fP به ترتیب اعداد ساده را بر حسب کیبی (کیلوی دودویی \- 1024)، مبی (مگای دودویی \- 1024^2) و گیبی (گیگای دودویی \- 1024^3) نشان می‌دهند. همین نتیجه را می‌توان با تنظیم متغیر محیطی \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 پیام کوتاه راهنمای استفاده را نمایش می‌دهد. .SS "گزینه‌های نمایش (SHOW OPTIONS)" .TP \fB-i\fP نمایش تعداد inodeها .TP \fB-d\fP نمایش تعداد دایرکتوری‌ها .TP \fB-f\fP نمایش تعداد فایل‌ها .TP \fB-c\fP نمایش تعداد چانک‌ها .TP \fB-l\fP نمایش طول (مجموع طول فایل‌ها) .TP \fB-s\fP نمایش اندازه (مجموع طول چانک‌ها) .TP \fB-r\fP نمایش realsize (تخمین سادهٔ مصرف دیسک سخت \- معمولاً اندازه ضرب در هدف فعلی) .SH "گزارش باگ‌ها (BUGS)" گزارش باگ‌ها را به ارسال کنید. .SH "کپی‌رایت و تکثیر (COPYRIGHT)" Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA .PP این فایل بخشی از MooseFS است. .PP نرم‌افزار MooseFS یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «پروانه عمومی همگانی گنو» (GNU General Public License) همان‌گونه که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، نسخه ۲ (تنها) بازتوزیع کرده یا تغییر دهید. .PP نرم‌افزار MooseFS با این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «پروانه عمومی همگانی گنو» مراجعه کنید. .PP شما باید به همراه این برنامه یک نسخه از پروانه عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت به مراجعه کنید. .SH "همچنین ببینید (SEE ALSO)" .BR mfsmount (8), .BR mfstools (1), .BR mfsmetadirinfo (8)