.TH BUPSTASH-RM 1 "2026-09-01" "bupstash" "User Commands"
.SH "نام (NAME)"
bupstash-rm \- حذف اسنپشاتها از مخزن bupstash
.SH "خلاصه دستور (SYNOPSIS)"
حذف آیتم‌ها از یک مخزن bupstash\.
.P
\fBbupstash rm\fR [\fIگزینه‌ها\fR] \fIپرس‌وجو\fR\|\.\|\.\|\.
.SH "توضیحات (DESCRIPTION)"
دستور
\fBbupstash rm\fR
آیتم‌ها را از یک مخزن bupstash حذف می‌کند\.
.P
آیتم‌هایی که حذف می‌شوند بلافاصله پاک نمی‌گردند، بلکه فرآیند پاک‌سازی و بازپس‌گیری فضای دیسک برای اجرای بعدی زباله‌روب
.BR bupstash\-gc (1)
زمان‌بندی می‌شود\.
.P
برای حذف آیتم‌ها، تنها رمزگشایی متاداده‌ها لازم است؛ بنابراین یک کلید متاداده حتی بدون دسترسی به کلید رمزگشایی داده‌ها برای حذف آیتم کافی خواهد بود\.
.SH "زبان پرس‌وجو (QUERY LANGUAGE)"
برای مستندات کامل درباره زبان پرس‌وجو، به
.BR bupstash\-query\-language (7)
مراجعه کنید\.
.SS "مثال‌های پرس‌وجوی حذف"
.nf
$ id=$(bupstash put \./some\-data)

$ bupstash rm id=$id

$ bupstash rm name=backups\.tar

$ bupstash rm \-\-allow\-many name='*\.tar' and older\-than 30d

$ bupstash rm \-\-allow\-many id="*"
.fi
.SH "حافظه موقت پرس‌وجو (QUERY CACHING)"
دستور rm از همان سازوکارهای حافظه موقت پرس‌وجوی
.BR bupstash\-list (1)
استفاده می‌کند؛ برای اطلاعات بیشتر درباره حافظه موقت پرس‌وجو (query cache) به صفحه آن مراجعه کنید\.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-r ", " \-\-repository " \fIREPO\fR"
مخزنی که باید به آن متصل شد\. در صورت پیکربندی دسترسی ssh می‌تواند برای مخازن دوردست به شکل
\fBssh://$SERVER/$PATH\fR
باشد\. در صورت عدم تعیین، روی
\fBBUPSTASH_REPOSITORY\fR
تنظیم می‌شود\.
.TP
.BR \-k ", " \-\-key " \fIKEY\fR"
کلید مورد استفاده برای رمزگشایی متاداده‌ها هنگام اجرای پرس‌وجو\. در صورت عدم تنظیم، به صورت پیش‌فرض
\fBBUPSTASH_KEY\fR
خواهد بود\.
.TP
.BI \-\-query\-cache " PATH"
مسیر فایل حافظه موقت پرس‌وجو (query-cache)؛ در صورت تنظیم بودن متغیرهای محیطی مربوطه، به ترتیب اولویت پیش‌فرض یکی از مقادیر زیر است:
\fB$BUPSTASH_QUERY_CACHE\fR
یا
\fB$XDG_CACHE_HOME/\.cache/bupstash/bupstash\.qcache\fR
یا
\fB$HOME/\.cache/bupstash/bupstash\.qcache\fR\.
.TP
.B \-\-query\-encrypted
پرس‌وجو هیچ متاداده‌ای را رمزگشایی نمی‌کند و به شما امکان می‌دهد آیتم‌هایی را فهرست کنید که کلید رمزگشایی آن‌ها را در اختیار ندارید\. این گزینه برچسب پرس‌وجوی ساختگی 'decryption\-key\-id' را درج می‌کند\.
.TP
.B \-\-ids\-from\-stdin
حذف آیتم‌ها با شناسه‌های خوانده‌شده از ورودی استاندارد (stdin)، هر شناسه در یک سطر، به جای اجرای پرس‌وجو\.
.TP
.B \-\-allow\-many
به طور پیش‌فرض bupstash از حذف چندین آیتم توسط یک پرس‌وجوی واحد خودداری می‌کند؛ این پرچم این قابلیت امنیتی را غیرفعال می‌سازد\.
.TP
.B \-\-utc\-timestamps
نمایش و جستجو بر اساس برچسب‌های زمانی به وقت جهانی (UTC) به جای زمان محلی\.
.TP
.B \-\-no\-progress
غیرفعال‌سازی نشانگرهای پیشرفت (اگر stderr یک ترمینال تعاملی نباشد نیز نشانگرهای پیشرفت غیرفعال می‌شوند)\.
.TP
.BR \-q ", " \-\-quiet
اجرای بی‌صدا؛ متضمن
.B \-\-no\-progress
است\.
.SH "محیط (ENVIRONMENT)"
.TP
.B BUPSTASH_REPOSITORY
مخزنی که باید به آن متصل شد\. در صورت پیکربندی دسترسی ssh می‌تواند برای مخازن دوردست به شکل
\fBssh://$SERVER/$PATH\fR
باشد\.
.TP
.B BUPSTASH_REPOSITORY_COMMAND
دستوری برای اجرا جهت اتصال به یک نمونه از
.BR bupstash\-serve (1)\.
این متغیر امکان برقراری اتصالات پیچیده‌تر به مخزن را برای کاربردهای کمتر رایج فراهم می‌سازد\.
.TP
.B BUPSTASH_KEY
مسیر کلید اصلی که برای رمزگشایی داده‌ها و متاداده‌ها استفاده خواهد شد\.
.TP
.B BUPSTASH_KEY_COMMAND
دستوری برای اجرا که باید داده‌های کلید را چاپ کند؛ می‌تواند به جای
.B BUPSTASH_KEY
برای واکشی کلید از مکان‌های دلخواه مانند شبکه یا سایر فضاهای ذخیره‌سازی محرمانه به کار رود\.
.TP
.B BUPSTASH_QUERY_CACHE
مسیر فایل حافظه موقت پرس‌وجو (query cache) جهت استفاده\.
.SH "مثال‌ها (EXAMPLES)"
.SS "حذف یک آیتم با شناسه‌ای مشخص از مخزن"
.nf
$ bupstash rm id=14ebd2073b258b1f55c5bbc889c49db4
.fi
.SS "حذف تمام آیتم‌ها از مخزن"
.nf
$ bupstash rm id="*"
.fi
.SS "حذف آیتم‌های با نام backup.tar که قدیمی‌تر از ۳۰ روز هستند"
.nf
$ bupstash rm name=backup\.tar and older\-than 30d
.fi
.SS "حذف آیتم‌ها با یک اسکریپت سفارشی"
.nf
 $ bupstash list \-\-format=jsonl1 \e
    | custom\-json\-filter \e
    | bupstash rm \-\-ids\-from\-stdin
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR bupstash (1),
.BR bupstash\-list (1),
.BR bupstash\-gc (1),
.BR bupstash\-query\-language (7)