.TH mfspatadmin "1" "May 2026" "MooseFS 4.59.2-1" "This is part of MooseFS"
.ss 12 0
.SH "نام (NAME)"
mfspatadmin \- ابزار مدیریت الگوهای \fBMooseFS\fP
.SH "خلاصه دستور (SYNOPSIS)"
.B mfscreatepattern
[\fB-?\fP] [\fB-M\fP \fIMOUNTPOINT\fP]
\fB-n\fP \fIpattern\fP
[\fB-u\fP \fIuid\fP]
[\fB-g\fP \fIgid\fP]
[\fB-p\fP \fIpriority\fP]
[\fB-c\fP \fIstorage_class\fP]
[\fB-t\fP \fItrash_retention\fP]
[\fB-f\fP \fIeattr\fP]
.PP
.B mfsdeletepattern
[\fB-?\fP] [\fB-M\fP \fIMOUNTPOINT\fP]
\fB-n\fP \fIpattern\fP
[\fB-u\fP \fIuid\fP]
[\fB-g\fP \fIgid\fP]
.PP
.B mfslistpattern
[\fB-?\fP] [\fB-M\fP \fIMOUNTPOINT\fP]
.SH "توضیحات (DESCRIPTION)"
این مجموعه‌ای از ابزارها برای مدیریت الگوها است که جهت تغییر کلاس‌های ذخیره‌سازی، زمان نگهداری در سطل زباله و/یا ویژگی‌های اضافی در هنگام ایجاد یک فایل جدید یا تغییر نام یک فایل موجود استفاده می‌شوند.
.PP
دستور \fBmfscreatepattern\fP تعریف الگوی جدیدی را که در ادامه شرح داده شده اضافه می‌کند.
.PP
دستور \fBmfsdeletepattern\fP تعریف الگوی مشخص‌شده را حذف می‌کند.
.PP
دستور \fBmfslistpattern\fP تمام تعاریف الگوها را فهرست می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-n\fP الگویی را تعریف می‌کند که با نام فایل‌ها تطبیق داده خواهد شد. این قالب یک GLOB ساده است (به بخش زیر مراجعه کنید). این گزینه باید برای دستورات \fBadd\fP و \fBdelete\fP مشخص شود.
.PP
\fB-u\fP شناسه کاربری (UID) را مشخص می‌کند که باید با شناسه کاربری مؤثر کاربری که فایل را ایجاد می‌کند یا نام آن را تغییر می‌دهد برابر باشد. در صورت مشخص نشدن، شناسه کاربری هنگام تطبیق بررسی نخواهد شد.
.PP
\fB-g\fP شناسه گروهی (GID) را مشخص می‌کند که باید با یکی از شناسه‌های گروهی کاربری که فایل را ایجاد می‌کند یا نام آن را تغییر می‌دهد برابر باشد. در صورت مشخص نشدن، شناسه گروه هنگام تطبیق بررسی نخواهد شد.
.PP
\fB-p\fP اولویت تطبیق. هنگامی که چندین الگو با نام یک فایل مطابقت داشته باشند، الگوهای با اولویت بالاتر ارجحیت دارند. اولویت می‌تواند به صورت مقداری بین \fB0\fP (کمترین) و \fB255\fP (بیشترین) مشخص شود. در صورت مشخص نشدن، از مقدار پیش‌فرض \fB128\fP استفاده می‌شود. اگر دو یا چند الگو با اولویت یکسان با نام یک فایل مطابقت داشته باشند (با بالاترین اولویت ممکن برای آن فایل)، تنها یکی از آن‌ها (نامشخص) استفاده خواهد شد.
.PP
\fB-c\fP نام کلاس ذخیره‌سازی که در صورت تطبیق تنظیم می‌شود.
.PP
\fB-t\fP مقدار زمان نگهداری در سطل زباله که در صورت تطبیق تنظیم می‌شود؛ حداقل واحد ساعت است، برای نحوه قالب‌بندی مقدار به بخش "زمان (TIME)" مراجعه کنید.
.PP
\fB-f\fP نام فلگ‌هایی که با کاما از هم جدا شده‌اند و در صورت تطبیق تنظیم می‌شوند. هر فلگ \fBباید\fP با علامت '+' یا '-' همراه باشد که به ترتیب نشان‌دهنده فعال یا غیرفعال بودن آن فلگ است. برای توضیحات مربوط به فلگ‌ها به
.BR mfseattr (1)
مراجعه کنید.
.PP
\fB-M\fP نقطه اتصال \fBMooseFS\fP؛ در صورتی که ابزار درون دایرکتوری متصل‌شده \fBMooseFS\fP اجرا شود یا \fBMooseFS\fP در /mnt/mfs/ متصل شده باشد، نیازی به تعیین آن نیست.
.PP
\fB-?\fP پیام کوتاه راهنمای استفاده را نمایش می‌دهد.
.PP
حداقل یکی از گزینه‌های \fB-c\fP، \fB-t\fP یا \fB-f\fP باید برای دستور \fBadd\fP مشخص شود.
.SH "نکات (NOTES)"
.SS "زمان (TIME)"
.PP
برای متغیرهایی که زمان را بدون الزام به یک واحد مشخص و منفرد تعریف می‌کنند، زمان می‌تواند به عنوان تعداد ثانیه‌ها یا ساعت‌ها (عدد صحیح) بسته به حداقل واحد متغیر، یا به عنوان یک بازه زمانی در یکی از دو قالب ممکن تعریف شود:
.PP
قالب اول: #.#T که در آن T یکی از این موارد است: s (ثانیه)، m (دقیقه)، h (ساعت)، d (روز) یا w (هفته)؛ کسرهای حداقل واحد گرد خواهند شد.
.PP
قالب دوم: #w#d#h#m#s، که در آن هر تعداد از تعاریف را می‌توان حذف کرد، اما تعاریف باقی‌مانده باید به ترتیب باشند (بنابراین #d#m همچنان معتبر است، اما #m#d معتبر نیست)؛ محدوده‌ها: s و m از 0 تا 59، h از 0 تا 23، d از 0 تا 6، w نامحدود است و اولین تعریف نیز همیشه نامحدود خواهد بود (یعنی برای #d#h#m، مقدار d نامحدود است).
.PP
اگر حداقل واحد یک متغیر بزرگ‌تر از ثانیه باشد، واحدهای کمتر از حداقل واحد پذیرفته نخواهند شد. برای مثال، متغیری که حداقل واحد آن ساعت است، واحدهای s و m را نمی‌پذیرد.
.PP
مثال‌ها:
.PP
مقدار 1.5d همان 1d12h و معادل 36h است.
.PP
مقدار 2.5w همان 2w3d12h و معادل 420h است؛ 2w84h یک بازه زمانی معتبر نیست (h اولین تعریف نیست، بنابراین در محدوده 0 تا 23 محدود می‌شود).
.SS "تعریف الگو (PATTERN DEFINITION)"
الگو رشته‌ای همراه با نویسه‌های عمومی اختیاری (مشابه glob یونیکس) است. نویسه‌های عمومی شناخته‌شده:
.PP
\fB*\fP \- با هر تعداد از هر نویسه‌ای (از جمله هیچ نویسه‌ای) مطابقت دارد
.PP
\fB?\fP \- با هر تک‌نویسه‌ای مطابقت دارد
.PP
\fB[\fP\fIabc\fP\fB]\fP \- با یک نویسه مشخص‌شده در داخل براکت مطابقت دارد
.PP
\fB[\fP\fIFROM\fP\fB-\fP\fITO\fP\fB]\fP \- با یک نویسه از محدوده مشخص‌شده در داخل براکت مطابقت دارد
.PP
\fB[!\fP\fIabc\fP\fB]\fP \- با یک نویسه که در داخل براکت داده نشده مطابقت دارد
.PP
\fB[!\fP\fIFROM\fP\fB-\fP\fITO\fP\fB]\fP \- با یک نویسه خارج از محدوده مشخص‌شده در داخل براکت مطابقت دارد
.PP
مثال‌هایی از الگوها:
.PP
\fBexactname\fP \- تنها با فایلی با نام 'exactname' مطابقت دارد
.PP
\fB*.txt\fP \- با هر فایل متنی (رسماً فایلی با پسوند نام '.txt') مطابقت دارد.
.PP
\fBmyproject*\fP \- با هر فایلی با پیشوند نام 'myproject' مطابقت دارد.
.PP
\fBletter[0-9]\fP \- با فایل‌هایی با نام‌های 'letter0' ،'letter1' ،'letter2' و ... 'letter9' مطابقت دارد.
.PP
\fB[CB]at\fP \- با فایل‌هایی با نام‌های 'Cat' و 'Bat' مطابقت دارد.
.PP
\fB[!0-9]*\fP \- با فایل‌هایی با نام‌هایی که با رقم شروع نمی‌شوند مطابقت دارد
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها را به <bugs@moosefs.com> ارسال کنید.
.SH "حق نشر (COPYRIGHT)"
Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA
.PP
این فایل بخشی از MooseFS است.
.PP
نرم‌افزار MooseFS یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو انتشاریافته توسط بنیاد نرم‌افزارهای آزاد، نسخه ۲ (تنها)، بازتوزیع کرده یا تغییر دهید.
.PP
نرم‌افزار MooseFS به این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانتی؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.
.PP
شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به
<https://www.gnu.org/licenses>
مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR mfsmount (8),
.BR mfstools (1),
.BR mfssclass (1),
.BR mfseattr (1)