نام (NAME)

bupstash-rm - حذف اسنپشاتها از مخزن bupstash

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

حذف آیتم‌ها از یک مخزن bupstash.

bupstash rm [گزینه‌ها] پرس‌وجو...

توضیحات (DESCRIPTION)

دستور bupstash rm آیتم‌ها را از یک مخزن bupstash حذف می‌کند.

آیتم‌هایی که حذف می‌شوند بلافاصله پاک نمی‌گردند، بلکه فرآیند پاک‌سازی و بازپس‌گیری فضای دیسک برای اجرای بعدی زباله‌روب bupstash-gc(1) زمان‌بندی می‌شود.

برای حذف آیتم‌ها، تنها رمزگشایی متاداده‌ها لازم است؛ بنابراین یک کلید متاداده حتی بدون دسترسی به کلید رمزگشایی داده‌ها برای حذف آیتم کافی خواهد بود.

زبان پرس‌وجو (QUERY LANGUAGE)

برای مستندات کامل درباره زبان پرس‌وجو، به bupstash-query-language(7) مراجعه کنید.

$ 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="*"

حافظه موقت پرس‌وجو (QUERY CACHING)

دستور rm از همان سازوکارهای حافظه موقت پرس‌وجوی bupstash-list(1) استفاده می‌کند؛ برای اطلاعات بیشتر درباره حافظه موقت پرس‌وجو (query cache) به صفحه آن مراجعه کنید.

گزینه‌ها (OPTIONS)

-r, --repository REPO

مخزنی که باید به آن متصل شد. در صورت پیکربندی دسترسی ssh می‌تواند برای مخازن دوردست به شکل ssh://$SERVER/$PATH باشد. در صورت عدم تعیین، روی BUPSTASH_REPOSITORY تنظیم می‌شود.

-k, --key KEY

کلید مورد استفاده برای رمزگشایی متاداده‌ها هنگام اجرای پرس‌وجو. در صورت عدم تنظیم، به صورت پیش‌فرض BUPSTASH_KEY خواهد بود.

--query-cache PATH

مسیر فایل حافظه موقت پرس‌وجو (query-cache)؛ در صورت تنظیم بودن متغیرهای محیطی مربوطه، به ترتیب اولویت پیش‌فرض یکی از مقادیر زیر است: $BUPSTASH_QUERY_CACHE یا $XDG_CACHE_HOME/.cache/bupstash/bupstash.qcache یا $HOME/.cache/bupstash/bupstash.qcache.

--query-encrypted

پرس‌وجو هیچ متاداده‌ای را رمزگشایی نمی‌کند و به شما امکان می‌دهد آیتم‌هایی را فهرست کنید که کلید رمزگشایی آن‌ها را در اختیار ندارید. این گزینه برچسب پرس‌وجوی ساختگی 'decryption-key-id' را درج می‌کند.

--ids-from-stdin

حذف آیتم‌ها با شناسه‌های خوانده‌شده از ورودی استاندارد (stdin)، هر شناسه در یک سطر، به جای اجرای پرس‌وجو.

--allow-many

به طور پیش‌فرض bupstash از حذف چندین آیتم توسط یک پرس‌وجوی واحد خودداری می‌کند؛ این پرچم این قابلیت امنیتی را غیرفعال می‌سازد.

--utc-timestamps

نمایش و جستجو بر اساس برچسب‌های زمانی به وقت جهانی (UTC) به جای زمان محلی.

--no-progress

غیرفعال‌سازی نشانگرهای پیشرفت (اگر stderr یک ترمینال تعاملی نباشد نیز نشانگرهای پیشرفت غیرفعال می‌شوند).

-q, --quiet

اجرای بی‌صدا؛ متضمن --no-progress است.

محیط (ENVIRONMENT)

BUPSTASH_REPOSITORY

مخزنی که باید به آن متصل شد. در صورت پیکربندی دسترسی ssh می‌تواند برای مخازن دوردست به شکل ssh://$SERVER/$PATH باشد.

BUPSTASH_REPOSITORY_COMMAND

دستوری برای اجرا جهت اتصال به یک نمونه از bupstash-serve(1). این متغیر امکان برقراری اتصالات پیچیده‌تر به مخزن را برای کاربردهای کمتر رایج فراهم می‌سازد.

BUPSTASH_KEY

مسیر کلید اصلی که برای رمزگشایی داده‌ها و متاداده‌ها استفاده خواهد شد.

BUPSTASH_KEY_COMMAND

دستوری برای اجرا که باید داده‌های کلید را چاپ کند؛ می‌تواند به جای BUPSTASH_KEY برای واکشی کلید از مکان‌های دلخواه مانند شبکه یا سایر فضاهای ذخیره‌سازی محرمانه به کار رود.

BUPSTASH_QUERY_CACHE

مسیر فایل حافظه موقت پرس‌وجو (query cache) جهت استفاده.

مثال‌ها (EXAMPLES)

$ bupstash rm id=14ebd2073b258b1f55c5bbc889c49db4

$ bupstash rm id="*"

$ bupstash rm name=backup.tar and older-than 30d

$ bupstash list --format=jsonl1 \
   | custom-json-filter \
   | bupstash rm --ids-from-stdin

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

bupstash(1), bupstash-list(1), bupstash-gc(1), bupstash-query-language(7)