نام (NAME)

borg-compact - فشردهسازی و پاکسازی قطعات حذفشده در مخزن borg

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

borg [گزینه‌های عمومی] compact [گزینه‌ها] [REPOSITORY]

توضیحات (DESCRIPTION)

این دستور با فشرده‌سازی قطعات (segments)، فضای مخزن را آزاد می‌کند.

از این دستور به‌طور منظم برای جلوگیری از اتمام فضا استفاده کنید - البته نیازی نیست پس از هر دستور borg آن را اجرا نمایید. این کار به‌ویژه پس از حذف بایگانی‌ها بسیار مفید است، زیرا تنها فشرده‌سازی است که واقعاً فضای مخزن را آزاد می‌کند.

دستور borg compact نیازی به کلید ندارد، بنابراین اجرای آن هم از سمت کلاینت و هم از سمت سرور امکان‌پذیر است.

بسته به تعداد قطعاتی که نیاز به فشرده‌سازی دارند، ممکن است این فرآیند مدتی طول بکشد، بنابراین استفاده از گزینه --progress را در نظر داشته باشید.

یک قطعه تنها در صورتی فشرده می‌شود که میزان فضای صرفه‌جویی‌شده بالاتر از درصد مشخص‌شده توسط گزینه --threshold باشد. در صورت عدم تعیین، آستانه پیش‌فرض ۱۰٪ استفاده می‌شود. هنگام استفاده از --verbose، برنامه borg تخمینی از فضای آزادشده را گزارش می‌دهد.

برای حداکثر فشرده‌سازی، از --threshold 0 استفاده کنید. این کار هر زمان که فضایی قابل آزادسازی باشد قطعات را فشرده می‌کند و در نتیجه بیشترین داده را بازنویسی می‌نماید؛ این عمل ممکن است در مخازن بزرگ بسیار کندتر باشد. استفاده از --threshold 1 معمولاً تقریباً همان نتیجه را با سرعتی به‌مراتب بالاتر حاصل می‌کند. آستانه‌های بالاتر (مانند مقدار پیش‌فرض ۱۰) دقت فشرده‌سازی را با سرعت مبادله می‌کنند. توجه: --threshold 100 در عمل هیچ چیزی را فشرده نخواهد کرد.

پس از ارتقای borg (سمت سرور) به نسخه 1.2 یا بالاتر، می‌توانید از borg compact --cleanup-commits برای پاکسازی قطعات متعدد ۱۷ بایتی که صرفاً شامل کامیت بوده و borg 1.1 به دلیل یک نقص نرم‌افزاری آن‌ها را پاک نکرده بود، استفاده کنید. انجام یک‌بار این کار برای هر مخزن کافی است. پس از پاکسازی کامیت‌ها، borg یک فشرده‌سازی عادی را نیز انجام می‌دهد.

برای جزئیات بیشتر، به بخش separate_compaction در یادداشت‌های اضافی (Additional Notes) مراجعه کنید.

گزینه‌ها (OPTIONS)

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

مثال‌ها (EXAMPLES)

# فشرده‌سازی قطعات و آزادسازی فضای دیسک مخزن
$ borg compact /path/to/repo
# همانند دستور بالا به‌همراه پاکسازی قطعات ۱۷ بایتی فقط‌کامیت
$ borg compact --cleanup-commits /path/to/repo

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

borg-common(1)

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

The Borg Collective