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

.SH "نام (NAME)"
restic-tag \- ویرایش برچسب‌ها روی اسنپ‌شات‌ها


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


.SH "توضیحات (DESCRIPTION)"
دستور «tag» به شما امکان می‌دهد برچسب‌های روی اسنپ‌شات‌های موجود را تغییر دهید.

.PP
می‌توانید کل مجموعه برچسب‌های یک اسنپ‌شات را تنظیم/جایگزین کنید، یا برچسب‌هایی را به مجموعه موجود اضافه کرده یا از آن حذف نمایید.

.PP
هنگامی که هیچ snapshotID مشخص نشده باشد، تمام اسنپ‌شات‌هایی که با معیارهای فیلتر میزبان (host)، برچسب (tag) و مسیر (path) مطابقت دارند تغییر داده می‌شوند.


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


.SH "گزینه‌ها (OPTIONS)"
\fB--add\fP=[]
	\fBبرچسب‌هایی\fR که در قالب \fBtag[,tag,...]\fR به برچسب‌های موجود افزوده خواهند شد (می‌تواند چندین بار مشخص شود)

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

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

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

.PP
\fB--remove\fP=[]
	\fBبرچسب‌هایی\fR که در قالب \fBtag[,tag,...]\fR از برچسب‌های موجود حذف خواهند شد (می‌تواند چندین بار مشخص شود)

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

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


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

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

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

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

.PP
\fB--http-user-agent\fP=""
	تنظیم یک 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کلید\fR برای تلاش اول در رمزگشایی (پیش‌فرض: $RESTIC_KEY_HINT)

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

.PP
\fB--limit-upload\fP=0
	محدود کردن بارگذاری‌ها به حداکثر \fBنرخ\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=[]
	تنظیم گزینه گسترده (\fBکلید=مقدار\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 سطحی تعیین کنید، حداکثر سطح/دفعات ۲ است)


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