.TH BUPSTASH-GC 1 "2026-09-01" "bupstash" "User Commands"
.SH "نام (NAME)"
bupstash-gc \- پاکسازی و حذف دادههای بدون ارجاع از مخزن
.SH "خلاصه دستور (SYNOPSIS)"
اجرای فرآیند زباله‌روب (garbage collector) روی یک مخزن، حذف داده‌های بدون ارجاع و آزادسازی فضای دیسک.
.P
\fBbupstash gc\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
دستور
.B bupstash gc
محتویات مخزن را پیمایش می‌کند تا تکه‌داده‌های (chunks) غیرقابل‌دسترس را یافته و حذف کند، و از این طریق فضای دیسک را بازپس گیرد.
.P
اجرای
.B bupstash gc
در هر زمانی ایمن است، اما ممکن است برخی عملیات (مانند
.BR bupstash\-put (1))
را به‌طور موقت به تعویق بیندازد.
.P
فرآیند زباله‌روب تنها به متادیتای رمزگذاری‌نشده متکی است، بنابراین برای کارکرد خود نیازی به دسترسی به کلیدهای رمزگشایی ندارد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-r\fR, \fB\-\-repository\fR \fIREPO\fR
مخزنی که باید به آن متصل شده و عملیات روی آن انجام گیرد. اگر دسترسی ssh پیکربندی شده باشد، می‌تواند به صورت
\fBssh://$SERVER/$PATH\fR
برای مخازن راه‌دور باشد. در صورت مشخص نشدن، بر روی مقدار
\fBBUPSTASH_REPOSITORY\fR
تنظیم می‌شود.
.TP
\fB\-\-no\-progress\fR
عدم نمایش نشانگرهای پیشرفت (نشانگرهای پیشرفت همچنین در صورتی که stderr یک ترمینال تعاملی نباشد، غیرفعال می‌شوند).
.TP
\fB\-q\fR, \fB\-\-quiet\fR
اجرای بی‌صدا؛ متضمن
\fB\-\-no\-progress\fR
است.
.SH "متغیرهای محیطی (ENVIRONMENT)"
.TP
.B BUPSTASH_REPOSITORY
مخزنی که باید به آن متصل شد. در صورت پیکربندی دسترسی ssh، می‌تواند به صورت
\fBssh://$SERVER/$PATH\fR
برای مخازن راه‌دور باشد.
.TP
.B BUPSTASH_REPOSITORY_COMMAND
دستوری که برای اتصال به یک نمونه از
.BR bupstash\-serve (1)
اجرا می‌شود. این امکان، برقراری اتصالات پیچیده‌تر به مخزن را برای موارد کاربرد خاص فراهم می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR bupstash (1),
.BR bupstash\-repository (7)