.TH mfscli "1" "May 2026" "MooseFS 4.59.2-1" "This is part of MooseFS"
.ss 12 0
.SH "نام (NAME)"
mfscli \- همتای رابط کاربری گرافیکی (GUI) در حالت متنی (TXT)
.SH "خلاصه دستور (SYNOPSIS)"
\fBmfscli\fP [\fB-jpn28\fP] [\fB-H\fP \fImaster_host\fP] [\fB-P\fP \fImaster_port\fP]
[\fB-f\fP \fI0..3\fP] \fB-S(IN|IG|IM|LI|IC|IL|MF|MU|CS|MB|HD|EX|MD|MS|MO|OF|AL|RP|SC|PA|QU|MC|CC)\fP
[\fB-s\fP \fIseparator\fP] [\fB-o\fP \fIorder_id\fP [\fB-r\fP]] [\fB-m\fP \fImode_id\fP]
[\fB-i\fP \fIid\fP] [\fB-a\fP \fImaster_data_count\fP] [\fB-b\fP \fImaster_data_desc\fP] [\fB-c\fP \fIchunkserver_data_count\fP] [\fB-d\fP \fIchunkserver_data_desc\fP]
.PP
\fBmfscli\fP [\fB-pn28\fP] [\fB-H\fP \fImaster_host\fP] [\fB-P\fP \fImaster_port\fP]
[\fB-f\fP \fI0..3\fP]
\fB-C\fP(\fBRC/\fP\fIip\fP\fB/\fP\fIport\fP|\fBBW/\fP\fIip\fP\fB/\fP\fIport\fP|\fBM[01]/\fP\fIip\fP\fB/\fP\fIport\fP|\fBRS/\fP\fIsessionid\fP|\fBTR/\fP\fIip\fP\fB/\fP\fIport\fP)
.PP
\fBmfscli\fP \fB-h\fP
.SH "توضیحات (DESCRIPTION)"
دستور \fBmfscli\fP همتای خط فرمانی رابط گرافیکی MooseFS است. تمام اطلاعات موجود در رابط گرافیکی (به‌جز بخش‌های نمودارها و وضعیت) را می‌توان با استفاده از «گزینه‌های پایش» مختلف از طریق خط فرمان به دست آورد؛ داده‌های نمودار را نیز می‌توان به‌صورت متنی دریافت کرد.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های عمومی (GENERAL OPTIONS)"
.TP
\fB-h\fP
چاپ پیام راهنما و خروج
.TP
\fB-j\fP
چاپ خروجی در قالب JSON
.TP
\fB-p\fP
اجبار به استفاده از قالب متنی ساده (plain text) در دستگاه‌های tty
.TP
\fB-n\fP
عدم حل و نام‌گشایی آدرس‌های ip (پیش‌فرض هنگامی که دستگاه خروجی tty نیست)
.TP
\fB-s\fP \fIseparator\fP
جداکننده فیلدها برای استفاده در قالب متنی ساده روی دستگاه‌های tty (گزینه \fB-p\fP را تحمیل می‌کند)
.TP
\fB-2\fP
اجبار به استفاده از کدهای رنگی ترمینال ۲۵۶ رنگی
.TP
\fB-8\fP
اجبار به استفاده از کدهای رنگی ترمینال ۸ رنگی
.TP
\fB-H\fP \fImaster_host\fP
آدرس master (پیش‌فرض: mfsmaster)
.TP
\fB-P\fP \fImaster_port\fP
پورت کلاینت master (پیش‌فرض: 9421)
.TP
\fB-f\fP \fB0\fP..\fB3\fP
تعیین مجموعه نویسه قاب برای نمایش کادرهای جدول در حالت tty؛
.RS
.IP 0
قاب‌های ساده اسکی \(aq+\(aq، \(aq-\(aq، \(aq|\(aq (پیش‌فرض)
.IP 1
قاب‌های یونیکد ضخیم
.IP 2
قاب‌های یونیکد نازک
.IP 3
قاب‌های یونیکد دوخطی (به سبک dos)
.RE
.TP
\fB-o\fP \fIorder_id\fP
مرتب‌سازی داده‌ها بر اساس ستونی که با \(aqorder id\(aq مشخص شده است (بسته به مجموعه داده)
.TP
\fB-r\fP
معکوس کردن ترتیب مرتب‌سازی
.TP
\fB-m\fP \fImode_id\fP
نمایش داده‌های مشخص‌شده با \(aqmode id\(aq (بسته به مجموعه داده)
.TP
\fB-i\fP \fIid\fP
مقدار sessionid برای \fB-SOF\fP یا inode برای \fB-SAL\fP
.TP
\fB-a\fP \fImaster_data_count\fP
تعداد مدخل‌های نمودارهای دادهٔ master (\-SMC) که باید نمایش داده شوند
.TP
\fB-b\fP \fImaster_data_desc\fP
تعریف ستون‌های نمودارهای دادهٔ master (\-SMC)؛ افزودن پیشوند \(aq+\(aq برای داده‌های خام، (تنها در نسخه pro) افزودن پیشوند \(aqip:[port:]\(aq برای انتخاب سرور (به‌طور پیش‌فرض سرور leader master استفاده خواهد شد)؛ استفاده از \(aqall\(aq به‌عنوان نام نمودار برای همه نمودارهای موجود
.TP
\fB-c\fP \fIchunkserver_data_count\fP
تعداد مدخل‌های نمودارهای دادهٔ chunkserver (\-SCC) که باید نمایش داده شوند
.TP
\fB-d\fP \fIchunkserver_data_desc\fP
تعریف ستون‌های نمودارهای دادهٔ chunkserver (\-SCC)؛ افزودن پیشوند \(aq+\(aq برای داده‌های خام، افزودن پیشوند \(aqip:[port:]\(aq برای انتخاب سرور (به‌طور پیش‌فرض همه سرورها استفاده خواهند شد)؛ استفاده از \(aqall\(aq به‌عنوان نام نمودار برای همه نمودارهای موجود.SS "گزینه‌های پایش (MONITORING OPTIONS)"
.TP
\fB-SIN\fP
نمایش اطلاعات کامل مستر (شامل: SIG، SIM، SLI، SIC، SIL، SMF، SMU)
.TP
\fB-SIG\fP
فقط نمایش خلاصه کلی کلاستر
.TP
\fB-SIM\fP
فقط نمایش وضعیت‌های مسترها
.TP
\fB-SLI\fP
(فقط pro) فقط نمایش اطلاعات مجوز
.TP
\fB-SIC\fP
فقط نمایش اطلاعات چانک‌ها (ماتریس‌های سطح افزونگی هدف/فعلی)
.TP
\fB-SIL\fP
فقط نمایش اطلاعات حلقه‌های خودآزمایی (همراه با پیام‌ها)
.TP
\fB-SMF\fP
فقط نمایش چانک‌ها/فایل‌های مفقود
.TP
\fB-SMU\fP
فقط نمایش میزان مصرف حافظه مستر
.TP
\fB-SCS\fP
نمایش چانک‌سرورهای متصل
.TP
\fB-SMB\fP
نمایش سرورهای پشتیبان متاداده متصل
.TP
\fB-SHD\fP
نمایش داده‌های hdd
.TP
\fB-SEX\fP
نمایش اشتراک‌ها (exports)
.TP
\fB-SMD\fP
نمایش جزئیات مانت‌ها (شامل: SMS، SMO، SOF، SAL)
.TP
\fB-SMS\fP
فقط نمایش مانت‌های فعال
.TP
\fB-SMO\fP
فقط نمایش شمارنده‌های عملیات
.TP
\fB-SOF\fP
فقط نمایش فایل‌های باز
.TP
\fB-SAL\fP
فقط نمایش قفل‌های گرفته‌شده
.TP
\fB-SRP\fP
نمایش خط‌مشی افزونگی (شامل: SSC، SPA)
.TP
\fB-SSC\fP
نمایش کلاس‌های ذخیره‌سازی
.TP
\fB-SPA\fP
نمایش بازنویسی‌های الگو
.TP
\fB-SQU\fP
نمایش اطلاعات سهمیه (quota)
.TP
\fB-SMC\fP
نمایش داده‌های نمودارهای مستر (استفاده با \-a و \-b)
.TP
\fB-SCC\fP
نمایش داده‌های نمودارهای چانک‌سرور (استفاده با \-c و \-d)
.SS "ستون‌های دردسترس داده‌های نمودار مستر (-SMC)"
.TP 14
ucpu
میزان مصرف پردازنده در فضای کاربری
.TP
scpu
میزان مصرف پردازنده در فضای سیستم
.TP
delete,del
تعداد تلاش‌های حذف چانک
.TP
replicate,rep,repl
تعداد تلاش‌های تکثیر چانک
.TP
statfs
تعداد عملیات statfs
.TP
getattr
تعداد عملیات getattr
.TP
setattr
تعداد عملیات setattr
.TP
lookup
تعداد عملیات lookup
.TP
mkdir
تعداد عملیات mkdir
.TP
rmdir
تعداد عملیات rmdir
.TP
symlink
تعداد عملیات symlink
.TP
readlink
تعداد عملیات readlink
.TP
mknod
تعداد عملیات mknod
.TP
unlink
تعداد عملیات unlink
.TP
rename
تعداد عملیات rename
.TP
link
تعداد عملیات link
.TP
readdir
تعداد عملیات readdir
.TP
open
تعداد عملیات open
.TP
readchunk
تعداد عملیات chunk_read
.TP
writechunk
تعداد عملیات chunk_write
.TP
memoryrss,memrss,rmem,mem
میزان مصرف حافظه مقیم (RSS)
.TP
prcvd
بسته‌های دریافت‌شده
.TP
psent
بسته‌های ارسال‌شده
.TP
brcvd
بایت‌های دریافت‌شده
.TP
bsent
بایت‌های ارسال‌شده
.TP
memoryvirt,memvirt,vmem
میزان مصرف حافظه مجازی
.TP
usedspace
میزان مصرف فضای دیسک خام (RAW)
.TP
totalspace
کل فضای دیسک خام (RAW) متصل
.TP
create
تعداد تلاش‌های ایجاد چانک
.TP
change
تعداد تلاش‌های عملیات داخلی چانک
.TP
delete_ok
تعداد حذف‌های موفق چانک
.TP
delete_err
تعداد حذف‌های ناموفق چانک
.TP
replicate_ok
تعداد تکثیرهای موفق چانک
.TP
replicate_err
تعداد تکثیرهای ناموفق چانک
.TP
create_ok
تعداد ایجادهای موفق چانک
.TP
create_err
تعداد ایجادهای ناموفق چانک
.TP
change_ok
تعداد عملیات‌های داخلی موفق چانک.TP
change_err
تعداد عملیات‌های درونی ناموفق چانک
.TP
split_ok
تعداد عملیات‌های موفق تقسیم چانک
.TP
split_err
تعداد عملیات‌های ناموفق تقسیم چانک
.TP
fileobjects
تعداد اشیاء فایل
.TP
metaobjects
تعداد اشیاء غیرفایلی (دایرکتوری‌ها، پیوندهای نمادین و غیره)
.TP
chunksec8
تعداد کل چانک‌های ذخیره‌شده در قالب EC8
.TP
chunksec4
تعداد کل چانک‌های ذخیره‌شده در قالب EC4
.TP
chunkscopy
تعداد کل چانک‌های ذخیره‌شده در قالب COPY
.TP
chregdanger
تعداد چانک‌های در معرض خطر (بدون احتساب موارد نشانه‌گذاری‌شده برای حذف)
.TP
chregunder
تعداد چانک‌های کمتر از هدف (undergoal) (بدون احتساب موارد نشانه‌گذاری‌شده برای حذف)
.TP
challdanger
تعداد چانک‌های در معرض خطر (با احتساب موارد نشانه‌گذاری‌شده برای حذف)
.TP
challunder
تعداد چانک‌های کمتر از هدف (undergoal) (با احتساب موارد نشانه‌گذاری‌شده برای حذف)
.TP
bytesread
میانگین تعداد بایت‌های خوانده‌شده در ثانیه توسط همه کلاینت‌ها
.TP
byteswrite
میانگین تعداد بایت‌های نوشته‌شده در ثانیه توسط همه کلاینت‌ها
.TP
read
تعداد عملیات‌های خواندن (read)
.TP
write
تعداد عملیات‌های نوشتن (write)
.TP
fsync
تعداد عملیات‌های fsync
.TP
lock
تعداد عملیات‌های قفل‌گذاری (lock)
.TP
snapshot
تعداد عملیات‌های snapshot
.TP
truncate
تعداد عملیات‌های truncate
.TP
getxattr
تعداد عملیات‌های getxattr
.TP
setxattr
تعداد عملیات‌های setxattr
.TP
getfacl
تعداد عملیات‌های getfacl
.TP
setfacl
تعداد عملیات‌های setfacl
.TP
fcreate
تعداد عملیات‌های ایجاد فایل
.TP
meta
تعداد عملیات‌های فراداده‌ای اضافه (sclass، trashretention، eattr و غیره)
.TP
delay
(فقط در نسخه pro) بیشینه تأخیر Master به ثانیه
.TP
servers
تعداد کل سرورهای چانک ثبت‌شده (هم متصل و هم قطع‌شده)
.TP
mdservers
تعداد سرورهای چانک قطع‌شده که در حالت نگهداری (maintenance) هستند
.TP
dservers
تعداد سرورهای چانک قطع‌شده که در حالت نگهداری نیستند
.TP
udiff
اختلاف درصد استفاده از فضا میان سرور چانک با بیشترین و کمترین استفاده
.TP
cpu
کل میزان استفاده از cpu (مجموع scpu + ucpu).SS "ستون‌های در دسترس داده‌های نمودار CHUNKSERVER (-SCC)"
.TP 14
ucpu
میزان مصرف پردازنده در فضای کاربری
.TP
scpu
میزان مصرف پردازنده در فضای سیستمی
.TP
masterin
داده‌های دریافت‌شده از master
.TP
masterout
داده‌های ارسال‌شده به master
.TP
csrepin
داده‌های دریافت‌شده توسط replicator
.TP
csrepout
داده‌های ارسال‌شده توسط replicator
.TP
csservin
داده‌های دریافت‌شده توسط csserv
.TP
csservout
داده‌های ارسال‌شده توسط csserv
.TP
hdrbytesr
بایت‌های خوانده‌شده (سرایندها)
.TP
hdrbytesw
بایت‌های نوشته‌شده (سرایندها)
.TP
hdrllopr
عملیات‌های سطح پایین خواندن (سرایندها)
.TP
hdrllopw
عملیات‌های سطح پایین نوشتن (سرایندها)
.TP
databytesr
بایت‌های خوانده‌شده (داده‌ها)
.TP
databytesw
بایت‌های نوشته‌شده (داده‌ها)
.TP
datallopr
عملیات‌های سطح پایین خواندن (داده‌ها)
.TP
datallopw
عملیات‌های سطح پایین نوشتن (داده‌ها)
.TP
hlopr
عملیات‌های سطح بالای خواندن
.TP
hlopw
عملیات‌های سطح بالای نوشتن
.TP
rtime
زمان خواندن
.TP
wtime
زمان نوشتن
.TP
repl
عملیات‌های تکثیر چانک
.TP
create
عملیات‌های ایجاد چانک
.TP
delete
عملیات‌های حذف چانک
.TP
version
عملیات‌های تنظیم نسخه
.TP
duplicate
عملیات‌های همتاسازی (duplicate)
.TP
truncate
عملیات‌های کوتاه‌سازی (truncate)
.TP
duptrunc
عملیات‌های duptrunc (همتاسازی+کوتاه‌سازی)
.TP
test
عملیات‌های آزمایش چانک
.TP
load
بار کاری سرور
.TP
memoryrss,memrss,rmem,mem
میزان حافظهٔ مقیم مصرفی
.TP
memoryvirt,memvirt,vmem
میزان حافظهٔ مجازی مصرفی
.TP
movels
عملیات‌های جابه‌جایی با سرعت پایین
.TP
movehs
عملیات‌های جابه‌جایی با سرعت بالا
.TP
split
عملیات‌های تقسیم (split)
.TP
usedspace
فضای مصرف‌شدهٔ دیسک سخت بر حسب بایت (به‌جز موارد علامت‌گذاری‌شده برای حذف)
.TP
totalspace
کل فضای دیسک سخت بر حسب بایت (به‌جز موارد علامت‌گذاری‌شده برای حذف)
.TP
chunkcount
تعداد چانک‌های ذخیره‌شده (به‌جز موارد علامت‌گذاری‌شده برای حذف)
.TP
tdusedspace
فضای مصرف‌شدهٔ دیسک سخت بر حسب بایت روی دیسک‌های علامت‌گذاری‌شده برای حذف
.TP
tdtotalspace
کل فضای دیسک سخت بر حسب بایت روی دیسک‌های علامت‌گذاری‌شده برای حذف
.TP
tdchunkcount
تعداد چانک‌های ذخیره‌شده روی دیسک‌های علامت‌گذاری‌شده برای حذف
.TP
copychunks
تعداد چانک‌های ذخیره‌شده در قالب copy (تمامی دیسک‌ها)
.TP
ec4chunks
تعداد بخش‌های چانک ذخیره‌شده در قالب EC4 (تمامی دیسک‌ها)
.TP
ec8chunks
تعداد بخش‌های چانک ذخیره‌شده در قالب EC8 (تمامی دیسک‌ها)
.TP
hddok
تعداد پوشه‌ها (دیسک‌های سخت) معتبر
.TP
hddmfr
تعداد پوشه‌ها (دیسک‌های سخت) علامت‌گذاری‌شده برای حذف
.TP
hdddmg
تعداد پوشه‌ها (دیسک‌های سخت) علامت‌گذاری‌شده به عنوان آسیب‌دیده
.TP
udiff
اختلاف درصد استفاده میان بیشترین و کمترین دیسک مصرف‌شده
.TP
cpu
مجموع مصرف پردازنده (scpu + ucpu).SS "دستورها (COMMANDS)"
.TP
\fB-CRC/\fP\fIip\fP\fB/\fP\fIport\fP
حذف chunkserver انتخاب‌شده از فهرست chunkserverهای فعال
.TP
\fB-CTR/\fP\fIip\fP\fB/\fP\fIport\fP
حذف موقت chunkserver انتخاب‌شده از فهرست chunkserverهای فعال (فقط در حالت master elect)
.TP
\fB-CBW/\fP\fIip\fP\fB/\fP\fIport\fP
بازگرداندن chunkserver انتخاب‌شده به وضعیت کاری (از وضعیت grace)
.TP
\fB-CM1/\fP\fIip\fP\fB/\fP\fIport\fP
تغییر وضعیت chunkserver انتخاب‌شده به حالت نگهداری (maintenance)
.TP
\fB-CM0/\fP\fIip\fP\fB/\fP\fIport\fP
تغییر وضعیت chunkserver انتخاب‌شده به حالت استاندارد (از حالت نگهداری)
.TP
\fB-CRS/\fP\fIsessionid\fP
حذف نشست (session) انتخاب‌شده
.SH "مثال‌ها (EXAMPLES)"
.IP "\fBmfscli -SIC -2\fP"
نمایش جدول ماتریس وضعیت چانک (تعداد چانک‌ها برای هر ترکیبی از نسخه‌های معتبر و goal تعیین‌شده توسط کاربر) با استفاده از رنگ‌های گسترش‌یافته ترمینال (۲۵۶ رنگی)
.IP "\fBmfscli -SCS -f 1\fP"
نمایش جدول تمام chunkserverها با استفاده از کادرهای ضخیم یونیکد
.IP "\fBmfscli -SMS -p -s ','\fP"
نمایش نشست‌های (mountها) جاری با استفاده از قالب متن ساده و کاما به عنوان جداکننده
.IP "\fBmfscli -SOF -i 123\fP"
نمایش فایل‌های باز شده توسط فرایندهایی که از نشست (mount) با شناسه ۱۲۳ استفاده می‌کنند
.IP "\fBmfscli -SMC -a 10 -b cpu,memoryrss,delete,replicate\fP"
نمایش میزان مصرف cpu مستر، مقدار حافظه مقیم (resident) مصرفی مستر،
تعداد چانک‌های حذف‌شده و تعداد چانک‌های تکثیرشده در طول ده دقیقه گذشته
.IP "\fBmfscli -SCC -c 15 -d 192.168.1.10:9422:cpu,192.168.1.11:9422:cpu\fP"
نمایش مصرف cpu چانک‌سرورهای مستقر در ماشین‌هایی با IP 192.168.1.10 و 192.168.1.11
در طول پانزده دقیقه گذشته
.IP "\fBmfscli -SCC -d $(mfscli -SCS -p -s ',' | grep '^chunk' | awk -F ',' 'BEGIN {s=""""} {printf ""%s%s:%s:mem"",s,$2,$3 ; s="",""}')\fP"
نمایش میزان مصرف حافظه مقیم تمام chunkserverهای متصل (در نسخه قدیمی mfscli \- پیش از نگارش 4.32.2)
.IP "\fBmfscli -SCC -d mem\fP"
نمایش میزان مصرف حافظه مقیم تمام chunkserverهای متصل (در نسخه کنونی mfscli)
.IP "\fBmfscli -SIN -j\fP"
چاپ اطلاعات پایه در قالب JSON
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها به <bugs@moosefs.com>.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر (C) ۲۰۲۶ 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 mfsmaster (8)