.nh
.TH "restic backup" "1" "Jan 2017" "تولید شده توسط \fBrestic generate\fR" ""

.SH "نام (NAME)"
restic-forget \- حذف اسنپ‌شات‌ها از مخزن


.SH "خلاصه دستور (SYNOPSIS)"
\fBrestic forget [flags] [snapshot ID] [...]\fP


.SH "توضیحات (DESCRIPTION)"
دستور «forget» اسنپ‌شات‌ها را طبق یک خط‌مشی حذف می‌کند. ابتدا تمامی اسنپ‌شات‌ها بر اساس «\-\-group\-by» به گروه‌هایی تقسیم می‌شوند، و پس از آن خط‌مشی تعیین‌شده توسط گزینه‌های «\-\-keep\-\fI» به‌طور جداگانه بر هر گروه اعمال می‌گردد. اگر اسنپ‌شات‌های کافی برای نگه‌داری یک مورد به ازای هر گزینهٔ مرتبط با مدت‌زمان «\-\-keep\-{within\-,\}\fP» وجود نداشته باشد، قدیمی‌ترین اسنپ‌شات در آن گروه نیز علاوه بر آن نگه‌داری می‌شود.

.PP
لطفاً توجه داشته باشید که این دستور در حقیقت فقط شیء اسنپ‌شات را در مخزن حذف می‌کند که ارجاعی به داده‌های ذخیره‌شده در آنجاست. برای حذف داده‌های بدون ارجاع پس از اجرای موفقیت‌آمیز «forget»، دستور «prune» را ببینید.

.PP
همچنین لطفاً مستندات «forget» را بخوانید تا از برخی ملاحظات امنیتی مهم آگاه شوید.


.SH "وضعیت خروج (EXIT STATUS)"
در صورتی که دستور با موفقیت انجام شود، وضعیت خروج ۰ است.
در صورت بروز هرگونه خطا، وضعیت خروج ۱ است.
در صورتی که در حذف یک یا چند اسنپ‌شات خطایی رخ دهد، وضعیت خروج ۳ است.
در صورتی که مخزن وجود نداشته باشد، وضعیت خروج ۱۰ است.
در صورتی که مخزن از قبل قفل شده باشد، وضعیت خروج ۱۱ است.
در صورتی که گذرواژه نادرست باشد، وضعیت خروج ۱۲ است.


.SH "گزینه‌ها (OPTIONS)"
\fB-l\fP, \fB--keep-last\fP=0
	نگه‌داری \fBn\fR اسنپ‌شات پایانی (برای نگه‌داری همهٔ اسنپ‌شات‌ها از 'unlimited' استفاده کنید)

.PP
\fB-H\fP, \fB--keep-hourly\fP=0
	نگه‌داری \fBn\fR اسنپ‌شات ساعتی پایانی (برای نگه‌داری همهٔ اسنپ‌شات‌های ساعتی از 'unlimited' استفاده کنید)

.PP
\fB-d\fP, \fB--keep-daily\fP=0
	نگه‌داری \fBn\fR اسنپ‌شات روزانه پایانی (برای نگه‌داری همهٔ اسنپ‌شات‌های روزانه از 'unlimited' استفاده کنید)

.PP
\fB-w\fP, \fB--keep-weekly\fP=0
	نگه‌داری \fBn\fR اسنپ‌شات هفتگی پایانی (برای نگه‌داری همهٔ اسنپ‌شات‌های هفتگی از 'unlimited' استفاده کنید)

.PP
\fB-m\fP, \fB--keep-monthly\fP=0
	نگه‌داری \fBn\fR اسنپ‌شات ماهانه پایانی (برای نگه‌داری همهٔ اسنپ‌شات‌های ماهانه از 'unlimited' استفاده کنید)

.PP
\fB-y\fP, \fB--keep-yearly\fP=0
	نگه‌داری \fBn\fR اسنپ‌شات سالانه پایانی (برای نگه‌داری همهٔ اسنپ‌شات‌های سالانه از 'unlimited' استفاده کنید)

.PP
\fB--keep-within\fP=
	نگه‌داری اسنپ‌شات‌هایی که نسبت به آخرین اسنپ‌شات، جدیدتر از \fBduration\fR هستند (مانند 1y5m7d2h)

.PP
\fB--keep-within-hourly\fP=
	نگه‌داری اسنپ‌شات‌های ساعتی که نسبت به آخرین اسنپ‌شات، جدیدتر از \fBduration\fR هستند (مانند 1y5m7d2h)

