.nh
.TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" ""

.SH "نام (NAME)"
restic-rewrite \- بازنویسی اسنپ‌شات‌ها جهت حذف فایل‌ها یا تغییر فراداده‌ها


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


.SH "توضیحات (DESCRIPTION)"
دستور «rewrite» اسنپ‌شات‌های جدیدی را بر اساس اسنپ‌شات‌های موجود ایجاد می‌کند. می‌توانید
از فیلترهای include یا exclude برای کنترل اینکه چه فایل‌هایی در اسنپ‌شات‌های جدید
قرار گیرند، استفاده نمایید. فراداده‌ها (زمان، میزبان، برچسب‌ها) حفظ می‌شوند، مگر اینکه
\-\-new\-host یا \-\-new\-time مشخص شده باشد.

.PP
اسنپ‌شات‌هایی که باید بازنویسی شوند با استفاده از گزینه‌های \-\-host، \-\-tag و \-\-path،
یا با ارائه فهرستی از شناسه‌های اسنپ‌شات (snapshot ID) تعیین می‌شوند. لطفاً توجه داشته باشید
که مشخص نکردن هیچ‌یک از این گزینه‌ها و هیچ شناسه اسنپ‌شاتی موجب می‌شود دستور تمام اسنپ‌شات‌ها را بازنویسی کند.

.PP
برچسب ویژه 'rewrite' به اسنپ‌شات‌های جدید اضافه خواهد شد تا از اسنپ‌شات‌های اصلی متمایز گردند،
مگر اینکه از \-\-forget استفاده شود. اگر گزینه \-\-forget به کار رود، اسنپ‌شات‌های اصلی
به جای آن مستقیماً از مخزن حذف خواهند شد.

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

.PP
هنگامی که rewrite به همراه گزینه \-\-snapshot\-summary استفاده شود، اسنپ‌شات جدیدی
شامل داده‌های خلاصه آماری ایجاد می‌گردد. تنها دو فیلد در این خلاصه غیرصفر خواهند بود:
TotalFilesProcessed و TotalBytesProcessed.

.PP
هنگامی که rewrite با یکی از گزینه‌های \-\-exclude یا \-\-include فراخوانی شود،
مقادیر TotalFilesProcessed و TotalBytesProcessed در خلاصه اسنپ‌شات به‌روزرسانی خواهند شد.


.SH "وضعیت خروج (EXIT STATUS)"
در صورت موفقیت‌آمیز بودن دستور، وضعیت خروج 0 است.
در صورت بروز هرگونه خطا، وضعیت خروج 1 است.
اگر مخزن وجود نداشته باشد، وضعیت خروج 10 است.
اگر مخزن از قبل قفل شده باشد، وضعیت خروج 11 است.
اگر گذرواژه نادرست باشد، وضعیت خروج 12 است.


.SH "گزینه‌ها (OPTIONS)"
\fB-n\fP, \fB--dry-run\fP[=false]
	کاری انجام نده، صرفاً آنچه انجام خواهد شد را چاپ کن

.PP
\fB-e\fP, \fB--exclude\fP=[]
	مستثنی کردن یک \fBpattern\fR (می‌تواند چندین بار مشخص شود)

.PP
\fB--exclude-file\fP=[]
	خواندن الگوهای مستثنی‌سازی از یک \fBfile\fR (می‌تواند چندین بار مشخص شود)

.PP
\fB--forget\fP[=false]
	حذف اسنپ‌شات‌های اصلی پس از ایجاد اسنپ‌شات‌های جدید

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

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

.PP
\fB--iexclude\fP=[]
	مشابه \-\-exclude \fBpattern\fR اما کوچک یا بزرگ بودن حروف نام فایل‌ها را نادیده می‌گیرد

.PP
\fB--iexclude-file\fP=[]
	مشابه \-\-exclude\-file اما کوچک یا بزرگ بودن حروف نام \fBفایل‌ها\fR را در الگوها نادیده می‌گیرد

.PP
\fB--iinclude\fP=[]
	مشابه \-\-include \fBpattern\fR اما کوچک یا بزرگ بودن حروف نام فایل‌ها را نادیده می‌گیرد

.PP
\fB--iinclude-file\fP=[]
	مشابه \-\-include\-file اما کوچک یا بزرگ بودن حروف نام \fBفایل‌ها\fR را در الگوها نادیده می‌گیرد

.PP
\fB-i\fP, \fB--include\fP=[]
	شامل کردن یک \fBpattern\fR (می‌تواند چندین بار مشخص شود)

.PP
\fB--include-file\fP=[]
	خواندن الگوهای شامل‌سازی از یک \fBfile\fR (می‌تواند چندین بار مشخص شود)

.PP
\fB--new-host\fP=""
	جایگزینی hostname

.PP
\fB--new-time\fP=""
	جایگزینی زمان پشتیبان‌گیری

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

.PP
\fB-s\fP, \fB--snapshot-summary\fP[=false]
	ایجاد رکورد خلاصه اسنپ‌شات در صورت عدم وجود آن

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


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

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

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

.PP
\fB--compression\fP=auto
	حالت فشرده‌سازی (تنها برای فرمت مخزن نسخه 2 در دسترس است)، یکی از مقادیر (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=""
	شناسه \fBکلید (key)\fR برای تلاش اول جهت رمزگشایی (پیش‌فرض: $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
	تنظیم \fBاندازه\fR هدف بسته‌ها بر حسب MiB؛ فایل‌های بسته ایجادشده ممکن است بزرگ‌تر باشند (پیش‌فرض: $RESTIC_PACK_SIZE)

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

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

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

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

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

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

.PP
\fB--stuck-request-timeout\fP=5m0s
	\fBمدت‌زمانی\fR که پس از آن، درخواست‌های معلق مجدداً ارسال می‌شوند

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

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


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