.TH FSARCHIVER 8 "30 December 2009" "Parch Linux" "راهنمای مدیریت سیستم"

.SH "نام (NAME)"
fsarchiver \- ابزار پیشرفته ذخیره و بازیابی سامانه‌های پرونده

.SH "توضیحات (DESCRIPTION)"
دستور
.B fsarchiver
یک ابزار سیستمی است که امکان ذخیره‌سازی محتویات یک سامانه پرونده را در یک فایل بایگانی فشرده فراهم می‌کند. محتویات سامانه پرونده را می‌توان روی دستگاهی با اندازه متفاوت و همچنین روی یک سامانه پرونده متفاوت بازیابی کرد. برخلاف tar/dar، دستور
.B fsarchiver
هنگام استخراج داده‌ها روی دستگاه‌ها، سامانه پرونده را نیز ایجاد می‌کند. برای محافظت از داده‌ها، تمام اطلاعات داخل بایگانی دارای مجموع مقابله‌ای (checksum) هستند. اگر بایگانی آسیب ببیند، تنها فایل جاری از دست می‌رود، نه کل بایگانی.

.SH "پیوندها (LINKS)"
.SS "صفحه اصلی رسمی پروژه:"
http://www.fsarchiver.org
.SS "راهنمای شروع سریع:"
http://www.fsarchiver.org/quickstart
.SS "مخزن گیت:"
https://github.com/fdupoux/fsarchiver
.SS "گزارش باگ:"
https://github.com/fdupoux/fsarchiver/issues

.SH "خلاصه دستور (SYNOPSIS)"
.B fsarchiver [
.I options
.B ] savefs
.I archive
.I device
.B ...
.PP
.B fsarchiver [
.I options
.B ] restfs
.I archive
.BI id= n ,dest= device [,mkfs= fstype ,mkfsopt= options ,label= \
newlabel ,uuid= newuuid ]
.B ...
.PP
.B fsarchiver [
.I options
.B ] savedir
.I archive
.I directory
.B ...
.PP
.B fsarchiver [
.I options
.B ] restdir
.I archive destination
.PP
.B fsarchiver [
.I options
.B ] archinfo
.I archive
.PP
.B fsarchiver [
.I options
.B ] probe [detailed]

.SH "دستورها (COMMANDS)"
.TP
.B savefs
ذخیره سامانه پرونده
.I device
در
.IR archive .
.TP
.B restfs
بازیابی سامانه‌های پرونده از
.IR archive .
این عملیات داده‌های موجود روی
.I device
را رونویسی می‌کند. شناسه مبتنی بر صفر
.I n
مشخص‌کننده بخشی از بایگانی است که باید بازیابی شود. به‌صورت اختیاری، سامانه پرونده می‌تواند به
.I fstype
تبدیل شود و گزینه‌های اضافی mkfs با
.I options
مشخص گردند.
.I newlabel
و
.I newuuid
مقادیر ذخیره‌شده در بایگانی را بازنویسی می‌کنند.
.TP
.B savedir
ذخیره
.I directories
در
.I archive
(مشابه یک فایل tar فشرده).
.TP
.B restdir
بازیابی داده‌ها از
.I archive
که مبتنی بر سامانه پرونده نیست در
.IR destination .
.TP
.B archinfo
نمایش اطلاعات درباره یک فایل
.I archive
موجود و محتویات آن.
.TP
.B probe
نمایش فهرستی از سامانه‌های پرونده شناسایی‌شده روی دیسک‌ها.

