نام (NAME)

borg-export-tar - برون‌بری محتویات آرشیو به عنوان فایل tar

خلاصه دستور (SYNOPSIS)

borg [گزینه‌های عمومی] export-tar [گزینه‌ها] ARCHIVE FILE [PATH...]

توضیحات (DESCRIPTION)

این دستور یک فایل tar (تاربال) از یک آرشیو ایجاد می‌کند.

هنگام مشخص کردن '-' به‌عنوان FILE خروجی، Borg جریان tar را در خروجی استاندارد (stdout) می‌نویسد.

به‌طور پیش‌فرض (--tar-filter=auto)، Borg فشرده بودن یا نبودن FILE را بر اساس پسوند فایل آن تشخیص داده و تاربال را قبل از نوشتن در FILE از فیلتر مناسب عبور می‌دهد:

.tar.gz یا .tgz: gzip
.tar.bz2 یا .tbz: bzip2
.tar.xz یا .txz: xz
.tar.zstd یا .tar.zst: zstd
.tar.lz4: lz4

همچنین، می‌توان یک برنامه --tar-filter را به‌طور صریح مشخص کرد. این برنامه باید جریان tar فشرده‌نشده را از stdin خوانده و یک جریان tar فشرده/فیلترشده را در stdout بنویسد.

فایل tar تولیدشده از قالب GNU tar استفاده می‌کند.

دستور export-tar یک تبدیل اتلافی (lossy) است: پرچم‌های BSD، لیست‌های کنترل دسترسی (ACLها)، صفت‌های گسترده (xattrs)، و زمان‌های atime و ctime برون‌بری نمی‌شوند. دقت برچسب زمانی به ثانیه‌های کامل محدود است، نه دقت نانوثانیه‌ای که در حالت عادی توسط Borg پشتیبانی می‌شود.

گزینه --sparse (آن‌گونه که در borg extract یافت می‌شود) پشتیبانی نمی‌شود.

به‌طور پیش‌فرض کل آرشیو استخراج می‌شود، اما می‌توان با ارسال فهرستی از PATHها به عنوان آرگومان، زیرمجموعه‌ای از فایل‌ها و پوشه‌ها را انتخاب کرد. انتخاب فایل‌ها را می‌توان با استفاده از گزینه --exclude بیشتر محدود کرد.

برای راهنمایی بیشتر درباره الگوهای گنجاندن/مستثنی‌کردن، خروجی دستور borg_patterns را ببینید.

گزینه --progress می‌تواند از حالت بدون نمایش پیشرفت کندتر باشد، زیرا یک دور اضافی بر روی فراداده‌های آرشیو انجام می‌دهد.

گزینه‌ها (OPTIONS)

برای مشاهده گزینه‌های عمومی دستورات Borg، به borg-common(1) مراجعه کنید.

آرگومان‌ها (arguments)

ARCHIVE: آرشیو برای برون‌بری
FILE: فایل tar خروجی. برای نوشتن در stdout به‌جای آن، "-" را مشخص کنید.
PATH: مسیرهایی برای استخراج؛ از الگوها پشتیبانی می‌شود

گزینه‌ها (options)

--tar-filter: برنامه فیلتر برای هدایت داده‌ها از طریق پایپ
--list: خروجی فهرست پرجزئیات از موارد (فایل‌ها، پوشه‌ها و...)

گزینه‌های گنجاندن/مستثنی‌کردن (Include/Exclude options)

-e PATTERN, --exclude PATTERN: مستثنی کردن مسیرهای منطبق بر PATTERN
--exclude-from EXCLUDEFILE: خواندن الگوهای استثنا از EXCLUDEFILE، یک الگو در هر خط
--pattern PATTERN: گنجاندن/مستثنی کردن مسیرهای منطبق بر PATTERN
--patterns-from PATTERNFILE: خواندن الگوهای گنجاندن/استثنا از PATTERNFILE، یک الگو در هر خط
--strip-components NUMBER: حذف تعداد مشخص‌شده‌ای از عناصر ابتدایی مسیر. مسیرهایی با عناصر کمتر بدون اعلان رد خواهند شد.

مثال‌ها (EXAMPLES)

# برون‌بری به عنوان یک tar غیرفشرده.
$ borg export-tar /path/to/repo::Monday Monday.tar
# مستثنی کردن برخی انواع؛ فشرده‌سازی با استفاده از gzip.
$ borg export-tar /path/to/repo::Monday Monday.tar.gz --exclude '*.so'
# استفاده از سطح فشرده‌سازی بالاتر با gzip.
$ borg export-tar --tar-filter="gzip -9" testrepo::linux Monday.tar.gz
# برون‌بری یک tar، اما به جای ذخیره روی دیسک،
# بارگذاری آن در یک سایت راه دور با استفاده از curl.
$ borg export-tar /path/to/repo::Monday - | curl --data-binary @- https://somewhere/to/POST
# استخراج از راه دور از طریق "tarpipe".
$ borg export-tar /path/to/repo::Monday - | ssh somewhere "cd extracted; tar x"

همچنین ببینید (SEE ALSO)

borg-common(1)

نویسندگان (Author)

The Borg Collective