.TH mfsmetasearch "8" "May 2026" "MooseFS 4.59.2-1" "This is part of MooseFS"
.ss 12 0
.SH "نام (NAME)"
mfsmetasearch \- استفاده از فراداده MooseFS برای یافتن فایل‌های مشخص
.SH "خلاصه دستور (SYNOPSIS)"
\fBmfsmetasearch\fP [\fB\-f\fP \fBJ\fP|\fBC\fP|\fBC\fP \fIx\fP] [\fB\-o\fP \fIoutput_file\fP] [\fB\-e\fP \fIexpr\fP | \fB\-c\fP \fIchunkid_file\fP] \fImetadata_file\fP
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
\fBmfsmetasearch\fP
فایل‌ها و سایر اشیاء را در فراداده‌های MooseFS پیدا می‌کند که یا با عبارت ارائه‌شده مطابقت دارند (در صورت استفاده از گزینه
\fB\-e\fP)
یا حاوی یک یا چند شماره از تکه‌ها (چانک‌ها) هستند که در فایل مشخص‌شده به قالب هگزادسیمال فهرست شده‌اند (در صورت استفاده از گزینه
\fB\-c\fP).
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-f\fP
تغییر قالب پیش‌فرض خروجی متنی (TXT) به JSON
(\fBJ\fP)
یا CSV
(\fBC\fP)؛
در مورد CSV، اگر تنها
\fBC\fP
مشخص شده باشد، از جداکننده پیش‌فرض (کاما) استفاده می‌شود و اگر کاراکتر دوم مشخص شده باشد، این کاراکتر به عنوان جداکننده در داده‌های CSV به کار خواهد رفت.
.TP
\fB\-o\fP
نوشتن خروجی در
\fIoutput_file\fP
به جای خروجی استاندارد (stdout).
.TP
\fB\-e\fP
عبارت
\fIexpr\fP
که یک فایل یا شیء باید با آن مطابقت داشته باشد تا در خروجی فهرست شود.
.TP
\fB\-c\fP
فایل
\fIchunkid_file\fP
شامل شناسه‌های تکه (چانک)؛ تنها فایل‌هایی که شامل یکی از این تکه‌ها باشند در خروجی فهرست می‌شوند؛ شناسه‌های تکه‌ها باید در قالب هگزادسیمال فهرست شوند و تنها ۵۶ بیت پایانی مقادیر خوانده‌شده به عنوان شناسه تکه در نظر گرفته خواهند شد، به این معنی که در این حالت نیازی به حذف بیت‌های نشان‌دهنده بخش‌های EC (کدگذاری تصحیح خطا) نیست.
.TP
\fBmetadata_file\fP
مسیر فایل metadata.mfs.
.SS "عبارت‌ها (EXPRESSIONS)"
عبارت می‌تواند از چندین نماد، مقدار و عملگر تشکیل شود. یک نماد ویژگی یک فایل است، مقدار بیانگر مقدار آن ویژگی برای یک فایل خاص است و عملگرها کل عبارت را می‌سازند تا مشخص کنند آیا یک ویژگی خاص باید مطابقت داشته باشد، متفاوت باشد و غیره.
.PP
نمادها و مقادیر:
.nf
.ta +1.5i
inode		شماره inode (مقدار: عددی)
type		نوع inode (فهرست ثابت‌ها: file,directory,symlink,fifo,blockdev,chardev,socket,trash,sustained)
eattr		ماسک بیتی ویژگی‌های اضافی (فهرست ثابت‌های بیتی: noowner,noattrcache,noentrycache,nodatacache,snapshot,undeletable,appendonly,immutable)
sclass		شماره کلاس ذخیره‌سازی (مقدار: عددی؛ شماره‌های کلاس از طریق GUI یا CLI قابل بررسی است)
uid		شناسه کاربر (مقدار: عددی)
gid		شناسه گروه (مقدار: عددی)
mode		ماسک بیتی حالت دسترسی (فهرست ثابت‌های بیتی: sticky,sgid,suid,ur,uw,ux,gr,gw,gx,or,ow,ox)
umode		ماسک بیتی حالت دسترسی برای uid (فهرست ثابت‌های بیتی: read,write,execute)
gmode		ماسک بیتی حالت دسترسی برای gid (فهرست ثابت‌های بیتی: read,write,execute)
omode		ماسک بیتی حالت دسترسی برای others (فهرست ثابت‌های بیتی: read,write,execute)
atime		زمان دسترسی (مقدار: عددی - برچسب زمانی یونیکس بر حسب ثانیه)
mtime		زمان تغییر محتوا (مقدار: عددی - برچسب زمانی یونیکس بر حسب ثانیه)
ctime		زمان تغییر وضعیت (مقدار: عددی - برچسب زمانی یونیکس بر حسب ثانیه)
tretention	مدت نگهداری در سطل زباله بر حسب ساعت (مقدار: عددی)
length		طول فایل (مقدار: عددی؛ برای سایر اشیاء صفر است)
major		شناسه major (مقدار: عددی؛ تنها برای blockdev و chardev)
minor		شناسه minor (مقدار: عددی؛ تنها برای blockdev و chardev)
chunkid		شناسه عددی تکه (مقدار: عددی؛ عبارت برای تمام تکه‌های فایل بررسی شده و در صورت درست بودن یکی از آن‌ها پذیرفته می‌شود)
.fi
.PP
عملگرهای پذیرفته‌شده (سبک C):
- + * / % >> << < <= > >= == != ~ & ^ | ! && ^^ || ?:
.SH "مثال‌ها (EXAMPLES)"
.TP
.B mfsmetasearch \-e 'length<4096' /var/lib/mfs/metadata.mfs.back
این دستور تمام فایل‌های کوتاه‌تر از ۴۰۹۶ بایت (با اندازه کوچک‌تر از ۴۰۹۶ بایت) و تمام اشیاء غیر از فایل را نمایش می‌دهد.
.TP
.B mfsmetasearch \-e 'type==file && length<4096' /var/lib/mfs/metadata.mfs.back
این دستور تمام فایل‌های کوتاه‌تر از ۴۰۹۶ بایت (با اندازه کوچک‌تر از ۴۰۹6 بایت) را نمایش می‌دهد.
.TP
.B mfsmetasearch \-e 'umode&execute && gmode&execute && !(omode&execute)' /var/lib/mfs/metadata.mfs.back
این دستور تمام inodeهایی را نمایش می‌دهد که بیت اجازه اجرا برای هر دو کاربر و گروه در آن‌ها تنظیم شده، اما برای دیگران تنظیم نشده است.
.TP
.B mfsmetasearch \-e 'chunkid==101020 || chunkid==0xFF77AA || chunkid==01234 || chunkid==0b1010101' /var/lib/mfs/metadata.mfs.back
این دستور تمام فایل‌هایی را نمایش می‌دهد که شامل تکه‌ای با شناسه ده‌دهی 101020، یا تکه‌ای با شناسه هگزادسیمال FF77AA، یا تکه‌ای با شناسه هشت‌هشتی 1234، یا تکه‌ای با شناسه باینری 1010101 باشند.
.TP
.B mfsmetasearch \-e 'sclass==11' /var/lib/mfs/metadata.mfs.back
این دستور تمام اشیائی را نمایش می‌دهد که کلاس ذخیره‌سازی آن‌ها روی کلاس شماره ۱۱ تنظیم شده است.
.TP
.B mfsmetasearch \-c /tmp/mychunkids.txt /var/lib/mfs/metadata.mfs.back
این دستور تمام فایل‌هایی را نمایش می‌دهد که شامل یکی از تکه‌های فهرست‌شده در فایل متنی /tmp/mychunkids.txt باشند.
.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 mfsmaster (8),
.BR mfsmetadump (8)