نام (NAME)

mfssnapshots - ابزارهای تهیه اسنپ‌شات در MooseFS

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

mfsappendchunks [-?] [-s FROM:TO] SNAPSHOT_FILE FILE...

mfsmakesnapshot [-?] [-o|-c|-p] SOURCE_OBJECT... DESTINATION

mfsrmsnapshot [-?] [-f] OBJECT...

توضیحات (DESCRIPTION)

دستور mfsappendchunks (معادل mfssnapshot در MooseFS 1.5) یک رونوشت تنبل (lazy copy) از FILE(های) مشخص‌شده را به انتهای SNAPSHOT_FILE مشخص‌شده پیوست می‌کند («تنبل» بدین معناست که ایجاد چانک‌های (chunks) جدید تا زمان تغییر یکی از رونوشت‌ها به تعویق می‌افتد). اگر SNAPSHOT_FILE وجود نداشته باشد، ایجاد می‌شود. اگر چندین فایل مشخص شده باشند، آن‌ها به گونه‌ای در یک فایل مقصد ادغام می‌شوند که هر فایل از مرز یک chunk (۶۴ مگابایت) شروع شود؛ فضای خالی پرکننده دست‌نخورده باقی می‌ماند. به صورت اختیاری تنها برشی از چانک‌ها می‌تواند پیوست شود (گزینه -s). تعریف برش مشابه پایتون است: FROM شامل می‌شود، TO مستثنی است، اعداد منفی به معنای حرکت به عقب از انتهای فایل است. اگر FROM یا TO مشخص نشود، به ترتیب به معنای از ابتدای فایل یا تا انتهای فایل خواهد بود. مثال‌های زیر را ببینید.

دستور mfsmakesnapshot یک اسنپ‌شات «واقعی» (رونوشت تنبل، همانند حالت mfsappendchunks) از شیء(ها) یا زیردرخت مشخص‌شده ایجاد می‌کند (مشابه دستور cp -r). این عملیات نسبت به هر آرگومان SOURCE_OBJECT به صورت جداگانه اتمیک است. اگر DESTINATION به یک فایل موجود اشاره کند، خطا گزارش می‌شود مگر اینکه گزینه -o (رونویسی/overwrite) داده شده باشد. اگر مقصد به یک دایرکتوری از قبل موجود اشاره کند، اسنپ‌شات درون این دایرکتوری ایجاد می‌شود. نکته: اگر SOURCE_OBJECT یک دایرکتوری باشد، به طور کامل رونوشت‌برداری می‌شود؛ اما اگر یک اسلش در انتهای آن قرار گیرد، تنها محتویات دایرکتوری رونوشت‌برداری می‌شود. هنگامی که گزینه -c داده شود، ویژگی‌های فایل‌های جدیداً ایجادشده شباهت بیشتری به ویژگی‌های فایل‌های ایجادشده توسط cp معمولی خواهند داشت (بدون حفظ ویژگی‌ها). گزینه -p پیوندهای سخت (hardlinks) موجود در SOURCE را حفظ می‌کند (هنگامی که دو یا چند شیء داخل SOURCE دارای پیوند سخت به یکدیگر باشند، در پوشه مقصد DESTINATION نیز آن اشیاء به یکدیگر پیوند سخت خواهند داشت).

دستور mfsrmsnapshot اشیای ایجادشده در نتیجه‌ی mfsmakesnapshot را حذف می‌کند (مشابه rm -r، اما بسیار سریع‌تر). به دلایل ایمنی، اشیایی که از طریق mfsmakesnapshot ایجاد می‌شوند دارای ویژگی snapshot هستند (به mfseattr(1) مراجعه کنید) و تنها چنین اشیایی را می‌توان با استفاده از دستور mfsrmsnapshot حذف کرد. به طور پیش‌فرض تمام فایل‌ها و دایرکتوری‌های درون دایرکتوری مشخص‌شده باید دارای این ویژگی باشند تا دستور کل دایرکتوری را حذف کند؛ در غیر این صورت دستور هیچ چیزی را حذف نخواهد کرد. این رفتار را می‌توان با گزینه -f لغو کرد. با این گزینه، mfsrmsnapshot تنها آن دسته از فایل‌ها/دایرکتوری‌هایی را حذف می‌کند که دارای ویژگی snapshot هستند و سایر موارد را دست‌نخورده باقی می‌گذارد.

برش‌ها (SLICES)

عبارت FROM:TO برای فایل منبع با چانک‌های 0,1,2,...,N-1,N:

2:4 = چانک‌های 2 و 3

3: = چانک‌های 3,4,...,N

:5 = چانک‌های 0,1,2,3,4

:-1 = چانک‌های 0,1,2,3,...,N-1

-4:-2 = چانک‌های N-3,N-2

گزینه‌ها (OPTIONS)

گزینه -? پیام کوتاه راهنمای استفاده را نمایش می‌دهد.

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

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

حق نشر (COPYRIGHT)

این پرونده بخشی از MooseFS است.

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

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

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

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

mfsmount(8), mfstools(1), mfseattr(1)