نام (NAME)

bup-gc - حذف داده‌های بدون ارجاع و غیرضروری

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

bup gc [-#|--verbose] <شاخه|ذخیره...>

توضیحات (DESCRIPTION)

دستور bup gc داده‌های غیرقابل‌دسترس، موسوم به زباله (garbage) را از مخزن حذف (به‌طور دائمی پاک) می‌کند؛ این‌ها داده‌هایی هستند که نه به‌طور مستقیم و نه غیرمستقیم توسط مجموعه فعلی شاخه‌ها (مجموعه‌های پشتیبان) و برچسب‌ها مورد ارجاع قرار نگرفته‌اند. اما به یاد داشته باشید که با توجه به حذف داده‌های تکراری (deduplication)، حذف یک ذخیره و اجرای زباله‌روب ممکن است در عمل چیزی را حذف کند یا نکند (یا فضایی را آزاد کند یا نکند).

با پیاده‌سازی احتمالی فعلی، ممکن است بخشی از داده‌های غیرقابل دسترس حفظ شوند. در ازای آن، فرآیند جمع‌آوری زباله نسبت به روش‌های دقیق‌تر، نیازمند حافظه موقت (RAM) کمتری خواهد بود.

به‌طور معمول، زباله‌روب پس از چند بار اجرای دستور bup rm فراخوانی می‌شود.

هشدار: این یکی از معدود دستورات bup است که آرشیو شما را به شیوه‌ای تخریبی و هدفمند دستخوش تغییر می‌کند. هرچند اگر تلاش برای الحاق (join) یا بازگردانی (restore) داده‌هایی که هنوز به آن‌ها نیاز دارید پس از اجرای gc با موفقیت انجام شود، نشانه‌ای امیدوارکننده از کارکرد صحیح دستورات است. (دستور dev/compare-trees در درخت مبدا می‌تواند جهت سنجش نتایج پیش و پس از عملیات به کار رود.)

فرایند پاکسازی با بازنویسی فایل‌های بسته‌ای (packfiles) جهت حذف اشیاء غیرقابل دسترس پیش می‌رود، و بسته‌های جدید محدودیت pack.packSizeLimit (bup-config(5)) را رعایت خواهند کرد. هر بسته محتوایی از هر تعداد بسته موجود را ترکیب می‌کند.

هنگامی که یک فایل بسته موجود حذف می‌شود، کلیه فایل‌های وابسته (مانند .idx، .par2 و غیره) نیز باید حذف شوند؛ فایل‌های .par2 را می‌توان توسط bup-fsck(1) مجدداً ایجاد کرد.

گزینه‌ها (OPTIONS)

--threshold=N: تنها در صورتی فایل بسته‌ای بازنویسی می‌شود که بیش از N درصد زباله داشته باشد و فاقد هرگونه درخت یا کامیت غیرقابل دسترس باشد. اگر فایل بسته شامل درخت‌ها یا کامیت‌های غیرقابل دسترس باشد، بدون در نظر گرفتن شرط فوق بازنویسی خواهد شد. حد آستانه پیش‌فرض ۱۰٪ است.
-v, --verbose: افزایش سطح جزئیات خروجی (می‌توان بیش از یک بار مشخص کرد).
-#, --compress=#: تنظیم سطح فشرده‌سازی بر روی # (مقداری از ۰ تا ۹، که در آن ۹ بالاترین مقدار و ۰ بدون فشرده‌سازی است). پیش‌فرض آن pack.compression یا core.compression پیکربندی‌شده، یا ۱ (فشرده‌سازی سریع و سبک) است. این گزینه روی تمام فایل‌های بسته‌ای بازنویسی‌شده اعمال می‌شود.
--ignore-missing: گزارش اشیاء گم‌شده، بدون متوقف کردن فرایند جمع‌آوری زباله.

وضعیت خروج (EXIT STATUS)

در صورت بروز هرگونه خطا، وضعیت خروج غیرصفر خواهد بود. مواجهه با هر شیء گم‌شده به عنوان خطا تلقی می‌شود.

مثال‌ها (EXAMPLES)

# حذف تمام ذخیره‌های "home" (حذف شاخه).
$ bup rm home
# حذف دو ذخیره از شاخه archives.
$ bup rm archives/2025-01-01-030405 archives/2025-10-04-134117
# حذف بیشتر داده‌های بدون ارجاع.
$ bup gc

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

bup-rm(1) و bup-fsck(1)

BUP

بخشی از مجموعه‌ابزار bup(1).

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

Rob Browning rlb@defaultvalue.org.