.\" Man page generated from reStructuredText .\" by the Docutils 0.22.4 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "borg-recreate" "1" "2026-07-18" "" "ابزار پشتیبان‌گیری borg" .SH "نام (NAME)" borg-recreate \- بازسازی و اصلاح بایگانی‌های موجود در Borg .SH "خلاصه دستور (SYNOPSIS)" .sp borg [گزینه‌های عمومی] recreate [گزینه‌ها] [REPOSITORY_OR_ARCHIVE] [PATH...] .SH "توضیحات (DESCRIPTION)" .sp محتوای بایگانی‌های موجود را بازسازی می‌کند. .sp عملیات Recreate به‌طور بالقوه خطرناک است و ممکن است (در صورت استفاده نادرست) منجر به از دست رفتن داده‌ها شود. بسیار مراقب باشید! .sp مهم: فضای دیسک مخزن تا زمانی که .B borg compact را اجرا نکنید آزاد \fBنمی‌شود\fP\&. .sp گزینه‌های .BR \-\-exclude ، .BR \-\-exclude\-from ، .BR \-\-exclude\-if\-present ، .B \-\-keep\-exclude\-tags و PATH دقیقاً معنایی مشابه آنچه در \(dqborg create\(dq دارند دارا هستند، اما آن‌ها تنها فایل‌های موجود در بایگانی‌ها را بررسی می‌کنند و نه سیستم‌فایل محلی را. اگر PATHها مشخص شوند، بایگانی‌های حاصل تنها شامل فایل‌هایی از این PATHها خواهند بود. .sp توجه داشته باشید که تمام مسیرها در یک بایگانی نسبی هستند، بنابراین الگوها/مسیرهای مطلق با آن‌ها مطابقت \fIنخواهند\fP داشت .RB ( \-\-exclude ، .BR \-\-exclude\-from ، PATHها). .sp گزینه .B \-\-recompress به کاربر اجازه می‌دهد فشرده‌سازی داده‌های موجود در بایگانی‌ها را تغییر دهد. با توجه به نحوه ذخیره‌سازی اطلاعات اندازه فشرده‌شده توسط Borg، این عمل ممکن است اطلاعات نادرستی را برای بایگانی‌هایی که هم‌زمان بازسازی نشده‌اند نمایش دهد. این موضوع هیچ خطری از نظر از دست رفتن داده‌ها ندارد. .sp گزینه .B \-\-chunker\-params تمام فایل‌های موجود در بایگانی را مجدداً قطعه‌بندی (re-chunk) می‌کند؛ این گزینه می‌تواند برای تکثیرزدایی (deduplication) بایگانی‌های ارتقایافته Borg 0.xx یا Attic با بایگانی‌های Borg 1.x استفاده شود. .sp \fBبا احتیاط استفاده کنید.\fP بسته به PATHها و الگوهای مشخص‌شده، recreate می‌تواند برای حذف دائمی فایل‌ها از بایگانی‌ها استفاده شود. در صورت تردید، از .B \-\-dry\-run \-\-verbose \-\-list برای مشاهده نحوه تفسیر الگوها/PATHها استفاده کنید. برای جزئیات به .I list_item_flags در .B borg create مراجعه کنید. .sp بایگانی در حال بازسازی تنها پس از تکمیل عملیات حذف می‌شود. بایگانی که در حین عملیات ساخته می‌شود به‌طور هم‌زمان با نام \(dq.recreate\(dq وجود دارد. بایگانی جدید دارای شناسه بایگانی (archive ID) متفاوتی خواهد بود. .sp با استفاده از گزینه .B \-\-target بایگانی اصلی جایگزین نمی‌شود؛ در عوض، یک بایگانی جدید ایجاد می‌شود. .sp هنگام قطعه‌بندی مجدد (یا فشرده‌سازی مجدد)، میزان مصرف فضا می‌تواند قابل توجه باشد \- حداقل انتظار فضایی به اندازه کل حجم تکثیرزدایی‌شده بایگانی‌هایی را داشته باشید که از پارامترهای قبلی قطعه‌بند (یا فشرده‌سازی) استفاده می‌کردند. .sp اگر اخیراً .B borg check \-\-repair را اجرا کرده‌اید و مجبور به اصلاح قطعات از دست رفته با قطعات جایگزین تمام‌صفر (all-zero) شده است، لطفاً ابتدا یک پشتیبان‌گیری دیگر برای همان داده‌ها اجرا کرده و سپس .B borg check \-\-repair را مجدداً اجرا کنید تا بایگانی‌هایی که قطعات از دست رفته آن‌ها همچنان از داده‌های ورودی تولید می‌شوند، ترمیم شوند. .sp مهم: اجرای .B borg recreate برای قطعه‌بندی مجدد، فراداده (metadata) .B chunks_healthy مربوط به تمام موارد دارای قطعات جایگزین را حذف خواهد کرد؛ بنابراین پس از قطعه‌بندی مجدد، ترمیم دیگر امکان‌پذیر نخواهد بود (همچنین بعید است که هرگز کار کند: به دلیل تغییر پارامترهای قطعه‌بندی، قطعه گم‌شده احتمالاً هرگز دوباره دیده نخواهد شد حتی اگر هنوز داده‌هایی که آن را تولید کرده‌اند داشته باشید). .SH "گزینه‌ها (OPTIONS)" .sp برای گزینه‌های عمومی دستورات Borg به .I borg\-common(1) مراجعه کنید. .SS "آرگومان‌ها (arguments)" .INDENT 0.0 .TP .B REPOSITORY_OR_ARCHIVE مخزن یا بایگانی برای بازسازی .TP .B PATH مسیرها برای بازسازی؛ الگوها نیز پشتیبانی می‌شوند .UNINDENT .SS "گزینه‌ها (options)" .INDENT 0.0 .TP .B \-\-list خروجی فهرست پرجزئیات از موارد (فایل‌ها، پوشه‌ها، ...) .TP .BI \-\-filter \ STATUSCHARS فقط نمایش مواردی با نویسه‌های وضعیت داده‌شده (فهرست‌شده در borg create \-\-help) .TP .B \-n\fP,\fB \-\-dry\-run هیچ تغییری اعمال نشود .TP .B \-s\fP,\fB \-\-stats چاپ آمار در پایان .UNINDENT .SS "گزینه‌های گنجاندن/مستثنی‌کردن (Include/Exclude options)" .INDENT 0.0 .TP .BI \-e \ PATTERN\fR,\fB \ \-\-exclude \ PATTERN مستثنی کردن مسیرهای منطبق بر PATTERN .TP .BI \-\-exclude\-from \ EXCLUDEFILE خواندن الگوهای استثنا از EXCLUDEFILE، در هر خط یک الگو .TP .BI \-\-pattern \ PATTERN گنجاندن/مستثنی کردن مسیرهای منطبق بر PATTERN .TP .BI \-\-patterns\-from \ PATTERNFILE خواندن الگوهای گنجاندن/استثنا از PATTERNFILE، در هر خط یک الگو .TP .B \-\-exclude\-caches مستثنی کردن پوشه‌هایی که شامل یک فایل CACHEDIR.TAG هستند (\%) .TP .BI \-\-exclude\-if\-present \ NAME مستثنی کردن پوشه‌هایی که با داشتن یک شیء سیستم‌فایل با NAME داده‌شده علامت‌گذاری شده‌اند .TP .B \-\-keep\-exclude\-tags اگر اشیاء برچسب با \fB\-\-exclude\-if\-present\fP مشخص شده‌اند، خود اشیاء برچسب از بایگانی پشتیبان حذف نشوند .UNINDENT .SS "گزینه‌های آرشیو (Archive options)" .INDENT 0.0 .TP .BI \-\-target \ TARGET ایجاد یک بایگانی جدید با نام ARCHIVE، عدم جایگزینی بایگانی موجود (فقط برای یک بایگانی منفرد اعمال می‌شود) .TP .BI \-c \ SECONDS\fR,\fB \ \-\-checkpoint\-interval \ SECONDS نوشتن نقطه بازرسی (checkpoint) در هر SECONDS ثانیه (پیش‌فرض: 1800) .TP .BI \-\-comment \ COMMENT افزودن یک متن نظر/توضیح به بایگانی .TP .BI \-\-timestamp \ TIMESTAMP مشخص کردن دستی تاریخ/زمان ایجاد بایگانی (فرمت UTC، yyyy\-mm\-ddThh:mm:ss). یا به عنوان جایگزین، مشخص کردن یک فایل/پوشه مرجع. .TP .BI \-C \ COMPRESSION\fR,\fB \ \-\-compression \ COMPRESSION انتخاب الگوریتم فشرده‌سازی، برای جزئیات خروجی دستور \(dqborg help compression\(dq را ببینید. .TP .BI \-\-recompress \ MODE فشرده‌سازی مجدد قطعات داده طبق \fIMODE\fP و \fB\-\-compression\fP\&. حالت‌های ممکن عبارتند از: \fIif\-different\fP: فشرده‌سازی مجدد در صورتی که فشرده‌سازی فعلی با یک الگوریتم فشرده‌سازی متفاوت باشد (سطح فشرده‌سازی در نظر گرفته نمی‌شود)؛ \fIalways\fP: فشرده‌سازی مجدد حتی اگر فشرده‌سازی فعلی با همان الگوریتم باشد (از این برای تغییر سطح فشرده‌سازی استفاده کنید)؛ و \fInever\fP: فشرده‌سازی مجدد انجام نشود (از این گزینه برای جلوگیری صریح از فشرده‌سازی مجدد استفاده کنید). اگر هیچ MODE مشخص نشود، از \fIif\-different\fP استفاده خواهد شد. ارسال نکردن \-\-recompress معادل \(dq\-\-recompress never\(dq است. .TP .BI \-\-chunker\-params \ PARAMS قطعه‌بندی مجدد با استفاده از پارامترهای قطعه‌بند داده‌شده (ALGO, CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE) یا \fIdefault\fP برای استفاده از مقادیر پیش‌فرض قطعه‌بند. پیش‌فرض: قطعه‌بندی مجدد انجام نشود .UNINDENT .SH "مثال‌ها (EXAMPLES)" .INDENT 0.0 .INDENT 3.5 .sp .EX # یکسان‌سازی تکثیرزدایی بایگانی‌های قدیمی (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 \(dqThis is a comment\(dq /mnt/backup::archivename ~ $ borg info /mnt/backup::archivename Name: archivename Fingerprint: ... Comment: This is a comment \&... $ borg recreate \-\-comment \(dqThis is a better comment\(dq /mnt/backup::archivename $ borg info /mnt/backup::archivename Name: archivename Fingerprint: ... Comment: This is a better comment \&... .EE .UNINDENT .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp \fIborg\-common(1)\fP, \fIborg\-patterns(1)\fP, \fIborg\-placeholders(1)\fP, \fIborg\-compression(1)\fP .SH "نویسندگان (AUTHORS)" The Borg Collective .\" End of generated man page.