.TH mfsmaster "8" "May 2026" "MooseFS 4.59.2-1" "This is part of MooseFS"
.ss 12 0
.SH "نام (NAME)"
mfsmaster \- شروع، راه‌اندازی مجدد یا متوقف کردن فرایند مستر MooseFS
.SH "خلاصه دستور (SYNOPSIS)"
.B mfsmaster
[\fB\-c\fP \fICFGFILE\fP]
[\fB\-f\fP]
[\fB\-d\fP]
[\fB\-u\fP]
[\fB\-n\fP]
[\fB\-i\fP]
[\fB\-a\fP]
[\fB\-e\fP]
[\fB\-x\fP[\fBx\fP]]
[\fB\-t\fP \fILOCKTIMEOUT\fP]
[\fIACTION\fP]
.PP
.B mfsmaster \-v
.PP
.B mfsmaster \-h
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه
\fBmfsmaster\fP
برنامه اصلی (مستر) در سیستم فایل توزیع‌شده MooseFS است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-v\fP
نمایش اطلاعات نسخه و خروج.
.TP
\fB\-h\fP
نمایش راهنمای استفاده و خروج.
.TP
\fB\-c\fP \fICFGFILE\fP
مشخص کردن مسیر جایگزین برای فایل پیکربندی (پیش‌فرض
\fBmfsmaster.cfg\fP
در دایرکتوری پیکربندی سیستم است).
.TP
\fB\-f\fP
اجرا در پیش‌زمینه، بدون تبدیل شدن به دیمن (daemon).
.TP
\fB\-d\fP
اجرا همراه با گزینه‌های خطرناک (نام‌ها: DANGEROUS_*).
.TP
\fB\-u\fP
ثبت مقادیر پیکربندی تعریف‌نشده در لاگ (زمانی که مقدار پیش‌فرض لحاظ می‌شود).
.TP
\fB\-n\fP
تلاش نکردن برای افزایش حد اندازه core dump.
.TP
\fB\-i\fP
نادیده گرفتن برخی از خطاهای ساختاری فراداده (metadata).
.TP
\fB\-a\fP
بازیابی خودکار فراداده از گزارش‌های تغییرات (change logs).
.TP
\fB\-e\fP
(تنها در نسخه pro) شروع بدون فراداده (جهت شروع مسترهای کمکی استفاده می‌شود).
.TP
\fB\-x\fP
تولید خروجی با جزئیات بیشتر.
.TP
\fB\-xx\fP
تولید خروجی با جزئیات حتی بیشتر.
.TP
\fB\-t\fP \fILOCKTIMEOUT\fP
مدت زمان انتظار برای قفل‌فایل (به ثانیه؛ پیش‌فرض ۱۸۰۰ ثانیه است).
.TP
\fIACTION\fP
به مستر دستور می‌دهد که یکی از اقدامات زیر را اجرا کند:
.RS
.IP start 9
شروع فرایند مستر در صورتی که هم‌اکنون در حال اجرا نباشد؛ در غیر این صورت پیام خطا نمایش داده می‌شود.
.IP stop
متوقف کردن فرایند مستر در صورتی که در حال اجرا باشد؛ در غیر این صورت پیام خطا نمایش داده می‌شود.
.IP restart
(اقدام پیش‌فرض) اگر فرایند مستر در حال اجرا باشد، آن را مجدداً راه‌اندازی می‌کند؛ اگر در حال اجرا نباشد، آن را شروع می‌کند.
.IP reload
ارسال یک سیگنال به فرایند مستر جهت بارگذاری مجدد فایل‌های پیکربندی.
.IP info
ارسال یک سیگنال به فرایند مستر جهت ایجاد فایل اطلاعات خطایابی در دایرکتوری کاری.
.IP test
در صورتی که مستر در حال اجرا باشد عبارت "mfsmaster pid: PID" را نمایش می‌دهد (و مقدار ۰ برمی‌گرداند)؛ در غیر این صورت "mfsmaster is not running" را نمایش می‌دهد (و مقدار ۱ برمی‌گرداند).
.IP kill
ارسال سیگنال خاتمه به فرایند مستر.
.IP restore
بازیابی فایل فراداده جاری با استفاده از نسخه پشتیبان فراداده و فایل‌های گزارش تغییرات (در صورت امکان، یعنی اگر فایل‌های صحیح موجود باشند)، ذخیره آن در دایرکتوری کاری و خروج.
.RE
.SH "فایل‌ها (FILES)"
.TP
\fBmfsmaster.cfg\fP
فایل پیکربندی فرایند مستر MooseFS؛ برای جزئیات به صفحه راهنمای
\fBmfsmaster.cfg\fP\|(5)
مراجعه کنید.
.TP
\fBmfsexports.cfg\fP
فایل کنترل دسترسی MooseFS؛ برای جزئیات به صفحه راهنمای
\fBmfsexports.cfg\fP\|(5)
مراجعه کنید.
.TP
\fBmfstopology.cfg\fP
تعاریف توپولوژی شبکه؛ برای جزئیات به صفحه راهنمای
\fBmfstopology.cfg\fP\|(5)
مراجعه کنید.
.TP
\fBmfsipmap.cfg\fP
تعاریف نگاشت IP برای سرورهای تکه (Chunkservers)؛ برای جزئیات به صفحه راهنمای
\fBmfsipmap.cfg\fP\|(5)
مراجعه کنید.
.TP
\fB.mfsmaster.lock\fP
فایل قفل فرایند مستر در حال اجرای MooseFS
(در دایرکتوری داده‌ها ایجاد می‌شود).
.TP
\fB.bgwriter.lock\fP
فایل قفل زیرفرایند مستر MooseFS برای ذخیره فراداده
(در دایرکتوری داده‌ها ایجاد می‌شود).
.TP
\fBmetadata.mfs\fP, \fBmetadata\.mfs\.back\fP
تصویر فراداده سیستم فایل MooseFS (در دایرکتوری داده‌ها ایجاد می‌شود).
.TP
\fBmetadata.crc\fP
چک‌سام CRC فایل
\fBmetadata.mfs\fP
(در دایرکتوری داده‌ها ایجاد می‌شود).
.TP
\fBmetadata.mfs.empty\fP
یک فایل فراداده خالی، برای استفاده هنگام راه‌اندازی یک نمونه جدید و تازه از MooseFS (در دایرکتوری داده‌ها ایجاد می‌شود).
.TP
\fBchangelog.\fP*\fB.mfs\fP
گزارش‌های تغییرات فراداده سیستم فایل MooseFS (در دایرکتوری داده‌ها ایجاد می‌شود).
.TP
\fBstats.mfs\fP
آمارهای نمودارهای مستر (در دایرکتوری داده‌ها ایجاد می‌شود).
.TP
\fB.mfsmaster_info.txt\fP
فایل اطلاعات مستر، که با ارسال سیگنال INFO به فرایند ایجاد شده و شامل پارامترهای کاری برای اهداف اشکال‌زدایی یا پشتیبانی است (در دایرکتوری داده‌ها ایجاد می‌شود).
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها را به <bugs@moosefs.com> ارسال کنید.
.SH "حق نشر (COPYRIGHT)"
Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA
.PP
این فایل بخشی از MooseFS است.
.PP
سامانه MooseFS یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، نسخه ۲ (تنها) بازتوزیع کرده یا تغییر دهید.
.PP
سامانه MooseFS با این امید توزیع می‌شود که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف مشخص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.
.PP
شما باید به همراه این برنامه نسخه‌ای از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت به
<https://www.gnu.org/licenses>
مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR mfschunkserver (8),
.BR mfsmount (8),
.BR mfsmaster.cfg (5),
.BR mfsexports.cfg (5),
.BR mfstopology.cfg (5)