.\" 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-compact" "1" "2026-07-18" "" "ابزار پشتیبان‌گیری borg"
.SH "نام (NAME)"
borg-compact \- فشردهسازی و پاکسازی قطعات حذفشده در مخزن borg
.SH "خلاصه دستور (SYNOPSIS)"
.sp
borg [گزینه‌های عمومی] compact [گزینه‌ها] [REPOSITORY]
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور با فشرده‌سازی قطعات (segments)، فضای مخزن را آزاد می‌کند.
.sp
از این دستور به‌طور منظم برای جلوگیری از اتمام فضا استفاده کنید \- البته نیازی نیست
پس از هر دستور borg آن را اجرا نمایید. این کار به‌ویژه پس از حذف بایگانی‌ها بسیار مفید است،
زیرا تنها فشرده‌سازی است که واقعاً فضای مخزن را آزاد می‌کند.
.sp
دستور borg compact نیازی به کلید ندارد، بنابراین اجرای آن هم از سمت
کلاینت و هم از سمت سرور امکان‌پذیر است.
.sp
بسته به تعداد قطعاتی که نیاز به فشرده‌سازی دارند، ممکن است این فرآیند مدتی طول بکشد،
بنابراین استفاده از گزینه
\fB\-\-progress\fP
را در نظر داشته باشید.
.sp
یک قطعه تنها در صورتی فشرده می‌شود که میزان فضای صرفه‌جویی‌شده بالاتر از درصد مشخص‌شده
توسط گزینه
\fB\-\-threshold\fP
باشد. در صورت عدم تعیین، آستانه پیش‌فرض ۱۰٪ استفاده می‌شود.
هنگام استفاده از
\fB\-\-verbose\fP\c
، برنامه borg تخمینی از فضای آزادشده را گزارش می‌دهد.
.sp
برای حداکثر فشرده‌سازی، از
\fB\-\-threshold 0\fP\&
استفاده کنید. این کار هر زمان که فضایی قابل آزادسازی باشد قطعات را فشرده می‌کند و در نتیجه بیشترین داده را بازنویسی می‌نماید؛ این عمل ممکن است در مخازن بزرگ بسیار کندتر باشد. استفاده از
\fB\-\-threshold 1\fP
معمولاً تقریباً همان نتیجه را با سرعتی به‌مراتب بالاتر حاصل می‌کند. آستانه‌های بالاتر (مانند مقدار پیش‌فرض ۱۰) دقت فشرده‌سازی را با سرعت مبادله می‌کنند. توجه:
\fB\-\-threshold 100\fP
در عمل هیچ چیزی را فشرده نخواهد کرد.
.sp
پس از ارتقای borg (سمت سرور) به نسخه 1.2 یا بالاتر، می‌توانید از
\fBborg compact \-\-cleanup\-commits\fP
برای پاکسازی قطعات متعدد ۱۷ بایتی که صرفاً شامل کامیت بوده و borg 1.1 به دلیل یک نقص نرم‌افزاری آن‌ها را پاک نکرده بود، استفاده کنید. انجام یک‌بار این کار برای هر مخزن کافی است. پس از پاکسازی کامیت‌ها، borg یک فشرده‌سازی عادی را نیز انجام می‌دهد.
.sp
برای جزئیات بیشتر، به بخش
\fIseparate_compaction\fP
در یادداشت‌های اضافی (Additional Notes) مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
برای مشاهده گزینه‌های عمومی دستورات Borg، به
\fIborg\-common(1)\fP
مراجعه کنید.
.SS "آرگومان‌ها (arguments)"
.INDENT 0.0
.TP
.B REPOSITORY
مخزنی که باید فشرده‌سازی شود
.UNINDENT
.SS "گزینه‌ها (options)"
.INDENT 0.0
.TP
.B  \-n\fP,\fB  \-\-dry\-run
هیچ عملیاتی انجام نشود (اجرای آزمایشی)
.TP
.B  \-\-cleanup\-commits
پاکسازی فایل‌های قطعه ۱۷ بایتی که صرفاً شامل کامیت هستند
.TP
.BI \-\-threshold \ PERCENT
تنظیم حداقل آستانه برای فضای ذخیره‌شده بر حسب درصد (پیش‌فرض: ۱۰)
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# فشرده‌سازی قطعات و آزادسازی فضای دیسک مخزن
$ borg compact /path/to/repo

# همانند دستور بالا به‌همراه پاکسازی قطعات ۱۷ بایتی فقط‌کامیت
$ borg compact \-\-cleanup\-commits /path/to/repo
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fIborg\-common(1)\fP
.SH "نویسندگان (Author)"
The Borg Collective
.\" End of generated man page.