| borg-import-tar(1) | ابزار پشتیبانگیری borg | borg-import-tar(1) |
نام (NAME)
borg-import-tar - ایجاد یک آرشیو پشتیبان از فایل tar
خلاصه دستور (SYNOPSIS)
borg [گزینههای عمومی] import-tar [گزینهها] ARCHIVE TARFILE
توضیحات (DESCRIPTION)
این دستور یک آرشیو پشتیبان از یک فایل tar (تاربال) ایجاد میکند.
هنگام مشخص کردن '-' بهعنوان مسیر، Borg جریان دادههای tar را از ورودی استاندارد (stdin) میخواند.
بهطور پیشفرض (--tar-filter=auto)، Borg فشرده بودن فایل را بر اساس پسوند آن تشخیص داده و آن را از فیلتر مناسب عبور میدهد:
- .tar.gz یا .tgz: gzip -d
- .tar.bz2 یا .tbz: bzip2 -d
- .tar.xz یا .txz: xz -d
- .tar.zstd یا .tar.zst: zstd -d
- .tar.lz4: lz4 -d
همچنین، میتوان یک برنامه --tar-filter را بهطور صریح مشخص کرد. این برنامه باید دادههای فشرده را از stdin خوانده و جریان tar غیرفشرده را در stdout خروجی دهد.
بیشتر مستندات borg create در اینجا نیز صدق میکند. توجه داشته باشید که این دستور از مستثنی کردن فایلها پشتیبانی نمیکند.
دستور import-tar یک تبدیل اتلافی (lossy) است: پرچمهای BSD، لیستهای کنترل دسترسی (ACLs)، ویژگیهای گسترشیافته (xattrs)، و زمانهای atime و ctime ذخیره نمیشوند. دقت برچسب زمانی به ثانیههای کامل محدود است، نه دقت نانوثانیهای که در حالت عادی توسط Borg پشتیبانی میشود.
گزینه --sparse (آنگونه که در borg create وجود دارد) پشتیبانی نمیشود.
دستور import-tar فرمتهای POSIX.1-1988 (ustar)، POSIX.1-2001 (pax)، GNU tar، UNIX V7 tar و SunOS tar همراه با ویژگیهای گسترشیافته را میخواند.
برای وارد کردن چندین فایل tar به درون یک آرشیو واحد، میتوان آنها را بهسادگی (مثلاً با استفاده از "cat") در یک فایل تجمیع کرد و با گزینه --ignore-zeros برای رد شدن از نشانگرهای توقف بین آنها وارد نمود.
گزینهها (OPTIONS)
برای مشاهده گزینههای عمومی دستورات Borg، به borg-common(1) مراجعه کنید.
آرگومانها (arguments)
گزینهها (options)
- --tar-filter
- برنامه فیلتر برای هدایت دادهها از طریق پایپ
- -s, --stats
- چاپ آمار برای آرشیو ایجادشده
- --quick-stats
- تنها چاپ آمار آرشیو، و صرفنظر از آمار کلی مخزن
- --list
- خروجی فهرست مفصل موارد (فایلها، پوشهها و...)
- --filter STATUSCHARS
- تنها نمایش مواردی با کاراکترهای وضعیت دادهشده
- --json
- خروجی آمار بهصورت JSON (شامل --stats)
- --ignore-zeros
- نادیده گرفتن بلوکهای پر شده با صفر در فایل tar ورودی
گزینههای آرشیو (Archive options)
- --comment COMMENT
- افزودن متن یادداشت به آرشیو
- --timestamp TIMESTAMP
- تنظیم دستی زمان/تاریخ ایجاد آرشیو (قالب UTC، بهصورت yyyy-mm-ddThh:mm:ss). همچنین میتوانید یک فایل/پوشه مرجع مشخص کنید.
- -c SECONDS, --checkpoint-interval SECONDS
- نوشتن نقطه بازرسی در هر SECONDS ثانیه (پیشفرض: ۱۸۰۰)
- --chunker-params PARAMS
- مشخص کردن پارامترهای قطعهبندی (ALGO, CHUNK_MIN_EXP, CHUNK_MAX_EXP, HASH_MASK_BITS, HASH_WINDOW_SIZE). پیشفرض: buzhash,19,23,21,4095
- -C COMPRESSION, --compression COMPRESSION
- انتخاب الگوریتم فشردهسازی، برای جزئیات به خروجی دستور "borg help compression" مراجعه کنید.
همچنین ببینید (SEE ALSO)
نویسندگان (Author)
The Borg Collective
| 2026-07-18 |