.PP
\fB--keep-within-daily\fP=
	نگه‌داری اسنپ‌شات‌های روزانه که نسبت به آخرین اسنپ‌شات، جدیدتر از \fBduration\fR هستند (مانند 1y5m7d2h)

.PP
\fB--keep-within-weekly\fP=
	نگه‌داری اسنپ‌شات‌های هفتگی که نسبت به آخرین اسنپ‌شات، جدیدتر از \fBduration\fR هستند (مانند 1y5m7d2h)

.PP
\fB--keep-within-monthly\fP=
	نگه‌داری اسنپ‌شات‌های ماهانه که نسبت به آخرین اسنپ‌شات، جدیدتر از \fBduration\fR هستند (مانند 1y5m7d2h)

.PP
\fB--keep-within-yearly\fP=
	نگه‌داری اسنپ‌شات‌های سالانه که نسبت به آخرین اسنپ‌شات، جدیدتر از \fBduration\fR هستند (مانند 1y5m7d2h)

.PP
\fB--keep-tag\fP=[]
	نگه‌داری اسنپ‌شات‌هایی با این \fBtaglist\fR (می‌تواند چندین بار مشخص شود)

.PP
\fB--unsafe-allow-remove-all\fP[=false]
	اجازه به حذف تمامی اسنپ‌شات‌های یک گروه اسنپ‌شات

.PP
\fB--host\fP=[]
	تنها اسنپ‌شات‌های این \fBhost\fR در نظر گرفته شوند (می‌تواند چندین بار مشخص شود، برای لغو مقدار پیش‌فرض از رشته خالی استفاده کنید) (پیش‌فرض: $RESTIC_HOST)

.PP
\fB--tag\fP=[]
	تنها اسنپ‌شات‌های شامل \fBtag[,tag,...]\fR در نظر گرفته شوند (می‌تواند چندین بار مشخص شود)

.PP
\fB--path\fP=[]
	تنها اسنپ‌شات‌های شامل این \fBpath\fR (مطلق) در نظر گرفته شوند (می‌تواند چندین بار مشخص شود، اسنپ‌شات‌ها باید شامل تمام مسیرهای مشخص‌شده باشند)

.PP
\fB-c\fP, \fB--compact\fP[=false]
	استفاده از قالب خروجی فشرده

.PP
\fB-g\fP, \fB--group-by\fP=host,paths
	گروه‌بندی (\fBgroup\fR) اسنپ‌شات‌ها بر اساس host، paths و/یا tags، جداشده با کاما (غیرفعال‌سازی گروه‌بندی با '')

.PP
\fB-n\fP, \fB--dry-run\fP[=false]
	چیزی حذف نشود، فقط کارهایی که قرار است انجام شود چاپ شود

.PP
\fB--prune\fP[=false]
	اجرای خودکار دستور 'prune' در صورت حذف شدن اسنپ‌شات‌ها

.PP
\fB--max-unused\fP="5%"
	تحملِ حد (\fBlimit\fR) ارائه‌شده از داده‌های استفاده‌نشده (مقدار مطلق بر حسب بایت با پسوندهای k/K، m/M، g/G، t/T، مقداری بر حسب % یا کلمه 'unlimited')

.PP
\fB--max-repack-size\fP=""
	توقف پس از بسته‌بندی مجدد این مقدار کل داده (پسوندهای مجاز برای \fBsize\fR: k/K، m/M، g/G، t/T)

.PP
\fB--repack-cacheable-only\fP[=false]
	تنها بسته‌بندی مجدد بسته‌هایی که قابل کش‌شدن هستند

.PP
\fB--repack-uncompressed\fP[=false]
	بسته‌بندی مجدد تمامی داده‌های فشرده‌نشده

.PP
\fB--repack-smaller-than\fP=""
	بسته‌بندی فایل‌های بسته‌ای کمتر از حد (\fBbelow-limit\fR) (پسوندهای مجاز: m/M)

.PP
\fB-h\fP, \fB--help\fP[=false]
	راهنمای forget


.SH "گزینه‌های به ارث‌رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB--cacert\fP=[]
	فایل (\fBfile\fR) برای بارگیری گواهی‌های ریشه از آن (پیش‌فرض: استفاده از گواهی‌های سیستم یا $RESTIC_CACERT)

.PP
\fB--cache-dir\fP=""
	تنظیم دایرکتوری کش (\fBdirectory\fR)\&. (پیش‌فرض: استفاده از دایرکتوری کش پیش‌فرض سیستم)

.PP
\fB--cleanup-cache\fP[=false]
	حذف خودکار دایرکتوری‌های کش قدیمی

