نام (NAME)

mfsmetasearch - استفاده از فراداده MooseFS برای یافتن فایل‌های مشخص

خلاصه دستور (SYNOPSIS)

mfsmetasearch [-f J|C|C x] [-o output_file] [-e expr | -c chunkid_file] metadata_file

توضیحات (DESCRIPTION)

ابزار mfsmetasearch فایل‌ها و سایر اشیاء را در فراداده‌های MooseFS پیدا می‌کند که یا با عبارت ارائه‌شده مطابقت دارند (در صورت استفاده از گزینه -e) یا حاوی یک یا چند شماره از تکه‌ها (چانک‌ها) هستند که در فایل مشخص‌شده به قالب هگزادسیمال فهرست شده‌اند (در صورت استفاده از گزینه -c).

گزینه‌ها (OPTIONS)

-f: تغییر قالب پیش‌فرض خروجی متنی (TXT) به JSON (J) یا CSV (C)؛ در مورد CSV، اگر تنها C مشخص شده باشد، از جداکننده پیش‌فرض (کاما) استفاده می‌شود و اگر کاراکتر دوم مشخص شده باشد، این کاراکتر به عنوان جداکننده در داده‌های CSV به کار خواهد رفت.
-o: نوشتن خروجی در output_file به جای خروجی استاندارد (stdout).
-e: عبارت expr که یک فایل یا شیء باید با آن مطابقت داشته باشد تا در خروجی فهرست شود.
-c: فایل chunkid_file شامل شناسه‌های تکه (چانک)؛ تنها فایل‌هایی که شامل یکی از این تکه‌ها باشند در خروجی فهرست می‌شوند؛ شناسه‌های تکه‌ها باید در قالب هگزادسیمال فهرست شوند و تنها ۵۶ بیت پایانی مقادیر خوانده‌شده به عنوان شناسه تکه در نظر گرفته خواهند شد، به این معنی که در این حالت نیازی به حذف بیت‌های نشان‌دهنده بخش‌های EC (کدگذاری تصحیح خطا) نیست.
metadata_file: مسیر فایل metadata.mfs.

عبارت‌ها (EXPRESSIONS)

عبارت می‌تواند از چندین نماد، مقدار و عملگر تشکیل شود. یک نماد ویژگی یک فایل است، مقدار بیانگر مقدار آن ویژگی برای یک فایل خاص است و عملگرها کل عبارت را می‌سازند تا مشخص کنند آیا یک ویژگی خاص باید مطابقت داشته باشد، متفاوت باشد و غیره.

نمادها و مقادیر:

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		شناسه عددی تکه (مقدار: عددی؛ عبارت برای تمام تکه‌های فایل بررسی شده و در صورت درست بودن یکی از آن‌ها پذیرفته می‌شود)

عملگرهای پذیرفته‌شده (سبک C): - + * / % >> << < <= > >= == != ~ & ^ | ! && ^^ || ?:

مثال‌ها (EXAMPLES)

mfsmetasearch -e 'length<4096' /var/lib/mfs/metadata.mfs.back: این دستور تمام فایل‌های کوتاه‌تر از ۴۰۹۶ بایت (با اندازه کوچک‌تر از ۴۰۹۶ بایت) و تمام اشیاء غیر از فایل را نمایش می‌دهد.
mfsmetasearch -e 'type==file && length<4096' /var/lib/mfs/metadata.mfs.back: این دستور تمام فایل‌های کوتاه‌تر از ۴۰۹۶ بایت (با اندازه کوچک‌تر از ۴۰۹6 بایت) را نمایش می‌دهد.
mfsmetasearch -e 'umode&execute && gmode&execute && !(omode&execute)' /var/lib/mfs/metadata.mfs.back: این دستور تمام inodeهایی را نمایش می‌دهد که بیت اجازه اجرا برای هر دو کاربر و گروه در آن‌ها تنظیم شده، اما برای دیگران تنظیم نشده است.
mfsmetasearch -e 'chunkid==101020 || chunkid==0xFF77AA || chunkid==01234 || chunkid==0b1010101' /var/lib/mfs/metadata.mfs.back: این دستور تمام فایل‌هایی را نمایش می‌دهد که شامل تکه‌ای با شناسه ده‌دهی 101020، یا تکه‌ای با شناسه هگزادسیمال FF77AA، یا تکه‌ای با شناسه هشت‌هشتی 1234، یا تکه‌ای با شناسه باینری 1010101 باشند.
mfsmetasearch -e 'sclass==11' /var/lib/mfs/metadata.mfs.back: این دستور تمام اشیائی را نمایش می‌دهد که کلاس ذخیره‌سازی آن‌ها روی کلاس شماره ۱۱ تنظیم شده است.
mfsmetasearch -c /tmp/mychunkids.txt /var/lib/mfs/metadata.mfs.back: این دستور تمام فایل‌هایی را نمایش می‌دهد که شامل یکی از تکه‌های فهرست‌شده در فایل متنی /tmp/mychunkids.txt باشند.

گزارش باگ‌ها (REPORTING BUGS)

گزارش باگ‌ها را به <bugs@moosefs.com> ارسال کنید.

حق نشر (COPYRIGHT)

این فایل بخشی از MooseFS است.

سامانه MooseFS یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، نسخه ۲ (تنها) بازتوزیع کرده یا تغییر دهید.

سامانه MooseFS با این امید توزیع می‌شود که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا مناسب بودن برای یک هدف مشخص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

شما باید به همراه این برنامه نسخه‌ای از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت به https://www.gnu.org/licenses مراجعه کنید.

همچنین ببینید (SEE ALSO)

mfsmaster(8), mfsmetadump(8)