.SH "گزینه‌ها (OPTIONS)"
.PP
.IP "\fB\-h, \-\-help\fP"
نمایش راهنما و اطلاعات درباره نحوه استفاده از fsarchiver همراه با مثال‌ها.
.IP "\fB\-V, \-\-version\fP"
نمایش نسخه برنامه و خروج.
.IP "\fB\-v, \-\-verbose\fP"
حالت پرحرف (می‌تواند چندین بار برای افزایش سطح جزئیات استفاده شود). جزئیات در کنسول چاپ خواهند شد.
.IP "\fB\-o, \-\-overwrite\fP"
رونویسی روی فایل بایگانی در صورت وجود به جای پایان ناموفق با خطا.
.IP "\fB\-d, \-\-debug\fP"
حالت اشکال‌زدایی (می‌تواند چندین بار برای افزایش سطح جزئیات استفاده شود). جزئیات در /var/log/fsarchiver.log نوشته خواهند شد.
.IP "\fB\-x, \-\-experimental\fP"
امکان ذخیره سامانه‌های پرونده‌ای که پشتیبانی از آن‌ها در fsarchiver آزمایشی محسوب می‌شود.
.IP "\fB\-A, \-\-allow-rw-mounted\fP"
امکان ذخیره یک سامانه پرونده که به‌صورت خواندن-نوشتن سوار شده است (پشتیبان‌گیری زنده). به‌طور پیش‌فرض، اگر دستگاه به‌صورت خواندن-نوشتن سوار شده باشد، fsarchiver با یک خطا متوقف می‌شود، زیرا این حالت اجازه می‌دهد تغییراتی در طول پشتیبان‌گیری روی سامانه پرونده اعمال شود. این تغییرات می‌توانند منجر به ناهمخوانی و ناسازگاری در پشتیبان شوند. استفاده از اسنپ‌شات‌های LVM روش توصیه‌شده برای ایجاد نسخه پشتیبان است زیرا سازگاری داده‌ها را تضمین می‌کند، اما این امکان فقط برای سامانه‌های پرونده‌ای که روی حجم‌های منطقی LVM قرار دارند در دسترس است. هنگام استفاده از این گزینه، فایل‌هایی که در حین فرآیند پشتیبان‌گیری حذف شوند نادیده گرفته می‌شوند.
.IP "\fB\-a, \-\-allow-no-acl-xattr\fP"
امکان ذخیره یک سامانه پرونده در زمانی که ACLها و صفات گسترده توسط هسته پشتیبانی نمی‌شوند (یا غیرفعال هستند). به‌طور پیش‌فرض اگر fsarchiver نتواند به ACLها و صفات گسترده دسترسی پیدا کند با یک خطا متوقف می‌شود، زیرا آن‌ها ذخیره نخواهند شد. اگر نیازی به حفظ ACLها و صفات گسترده ندارید، استفاده از این گزینه امن است.
.IP "\fB\-e pattern, \-\-exclude=pattern\fP"
مستثنی کردن فایل‌ها و پوشه‌هایی که با الگوی مشخص‌شده مطابقت دارند. الگو می‌تواند شامل نویسه‌های عام شل مانند * و ? باشد، یا یک نام فایل/پوشه ساده و یا یک مسیر مطلق فایل/پوشه باشد. هر بار که از نویسه‌های عام استفاده می‌کنید، باید الگو را درون نقل‌قول قرار دهید، در غیر این صورت توسط شل تفسیر می‌شود. نویسه‌های عام باید توسط fsarchiver تفسیر شوند. برای جزئیات بیشتر درباره این گزینه مثال‌های زیر را ببینید.
.IP "\fB\-L label, \-\-label=label\fP"
تنظیم برچسب بایگانی: این فقط یک یادداشت درباره محتویات آن است. برای مثال می‌تواند برای به‌خاطر سپردن یک نکته خاص درباره بایگانی یا وضعیت سامانه پرونده استفاده شود.
.IP "\fB\-z level, \-\-compress=level\fP"
سطوح فشرده‌سازی سنتی بین 0 (بسیار سریع) و 9 (بسیار خوب) هستند. میزان حافظه مورد نیاز در بالاترین سطوح فشرده‌سازی بسیار افزایش می‌یابد و در تعداد ریسه‌های فشرده‌سازی (گزینه \-j) ضرب می‌شود. سطح 9 یک سطح فشرده‌سازی بسیار بالا و افراطی در نظر گرفته می‌شود و برای اجرا به مقدار عظیمی از حافظه نیاز دارد. برای جزئیات بیشتر لطفاً این صفحه را مطالعه کنید:
http://www.fsarchiver.org/compression
.IP "\fB\-Z level, \-\-zstd=level\fP"
سطوح فشرده‌سازی Zstd بین 1 (بسیار سریع) و 22 (بسیار خوب) هستند. میزان حافظه مورد نیاز در بالاترین سطوح فشرده‌سازی بسیار افزایش می‌یابد و در تعداد ریسه‌های فشرده‌سازی (گزینه \-j) ضرب می‌شود. سطوح بالاتر از 20 سطوح فشرده‌سازی بسیار بالا و افراطی در نظر گرفته می‌شوند و برای اجرا به مقدار عظیمی از حافظه نیاز دارند. برای جزئیات بیشتر لطفاً این صفحه را مطالعه کنید:
http://www.fsarchiver.org/compression
.IP "\fB\-s mbsize, \-\-split=mbsize\fP"
تقسیم بایگانی به چندین فایل با اندازه مشخص‌شده بر حسب مگابایت (mbsize).
.IP "\fB\-j count, \-\-jobs=count\fP"
ایجاد بیش از یک ریسه فشرده‌سازی/استخراج. برای پردازنده‌های چند‌هسته‌ای بسیار مفید است. به‌طور پیش‌فرض fsarchiver تنها از یک ریسه فشرده‌سازی/استخراج (\-j 1) استفاده می‌کند و در نتیجه تنها یک پردازنده منطقی برای این کار به کار گرفته می‌شود. اگر پردازنده چند‌هسته‌ای یا بیش از یک پردازنده فیزیکی روی رایانه خود دارید، باید از این گزینه استفاده کنید. روش معمول استفاده مشخص کردن تعداد پردازنده‌های منطقی موجود است تا تمام توان پردازشی برای فشرده‌سازی یا استخراج بسیار سریع بایگانی به کار گرفته شود. همچنین می‌توانید از همه پردازنده‌های منطقی به جز یکی استفاده کنید تا سیستم برای سایر برنامه‌ها پاسخگو باقی بماند.
.IP "\fB\-c password, \-\-cryptpass=password\fP"
رمزنگاری/رمزگشایی داده‌ها در بایگانی. طول رمز عبور: 6 تا 64 کاراکتر. می‌توانید یک رمز عبور واقعی یا یک خط تیره (\-c \-) وارد کنید. اگر نمی‌خواهید رمز عبور را در خط فرمان وارد کنید، از خط تیره استفاده نمایید تا در ترمینال از شما پرسیده شود.

