نام (NAME)

bup-prune-older - حذف ذخیره‌های قدیمی‌تر

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

bup prune-older [گزینه‌ها...] <شاخه...>

توضیحات (DESCRIPTION)

دستور bup prune-older تمام ذخیره‌ها (saves) را حذف دائمی می‌کند، به جز مواردی که با آرگومان‌های مختلف keep (که در ادامه به تفصیل آمده‌اند) نگهداری می‌شوند. حداقل باید یک آرگومان keep مشخص شود. این دستور معادل فراخوانی مناسب دستور bup rm و به دنبال آن bup gc است.

توجه داشته باشید که پیاده‌سازی فعلی انتظار یک شاخه معمولی را دارد که در آن تاریخ ذخیره جدید همیشه برابر یا جدیدتر از ذخیره قبلی باشد. هنگامی که چنین نباشد، تنها ذخیره‌های انتهای شاخه که دارای برچسب‌های زمانی غیر فزاینده هستند (از فرزند به والد) تحت تأثیر این دستور قرار می‌گیرند. احتمالاً نسخه‌های آینده این محدودیت را برطرف خواهند کرد.

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

دوره‌های نگهداری (KEEP PERIODS)

یک دوره PERIOD برای گزینه --keep (همان‌طور که در ادامه خواسته شده) باید یک عدد صحیح و به دنبال آن یک واحد مقیاس باشد، یا “forever”. برای مثال، 12y دوره دوازده‌ساله را مشخص می‌کند. واحدهای مقیاس معتبر در زیر آمده است:

s نشان‌دهنده ثانیه‌ها
min نشان‌دهنده دقیقه‌ها (60s)
h نشان‌دهنده ساعت‌ها (60m)
d نشان‌دهنده روزها (24h)
w نشان‌دهنده هفته‌ها (7d)
m نشان‌دهنده ماه‌ها (31d)
y نشان‌دهنده سال‌ها (366d)
forever نشان‌دهنده گذشته نامتناهی

همان‌طور که مشخص شده است، دوره‌ها با توجه به زمان فعلی یا مقدار --wrt (در صورت مشخص شدن) محاسبه می‌شوند و به هیچ تقویمی وابسته نیستند، بنابراین --keep-dailies-for 5d به معنی دوره‌ای است که دقیقاً از 5 * 24 * 60 * 60 ثانیه قبل از نقطه شروع آغاز می‌شود.

گزینه‌ها (OPTIONS)

--keep-all-for PERIOD: زمانی که هیچ گزینه --keep با مقیاس زمانی کوچک‌تر اعمال نشود، تمام ذخیره‌های درون دوره داده‌شده حفظ می‌شوند.
--keep-dailies-for PERIOD: زمانی که هیچ گزینه --keep با مقیاس زمانی کوچک‌تر اعمال نشود، جدیدترین ذخیره برای هر روز درون دوره داده‌شده حفظ می‌شود.
--keep-monthlies-for PERIOD: زمانی که هیچ گزینه --keep با مقیاس زمانی کوچک‌تر اعمال نشود، جدیدترین ذخیره برای هر ماه درون دوره داده‌شده حفظ می‌شود.
--keep-yearlies-for PERIOD: زمانی که هیچ گزینه --keep با مقیاس زمانی کوچک‌تر اعمال نشود، جدیدترین ذخیره برای هر سال درون دوره داده‌شده حفظ می‌شود.
--wrt UTC_SECONDS: هنگام محاسبه دوره نگهداری، جدیدترین انتهای بازه را روی UTC_SECONDS قرار می‌دهد و هر ذخیره جدیدتر از این مقدار حفظ خواهد شد.
--pretend: هیچ کاری انجام نده، فقط کارهایی را که قرار است انجام شود در خروجی استاندارد، هر کار در یک خط به این شکل فهرست کن:

- SAVE
+ SAVE
...

--gc: جمع‌آوری زباله (garbage collect) مخزن پس از حذف ذخیره‌های مربوطه. این رفتار پیش‌فرض است، اما می‌توان با --no-gc از آن اجتناب کرد.
--gc-threshold N: فقط در صورتی یک packfile را بازنویسی کن که بیش از N درصد آن زباله باشد؛ در غیر این صورت آن را دست‌نخورده باقی بگذار. آستانه پیش‌فرض 10% است.
-#, --compress #: تنظیم سطح فشرده‌سازی هنگام بازنویسی داده‌های بایگانی روی # (مقداری از 0 تا 9، که 9 بالاترین فشرده‌سازی و 0 بدون فشرده‌سازی است). مقدار پیش‌فرض 1 است (فشرده‌سازی سریع و سبک).
-v, --verbose: افزایش پرگویی گزارش‌ها (می‌توان بیش از یک بار مشخص کرد).

نکات (NOTES)

هنگامی که --verbose مشخص شود، دوره‌های ذخیره در خروجی خطای استاندارد با خطوطی مانند زیر خلاصه می‌شوند:

keeping monthlies since 1969-07-20-201800
keeping all yearlies
...

این احتمال وجود دارد که پیاده‌سازی فعلی در صورتی که تاریخ به اندازه کافی در گذشته باشد، قادر به قالب‌بندی آن نباشد. در این حالت، متنی مشابه زیر مشاهده خواهید کرد:

keeping yearlies since -30109891477 seconds before 1969-12-31-180000
...

مثال‌ها (EXAMPLES)

# نگهداری تمام ذخیره‌ها برای ماه گذشته، و هر نسخه ماهانه جدیدتر برای
# سال گذشته. حذف همه موارد دیگر.
$ bup prune-older --keep-all-for 1m --keep-monthlies-for 1y
# نگهداری تمام ذخیره‌ها برای ۶ ماه گذشته و حذف بقیه موارد،
# اما فقط روی شاخه semester.
$ bup prune-older --keep-all-for 6m semester

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

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

سامانه BUP (BUP)

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

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

Rob Browning rlb@defaultvalue.org.