'\" t .\" Title: btrbk .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.26 .\" Date: 2026-07-19 .\" Manual: Btrbk Manual .\" Source: Btrbk 0.32.7 .\" Language: Persian .\" .TH "BTRBK" "1" "2026-07-19" "Btrbk 0.32.7" "راهنمای Btrbk" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 .nh .ad l .de URL \fI\\$2\fP <\\$1>\\$3 .. .als MTO URL .if \n[.g] \{\ . mso www.tmac . am URL . ad l . . . am MTO . ad l . . . LINKSTYLE blue R < > .\} .SH "نام (NAME)" btrbk \- ابزار پشتیبان‌گیری و ساخت اسنپ‌شات برای زیرحجم‌های btrfs .SH "خلاصه دستور (SYNOPSIS)" .sp .nf btrbk [\-h|\-\-help] [\-\-version] [\-c|\-\-config ] [\-n|\-\-dry\-run] [\-\-exclude ] [\-p|\-\-preserve] [\-\-preserve\-snapshots] [\-\-preserve\-backups] [\-v|\-\-verbose] [\-q|\-\-quiet] [\-l|\-\-loglevel ] [\-t|\-\-table] [\-L|\-\-long] [\-1|\-\-single\-column] [\-\-format ] [\-\-pretty] [\-S|\-\-print\-schedule] [\-\-progress] [\-\-lockfile ] [\-\-override =] [[\-\-] .\|.\|.] .fi .br .SH "توضیحات (DESCRIPTION)" .sp دستور \fBbtrbk\fP یک ابزار پشتیبان‌گیری برای زیرحجم‌های btrfs است که از قابلیت‌های اختصاصی btrfs برای ایجاد اسنپ‌شات‌های اتمیک و انتقال افزایشی آن‌ها به یک سیستم‌فایل مقصد btrfs بهره می‌برد. این ابزار قادر است عملیات پشتیبان‌گیری را از یک مبدأ به چندین مقصد انجام دهد. .sp برای بیشتر عملیات‌ها، \fBbtrbk\fP جهت اجرای صحیح نیازمند \fIدسترسی‌های ریشه (root privileges)\fP است. به عنوان جایگزین، می‌توانید استفاده از بک‌اندهای "btrfs\-progs\-sudo" یا "btrfs\-progs\-btrbk" را مد نظر قرار دهید، که هر دو به شما اجازه می‌دهند btrbk را به عنوان یک کاربر عادی اجرا کنید. برای جزئیات بیشتر به گزینه پیکربندی \fIbackend\fP در btrbk.conf(5) مراجعه کنید. .SS "اسنپ‌شات‌ها و پشتیبان‌ها (Snapshots and Backups)" .sp اسنپ‌شات‌ها و همچنین زیرحجم‌های پشتیبان در این قالب ایجاد می‌شوند: .sp .if n .RS 4 .nf .fam C .[_N] .fam .fi .if n .RE .sp که در آن \fI\fP هم‌نام با زیرحجم مبدأ است، مگر اینکه گزینه پیکربندی \fIsnapshot_name\fP تنظیم شده باشد. \fI\fP برچسب زمانی توصیف‌کننده زمان ایجاد (زمان محلی میزبانی که btrbk را اجرا می‌کند) اسنپ‌شات/پشتیبان است. این قالب را می‌توان با استفاده از گزینه \fItimestamp_format\fP پیکربندی کرد، برای جزئیات به btrbk.conf(5) مراجعه کنید. اگر چندین اسنپ‌شات/پشتیبان در یک تاریخ/زمان یکسان ایجاد شوند، مقدار \fIN\fP از ۱ شروع شده و در هر اسنپ‌شات افزایش می‌یابد. .sp اگر یک اسنپ‌شات یا پشتیبان با الگوی نام‌گذاری بالا مطابقت نداشته باشد (مثلاً اگر به صورت دستی تغییر نام داده شده باشد)، btrbk آن را دست‌نخورده باقی می‌گذارد. .sp توجه داشته باشید که در اصطلاحات btrfs، یک \fIsnapshot\fP عبارت است از «یک زیرحجم با محتوای اولیه مشخص از زیرحجم اصلی» (که یک parent\-uuid را نشان می‌دهد، btrfs\-subvolume(8) را ببینید)، و می‌تواند خواندن\-نوشتن (پیش‌فرض) یا فقط‌خواندنی باشد. در اصطلاحات btrbk، واژه \fIsnapshot\fP به معنی «اسنپ‌شات فقط‌خواندنی btrfs» و واژه \fIbackup\fP به معنی «زیرحجم فقط‌خواندنی ایجادشده با send/receive» (که یک received\-uuid را نشان می‌دهد) است. .SH "گزینه‌ها (OPTIONS)" .sp \-h, \-\-help .RS 4 خلاصه دستور و فهرستی از دستورات را چاپ می‌کند. .RE .sp \-\-version .RS 4 نسخه btrbk را چاپ می‌کند. .RE .sp \-c, \-\-config .RS 4 پیکربندی را از می‌خواند. .RE .sp \-n, \-\-dry\-run .RS 4 هیچ عملی که سیستم‌فایل را تغییر دهد اجرا نمی‌کند، فقط اسنپ‌شات‌ها و زیرحجم‌های پشتیبانی را نشان می‌دهد که توسط دستورات \fBrun\fP، \fBsnapshot\fP، \fBresume\fP، \fBprune\fP، \fBarchive\fP و \fBclean\fP ایجاد یا حذف خواهند شد. برای دیدن دستورات btrfs که اجرا خواهند شد، همراه با \fI\-l debug\fP استفاده کنید. .RE .sp \-\-exclude .RS 4 بخش‌های پیکربندی‌شده مطابق با \fI\fP را مستثنی می‌کند. بخش عبارت‌های فیلتر (FILTER STATEMENTS) را در زیر ببینید. .RE .sp \-p, \-\-preserve .RS 4 تمام اسنپ‌شات‌ها و پشتیبان‌ها را حفظ می‌کند. از حذف هرگونه اسنپ‌شات و پشتیبان صرف‌نظر می‌کند، حتی اگر در فایل پیکربندی مشخص شده باشد (میانبری برای "\-\-preserve\-snapshots \-\-preserve\-backups"). .RE .sp \-\-preserve\-snapshots .RS 4 تمام اسنپ‌شات‌ها را حفظ می‌کند. از حذف هرگونه اسنپ‌شات صرف‌نظر می‌کند، حتی اگر در فایل پیکربندی مشخص شده باشد. .RE .sp \-\-preserve\-backups .RS 4 تمام پشتیبان‌ها را حفظ می‌کند. از حذف هرگونه پشتیبان صرف‌نظر می‌کند، حتی اگر در فایل پیکربندی مشخص شده باشد. .RE .sp \-\-wipe .RS 4 سیاست نگهداری اسنپ‌شات پیکربندی‌شده را نادیده گرفته و در عوض همه اسنپ‌شات‌ها به جز جدیدترین آن‌ها را حذف می‌کند. تمام اسنپ‌شات‌های مورد نیاز برای پشتیبان‌گیری افزایشی (آخرین مورد مشترک) نیز حفظ می‌شوند. در مواقعی که با کمبود فضای دیسک (ENOSPC) مواجه می‌شوید مفید است. .RE .sp \-v, \-\-verbose .RS 4 سطح ثبت گزارش (logging) را افزایش می‌دهد، "\-\-loglevel" را ببینید. .RE .sp \-q, \-\-quiet .RS 4 عملکرد بی‌صدا. در صورت تنظیم، btrbk خلاصه گزارش را پس از اجرای دستورات \fBrun\fP، \fBsnapshot\fP، \fBresume\fP، \fBprune\fP یا \fBarchive\fP چاپ نمی‌کند. .RE .sp \-l, \-\-loglevel .RS 4 سطح پرگویی را برای ثبت گزارش در stderr تنظیم می‌کند. سطوح پذیرفته‌شده عبارتند از: error، warn، info، debug و trace. پیش‌فرض info است. .RE .sp \-t, \-\-table .RS 4 خروجی را در قالب جدول چاپ می‌کند (میانبری برای "\-\-format=table"). .RE .sp \-L, \-\-long .RS 4 خروجی را در قالب جدول طولانی چاپ می‌کند (میانبری برای "\-\-format=long"). .RE .sp \-1, \-\-single\-column .RS 4 خروجی را به صورت تک‌ستونی چاپ می‌کند (برای همه دستورات در دسترس نیست). .RE .sp \-\-format table|long|raw|col:[h:] .RS 4 خروجی را در قالب مشخص‌شده چاپ می‌کند. اگر روی "raw" تنظیم شود، جفت‌های کلید=مقدار (key=value) جدا شده با فاصله و داخل نقل‌قول (قابل خواندن برای ماشین) را چاپ می‌کند. .sp اگر روی "col:" تنظیم شود، فقط ستون‌های مشخص‌شده در (فهرست جداشده با کاما) را چاپ می‌کند. اگر اصلاح‌کننده "h:" وجود داشته باشد خطوط هدر حذف می‌شوند. ستون‌هایی با پیشوند "\-" در صورت خالی بودن جمع می‌شوند. ستون‌هایی با پسوند ":RALIGN" راست‌چین می‌شوند. .RE .sp \-\-pretty .RS 4 خروجی جدول را با عناوین ستون حروف کوچک و زیرخط‌دار چاپ می‌کند (به جای عناوین تک‌خطی حروف بزرگ). .RE .sp \-S, \-\-print\-schedule .RS 4 اطلاعات زمان‌بندی دقیق را در دستورات \fBrun\fP، \fBsnapshot\fP، \fBresume\fP، \fBprune\fP و \fBarchive\fP چاپ می‌کند. از گزینه خط فرمان \fI\-\-format\fP برای جابجایی بین قالب‌های مختلف خروجی استفاده کنید. .RE .sp \-\-progress .RS 4 نوار پیشرفت را در عملیات send\-receive نمایش می‌دهد. نیازمند نصب بودن دستور "mbuffer" (نسخه >= 20180505) در میزبانی است که btrbk را اجرا می‌کند. .RE .sp \-\-lockfile .RS 4 در طول اجرای برنامه با استفاده از flock(2) یک قفل انحصاری روی قرار می‌دهد. اگر قفل توسط فرآیند دیگری نگه داشته شده باشد، قبل از اجرای هر اقدامی خارج می‌شود. گزینه پیکربندی "lockfile" را بازنویسی می‌کند. در حالت اجرای آزمایشی (\fI\-n\fP، \fI\-\-dry\-run\fP) نادیده گرفته می‌شود. .RE .sp \-\-override = .RS 4 یک گزینه پیکربندی را با بازنویسی می‌کند. به صورت سراسری، برای همه زمینه‌ها (contexts). با احتیاط استفاده کنید! .RE .SH "دستورات (COMMANDS)" .SS "عملیات‌ها (Actions)" .sp دستورات زیر برای ایجاد اسنپ‌شات و/یا پشتیبان استفاده می‌شوند. تمام اقدامات می‌توانند در حالت اجرای آزمایشی (\fI\-n\fP، \fI\-\-dry\-run\fP) کار کنند. از گزینه خط فرمان \fI\-\-format\fP برای جابجایی بین قالب‌های مختلف خروجی استفاده کنید. .sp برای اطلاعات در مورد پیکربندی سیاست نگهداری، بخش RETENTION POLICY را در \fBbtrbk.conf\fP(5) ببینید. .sp \fBrun\fP [filter.\|.\|.] .RS 4 عملیات اسنپ‌شات و پشتیبان‌گیری را طبق آنچه در فایل پیکربندی مشخص شده است انجام می‌دهد. اگر آرگومان‌های اختیاری [filter.\|.\|.] وجود داشته باشند، اسنپ‌شات‌ها و پشتیبان‌ها فقط برای زیرحجم‌ها/مقصدهایی که با یک عبارت فیلتر مطابقت دارند انجام می‌شوند (بخش عبارت‌های فیلتر (FILTER STATEMENTS) را در زیر ببینید). .sp \fBگام ۰: خواندن داده‌ها (Step 0: Read Data)\fP .RS 4 خواندن اطلاعات از سیستم‌فایل‌های مبدأ و مقصد btrfs به منظور انجام بررسی‌های صحت‌سنجی و شناسایی روابط والد/فرزند و received\-from. .RE .sp \fBگام ۱: ساخت اسنپ‌شات‌ها (Step 1: Create Snapshots)\fP .RS 4 در صورت موفقیت‌آمیز بودن بررسی‌ها، btrbk با توجه به گزینه \fIsnapshot_create\fP برای زیرحجم‌های مبدأ مشخص‌شده در فایل پیکربندی، اسنپ‌شات ایجاد می‌کند. .RE .sp \fBگام ۲: ایجاد پشتیبان‌ها (Step 2: Create Backups)\fP .RS 4 برای هر مقصد مشخص‌شده، btrbk پشتیبان‌ها را به شرح زیر ایجاد می‌کند: پس از مقایسه پشتیبان‌ها با اسنپ‌شات‌های مبدأ، btrbk تمام اسنپ‌شات‌های مفقود لازم برای برآوردن سیاست نگهداری مقصد پیکربندی‌شده را به صورت افزایشی از آخرین زیرحجم والد مشترکِ یافت‌شده انتقال می‌دهد. اگر هیچ زیرحجم والد مشترکی یافت نشود (یا اگر گزینه \fIincremental\fP روی \(lqno\(rq تنظیم شده باشد)، یک پشتیبان کامل (غیر افزایشی) ایجاد می‌شود. .RE .sp \fBگام ۳: حذف پشتیبان‌ها (Step 3: Delete Backups)\fP .RS 4 مگر اینکه گزینه \-p، \-\-preserve یا \-\-preserve\-backups تنظیم شده باشد، زیرحجم‌های پشتیبانی که توسط سیاست نگهداری پیکربندی‌شده‌شان حفظ نمی‌شوند، حذف خواهند شد. توجه داشته باشید که جدیدترین جفت اسنپ‌شات/پشتیبان بدون در نظر گرفتن سیاست نگهداری، همیشه حفظ می‌شود. .RE .sp \fBگام ۴: حذف اسنپ‌شات‌ها (Step 4: Delete Snapshots)\fP .RS 4 مگر اینکه گزینه \-p، \-\-preserve یا \-\-preserve\-snapshots تنظیم شده باشد، اسنپ‌شات‌هایی که توسط سیاست نگهداری پیکربندی‌شده‌شان حفظ نمی‌شوند، حذف خواهند شد. توجه داشته باشید که جدیدترین اسنپ‌شات (موردی که در گام ۱ ایجاد شد) و همچنین جدیدترین جفت اسنپ‌شات/پشتیبان، بدون در نظر گرفتن سیاست نگهداری همیشه حفظ می‌شوند. اگر هر مقصدی غیرقابل دسترس باشد یا خطایی داشته باشد، تمام اسنپ‌شات‌ها حفظ می‌شوند تا زنجیره افزایشی شکسته نشود. .RE .RE .sp \fBdryrun\fP [filter.\|.\|.] .RS 4 هیچ دستور btrfs که سیستم‌فایل را تغییر دهد اجرا نمی‌کند، فقط اسنپ‌شات‌ها و زیرحجم‌های پشتیبانی را نشان می‌دهد که توسط دستور \fBrun\fP ایجاد یا حذف خواهند شد. برای دیدن دستورات btrfs که اجرا خواهند شد، همراه با \fI\-l debug\fP استفاده کنید. .RE .sp \fBsnapshot\fP [filter.\|.\|.] .RS 4 فقط اسنپ‌شات: از ایجاد و حذف پشتیبان (گام‌های ۲ و ۳) صرف‌نظر می‌کند. اگر می‌خواهید از حذف اسنپ‌شات (گام ۴) نیز صرف‌نظر کنید، در ترکیب با \-p، \-\-preserve (یا \-\-preserve\-snapshots) استفاده کنید. .sp توجه داشته باشید که اگر مقصد در دسترس نباشد، حذف اسنپ‌شات نادیده گرفته می‌شود، زیرا همچنان برای تعیین آخرین جفت اسنپ‌شات/پشتیبان (که بدون در نظر گرفتن سیاست نگهداری همیشه حفظ می‌شود) مورد نیاز است. .RE .sp \fBresume\fP [filter.\|.\|.] .RS 4 ازسرگیری پشتیبان‌گیری: از ایجاد اسنپ‌شات (گام ۱) صرف‌نظر می‌کند، اسنپ‌شات‌ها/پشتیبان‌ها را برای برآوردن سیاست نگهداری پیکربندی‌شده آن‌ها منتقل و حذف می‌کند. اگر می‌خواهید از حذف پشتیبان و/یا اسنپ‌شات (گام‌های ۳ و ۴) صرف‌نظر کنید، در ترکیب با \-p، \-\-preserve، \-\-preserve\-backups، \-\-preserve\-snapshots استفاده کنید. .RE .sp \fBprune\fP [filter.\|.\|.] .RS 4 هرس کردن اسنپ‌شات‌ها و پشتیبان‌ها: از ایجاد اسنپ‌شات و پشتیبان (گام‌های ۱ و ۲) صرف‌نظر می‌کند، فقط اسنپ‌شات‌ها و پشتیبان‌ها را برای برآوردن سیاست نگهداری پیکربندی‌شده آن‌ها حذف می‌کند. برای پاکسازی دیسک پس از تغییر سیاست نگهداری مفید است. اگر می‌خواهید از حذف پشتیبان یا اسنپ‌شات (گام‌های ۳ و ۴) صرف‌نظر کنید، در ترکیب با \-\-preserve\-backups، \-\-preserve\-snapshots استفاده کنید. .sp توجه داشته باشید که اگر مبدأ یا مقصد در دسترس نباشد، حذف نادیده گرفته می‌شود، زیرا همچنان برای تعیین آخرین جفت اسنپ‌شات/پشتیبان (که بدون در نظر گرفتن سیاست نگهداری همیشه حفظ می‌شود) مورد نیاز است. .RE .sp \fBarchive\fP [\-\-raw] .RS 4 تمام زیرحجم‌های ایجادشده توسط btrbk را به طور بازگشتی از به دایرکتوری کپی می‌کند، که به صورت اختیاری با استفاده از گزینه‌های پیکربندی \fIarchive_preserve_*\fP مجدداً زمان‌بندی می‌شوند. همچنین درخت دایرکتوری را روی ایجاد می‌کند. برای ایجاد نسخه‌های بایگانی اضافی (کلون‌ها) از دیسک‌های پشتیبان شما مفید است. توجه داشته باشید که می‌توانید پس از جابجایی دیسک پشتیبان خود با دیسک بایگانی، به استفاده از btrbk ادامه دهید. .sp اگر می‌خواهید از زیرحجم‌های تو در تو در سیستم‌فایل مقصد استفاده کنید، باید آن‌ها را به صورت دستی ایجاد کنید (مثلاً با اجرای "btrfs subvolume create /dir"). اگر مطمئن نیستید، خروجی \-\-dry\-run را بررسی کنید. .sp توجه داشته باشید که این ویژگی برای عملکرد صحیح به \fBlinux kernel >=4.4\fP نیاز دارد! .sp اگر گزینه \fI\-\-raw\fP تنظیم شده باشد، مقصدهای خام (raw) ایجاد می‌کند (آزمایشی، btrbk.conf(5)، بخش انواع مقصد (TARGET TYPES) را ببینید). .RE .sp \fBclean\fP [filter.\|.\|.] .RS 4 پشتیبان‌های ناقص (خراب‌شده) را حذف می‌کند. پشتیبان‌های ناقص ممکن است به دلیل خطاهای شبکه یا سیگنال‌های قطع اجباری (kill) در حین انجام عملیات send/receive باقی مانده باشند، و از طریق تنظیم نبودن فلگ "received_uuid" روی یک زیرحجم مقصد (پشتیبان) شناسایی می‌شوند. .RE .sp جدول زیر نمای کلی سریعی از دستورات عملیاتی و نتایج حاصله شامل ایجاد اسنپ‌شات (+S)، ایجاد پشتیبان (+B)، حذف اسنپ‌شات (\-S) و حذف پشتیبان (\-B) ارائه می‌دهد: .sp .if n .RS 4 .nf .fam C Command\& Option\& S+ B+ S\- B\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- run\& x\& x\& x\& x run\& \-\-preserve\& x\& x run\& \-\-preserve\-snapshots\& x\& x\& x run\& \-\-preserve\-backups\& x\& x\& x snapshot\& x\& x snapshot\& \-\-preserve\& x resume\& x\& x\& x resume\& \-\-preserve\& x resume\& \-\-preserve\-snapshots\& x\& x resume\& \-\-preserve\-backups\& x\& x prune\& x\& x prune\& \-\-preserve\-snapshots\& x prune\& \-\-preserve\-backups\& x .fam .fi .if n .RE .SS "دستورات اطلاعاتی (Informative Commands)" .sp دستورات زیر صرفاً اطلاعاتی هستند و سیستم‌فایل را تغییر نخواهند داد. .sp \fBstats\fP [filter.\|.\|.] .RS 4 آمار زیرحجم‌های اسنپ‌شات و پشتیبان را چاپ می‌کند. به صورت اختیاری با آرگومان‌های [filter.\|.\|.] فیلتر می‌شود (بخش عبارت‌های فیلتر (FILTER STATEMENTS) را در زیر ببینید). .RE .sp \fBlist\fP [filter.\|.\|.] .RS 4 اطلاعات تعریف‌شده توسط را در قالب جدول چاپ می‌کند. به صورت اختیاری با آرگومان‌های [filter.\|.\|.] فیلتر می‌شود (بخش عبارت‌های فیلتر (FILTER STATEMENTS) را در زیر ببینید). .sp زیردستورات موجود (پیش‌فرض \(lqall\(rq): .sp \fBall\fP .RS 4 فهرست کردن تمام اسنپ‌شات‌ها و پشتیبان‌های ایجادشده توسط btrbk. .RE .sp \fBsnapshots\fP .RS 4 فهرست کردن تمام اسنپ‌شات‌های ایجادشده توسط btrbk. .RE .sp \fBbackups\fP .RS 4 فهرست کردن تمام پشتیبان‌ها (و اسنپ‌شات‌های مرتبط) ایجادشده توسط btrbk. .RE .sp \fBlatest\fP .RS 4 فهرست کردن جدیدترین جفت اسنپ‌شات/پشتیبان مشترک، یا جدیدترین اسنپ‌شات در صورت نیافتن مورد مشترک. .RE .sp \fBconfig\fP .RS 4 فهرست کردن روابط منبع/اسنپ‌شات/مقصد پیکربندی‌شده. .RE .sp \fBsource\fP .RS 4 فهرست کردن روابط منبع/اسنپ‌شات پیکربندی‌شده. .RE .sp \fBvolume\fP .RS 4 فهرست کردن بخش‌های حجم (volume) پیکربندی‌شده. .RE .sp \fBtarget\fP .RS 4 فهرست کردن مقصدهای پیکربندی‌شده. .RE .sp از گزینه خط فرمان \fI\-\-format\fP برای جابجایی بین قالب‌های مختلف خروجی استفاده کنید. .RE .sp \fBusage\fP [filter.\|.\|.] .RS 4 اطلاعات استفاده از سیستم‌فایل را برای همه حجم‌های مبدأ/مقصد چاپ می‌کند، به صورت اختیاری با آرگومان‌های [filter.\|.\|.] فیلتر می‌شود (بخش عبارت‌های فیلتر (FILTER STATEMENTS) را در زیر ببینید). توجه داشته باشید که مقدار "free" یک تخمین از میزان داده‌ای است که هنوز می‌تواند روی سیستم‌فایل نوشته شود. .RE .sp \fBorigin\fP .RS 4 درخت مبدأ زیرحجم را چاپ می‌کند: روابط والد\-فرزند و همچنین اطلاعات received\-from را نشان می‌دهد. از گزینه خط فرمان \fI\-\-format\fP برای جابجایی بین قالب‌های مختلف خروجی استفاده کنید. .RE .sp \fBdiff\fP .RS 4 فهرست فایل‌های تغییریافته از زمان نسل (transid) زیرحجم در زیرحجم را نمایش می‌دهد. ستون‌ها: .sp .if n .RS 4 .nf .fam C SIZE\& file was modified for a total of SIZE bytes COUNT\& file was modified in COUNT generations FLAGS\& "+"\& file accessed at offset 0 (at least once) "c"\& COMPRESS flag is set (at least once) "i"\& INLINE flag is set (at least once) .fam .fi .if n .RE .RE .sp \fBextents\fP [diff] .\|.\|. [exclusive .\|.\|.] .RS 4 میزان دقیق مصرف فضای دیسک و تفاوت (diff) را بر اساس داده‌های extent چاپ می‌کند (فراخوانی FIEMAP ioctl، کند است!). .sp زیرحجم‌های پس از کلمه کلیدی \fIexclusive\fP به یک مجموعه جداگانه اضافه می‌شوند، و داده‌های set\-exclusive اضافی در انتهای فهرست چاپ می‌شوند. این کار دیدی از میزان داده‌ای که در صورت حذف همه زیرحجم‌های موجود در مجموعه آزاد می‌شود ارائه می‌دهد. مثال: .sp .if n .RS 4 .nf .fam C btrbk extents diff /backup/data.* exclusive /backup/data.2010* .fam .fi .if n .RE .sp ستون EXCLUSIVE داده‌های set\-exclusive تمام زیرحجم‌های دیگرِ (!) فهرست‌شده را نشان می‌دهد (متمم نسبی نواحی بلوک). به شرطی که تمام زیرحجم‌های مرتبط (حاوی ارجاع به extentها) نیز فهرست شده باشند، این مقدار از فضای دیسک در هنگام حذف زیرحجم آزاد خواهد شد. .sp ستون DIFF داده‌های اضافه‌شده به زیرحجم قبلی را نشان می‌دهد (متمم نسبی نواحی بلوک). .sp اگر با گزینه \fI\-\-related\fP فراخوانی شود، btrbk تمام زیرحجم‌های مرتبط را نیز فهرست می‌کند. این مورد برای پشتیبان‌ها توصیه نمی‌شود، زیرا به محض حذف یک زیرحجم میانی، روابط parent\-uuid برای زیرحجم‌های دریافت‌شده شکسته می‌شود. .sp توجه داشته باشید که خواندن تمام extentها یک کار سنگین روی دیسک است؛ انتظار زمان‌های اجرای طولانی و مصرف بالای رم (RAM) را داشته باشید. مقداردهی \fIcache_dir\fP را مد نظر قرار دهید. .RE .sp \fBls\fP |.\|.\|. .RS 4 تمام زیرحجم‌های btrfs زیر را فهرست می‌کند. از گزینه خط فرمان \fI\-\-format\fP برای جابجایی بین قالب‌های مختلف خروجی استفاده کنید. lsbtr(1) را ببینید. .RE .sp \fBconfig\fP print|print\-all .RS 4 فایل پیکربندی تجزیه‌شده را چاپ می‌کند. .RE .SH "عبارت‌های فیلتر (FILTER STATEMENTS)" .sp آرگومان‌های فیلتر به قالب زیر پذیرفته می‌شوند: .sp .RS 4 با گزینه پیکربندی \fIgroup\fP در بخش‌های \fIvolume\fP، \fIsubvolume\fP یا \fItarget\fP مطابقت دارد. .RE .sp [:] .RS 4 با بخش \fIhostname\fP از \fI\fP در بخش‌های \fIvolume\fP یا \fItarget\fP مطابقت دارد. .RE .sp | .RS 4 با بخش‌های \fIvolume\fP، \fIsubvolume\fP یا \fItarget\fP از طریق مسیر نسبی یا مطلق (در صورت شروع با "/" یا "ssh://" یا ":/") مطابقت دارد و کاراکتر عام "*" را می‌پذیرد. مسیرهای نسبی با انتهای نام مسیر مطابقت داده می‌شوند. یکی از موارد زیر: .sp .RS 4 با بخش‌های \fIvolume\fP مطابقت دارد. .RE .sp / .RS 4 با بخش‌های \fIsubvolume\fP مطابقت دارد. .RE .sp // .RS 4 با بخش‌های \fIsubvolume\fP که اسنپ‌شات‌ها را با \fIsnapshot_dir\fP و \fIsnapshot_name\fP پیکربندی‌شده تعریف می‌کنند، مطابقت دارد. .RE .sp .RS 4 با بخش‌های \fItarget\fP مطابقت دارد. .RE .sp / .RS 4 با بخش‌های \fItarget\fP درون بخش‌های \fIsubvolume\fP که اسنپ‌شات‌ها را با \fIsnapshot_name\fP پیکربندی‌شده تعریف می‌کنند، مطابقت دارد. .RE .sp قالب‌های پذیرفته‌شده برای \fI\fP عبارتند از: .sp .if n .RS 4 .nf .fam C ssh://[:]/ : .fam .fi .if n .RE .RE .sp توجه داشته باشید که برای دستورات \fBrun\fP و \fBsnapshot\fP، فیلتری که با یک بخش پیکربندی \fItarget\fP مطابقت دارد، ایجاد اسنپ‌شات از بخش \fIsubvolume\fP پیرامون آن را نیز فعال می‌کند. اگر این مورد مطلوب نیست، اجرای جداگانه دستورات \fBsnapshot\fP و \fBresume\fP را مد نظر قرار دهید. .sp عبارت‌های فیلتر می‌توانند چندین بار مطابقت پیدا کنند (مثلاً هم روی گروه و هم روی نام میزبان). در چنین حالتی، تمام موارد منطبق پردازش می‌شوند. .SH "فایل‌ها (FILES)" .sp \f(CR/etc/btrbk.conf\fP, \f(CR/etc/btrbk/btrbk.conf\fP .RS 4 فایل پیکربندی پیش‌فرض. قالب فایل و گزینه‌های پیکربندی در \fBbtrbk.conf\fP(5) توضیح داده شده‌اند. .RE .SH "وضعیت خروج (EXIT STATUS)" .sp \fBbtrbk\fP کدهای خطای زیر را برمی‌گرداند: .sp 0 .RS 4 هیچ مشکلی رخ نداده است. .RE .sp 1 .RS 4 کد خطای عمومی. .RE .sp 2 .RS 4 خطای تجزیه: هنگام تجزیه گزینه‌های خط فرمان یا فایل پیکربندی. .RE .sp 3 .RS 4 خطای فایل قفل: در صورتی که فایل قفل هنگام راه‌اندازی وجود داشته باشد. .RE .sp 10 .RS 4 توقف پشتیبان‌گیری: حداقل یک وظیفه پشتیبان‌گیری متوقف شد. .RE .sp 255 .RS 4 خطای اسکریپت. .RE .SH "دسترس‌پذیری (AVAILABILITY)" .sp لطفاً برای جزئیات بیشتر به صفحه پروژه btrbk در \fB\c .URL "https://digint.ch/btrbk" "" "\fP" مراجعه کنید. .SH "همچنین ببینید (SEE ALSO)" .sp \fBbtrbk.conf\fP(5), \fBbtrfs\fP(8) .sp برای اطلاعات بیشتر درباره btrfs و پشتیبان‌گیری افزایشی، به وب‌سایت در نشانی \c .URL "https://btrfs.wiki.kernel.org/index.php/Incremental_Backup" "" "" مراجعه کنید. .SH "نویسندگان (AUTHORS)" .sp Axel Burri \c .MTO "axel\(attty0.ch" "" ""