نام (NAME)

borg-recreate - بازسازی و اصلاح بایگانی‌های موجود در Borg

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

borg [گزینه‌های عمومی] recreate [گزینه‌ها] [REPOSITORY_OR_ARCHIVE] [PATH...]

توضیحات (DESCRIPTION)

محتوای بایگانی‌های موجود را بازسازی می‌کند.

عملیات Recreate به‌طور بالقوه خطرناک است و ممکن است (در صورت استفاده نادرست) منجر به از دست رفتن داده‌ها شود. بسیار مراقب باشید!

مهم: فضای دیسک مخزن تا زمانی که borg compact را اجرا نکنید آزاد نمی‌شود.

گزینه‌های --exclude، --exclude-from، --exclude-if-present، --keep-exclude-tags و PATH دقیقاً معنایی مشابه آنچه در "borg create" دارند دارا هستند، اما آن‌ها تنها فایل‌های موجود در بایگانی‌ها را بررسی می‌کنند و نه سیستم‌فایل محلی را. اگر PATHها مشخص شوند، بایگانی‌های حاصل تنها شامل فایل‌هایی از این PATHها خواهند بود.

توجه داشته باشید که تمام مسیرها در یک بایگانی نسبی هستند، بنابراین الگوها/مسیرهای مطلق با آن‌ها مطابقت نخواهند داشت (--exclude، --exclude-from، PATHها).

گزینه --recompress به کاربر اجازه می‌دهد فشرده‌سازی داده‌های موجود در بایگانی‌ها را تغییر دهد. با توجه به نحوه ذخیره‌سازی اطلاعات اندازه فشرده‌شده توسط Borg، این عمل ممکن است اطلاعات نادرستی را برای بایگانی‌هایی که هم‌زمان بازسازی نشده‌اند نمایش دهد. این موضوع هیچ خطری از نظر از دست رفتن داده‌ها ندارد.

گزینه --chunker-params تمام فایل‌های موجود در بایگانی را مجدداً قطعه‌بندی (re-chunk) می‌کند؛ این گزینه می‌تواند برای تکثیرزدایی (deduplication) بایگانی‌های ارتقایافته Borg 0.xx یا Attic با بایگانی‌های Borg 1.x استفاده شود.

با احتیاط استفاده کنید. بسته به PATHها و الگوهای مشخص‌شده، recreate می‌تواند برای حذف دائمی فایل‌ها از بایگانی‌ها استفاده شود. در صورت تردید، از --dry-run --verbose --list برای مشاهده نحوه تفسیر الگوها/PATHها استفاده کنید. برای جزئیات به list_item_flags در borg create مراجعه کنید.

بایگانی در حال بازسازی تنها پس از تکمیل عملیات حذف می‌شود. بایگانی که در حین عملیات ساخته می‌شود به‌طور هم‌زمان با نام "<ARCHIVE>.recreate" وجود دارد. بایگانی جدید دارای شناسه بایگانی (archive ID) متفاوتی خواهد بود.

با استفاده از گزینه --target بایگانی اصلی جایگزین نمی‌شود؛ در عوض، یک بایگانی جدید ایجاد می‌شود.

هنگام قطعه‌بندی مجدد (یا فشرده‌سازی مجدد)، میزان مصرف فضا می‌تواند قابل توجه باشد - حداقل انتظار فضایی به اندازه کل حجم تکثیرزدایی‌شده بایگانی‌هایی را داشته باشید که از پارامترهای قبلی قطعه‌بند (یا فشرده‌سازی) استفاده می‌کردند.

اگر اخیراً borg check --repair را اجرا کرده‌اید و مجبور به اصلاح قطعات از دست رفته با قطعات جایگزین تمام‌صفر (all-zero) شده است، لطفاً ابتدا یک پشتیبان‌گیری دیگر برای همان داده‌ها اجرا کرده و سپس borg check --repair را مجدداً اجرا کنید تا بایگانی‌هایی که قطعات از دست رفته آن‌ها همچنان از داده‌های ورودی تولید می‌شوند، ترمیم شوند.

مهم: اجرای borg recreate برای قطعه‌بندی مجدد، فراداده (metadata) chunks_healthy مربوط به تمام موارد دارای قطعات جایگزین را حذف خواهد کرد؛ بنابراین پس از قطعه‌بندی مجدد، ترمیم دیگر امکان‌پذیر نخواهد بود (همچنین بعید است که هرگز کار کند: به دلیل تغییر پارامترهای قطعه‌بندی، قطعه گم‌شده احتمالاً هرگز دوباره دیده نخواهد شد حتی اگر هنوز داده‌هایی که آن را تولید کرده‌اند داشته باشید).

گزینه‌ها (OPTIONS)

برای گزینه‌های عمومی دستورات Borg به borg-common(1) مراجعه کنید.

آرگومان‌ها (arguments)

REPOSITORY_OR_ARCHIVE: مخزن یا بایگانی برای بازسازی
PATH: مسیرها برای بازسازی؛ الگوها نیز پشتیبانی می‌شوند

گزینه‌ها (options)

--list: خروجی فهرست پرجزئیات از موارد (فایل‌ها، پوشه‌ها، ...)
--filter STATUSCHARS: فقط نمایش مواردی با نویسه‌های وضعیت داده‌شده (فهرست‌شده در borg create --help)
-n, --dry-run: هیچ تغییری اعمال نشود
-s, --stats: چاپ آمار در پایان

