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

.SH "نام (NAME)"
restic-copy \- کپی کردن اسنپ‌شات‌ها از یک مخزن به مخزنی دیگر


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


.SH "توضیحات (DESCRIPTION)"
دستور "copy" یک یا چند اسنپ‌شات را از یک مخزن به مخزن دیگری کپی می‌کند.

.PP
نکته: این فرایند به دلیل تفاوت در کلیدهای رمزنگاری استفاده‌شده در مخزن مبدأ و مقصد، مجبور است کل اسنپ‌شات(ها) را هم دانلود (خواندن) و هم آپلود (نوشتن) کند. این امر /ممکن است مصرف پهنای باند و هزینه‌های بیشتری/ نسبت به مقادیر مورد انتظار در روال‌های عادی پشتیبان‌گیری به همراه داشته باشد.

.PP
نکته: فرایند کپی، فایل‌ها را مجدداً تکه‌تکه (re-chunk) نمی‌کند؛ این موضوع ممکن است حذف داده‌های تکراری (deduplication) بین فایل‌های کپی‌شده و فایل‌های از قبل ذخیره‌شده در مخزن مقصد را مختل کند. این بدان معناست که فایل‌های کپی‌شده‌ای که در هر دو مخزن مبدأ و مقصد وجود داشته‌اند، /ممکن است تا دو برابر فضای خود را/ در مخزن مقصد اشغال کنند. با استفاده از گزینه «--copy-chunker-params» هنگام راه‌اندازی اولیه یک مخزن مقصد جدید با دستور «init»، می‌توان این اثر را کاهش داد.


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


.SH "گزینه‌ها (OPTIONS)"
\fB--from-insecure-no-password\fP[=false]
	استفاده از گذرواژه خالی برای مخزن مبدأ (ناامن)

.PP
\fB--from-key-hint\fP=""
	شناسه کلیدی که ابتدا برای رمزگشایی مخزن مبدأ آزمایش می‌شود (پیش‌فرض: $RESTIC_FROM_KEY_HINT)

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

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

.PP
\fB--from-repo\fP=""
	\fBمخزن\fR مبدأ برای کپی کردن اسنپ‌شات‌ها از آن (پیش‌فرض: $RESTIC_FROM_REPOSITORY)

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

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

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

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

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


.SH "گزینه‌های به ارث‌رسیده از دستورهای والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB--cacert\fP=[]
	\fBفایل\fR برای بارگذاری گواهی‌های ریشه (CA) از آن (پیش‌فرض: استفاده از گواهی‌های سیستم یا $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=""
	تنظیم یک 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کلید\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]
	عدم استفاده از حافظه پنهان (cache) محلی

.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 هدف بسته‌ها (pack) به 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