.PP
\fB--compression\fP=auto
	حالت فشرده‌سازی (تنها برای نسخه ۲ قالب مخزن موجود است)، یکی از (auto|off|fastest|better|max) (پیش‌فرض: $RESTIC_COMPRESSION)

.PP
\fB--http-user-agent\fP=""
	تنظیم http user agent برای درخواست‌های خروجی http

.PP
\fB--insecure-no-password\fP[=false]
	استفاده از گذرواژه خالی برای مخزن، باید به هر دستور restic فرستاده شود (ناامن)

.PP
\fB--insecure-tls\fP[=false]
	صرف‌نظر کردن از اعتبارسنجی گواهی TLS هنگام اتصال به مخزن (ناامن)

.PP
\fB--json\fP[=false]
	تنظیم حالت خروجی روی JSON برای دستوراتی که از آن پشتیبانی می‌کنند

.PP
\fB--key-hint\fP=""
	شناسه کلید (\fBkey\fR ID) کلیدی که ابتدا باید برای رمزگشایی امتحان شود (پیش‌فرض: $RESTIC_KEY_HINT)

.PP
\fB--limit-download\fP=0
	محدود کردن بارگیری‌ها به حداکثر نرخ (\fBrate\fR) بر حسب KiB/s\&. (پیش‌فرض: نامحدود)

.PP
\fB--limit-upload\fP=0
	محدود کردن بارگذاری‌ها به حداکثر نرخ (\fBrate\fR) بر حسب KiB/s\&. (پیش‌فرض: نامحدود)

.PP
\fB--no-cache\fP[=false]
	عدم استفاده از کش محلی

.PP
\fB--no-extra-verify\fP[=false]
	صرف‌نظر کردن از اعتبارسنجی اضافی داده‌ها پیش از بارگذاری (مستندات را ببینید)

.PP
\fB--no-lock\fP[=false]
	مخزن قفل نشود، این کار اجازه برخی عملیات روی مخازن فقط‌خواندنی را می‌دهد

.PP
\fB-o\fP, \fB--option\fP=[]
	تنظیم گزینه پیشرفته (\fBkey=value\fR، می‌تواند چندین بار مشخص شود)

.PP
\fB--pack-size\fP=0
	تنظیم اندازه (\fBsize\fR) بسته هدف بر حسب MiB، فایل‌های بسته‌ای ایجادشده ممکن است بزرگتر باشند (پیش‌فرض: $RESTIC_PACK_SIZE)

.PP
\fB--password-command\fP=""
	دستور شل (\fBcommand\fR) برای دریافت گذرواژه مخزن از آن (پیش‌فرض: $RESTIC_PASSWORD_COMMAND)

.PP
\fB-p\fP, \fB--password-file\fP=""
	فایل (\fBfile\fR) برای خواندن گذرواژه مخزن از آن (پیش‌فرض: $RESTIC_PASSWORD_FILE)

.PP
\fB-q\fP, \fB--quiet\fP[=false]
	عدم نمایش گزارش جامع پیشرفت در خروجی

.PP
\fB-r\fP, \fB--repo\fP=""
	مخزن (\fBrepository\fR) برای پشتیبان‌گیری در آن یا بازیابی از آن (پیش‌فرض: $RESTIC_REPOSITORY)

.PP
\fB--repository-file\fP=""
	فایل (\fBfile\fR) برای خواندن مکان مخزن از آن (پیش‌فرض: $RESTIC_REPOSITORY_FILE)

.PP
\fB--retry-lock\fP=0s
	تلاش مجدد برای قفل کردن مخزن در صورتی که از قبل قفل است، مقداری مانند 5m یا 2h می‌گیرد (پیش‌فرض: بدون تلاش مجدد)

.PP
\fB--stuck-request-timeout\fP=5m0s
	مدت‌زمان (\fBduration\fR) که پس از آن برای درخواست‌های گیرکرده تلاش مجدد شود

.PP
\fB--tls-client-cert\fP=""
	مسیر یک فایل (\fBfile\fR) شامل گواهی کلاینت TLS و کلید خصوصی با کدگذاری PEM (پیش‌فرض: $RESTIC_TLS_CLIENT_CERT)

.PP
\fB-v\fP, \fB--verbose\fP[=0]
	پرگویی در گزارش (چندین بار مشخص شود یا یک سطح با استفاده از ‎--verbose=n تعیین گردد، حداکثر سطح/دفعات ۲ است)


.SH "همچنین ببینید (SEE ALSO)"
\fBrestic(1)\fP