.TH mfshdd.cfg "5" "May 2026" "MooseFS 4.59.2-1" "This is part of MooseFS"
.ss 12 0
.SH "نام (NAME)"
mfshdd.cfg \- فهرست دایرکتوری‌های ذخیره‌سازی MooseFS برای \fBmfschunkserver\fP
.SH "توضیحات (DESCRIPTION)"
فایل \fBmfshdd.cfg\fP حاوی فهرستی از دایرکتوری‌ها (نقاط اتصال یا mountpoint) است که برای ذخیره‌سازی MooseFS استفاده می‌شوند.
.SS "نحو (SYNTAX)"
.PP
نحو به صورت زیر است:
.TP
[\fB*\fP|\fB<\fP|\fB>\fP|\fB~\fP]\fIPATH\fP [\fISPACE OPTIONS\fP]
.PP
خطوطی که با نویسهٔ \fB#\fP آغاز می‌شوند به عنوان توضیح نادیده گرفته می‌شوند.
.PP
مسیر (\fIPATH\fP) می‌تواند با یک یا چند نویسهٔ ویژه پیشوندگذاری شود. این نویسه‌ها به عنوان گزینه‌های اضافی عمل می‌کنند:
.RS
.IP \fB*\fP
نشان می‌دهد این دایرکتوری (هارد دیسک) به عنوان «نشانه‌گذاری‌شده برای حذف» در نظر گرفته شده و تمام داده‌ها به هارد دیسک‌های دیگر، معمولاً روی سایر chunkserverها، تکثیر (replicate) خواهند شد.
.IP \fB<\fP
نشان می‌دهد تمام داده‌ها از این هارد دیسک باید به سایر هارد دیسک‌های محلی منتقل شوند.
.IP \fB>\fP
نشان می‌دهد تمام داده‌ها از سایر هارد دیسک‌های محلی باید به این هارد دیسک منتقل شوند.
.IP \fB~\fP
نشان می‌دهد تغییر چشمگیر (بیش از ۱۰٪ در کمتر از یک دقیقه) در تعداد کل بلوک‌ها باعث نخواهد شد این دیسک معیوب و آسیب‌دیده علامت‌گذاری شود (برای سیستم‌های فایل فشرده‌سازی‌شده مفید است).
.RE
.PP
مقدار \fIPATH\fP مسیر نقطهٔ اتصال دایرکتوری ذخیره‌سازی است، که معمولاً یک هارد دیسک منفرد می‌باشد.
.PP
گزینه‌های \fISPACE OPTIONS\fP امکان تعیین محدودیت‌ها در فضای استفاده‌شده و تغییر در نحوهٔ گزارش مصرف دیسک را فراهم می‌کنند. یک \fISPACE OPTION\fP می‌تواند یکی از موارد زیر باشد:
.IP
محدودیت فضای مثبت، که نشان‌دهندهٔ تعریف سقف فضا است (یعنی فقط همین مقدار فضا در مسیر مشخص‌شده باید برای ذخیره‌سازی chunk استفاده شود).
.IP
محدودیت فضای منفی، که نشان‌دهندهٔ تعریف فضای رزروشده است (یعنی حداقل این مقدار فضا باید همیشه در مسیر مشخص‌شده خالی بماند).
.IP
یک علامت مساوی «=»، که می‌تواند اختیاری با نشانگر محدودیت فضا همراه شود.
.PP
محدودیت فضا می‌تواند یک مقدار فضای مشخص (فرمت: [0-9]*(.[0-9]*)?([kMGTPE]|[KMGTPE]i)?B?) یا درصدی از اندازهٔ کل دستگاه باشد.
.PP
علامت مساوی نشان می‌دهد که یک دیسک با فرآیند دیگری «به‌اشتراک گذاشته شده است» (چه فرآیند دیگری از chunkserver یا یک فرآیند غیرمرتبط) و مقدار فضای استفاده‌شده روی دیسک لزوماً نشان‌دهندهٔ میزان فضای استفاده‌شده توسط chunkها نیست. علاوه بر این، می‌توان یک نشانگر محدودیت فضا نیز تعریف کرد.
درصد مشخص می‌کند چه درصدی از فضای دیسک موجود باید به عنوان فضای در دسترس برای chunkserver در نظر گرفته شود.
اندازه مشخص می‌کند دقیقاً چه مقدار فضا باید برای chunkserver در دسترس باشد. اگر درصد یا فضا منفی باشند، مقدار فضای غیرقابل استفاده را تعریف می‌کنیم.
.PP
وجود یا عدم وجود \fISPACE OPTION\fP نحوهٔ محاسبهٔ فضای موجود و استفاده‌شده در یک مسیر مشخص را توسط chunkserver تغییر می‌دهد.
.PP
تعریف ۳ مقدار پایه:
.PP
.nf
total_hdd \- total device size, as returned by statvfs
avail_hdd \- total available space, as returned by statvfs
calc_size \- used space (sum of chunk's disk usage)
.fi
.PP
در صورتی که هیچ \fISPACE OPTION\fP تعریف نشده باشد، فضای کل و موجود به صورت زیر گزارش می‌شوند:
.PP
.nf
- reported total = total_hdd
- reported avail = avail_hdd
.fi
.PP
در غیر این صورت، فضای موجود طبق فرمول‌های زیر محاسبه می‌شود:
.PP
۱. با فضای رزروشدهٔ ثابت (محدودیت فضای منفی X\-):
.PP
.nf
- reported avail = total_hdd - X - calc_size (or zero if X + calc_size > total_hdd)
.fi
.PP
۲. با درصد فضای رزروشده (محدودیت فضای منفی %X\-):
.PP
.nf
- reported avail = total_hdd - total_hdd*X/100 - calc_size (or zero if total_hdd*X/100 + calc_size > total_hdd)
.fi
.PP
۳. با محدودیت فضای ثابت (محدودیت فضای مثبت X):
.PP
.nf
- reported avail = X - calc_size (or zero if calc_size > X)
.fi
.PP
۴. با درصد محدودیت فضا (محدودیت فضای مثبت %X):
.PP
.nf
- reported avail = total_hdd*X/100 - calc_size (or zero if calc_size > total_hdd*X/100)
.fi
.PP
۵. با نشانگر فضای اشتراکی (علامت =):
.PP
.nf
- reported avail = avail_hdd
.fi
.PP
۶. با نشانگر فضای اشتراکی و نشانگر فضا (=X):
.PP
.nf
- reported avail = X (or avail_hdd if avail_hdd < X)
.fi
.PP
۷. با نشانگر فضای اشتراکی و نشانگر درصدی (=X%):
.PP
.nf
- reported avail = avail_hdd*X/100
.fi
.PP
۸. با نشانگر فضای اشتراکی و نشانگر فضای منفی (=X\-):
.PP
.nf
- reported avail = avail_hdd - X (or 0, if X>avail_hdd)
.fi
.PP
۹. با نشانگر فضای اشتراکی و نشانگر درصد منفی (=X%\-):
.PP
.nf
- reported avail = avail_hdd - avail_hdd*X/100
.fi
.PP
در تمامی این موارد، فضای کل به این صورت محاسبه می‌شود:
.PP
.nf
- reported total = reported avail + calc_size
.fi
.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),
.BR mfschunkserver.cfg (5)