.SH "مثال‌ها (EXAMPLES)"
.SS ذخیره تنها یک سامانه پرونده (/dev/sda1) در یک بایگانی:
fsarchiver savefs /data/myarchive1.fsa /dev/sda1
.SS ذخیره دو سامانه پرونده (/dev/sda1 و /dev/sdb1) در یک بایگانی:
fsarchiver savefs /data/myarchive2.fsa /dev/sda1 /dev/sdb1
.SS بازیابی اولین سامانه پرونده از یک بایگانی (اولی = شماره 0):
fsarchiver restfs /data/myarchive2.fsa id=0,dest=/dev/sda1
.SS بازیابی دومین سامانه پرونده از یک بایگانی (دومی = شماره 1):
fsarchiver restfs /data/myarchive2.fsa id=1,dest=/dev/sdb1
.SS بازیابی دو سامانه پرونده از یک بایگانی (شماره‌های 0 و 1):
fsarchiver restfs /data/arch2.fsa id=0,dest=/dev/sda1 id=1,dest=/dev/sdb1
.SS بازیابی یک سامانه پرونده از یک بایگانی و تبدیل آن به reiserfs:
fsarchiver restfs /data/myarchive1.fsa id=0,dest=/dev/sda1,mkfs=reiserfs
.SS بازیابی یک سامانه پرونده از یک بایگانی و تعیین گزینه‌های اضافی mkfs:
fsarchiver restfs /data/myarchive1.fsa id=0,dest=/dev/sda1,mkfs=ext4,mkfsopt="-I 256"
.SS بازیابی یک سامانه پرونده از یک بایگانی و تعیین یک برچسب جدید برای آن:
fsarchiver restfs /data/myarchive1.fsa id=0,dest=/dev/sda1,label=root
.SS بازیابی یک سامانه پرونده از یک بایگانی و تعیین یک UUID جدید برای آن:
fsarchiver restfs /data/myarchive1.fsa id=0,dest=/dev/sda1,uuid=5f6e5f4f-dc2a-4dbd-a6ea-9ca997cde75e
.SS ذخیره محتویات /usr/src/linux در یک بایگانی (مشابه tar):
fsarchiver savedir /data/linux-sources.fsa /usr/src/linux
.SS ذخیره یک سامانه پرونده (/dev/sda1) در بایگانی تقسیم‌شده به بخش‌های 680 مگابایتی:
fsarchiver savefs -s 680 /data/myarchive1.fsa /dev/sda1
.SS ذخیره یک سامانه پرونده و مستثنی کردن تمام فایل‌ها/پوشه‌های با نام 'pagefile.*':
fsarchiver savefs /data/myarchive.fsa /dev/sda1 --exclude='pagefile.*'
.SS استثنای عمومی برای 'share' مانند '/usr/share' و '/usr/local/share':
fsarchiver savefs /data/myarchive.fsa --exclude=share
.SS استثنای مطلق معتبر برای '/usr/share' و نه برای '/usr/local/share':
fsarchiver savefs /data/myarchive.fsa --exclude=/usr/share
.SS ذخیره یک سامانه پرونده (/dev/sda1) در یک بایگانی رمزنگاری‌شده:
fsarchiver savefs -c mypassword /data/myarchive1.fsa /dev/sda1
.SS همانند قبل اما با درخواست رمز عبور در محیط ترمینال:
fsarchiver savefs -c - /data/myarchive1.fsa /dev/sda1
.SS استخراج یک بایگانی متشکل از فایل‌های ساده در /tmp/extract:
fsarchiver restdir /data/linux-sources.fsa /tmp/extract
.SS نمایش اطلاعات درباره یک بایگانی و سامانه‌های پرونده آن:
fsarchiver archinfo /data/myarchive2.fsa

.SH "هشدار (WARNING)"
دستور
.B fsarchiver
برای سامانه‌های پرونده لینوکس مانند EXT4 و XFS پایدار در نظر گرفته می‌شود اما برای NTFS ناپایدار است.

.SH "نویسنده (AUTHOR)"
برنامه fsarchiver توسط Francois Dupoux نوشته شده است. این نرم‌افزار تحت مجوز عمومی همگانی گنو نسخه ۲ (GPL2) منتشر می‌شود. این صفحه راهنما توسط Ilya Barygin و Francois Dupoux نوشته شده است.