.nh
.TH "restic backup" "1" "Jan 2017" "generated by \fBrestic generate\fR" ""

.SH "نام (NAME)"
restic-backup \- ایجاد یک نسخهٔ پشتیبان جدید از فایل‌ها و/یا دایرکتوری‌ها


.SH "خلاصه دستور (SYNOPSIS)"
\fBrestic backup [flags] [FILE/DIR] ...\fP


.SH "توضیحات (DESCRIPTION)"
دستور «backup» یک اسنپ‌شات جدید ایجاد کرده و فایل‌ها و دایرکتوری‌های داده‌شده به عنوان آرگومان را ذخیره می‌کند.


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


.SH "گزینه‌ها (OPTIONS)"
\fB-n\fP, \fB--dry-run\fP[=false]
	هیچ داده‌ای را بارگذاری یا ذخیره نکن، تنها کارهایی که قرار است انجام شوند را نمایش بده

.PP
\fB-e\fP, \fB--exclude\fP=[]
	مستثنی کردن یک \fBpattern\fR (می‌تواند چندین بار مشخص شود)

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

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

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

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

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

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

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

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

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

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

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

.PP
\fB--iexclude\fP=[]
	مشابه --exclude \fBpattern\fR اما بزرگی و کوچکی حروف در نام فایل‌ها را نادیده می‌گیرد

.PP
\fB--iexclude-file\fP=[]
	مشابه --exclude-file اما بزرگی و کوچکی حروف در \fBfile\fRnames درون الگوها را نادیده می‌گیرد

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

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

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

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

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

.PP
\fB--read-concurrency\fP=0
	خواندن هم‌روند \fBn\fR فایل (پیش‌فرض: $RESTIC_READ_CONCURRENCY یا 2)

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

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

.PP
\fB--stdin-filename\fP="stdin"
	\fBfilename\fR مورد استفاده هنگام خواندن از stdin

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

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

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

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


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB--cacert\fP=[]
	\fBfile\fR برای بارگذاری گواهی‌های ریشه از آن (پیش‌فرض: استفاده از گواهی‌های سیستم یا $RESTIC_CACERT)

.PP
\fB--cache-dir\fP=""
	تنظیم \fBdirectory\fR حافظهٔ موقت (کَش)\&. (پیش‌فرض: استفاده از دایرکتوری کَش پیش‌فرض سیستم)

.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=""
	شناسهٔ کلید (\fBkey\fR ID) برای اینکه ابتدا برای رمزگشایی امتحان شود (پیش‌فرض: $RESTIC_KEY_HINT)

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

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

.PP
\fB--no-cache\fP[=false]
	استفاده نکردن از کَش محلی

.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
	تنظیم \fBsize\fR (اندازه) هدف بسته بر حسب MiB، بسته‌های ایجادشده ممکن است بزرگ‌تر باشند (پیش‌فرض: $RESTIC_PACK_SIZE)

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

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

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

.PP
\fB-r\fP, \fB--repo\fP=""
	مخزن (\fBrepository\fR) برای تهیهٔ نسخهٔ پشتیبان در آن یا بازیابی از آن (پیش‌فرض: $RESTIC_REPOSITORY)

.PP
\fB--repository-file\fP=""
	\fBfile\fR برای خواندن مکان مخزن از آن (پیش‌فرض: $RESTIC_REPOSITORY_FILE)

.PP
\fB--retry-lock\fP=0s
	تلاش مجدد برای قفل کردن مخزن اگر قبلاً قفل شده باشد، مقداری مانند 5m یا 2h می‌گیرد (پیش‌فرض: بدون تلاش مجدد)

.PP
\fB--stuck-request-timeout\fP=5m0s
	مدت‌زمان (\fBduration\fR) که پس از آن درخواست‌های گیرکرده مجدداً تلاش می‌شوند

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

.PP
\fB-v\fP, \fB--verbose\fP[=0]
	پرگویی در خروجی (می‌توان چندین بار مشخص کرد یا با استفاده از --verbose=n یک سطح تعیین نمود، حداکثر سطح/تکرار ۲ است)


.SH "همچنین ببینید (SEE ALSO)"
\fBrestic(1)\fP