.\" 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-export-tar" "1" "2026-07-18" "" "ابزار پشتیبان‌گیری borg"
.SH "نام (NAME)"
borg-export-tar \- برون‌بری محتویات آرشیو به عنوان فایل tar
.SH "خلاصه دستور (SYNOPSIS)"
.sp
borg [گزینه‌های عمومی] export\-tar [گزینه‌ها] ARCHIVE FILE [PATH...]
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور یک فایل tar (تاربال) از یک آرشیو ایجاد می‌کند.
.sp
هنگام مشخص کردن \(aq\-\(aq به‌عنوان FILE خروجی، Borg جریان tar را در خروجی استاندارد (stdout) می‌نویسد.
.sp
به‌طور پیش‌فرض (\fB\-\-tar\-filter=auto\fP)، Borg فشرده بودن یا نبودن FILE را بر اساس پسوند فایل آن تشخیص داده و تاربال را قبل از نوشتن در FILE از فیلتر مناسب عبور می‌دهد:
.INDENT 0.0
.IP \(bu 2
\&.tar.gz یا .tgz: gzip
.IP \(bu 2
\&.tar.bz2 یا .tbz: bzip2
.IP \(bu 2
\&.tar.xz یا .txz: xz
.IP \(bu 2
\&.tar.zstd یا .tar.zst: zstd
.IP \(bu 2
\&.tar.lz4: lz4
.UNINDENT
.sp
همچنین، می‌توان یک برنامه \fB\-\-tar\-filter\fP را به‌طور صریح مشخص کرد. این برنامه باید جریان tar فشرده‌نشده را از stdin خوانده و یک جریان tar فشرده/فیلترشده را در stdout بنویسد.
.sp
فایل tar تولیدشده از قالب GNU tar استفاده می‌کند.
.sp
دستور export\-tar یک تبدیل اتلافی (lossy) است:
پرچم‌های BSD، لیست‌های کنترل دسترسی (ACLها)، صفت‌های گسترده (xattrs)، و زمان‌های atime و ctime برون‌بری نمی‌شوند.
دقت برچسب زمانی به ثانیه‌های کامل محدود است، نه دقت نانوثانیه‌ای که در حالت عادی توسط Borg پشتیبانی می‌شود.
.sp
گزینه \fB\-\-sparse\fP (آن‌گونه که در \fBborg extract\fP یافت می‌شود) پشتیبانی نمی‌شود.
.sp
به‌طور پیش‌فرض کل آرشیو استخراج می‌شود، اما می‌توان با ارسال فهرستی از \fBPATH\fPها به عنوان آرگومان، زیرمجموعه‌ای از فایل‌ها و پوشه‌ها را انتخاب کرد.
انتخاب فایل‌ها را می‌توان با استفاده از گزینه \fB\-\-exclude\fP بیشتر محدود کرد.
.sp
برای راهنمایی بیشتر درباره الگوهای گنجاندن/مستثنی‌کردن، خروجی دستور \fIborg_patterns\fP را ببینید.
.sp
گزینه \fB\-\-progress\fP می‌تواند از حالت بدون نمایش پیشرفت کندتر باشد، زیرا یک دور اضافی بر روی فراداده‌های آرشیو انجام می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.sp
برای مشاهده گزینه‌های عمومی دستورات Borg، به \fIborg\-common(1)\fP مراجعه کنید.
.SS "آرگومان‌ها (arguments)"
.INDENT 0.0
.TP
.B ARCHIVE
آرشیو برای برون‌بری
.TP
.B FILE
فایل tar خروجی. برای نوشتن در stdout به‌جای آن، \(dq\-\(dq را مشخص کنید.
.TP
.B PATH
مسیرهایی برای استخراج؛ از الگوها پشتیبانی می‌شود
.UNINDENT
.SS "گزینه‌ها (options)"
.INDENT 0.0
.TP
.B  \-\-tar\-filter
برنامه فیلتر برای هدایت داده‌ها از طریق پایپ
.TP
.B  \-\-list
خروجی فهرست پرجزئیات از موارد (فایل‌ها، پوشه‌ها و...)
.UNINDENT
.SS "گزینه‌های گنجاندن/مستثنی‌کردن (Include/Exclude options)"
.INDENT 0.0
.TP
.BI \-e \ PATTERN\fR,\fB \ \-\-exclude \ PATTERN
مستثنی کردن مسیرهای منطبق بر PATTERN
.TP
.BI \-\-exclude\-from \ EXCLUDEFILE
خواندن الگوهای استثنا از EXCLUDEFILE، یک الگو در هر خط
.TP
.BI \-\-pattern \ PATTERN
گنجاندن/مستثنی کردن مسیرهای منطبق بر PATTERN
.TP
.BI \-\-patterns\-from \ PATTERNFILE
خواندن الگوهای گنجاندن/استثنا از PATTERNFILE، یک الگو در هر خط
.TP
.BI \-\-strip\-components \ NUMBER
حذف تعداد مشخص‌شده‌ای از عناصر ابتدایی مسیر. مسیرهایی با عناصر کمتر بدون اعلان رد خواهند شد.
.UNINDENT
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# برون‌بری به عنوان یک tar غیرفشرده.
$ borg export\-tar /path/to/repo::Monday Monday.tar

# مستثنی کردن برخی انواع؛ فشرده‌سازی با استفاده از gzip.
$ borg export\-tar /path/to/repo::Monday Monday.tar.gz \-\-exclude \(aq*.so\(aq

# استفاده از سطح فشرده‌سازی بالاتر با gzip.
$ borg export\-tar \-\-tar\-filter=\(dqgzip \-9\(dq testrepo::linux Monday.tar.gz

# برون‌بری یک tar، اما به جای ذخیره روی دیسک،
# بارگذاری آن در یک سایت راه دور با استفاده از curl.
$ borg export\-tar /path/to/repo::Monday \- | curl \-\-data\-binary @\- https://somewhere/to/POST

# استخراج از راه دور از طریق \(dqtarpipe\(dq.
$ borg export\-tar /path/to/repo::Monday \- | ssh somewhere \(dqcd extracted; tar x\(dq
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fIborg\-common(1)\fP
.SH "نویسندگان (Author)"
The Borg Collective
.\" End of generated man page.