restic backup(1) restic backup(1)

restic-copy - کپی کردن اسنپ‌شات‌ها از یک مخزن به مخزنی دیگر

restic copy [flags] [snapshotID ...]

دستور "copy" یک یا چند اسنپ‌شات را از یک مخزن به مخزن دیگری کپی می‌کند.

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

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

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

--from-insecure-no-password[=false] استفاده از گذرواژه خالی برای مخزن مبدأ (ناامن)

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

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

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

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

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

-h, --help[=false] راهنمای copy

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

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

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

--cacert=[] فایل برای بارگذاری گواهی‌های ریشه (CA) از آن (پیش‌فرض: استفاده از گواهی‌های سیستم یا $RESTIC_CACERT)

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

--cleanup-cache[=false] حذف خودکار دایرکتوری‌های حافظه پنهان قدیمی

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

--http-user-agent="" تنظیم یک http user agent برای درخواست‌های http خروجی

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

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

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

--key-hint="" شناسه کلید برای نخستین تلاش جهت رمزگشایی (پیش‌فرض: $RESTIC_KEY_HINT)

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

--limit-upload=0 محدود کردن آپلودها به حداکثر نرخ بر حسب KiB/s. (پیش‌فرض: نامحدود)

--no-cache[=false] عدم استفاده از حافظه پنهان (cache) محلی

--no-extra-verify[=false] صرف‌نظر کردن از اعتبارسنجی مضاعف داده‌ها پیش از آپلود (به مستندات مراجعه کنید)

--no-lock[=false] مخزن را قفل نکند؛ این گزینه امکان انجام برخی عملیات‌ها را در مخازن فقط‌خواندنی فراهم می‌کند

-o, --option=[] تنظیم گزینه‌های پیشرفته (key=value، می‌تواند چندین بار مشخص شود)

--pack-size=0 تنظیم اندازه هدف بسته‌ها (pack) به MiB؛ فایل‌های بسته ایجادشده ممکن است بزرگ‌تر باشند (پیش‌فرض: $RESTIC_PACK_SIZE)

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

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

-q, --quiet[=false] عدم چاپ گزارش جامع پیشرفت در خروجی

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

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

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

--stuck-request-timeout=5m0s مدت‌زمان انتظار پیش از تلاش مجدد برای درخواست‌های متوقف‌شده

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

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

restic(1)

ژانویه 2017 تولیدشده توسط restic generate