restic backup(1) restic backup(1)

restic-rewrite - بازنویسی اسنپ‌شات‌ها جهت حذف فایل‌ها یا تغییر فراداده‌ها

restic rewrite [flags] [snapshotID ...]

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

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

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

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

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

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

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

-n, --dry-run[=false] کاری انجام نده، صرفاً آنچه انجام خواهد شد را چاپ کن

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

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

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

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

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

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

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

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

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

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

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

--new-host="" جایگزینی hostname

--new-time="" جایگزینی زمان پشتیبان‌گیری

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

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

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

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

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

--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 تنظیم اندازه هدف بسته‌ها بر حسب 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 یک سطح تعیین نمایید؛ حداکثر سطح/تعداد 2 است)

restic(1)

Jan 2017 generated by restic generate