.\" 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-prune" "1" "2026-07-18" "" "ابزار پشتیبان‌گیری borg" .SH "نام (NAME)" borg-prune \- هرس و پاکسازی بایگانی‌های قدیمی طبق سیاست‌های نگهداری در Borg .SH "خلاصه دستور (SYNOPSIS)" .sp borg [گزینه‌های عمومی] prune [گزینه‌ها] [REPOSITORY] .SH "توضیحات (DESCRIPTION)" .sp دستور prune با حذف تمام بایگانی‌هایی که با هیچ‌یک از گزینه‌های نگهداری مشخص‌شده مطابقت ندارند، یک مخزن را هرس و پاکسازی می‌کند. .sp نکته مهم: فضای دیسک مخزن تا زمانی که .B borg compact را اجرا نکنید آزاد \fBنمی‌شود\fP\&. .sp این دستور معمولاً توسط اسکریپت‌های پشتیبان‌گیری خودکار استفاده می‌شود که قصد دارند تعداد مشخصی از پشتیبان‌های گذشته را نگه دارند. این سیاست نگهداری معمولاً به عنوان طرح چرخش پشتیبان GFS (Grandfather\-father\-son) \% شناخته می‌شود. .sp همچنین، دستور prune بایگانی‌های چک‌پوینت (بایگانی‌های ناقص که بر اثر قطع شدن فرآیند پشتیبان‌گیری به جا مانده‌اند) را به‌طور خودکار حذف می‌کند، مگر اینکه چک‌پوینت آخرین بایگانی باشد (و در نتیجه همچنان مورد نیاز باشد). بایگانی‌های چک‌پوینت هنگام مقایسه تعداد بایگانی‌ها با محدودیت‌های نگهداری (\fB\-\-keep\-X\fP) لحاظ نمی‌شوند. .sp اگر یک پیشوند با .B \-P تنظیم شده باشد، فقط بایگانی‌هایی که با آن پیشوند شروع می‌شوند برای حذف در نظر گرفته می‌شوند و تنها همان بایگانی‌ها در مجموع‌های تعیین‌شده توسط قوانین محاسبه می‌گردند. در غیر این صورت، \fIهمه\fP بایگانی‌های موجود در مخزن نامزد حذف خواهند بود! هیچ تمایز خودکاری بین بایگانی‌هایی با محتویات متفاوت وجود ندارد. این موارد باید با مشخص کردن پیشوندهای منطبق متمایز شوند. .sp اگر چندین توالی از بایگانی‌ها با مجموعه‌داده‌های مختلف (برای مثال از ماشین‌های مختلف) در یک مخزن مشترک دارید، برای هر مجموعه‌داده یک بار دستور prune را با استفاده از گزینه .B \-P طوری اجرا کنید که فقط بایگانی‌های مربوطه را مطابقت دهد. .sp گزینه \fB\-\-keep\-within\fP آرگومانی به شکل \(dq\(dq دریافت می‌کند که در آن char یکی از مقادیر \(dqH\(dq، \(dqd\(dq، \(dqw\(dq، \(dqm\(dq یا \(dqy\(dq است. برای مثال، \fB\-\-keep\-within 2d\fP به معنای نگهداری تمام بایگانی‌هایی است که در ۴۸ ساعت گذشته ایجاد شده‌اند. مقدار \(dq1m\(dq به معنای \(dq31d\(dq در نظر گرفته می‌شود. بایگانی‌های نگهداری‌شده با این گزینه در مجموع‌های مشخص‌شده توسط گزینه‌های دیگر شمرده نمی‌شوند. .sp یک روش مناسب این است که هر چه پشتیبان‌های شما قدیمی‌تر می‌شوند، آن‌ها را بیشتر و بیشتر کم‌پشت و تنک کنید. به عنوان مثال، \fB\-\-keep\-daily 7\fP به معنای نگهداری آخرین پشتیبان در هر روز، تا ۷ روز اخیرِ دارای پشتیبان است (روزهای بدون پشتیبان شمرده نمی‌شوند). قوانین از ثانیه‌ای تا سالانه اعمال می‌شوند و پشتیبان‌های انتخاب‌شده توسط قوانین قبلی، در قوانین بعدی شمرده نمی‌شوند. زمان شروع هر پشتیبان برای اهداف هرس استفاده می‌شود. تاریخ‌ها و زمان‌ها در منطقه زمانی محلی تفسیر می‌شوند و هفته‌ها از دوشنبه تا یکشنبه در نظر گرفته می‌شوند. مشخص کردن یک عدد منفی برای تعداد بایگانی‌های قابل نگهداری به معنای نامحدود بودن آن است. از نسخه 1.2.0 به بعد، اگر هر یک از قوانین ثانیه‌ای، دقیقه‌ای، ساعتی، روزانه، هفتگی، ماهانه، فصلی یا سالانه نتواند به هدف نگهداری خود برسد، Borg قدیمی‌ترین بایگانی را نگه می‌دارد. این امر به اولین بایگانی از نظر زمانی اجازه می‌دهد تا زمان جایگزین شدن با بایگانی جدیدتری که شرایط نگهداری را برآورده می‌کند، به حفظ خود ادامه دهد. .sp قوانین \fB\-\-keep\-13weekly\fP و \fB\-\-keep\-3monthly\fP دو راهبرد متفاوت برای نگهداری بایگانی‌ها در هر فصل (سه ماه) هستند. .sp گزینه \fB\-\-keep\-last N\fP همان کار \fB\-\-keep\-secondly N\fP را انجام می‌دهد (و N بایگانی آخر را با این فرض نگه می‌دارد که بیش از یک بایگانی پشتیبان در یک ثانیه ایجاد نمی‌کنید). .sp هنگام استفاده از \fB\-\-stats\fP\c ، آمارهایی درباره میزان داده‌های حذف‌شده دریافت خواهید کرد \- اندازه یکتاشده (deduplicated) در بخش \(dqDeleted data\(dq از همه جالب‌تر است، زیرا نشان می‌دهد مخزن شما چقدر کوچک خواهد شد. لطفاً توجه داشته باشید که آمار \(dqAll archives\(dq به وضعیت پس از هرس اشاره دارد. گزینه \fB\-\-stats\fP می‌تواند کُند باشد \- اگر گزینه‌ای سریع‌تر می‌خواهید، از \fB\-\-quick\-stats\fP استفاده کنید (این گزینه از آمار سراسری \(dqAll archives\(dq در مخزن صرف‌نظر می‌کند). گزینه‌های \fB\-\-stats\fP / \fB\-\-quick\-stats\fP و \fB\-\-dry\-run\fP مانعة‌الجمع هستند. .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 \-\-force اجبار به هرس بایگانی‌های آسیب‌دیده؛ در صورتی که \fB\-\-force\fP کارساز نبود، از \fB\-\-force \-\-force\fP استفاده کنید. .TP .B \-s\fP,\fB \-\-stats چاپ آمار برای بایگانی حذف‌شده .TP .B \-\-quick\-stats فقط چاپ آمار حذف، با صرف‌نظر کردن از آمار سراسری مخزن .TP .B \-\-list خروجی فهرست باجزئیات از بایگانی‌هایی که نگهداری/هرس می‌شوند .TP .BI \-\-keep\-within \ INTERVAL نگهداری تمام بایگانی‌ها در این بازه زمانی .TP .B \-\-keep\-last\fP,\fB \-\-keep\-secondly تعداد بایگانی‌های ثانیه‌ای برای نگهداری .TP .B \-\-keep\-minutely تعداد بایگانی‌های دقیقه‌ای برای نگهداری .TP .B \-H\fP,\fB \-\-keep\-hourly تعداد بایگانی‌های ساعتی برای نگهداری .TP .B \-d\fP,\fB \-\-keep\-daily تعداد بایگانی‌های روزانه برای نگهداری .TP .B \-w\fP,\fB \-\-keep\-weekly تعداد بایگانی‌های هفتگی برای نگهداری .TP .B \-m\fP,\fB \-\-keep\-monthly تعداد بایگانی‌های ماهانه برای نگهداری .TP .B \-\-keep\-13weekly تعداد بایگانی‌های فصلی برای نگهداری (راهبرد ۱۳ هفته) .TP .B \-\-keep\-3monthly تعداد بایگانی‌های فصلی برای نگهداری (راهبرد ۳ ماه) .TP .B \-y\fP,\fB \-\-keep\-yearly تعداد بایگانی‌های سالانه برای نگهداری .TP .B \-\-save\-space کار با سرعت کمتر، اما با استفاده از فضای کمتر .TP .BI \-c \ SECONDS\fR,\fB \ \-\-checkpoint\-interval \ SECONDS نوشتن چک‌پوینت در هر SECONDS ثانیه (پیش‌فرض: 1800) .UNINDENT .SS "پالایه‌های بایگانی (Archive filters)" .INDENT 0.0 .TP .BI \-P \ PREFIX\fR,\fB \ \-\-prefix \ PREFIX فقط بایگانی‌هایی که نامشان با این پیشوند شروع می‌شود در نظر گرفته شوند. (منسوخ‌شده) .TP .BI \-a \ GLOB\fR,\fB \ \-\-glob\-archives \ GLOB فقط بایگانی‌هایی که نامشان با الگوی glob مطابقت دارد در نظر گرفته شوند. قوانین :sh اعمال می‌شوند (بدون استفاده واقعی از پیشوند :sh)، به \(dqborg help patterns\(dq مراجعه کنید. .UNINDENT .SH "مثال‌ها (EXAMPLES)" .sp مراقب باشید: prune دستوری بالقوه خطرناک است؛ زیرا بایگانی‌های پشتیبان را حذف می‌کند. .sp به‌طور پیش‌فرض، prune روی \fBتمام بایگانی‌های موجود در مخزن\fP اعمال می‌شود، مگر اینکه با استفاده از \fB\-\-glob\-archives\fP عملیات آن را به زیرمجموعه‌ای از بایگانی‌ها محدود کنید. هنگام استفاده از \fB\-\-glob\-archives\fP، در انتخاب یک الگوی تطبیق مناسب دقت کنید — برای مثال، اگر نمی‌خواهید با \(dqfoobar\(dq نیز مطابقت داده شود، از \(dqfoo*\(dq استفاده نکنید. .sp اکیداً توصیه می‌شود که همیشه ابتدا \fBprune \-v \-\-list \-\-dry\-run ...\fP را اجرا کنید تا بتوانید ببینید بدون اینکه واقعاً تغییری ایجاد شود، چه اقداماتی انجام خواهد شد. .INDENT 0.0 .INDENT 3.5 .sp .EX # نگهداری ۷ بایگانی پایان روز و ۴ بایگانی اضافی پایان هفته. # اجرای آزمایشی (dry-run) بدون حذف واقعی هیچ موردی. $ borg prune \-v \-\-list \-\-dry\-run \-\-keep\-daily=7 \-\-keep\-weekly=4 /path/to/repo # مشابه دستور بالا اما فقط اعمال روی نام‌های بایگانی که با نام میزبان (hostname) # دستگاه شروع شده و به دنبال آن یک نویسه \(dq\-\(dq می‌آید: $ borg prune \-v \-\-list \-\-keep\-daily=7 \-\-keep\-weekly=4 \-\-glob\-archives=\(aq{hostname}\-*\(aq /path/to/repo # آزادسازی واقعی فضای دیسک: $ borg compact /path/to/repo # نگهداری ۷ بایگانی پایان روز، ۴ بایگانی اضافی پایان هفته، # و یک بایگانی پایان ماه برای هر ماه: $ borg prune \-v \-\-list \-\-keep\-daily=7 \-\-keep\-weekly=4 \-\-keep\-monthly=\-1 /path/to/repo # نگهداری تمام پشتیبان‌ها در ۱۰ روز گذشته، ۴ بایگانی اضافی پایان هفته، # و یک بایگانی پایان ماه برای هر ماه: $ borg prune \-v \-\-list \-\-keep\-within=10d \-\-keep\-weekly=4 \-\-keep\-monthly=\-1 /path/to/repo .EE .UNINDENT .UNINDENT .sp همچنین یک مثال تصویری از هرس کردن در \fBdocs/misc/prune\-example.txt\fP وجود دارد. .SH "همچنین ببینید (SEE ALSO)" .sp \fIborg\-common(1)\fP, \fIborg\-compact(1)\fP .SH "نویسندگان (AUTHORS)" The Borg Collective .\" End of generated man page.