.TH mfschunktool "8" "مه 2026" "MooseFS 4.59.2-1" "این بخشی از MooseFS است"
.ss 12 0
.SH "نام (NAME)"
mfschunktool \- بررسی یکپارچگی چانک به صورت آفلاین
.SH "خلاصه دستور (SYNOPSIS)"
\fBmfschunktool\fP
[\fB\-f\fP]
[\fB\-r\fP]
[\fB\-n\fP]
[\fB\-e\fP]
[\fB\-x\fP]
[\fB\-m\fP \fIdamaged_dir\fP]
\fIchunk_file\fP|\fImfs_hdd_path\fP ...
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBmfschunktool\fP
یکپارچگی چانک را با استفاده از چکسام‌های CRC ذخیره‌شده در سرایند چانک بررسی می‌کند.
این ابزار همچنین می‌تواند چانک را «تعمیر» کند (چکسام‌های ذخیره‌شده را اصلاح کند). این ابزار ممکن است برای بررسی آخرین چانک‌های نوشته‌شده پس از خرابی احتمالی داده‌ها (قطع برق و غیره) مفید باشد.
اگر پارامتر ارائه‌شده یک پرونده باشد، ابزار این پرونده را بررسی می‌کند. اگر پارامتر ارائه‌شده یک پوشه باشد، ابزار به‌صورت بازگشتی این پوشه را پیمایش می‌کند و تلاش می‌کند تمام پرونده‌هایی را که به نظر می‌رسد چانک هستند بررسی کند (پرونده‌هایی که نام آن‌ها مشابه پرونده‌های چانک است یا در صورت استفاده از گزینهٔ
\fB\-n\fP
حتی با وجود نادرست بودن نام، سرایندی مشابه پرونده‌های چانک دارند).
.PP
\fBتوجه! این ابزار هرگز نباید هنگامی که فرایند چانک‌سرور فعال است استفاده شود!\fP
اگر ابزار روی دیسک چانک (مسیر موجود در پروندهٔ
\fBmfshdd.cfg\fP\fR)
استفاده شود، فعال بودن چانک‌سرور را بررسی کرده و از اجرا خودداری می‌کند. اما اگر روی یک پروندهٔ منفرد یا زیرپوشه استفاده شود، چنین بررسی‌ای امکان‌پذیر نیست و مسئولیت اطمینان از عدم استفاده از ابزار روی چانک‌های «در حال کار» بر عهدهٔ کاربر است، زیرا این کار ممکن است منجر به از دست رفتن داده‌ها شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-f\fP
فعال کردن حالت سریع (در این حالت فقط آخرین بلوک آزمایش می‌شود \- معمولاً این برای یافتن چانک‌های خراب کافی است).
.TP
\fB\-r\fP
فعال کردن حالت تعمیر (اگر چکسام‌های چانک مشخص‌شده مطابقت نداشته باشند، با چکسام‌های محاسبه‌شده از روی داده‌های واقعی بازنویسی می‌شوند).
.TP
\fB\-n\fP
فعال کردن حالت اصلاح نام (اگر نام پروندهٔ چانک درست نباشد اما سرایند پرونده معتبر باشد، ابزار نام پرونده را با استفاده از داده‌های ذخیره‌شده در سرایند تغییر می‌دهد).
.TP
\fB\-e\fP
فعال کردن بررسی CRC بلوک‌های خالی برای چانک‌های نگارش ۱.۰ (اجبار به بررسی مقادیر CRC برای بلوک‌های ناموجود \- ممکن است در مورد چانک‌هایی که کوتاه شده‌اند با شکست مواجه شود).
.TP
\fB\-x\fP
فعال کردن گزارش بررسی موفقیت‌آمیز (چاپ پیام 'OK' هنگامی که همه چیز درست است).
.TP
\fB\-m\fP \fIdamaged_dir\fP
انتقال چانک‌های آسیب‌دیده به پوشهٔ مشخص‌شدهٔ
\fIdamaged_dir\fP؛
بخش «نکات (NOTES)» را ببینید.
.SH "نکات (NOTES)"
.PP
گزینهٔ انتقال چانک‌های آسیب‌دیده به یک پوشهٔ مشخص‌شده زمانی بیشترین کاربرد را دارد که کل پوشه‌ها (دیسک‌ها) حاوی چانک‌ها پویش شوند، و بسته به اینکه چه گزینه‌های دیگری به‌طور هم‌زمان استفاده شوند، می‌توان آن را به روش‌های مختلفی به کار گرفت.
.PP
اگر گزینهٔ
\fB\-r\fP
همراه با گزینهٔ
\fB\-m\fP
استفاده شود، فقط چانک‌های غیرقابل‌تعمیر منتقل خواهند شد. این یک روش سریع برای تعمیر چانک است که پوشه (دیسک) چانک را در یک مرحله تعمیر و پاک‌سازی می‌کند.
.PP
اگر فقط گزینهٔ
\fB\-m\fP
استفاده شود، تمام چانک‌های آسیب‌دیده به پوشهٔ مشخص‌شده منتقل خواهند شد. سپس کاربر می‌تواند دوباره از
\fBmfschunktool\fP
در این پوشه استفاده کند، این بار با گزینهٔ
\fB\-r\fP\c
، تا تمام چانک‌هایی را که قابل تعمیر هستند تعمیر کند، اما چانک‌های تعمیرشده را تنها در صورتی به سیستم بازگرداند که هیچ نسخهٔ دیگری از چانک‌سرور دیگری موجود نباشد (نسخه‌ای که از همان ابتدا نیازی به عملیات تعمیر نداشته است). این یک رویکرد زمان‌برتر اما امن‌تر برای تعمیر چند چانک، مثلاً پس از قطع برق است.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها را به <bugs@moosefs.com> ارسال کنید.
.SH "حق نشر (COPYRIGHT)"
Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA
.PP
این پرونده بخشی از MooseFS است.
.PP
نرم‌افزار MooseFS یک نرم‌افزار آزاد است؛ می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) طبق آنچه بنیاد نرم‌افزار آزاد منتشر کرده است، فقط نگارش ۲، بازتوزیع کنید یا تغییر دهید.
.PP
نرم‌افزار MooseFS به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف مشخص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.
.PP
باید همراه با این برنامه نسخه‌ای از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، نشانی
<https://www.gnu.org/licenses>
را ببینید.
.SH "همچنین ببینید (SEE ALSO)"
.BR mfschunkserver (8)