نحو (SYNTAX)

نحو به صورت زیر است:

[*|<|>|~]PATH [SPACE OPTIONS]

خطوطی که با نویسهٔ # آغاز می‌شوند به عنوان توضیح نادیده گرفته می‌شوند.

مسیر (PATH) می‌تواند با یک یا چند نویسهٔ ویژه پیشوندگذاری شود. این نویسه‌ها به عنوان گزینه‌های اضافی عمل می‌کنند:

مقدار PATH مسیر نقطهٔ اتصال دایرکتوری ذخیره‌سازی است، که معمولاً یک هارد دیسک منفرد می‌باشد.

گزینه‌های SPACE OPTIONS امکان تعیین محدودیت‌ها در فضای استفاده‌شده و تغییر در نحوهٔ گزارش مصرف دیسک را فراهم می‌کنند. یک SPACE OPTION می‌تواند یکی از موارد زیر باشد:

محدودیت فضای مثبت، که نشان‌دهندهٔ تعریف سقف فضا است (یعنی فقط همین مقدار فضا در مسیر مشخص‌شده باید برای ذخیره‌سازی chunk استفاده شود).

محدودیت فضای منفی، که نشان‌دهندهٔ تعریف فضای رزروشده است (یعنی حداقل این مقدار فضا باید همیشه در مسیر مشخص‌شده خالی بماند).

یک علامت مساوی «=»، که می‌تواند اختیاری با نشانگر محدودیت فضا همراه شود.

محدودیت فضا می‌تواند یک مقدار فضای مشخص (فرمت: [0-9]*(.[0-9]*)?([kMGTPE]|[KMGTPE]i)?B?) یا درصدی از اندازهٔ کل دستگاه باشد.

علامت مساوی نشان می‌دهد که یک دیسک با فرآیند دیگری «به‌اشتراک گذاشته شده است» (چه فرآیند دیگری از chunkserver یا یک فرآیند غیرمرتبط) و مقدار فضای استفاده‌شده روی دیسک لزوماً نشان‌دهندهٔ میزان فضای استفاده‌شده توسط chunkها نیست. علاوه بر این، می‌توان یک نشانگر محدودیت فضا نیز تعریف کرد. درصد مشخص می‌کند چه درصدی از فضای دیسک موجود باید به عنوان فضای در دسترس برای chunkserver در نظر گرفته شود. اندازه مشخص می‌کند دقیقاً چه مقدار فضا باید برای chunkserver در دسترس باشد. اگر درصد یا فضا منفی باشند، مقدار فضای غیرقابل استفاده را تعریف می‌کنیم.

وجود یا عدم وجود SPACE OPTION نحوهٔ محاسبهٔ فضای موجود و استفاده‌شده در یک مسیر مشخص را توسط chunkserver تغییر می‌دهد.

تعریف ۳ مقدار پایه:

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)

در صورتی که هیچ SPACE OPTION تعریف نشده باشد، فضای کل و موجود به صورت زیر گزارش می‌شوند:

- reported total = total_hdd
- reported avail = avail_hdd

در غیر این صورت، فضای موجود طبق فرمول‌های زیر محاسبه می‌شود:

۱. با فضای رزروشدهٔ ثابت (محدودیت فضای منفی X-):

- reported avail = total_hdd - X - calc_size (or zero if X + calc_size > total_hdd)

۲. با درصد فضای رزروشده (محدودیت فضای منفی %X-):

- reported avail = total_hdd - total_hdd*X/100 - calc_size (or zero if total_hdd*X/100 + calc_size > total_hdd)

۳. با محدودیت فضای ثابت (محدودیت فضای مثبت X):

- reported avail = X - calc_size (or zero if calc_size > X)

۴. با درصد محدودیت فضا (محدودیت فضای مثبت %X):

- reported avail = total_hdd*X/100 - calc_size (or zero if calc_size > total_hdd*X/100)

۵. با نشانگر فضای اشتراکی (علامت =):

- reported avail = avail_hdd

۶. با نشانگر فضای اشتراکی و نشانگر فضا (=X):

- reported avail = X (or avail_hdd if avail_hdd < X)

۷. با نشانگر فضای اشتراکی و نشانگر درصدی (=X%):

- reported avail = avail_hdd*X/100

۸. با نشانگر فضای اشتراکی و نشانگر فضای منفی (=X-):

- reported avail = avail_hdd - X (or 0, if X>avail_hdd)

۹. با نشانگر فضای اشتراکی و نشانگر درصد منفی (=X%-):

- reported avail = avail_hdd - avail_hdd*X/100

در تمامی این موارد، فضای کل به این صورت محاسبه می‌شود:

- reported total = reported avail + calc_size