restic backup(1) restic backup(1)

restic-backup - ایجاد یک نسخهٔ پشتیبان جدید از فایل‌ها و/یا دایرکتوری‌ها

restic backup [flags] [FILE/DIR] ...

دستور «backup» یک اسنپ‌شات جدید ایجاد کرده و فایل‌ها و دایرکتوری‌های داده‌شده به عنوان آرگومان را ذخیره می‌کند.

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

-n, --dry-run[=false] هیچ داده‌ای را بارگذاری یا ذخیره نکن، تنها کارهایی که قرار است انجام شوند را نمایش بده

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

--exclude-caches[=false] دایرکتوری‌های حافظهٔ موقت (کَش) که با یک فایل CACHEDIR.TAG نشانه‌گذاری شده‌اند را مستثنی می‌کند. برای مشاهدهٔ Cache Directory Tagging Standard به https://bford.info/cachedir مراجعه کنید

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

--exclude-if-present=[] filename[:header] را می‌گیرد؛ در صورتی که سرآیند فایل مطابق مقدار داده‌شده باشد، محتوای دایرکتوری‌های حاوی filename (به‌جز خود filename) را مستثنی می‌کند (می‌تواند چندین بار مشخص شود)

--exclude-larger-than="" حداکثر size فایل‌هایی که باید نسخهٔ پشتیبان از آن‌ها تهیه شود (پسوندهای مجاز: k/K، m/M، g/G، t/T)

--files-from=[] خواندن فایل‌ها برای تهیهٔ نسخهٔ پشتیبان از file (می‌تواند با آرگومان‌های فایل ترکیب شود؛ می‌تواند چندین بار مشخص شود)

--files-from-raw=[] خواندن فایل‌ها برای تهیهٔ نسخهٔ پشتیبان از file (می‌تواند با آرگومان‌های فایل ترکیب شود؛ می‌تواند چندین بار مشخص شود)

--files-from-verbatim=[] خواندن فایل‌ها برای تهیهٔ نسخهٔ پشتیبان از file (می‌تواند با آرگومان‌های فایل ترکیب شود؛ می‌تواند چندین بار مشخص شود)

-f, --force[=false] اجبار به بازخوانی دوبارهٔ فایل‌ها/دایرکتوری‌های مبدأ (پرچم «parent» را لغو می‌کند)

-g, --group-by=host,paths گروه‌بندی (group) اسنپ‌شات‌ها بر اساس host، paths و/یا tags که با ویرگول جدا شده‌اند (غیرفعال کردن گروه‌بندی با '')

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

-H, --host="" تنظیم دستی hostname برای اسنپ‌شات (پیش‌فرض: $RESTIC_HOST). برای جلوگیری از پویش مجدد پرهزینه از پرچم «parent» استفاده کنید

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

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

--ignore-ctime[=false] نادیده گرفتن تغییرات ctime هنگام بررسی فایل‌های تغییریافته

--ignore-inode[=false] نادیده گرفتن شمارهٔ inode و تغییرات ctime هنگام بررسی فایل‌های تغییریافته

--no-scan[=false] اجرا نکردن پویشگر برای برآورد اندازهٔ نسخهٔ پشتیبان

-x, --one-file-system[=false] مستثنی کردن دیگر سیستم‌های فایل، عبور نکردن از مرزهای سیستم فایل و subvolumeها

--parent="" استفاده از این snapshot والد (پیش‌فرض: تازه‌ترین اسنپ‌شات در گروه تعیین‌شده توسط --group-by که جدیدتر از برچسب زمانیِ مشخص‌شده توسط --time نباشد)

--read-concurrency=0 خواندن هم‌روند n فایل (پیش‌فرض: $RESTIC_READ_CONCURRENCY یا 2)

--skip-if-unchanged[=false] صرف‌نظر از ایجاد اسنپ‌شات در صورتی که با اسنپ‌شات والد یکسان باشد

--stdin[=false] خواندن نسخهٔ پشتیبان از stdin

--stdin-filename="stdin" filename مورد استفاده هنگام خواندن از stdin

--stdin-from-command[=false] تفسیر آرگومان‌ها به عنوان دستوری برای اجرا و ذخیرهٔ stdout آن

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

--time="" time (زمان) نسخهٔ پشتیبان (مثال: '2012-11-01 22:08:41') (پیش‌فرض: now)

--with-atime[=false] ذخیرهٔ atime برای تمام فایل‌ها و دایرکتوری‌ها

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

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

--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="" شناسهٔ کلید (key ID) برای اینکه ابتدا برای رمزگشایی امتحان شود (پیش‌فرض: $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 یک سطح تعیین نمود، حداکثر سطح/تکرار ۲ است)

restic(1)

Jan 2017 generated by restic generate