.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "borg-import-tar" "1" "2026-07-18" "" "ابزار پشتیبان‌گیری borg"
.SH "نام (NAME)"
borg-import-tar \- ایجاد یک آرشیو پشتیبان از فایل tar
.SH "خلاصه دستور (SYNOPSIS)"
.sp
borg [گزینه‌های عمومی] import\-tar [گزینه‌ها] ARCHIVE TARFILE
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور یک آرشیو پشتیبان از یک فایل tar (تاربال) ایجاد می‌کند.
.sp
هنگام مشخص کردن \(aq\-\(aq به‌عنوان مسیر، Borg جریان داده‌های tar را از ورودی استاندارد (stdin) می‌خواند.
.sp
به‌طور پیش‌فرض (\fB\-\-tar\-filter=auto\fP)، Borg فشرده بودن فایل را بر اساس پسوند آن تشخیص داده و آن را از فیلتر مناسب عبور می‌دهد:
.INDENT 0.0
.IP \(bu 2
\&.tar.gz یا .tgz: gzip \-d
.IP \(bu 2
\&.tar.bz2 یا .tbz: bzip2 \-d
.IP \(bu 2
\&.tar.xz یا .txz: xz \-d
.IP \(bu 2
\&.tar.zstd یا .tar.zst: zstd \-d
.IP \(bu 2
\&.tar.lz4: lz4 \-d
.UNINDENT
.sp
همچنین، می‌توان یک برنامه \fB\-\-tar\-filter\fP را به‌طور صریح مشخص کرد. این برنامه باید داده‌های فشرده را از stdin خوانده و جریان tar غیرفشرده را در stdout خروجی دهد.
.sp
بیشتر مستندات \fBborg create\fP در اینجا نیز صدق می‌کند. توجه داشته باشید که این دستور از مستثنی کردن فایل‌ها پشتیبانی نمی‌کند.
.sp
دستور import\-tar یک تبدیل اتلافی (lossy) است:
پرچم‌های BSD، لیست‌های کنترل دسترسی (ACLs)، ویژگی‌های گسترش‌یافته (xattrs)، و زمان‌های atime و ctime ذخیره نمی‌شوند.
دقت برچسب زمانی به ثانیه‌های کامل محدود است، نه دقت نانوثانیه‌ای که در حالت عادی توسط Borg پشتیبانی می‌شود.
.sp
گزینه \fB\-\-sparse\fP (آن‌گونه که در borg create وجود دارد) پشتیبانی نمی‌شود.
.sp
دستور import\-tar فرمت‌های POSIX.1\-1988 (ustar)، POSIX.1\-2001 (pax)، GNU tar، UNIX V7 tar و SunOS tar همراه با ویژگی‌های گسترش‌یافته را می‌خواند.
.sp
برای وارد کردن چندین فایل tar به درون یک آرشیو واحد، می‌توان آن‌ها را به‌سادگی (مثلاً با استفاده از \(dqcat\(dq) در یک فایل تجمیع کرد و با گزینه \fB\-\-ignore\-zeros\fP برای رد شدن از نشانگرهای توقف بین آن‌ها وارد نمود.
.SH "گزینه‌ها (OPTIONS)"
.sp
برای مشاهده گزینه‌های عمومی دستورات Borg، به \fIborg\-common(1)\fP مراجعه کنید.
.SS "آرگومان‌ها (arguments)"
.INDENT 0.0
.TP
.B ARCHIVE
نام آرشیو جهت ایجاد (باید یک نام معتبر برای پوشه نیز باشد)
.TP
.B TARFILE
فایل tar ورودی. برای خواندن از stdin به‌جای آن، \(dq\-\(dq را مشخص کنید.
.UNINDENT
.SS "گزینه‌ها (options)"
.INDENT 0.0
.TP
.B  \-\-tar\-filter
برنامه فیلتر برای هدایت داده‌ها از طریق پایپ
.TP
.B  \-s\fP,\fB  \-\-stats
چاپ آمار برای آرشیو ایجادشده
.TP
.B  \-\-quick\-stats
تنها چاپ آمار آرشیو، و صرف‌نظر از آمار کلی مخزن
.TP
.B  \-\-list
خروجی فهرست مفصل موارد (فایل‌ها، پوشه‌ها و...)
.TP
.BI \-\-filter \ STATUSCHARS
تنها نمایش مواردی با کاراکترهای وضعیت داده‌شده
.TP
.B  \-\-json
خروجی آمار به‌صورت JSON (شامل \-\-stats)
.TP
.B  \-\-ignore\-zeros
نادیده گرفتن بلوک‌های پر شده با صفر در فایل tar ورودی
.UNINDENT
.SS "گزینه‌های آرشیو (Archive options)"
.INDENT 0.0
.TP
.BI \-\-comment \ COMMENT
افزودن متن یادداشت به آرشیو
.TP
.BI \-\-timestamp \ TIMESTAMP
تنظیم دستی زمان/تاریخ ایجاد آرشیو (قالب UTC، به‌صورت yyyy\-mm\-ddThh:mm:ss). همچنین می‌توانید یک فایل/پوشه مرجع مشخص کنید.
.TP
.BI \-c \ SECONDS\fR,\fB \ \-\-checkpoint\-interval \ SECONDS
نوشتن نقطه بازرسی در هر SECONDS ثانیه (پیش‌فرض: ۱۸۰۰)
.TP
.BI \-\-chunker\-params \ PARAMS
مشخص کردن پارامترهای قطعه‌بندی (ALGO, CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE). پیش‌فرض: buzhash,19,23,21,4095
.TP
.BI \-C \ COMPRESSION\fR,\fB \ \-\-compression \ COMPRESSION
انتخاب الگوریتم فشرده‌سازی، برای جزئیات به خروجی دستور \(dqborg help compression\(dq مراجعه کنید.
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fIborg\-common(1)\fP
.SH "نویسندگان (Author)"
The Borg Collective
.\" End of generated man page.