restic backup(1) restic backup(1)

restic-restore - استخراج داده‌ها از یک snapshot

restic restore [flags] snapshotID

دستور «restore» داده‌ها را از یک snapshot موجود در مخزن به یک دایرکتوری استخراج می‌کند.

شناسهٔ ویژهٔ snapshotID با مقدار «latest» می‌تواند برای بازیابی جدیدترین snapshot در مخزن استفاده شود.

برای بازیابی تنها یک زیرپوشهٔ خاص، می‌توانید از نحو «snapshotID:subfolder» استفاده کنید، که در آن «subfolder» مسیری درون درخت snapshot است، همان‌طور که توسط «restic ls» نشان داده می‌شود.

مجوزهای POSIX ACL همیشه با مقدار عددی خود بازیابی می‌شوند، در حالی که مالکیت فایل می‌تواند به‌صورت اختیاری به‌جای مقدار عددی، با نام بازیابی شود.

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

--delete[=false] حذف فایل‌ها از دایرکتوری مقصد در صورتی که در snapshot وجود نداشته باشند. از ‎'--dry-run -vv'‎ برای بررسی موارد قابل حذف استفاده کنید

--dry-run[=false] هیچ داده‌ای نوشته نشود، فقط کارهایی که انجام خواهند شد نشان داده شوند

-e, --exclude=[] مستثنی کردن یک pattern (می‌تواند چندین بار مشخص شود)

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

--exclude-xattr=[] مستثنی کردن ویژگی‌های xattr بر اساس pattern (می‌تواند چندین بار مشخص شود)

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

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

--iexclude=[] مشابه ‎--exclude pattern است اما بزرگی و کوچکی حروف نام فایل‌ها را نادیده می‌گیرد

--iexclude-file=[] مشابه ‎--exclude-file است اما بزرگی و کوچکی حروف نام fileها در الگوها را نادیده می‌گیرد

--iinclude=[] مشابه ‎--include pattern است اما بزرگی و کوچکی حروف نام فایل‌ها را نادیده می‌گیرد

--iinclude-file=[] مشابه ‎--include-file است اما بزرگی و کوچکی حروف نام fileها در الگوها را نادیده می‌گیرد

-i, --include=[] شامل کردن یک pattern (می‌تواند چندین بار مشخص شود)

--include-file=[] خواندن الگوهای شمول از یک file (می‌تواند چندین بار مشخص شود)

--include-xattr=[] شامل کردن ویژگی‌های xattr بر اساس pattern (می‌تواند چندین بار مشخص شود)

--overwrite=always رفتار رونویسی، یکی از گزینه‌های (always|if-changed|if-newer|never)

--ownership-by-name[=false] بازیابی مالکیت فایل بر اساس نام کاربر و نام گروه (به‌جز POSIX ACLها)

--path=[] تنها snapshotهای شامل این path (مطلق) در نظر گرفته شوند، هنگامی که شناسهٔ snapshot با مقدار «latest» داده شده است (می‌تواند چندین بار مشخص شود، snapshotها باید شامل تمام مسیرهای مشخص‌شده باشند)

--sparse[=false] بازیابی فایل‌ها به‌صورت sparse

--tag=[] تنها snapshotهای دارای tag[,tag,...] در نظر گرفته شوند، هنگامی که شناسهٔ snapshot با مقدار «latest» داده شده است (می‌تواند چندین بار مشخص شود)

-t, --target="" دایرکتوری مقصد برای استخراج داده‌ها به آن

--verify[=false] تأیید صحت محتوای فایل‌های بازیابی‌شده

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

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

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

--compression=auto حالت فشرده‌سازی (تنها برای فرمت مخزن نسخهٔ 2 در دسترس است)، یکی از گزینه‌های (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="" شناسهٔ کلید (key) جهت تلاش برای رمزگشایی در ابتدا (پیش‌فرض: $RESTIC_KEY_HINT)

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

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

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

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

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

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

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

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

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

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

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

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

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

--stuck-request-timeout=5m0s مدت زمان (duration) که پس از آن تلاش مجدد برای درخواست‌های گیرکرده انجام می‌شود

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

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

restic(1)

Jan 2017 generated by restic generate