.TH mfssnapshots "1" "May 2026" "MooseFS 4.59.2-1" "This is part of MooseFS"
.ss 12 0
.SH "نام (NAME)"
mfssnapshots \- ابزارهای تهیه اسنپ‌شات در \fBMooseFS\fP
.SH "خلاصه دستور (SYNOPSIS)"
.B mfsappendchunks
[\fB-?\fP] [\fB-s \fP\fIFROM\fP\fB:\fP\fITO\fP] \fISNAPSHOT_FILE\fP \fIFILE\fP...
.PP
.B mfsmakesnapshot
[\fB-?\fP] [\fB-o\fP|\fB-c\fP|\fB-p\fP] \fISOURCE_OBJECT\fP... \fIDESTINATION\fP
.PP
.B mfsrmsnapshot
[\fB-?\fP] [\fB-f\fP] \fIOBJECT\fP...
.SH "توضیحات (DESCRIPTION)"
دستور \fBmfsappendchunks\fP (معادل \fBmfssnapshot\fP در MooseFS 1.5)
یک رونوشت تنبل (lazy copy) از \fIFILE\fP(های) مشخص‌شده را به انتهای \fISNAPSHOT_FILE\fP مشخص‌شده پیوست می‌کند («تنبل»
بدین معناست که ایجاد چانک‌های (chunks) جدید تا زمان تغییر یکی از رونوشت‌ها به تعویق می‌افتد). اگر \fISNAPSHOT_FILE\fP وجود نداشته باشد، ایجاد می‌شود. اگر چندین فایل مشخص شده باشند، آن‌ها به گونه‌ای در یک فایل مقصد ادغام می‌شوند که هر فایل از مرز یک \fIchunk\fP (۶۴ مگابایت) شروع شود؛ فضای خالی پرکننده دست‌نخورده باقی می‌ماند. به صورت اختیاری تنها برشی از چانک‌ها می‌تواند پیوست شود (گزینه \fB-s\fP). تعریف برش مشابه پایتون است: \fIFROM\fP شامل می‌شود، \fITO\fP مستثنی است، اعداد منفی به معنای حرکت به عقب از انتهای فایل است. اگر \fIFROM\fP یا \fITO\fP مشخص نشود، به ترتیب به معنای از ابتدای فایل یا تا انتهای فایل خواهد بود. مثال‌های زیر را ببینید.

.PP
دستور \fBmfsmakesnapshot\fP یک اسنپ‌شات «واقعی» (رونوشت تنبل، همانند حالت \fBmfsappendchunks\fP) از شیء(ها) یا زیردرخت مشخص‌شده ایجاد می‌کند (مشابه دستور \fBcp -r\fP). این عملیات نسبت به هر آرگومان \fISOURCE_OBJECT\fP به صورت جداگانه اتمیک است. اگر \fIDESTINATION\fP به یک فایل موجود اشاره کند، خطا گزارش می‌شود مگر اینکه گزینه \fB-o\fP (رونویسی/overwrite) داده شده باشد. اگر مقصد به یک دایرکتوری از قبل موجود اشاره کند، اسنپ‌شات درون این دایرکتوری ایجاد می‌شود. نکته: اگر \fISOURCE_OBJECT\fP یک دایرکتوری باشد، به طور کامل رونوشت‌برداری می‌شود؛ اما اگر یک اسلش در انتهای آن قرار گیرد، تنها محتویات دایرکتوری رونوشت‌برداری می‌شود. هنگامی که گزینه \fB-c\fP داده شود، ویژگی‌های فایل‌های جدیداً ایجادشده شباهت بیشتری به ویژگی‌های فایل‌های ایجادشده توسط \fBcp\fP معمولی خواهند داشت (بدون حفظ ویژگی‌ها). گزینه \fB-p\fP پیوندهای سخت (hardlinks) موجود در \fISOURCE\fP را حفظ می‌کند (هنگامی که دو یا چند شیء داخل \fISOURCE\fP دارای پیوند سخت به یکدیگر باشند، در پوشه مقصد \fIDESTINATION\fP نیز آن اشیاء به یکدیگر پیوند سخت خواهند داشت).
.PP
دستور \fBmfsrmsnapshot\fP اشیای ایجادشده در نتیجه‌ی \fBmfsmakesnapshot\fP را حذف می‌کند (مشابه \fBrm -r\fP، اما بسیار سریع‌تر). به دلایل ایمنی، اشیایی که از طریق \fBmfsmakesnapshot\fP ایجاد می‌شوند دارای ویژگی \fBsnapshot\fP هستند (به \fBmfseattr\fP(1) مراجعه کنید) و تنها چنین اشیایی را می‌توان با استفاده از دستور \fBmfsrmsnapshot\fP حذف کرد. به طور پیش‌فرض تمام فایل‌ها و دایرکتوری‌های درون دایرکتوری مشخص‌شده باید دارای این ویژگی باشند تا دستور کل دایرکتوری را حذف کند؛ در غیر این صورت دستور هیچ چیزی را حذف نخواهد کرد. این رفتار را می‌توان با گزینه \fB-f\fP لغو کرد. با این گزینه، \fBmfsrmsnapshot\fP تنها آن دسته از فایل‌ها/دایرکتوری‌هایی را حذف می‌کند که دارای ویژگی \fBsnapshot\fP هستند و سایر موارد را دست‌نخورده باقی می‌گذارد.
.SS "برش‌ها (SLICES)"
عبارت \fIFROM\fP\fB:\fP\fITO\fP برای فایل منبع با چانک‌های 0,1,2,...,N-1,N:
.PP
2:4 = چانک‌های 2 و 3
.PP
3: = چانک‌های 3,4,...,N
.PP
:5 = چانک‌های 0,1,2,3,4
.PP
:-1 = چانک‌های 0,1,2,3,...,N-1
.PP
-4:-2 = چانک‌های N-3,N-2
.SH "گزینه‌ها (OPTIONS)"
گزینه \fB-?\fP پیام کوتاه راهنمای استفاده را نمایش می‌دهد.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها را به <bugs@moosefs.com> ارسال کنید.
.SH "حق نشر (COPYRIGHT)"
Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA

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

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

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

شما باید به همراه این برنامه نسخه‌ای از «مجوز عمومی همگانی گنو» را دریافت کرده باشید؛ در غیر این صورت، به
<https://www.gnu.org/licenses>
مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR mfsmount (8),
.BR mfstools (1),
.BR mfseattr (1)