گزینه‌های گنجاندن/مستثنی‌کردن (Include/Exclude options)

-e PATTERN, --exclude PATTERN: مستثنی کردن مسیرهای منطبق بر PATTERN
--exclude-from EXCLUDEFILE: خواندن الگوهای استثنا از EXCLUDEFILE، در هر خط یک الگو
--pattern PATTERN: گنجاندن/مستثنی کردن مسیرهای منطبق بر PATTERN
--patterns-from PATTERNFILE: خواندن الگوهای گنجاندن/استثنا از PATTERNFILE، در هر خط یک الگو
--exclude-caches: مستثنی کردن پوشه‌هایی که شامل یک فایل CACHEDIR.TAG هستند (http://www.bford.info/cachedir/spec.html)
--exclude-if-present NAME: مستثنی کردن پوشه‌هایی که با داشتن یک شیء سیستم‌فایل با NAME داده‌شده علامت‌گذاری شده‌اند
--keep-exclude-tags: اگر اشیاء برچسب با --exclude-if-present مشخص شده‌اند، خود اشیاء برچسب از بایگانی پشتیبان حذف نشوند

گزینه‌های آرشیو (Archive options)

--target TARGET: ایجاد یک بایگانی جدید با نام ARCHIVE، عدم جایگزینی بایگانی موجود (فقط برای یک بایگانی منفرد اعمال می‌شود)
-c SECONDS, --checkpoint-interval SECONDS: نوشتن نقطه بازرسی (checkpoint) در هر SECONDS ثانیه (پیش‌فرض: 1800)
--comment COMMENT: افزودن یک متن نظر/توضیح به بایگانی
--timestamp TIMESTAMP: مشخص کردن دستی تاریخ/زمان ایجاد بایگانی (فرمت UTC، yyyy-mm-ddThh:mm:ss). یا به عنوان جایگزین، مشخص کردن یک فایل/پوشه مرجع.
-C COMPRESSION, --compression COMPRESSION: انتخاب الگوریتم فشرده‌سازی، برای جزئیات خروجی دستور "borg help compression" را ببینید.
--recompress MODE: فشرده‌سازی مجدد قطعات داده طبق MODE و --compression. حالت‌های ممکن عبارتند از: if-different: فشرده‌سازی مجدد در صورتی که فشرده‌سازی فعلی با یک الگوریتم فشرده‌سازی متفاوت باشد (سطح فشرده‌سازی در نظر گرفته نمی‌شود)؛ always: فشرده‌سازی مجدد حتی اگر فشرده‌سازی فعلی با همان الگوریتم باشد (از این برای تغییر سطح فشرده‌سازی استفاده کنید)؛ و never: فشرده‌سازی مجدد انجام نشود (از این گزینه برای جلوگیری صریح از فشرده‌سازی مجدد استفاده کنید). اگر هیچ MODE مشخص نشود، از if-different استفاده خواهد شد. ارسال نکردن --recompress معادل "--recompress never"; است.
--chunker-params PARAMS: قطعه‌بندی مجدد با استفاده از پارامترهای قطعه‌بند داده‌شده (ALGO, CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE) یا default برای استفاده از مقادیر پیش‌فرض قطعه‌بند. پیش‌فرض: قطعه‌بندی مجدد انجام نشود

مثال‌ها (EXAMPLES)

# یکسان‌سازی تکثیرزدایی بایگانی‌های قدیمی (Attic/Borg 0.xx) با بایگانی‌های Borg 1.x.
# بایگانی‌های ایجاد شده با Borg 1.1+ و پارامترهای پیش‌فرض قطعه‌بند نادیده گرفته می‌شوند
# (شناسه بایگانی بدون تغییر باقی می‌ماند).
$ borg recreate /mnt/backup --chunker-params default --progress
# ایجاد یک پشتیبان با فشرده‌سازی کم اما سریع.
$ borg create /mnt/backup::archive /some/files --compression lz4
# سپس فشرده‌سازی مجدد آن — این ممکن است بیشتر طول بکشد، اما پشتیبان‌گیری از قبل تکمیل شده است،
# بنابراین هیچ ناسازگاری ناشی از اجرای یک عملیات پشتیبان‌گیری طولانی‌مدت رخ نخواهد داد.
$ borg recreate /mnt/backup::archive --recompress --compression zlib,9
# حذف فایل‌های ناخواسته از تمام بایگانی‌های موجود در یک مخزن.
# به مسیر نسبی برای گزینه --exclude توجه کنید — بایگانی‌ها تنها شامل مسیرهای نسبی هستند.
$ borg recreate /mnt/backup --exclude home/icke/Pictures/drunk_photos
# تغییر نظر/توضیح بایگانی.
$ borg create --comment "This is a comment" /mnt/backup::archivename ~
$ borg info /mnt/backup::archivename
Name: archivename
Fingerprint: ...
Comment: This is a comment
...
$ borg recreate --comment "This is a better comment" /mnt/backup::archivename
$ borg info /mnt/backup::archivename
Name: archivename
Fingerprint: ...
Comment: This is a better comment
...

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

borg-common(1), borg-patterns(1), borg-placeholders(1), borg-compression(1)

نویسندگان (AUTHORS)

The Borg Collective