نام (NAME)

borg-extract - استخراج محتویات یک آرشیو پشتیبان

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

borg [گزینه‌های عمومی] extract [گزینه‌ها] ARCHIVE [PATH...]

توضیحات (DESCRIPTION)

این دستور محتویات یک آرشیو را استخراج می‌کند.

به‌طور پیش‌فرض، کل آرشیو استخراج می‌شود، اما می‌توان با ارسال فهرستی از آرگومان‌های PATH زیرمجموعه‌ای از فایل‌ها و دایرکتوری‌ها را انتخاب کرد. تفسیر پیش‌فرض برای مسیرهای استخراج pp: است که تطابق دقیق پیشوند مسیر را انجام می‌دهد. اگر می‌خواهید مثلاً از کاراکترهای عام (wildcard) استفاده کنید، باید سبک الگوی متفاوتی مانند sh: یا fm: را انتخاب کنید. برای اطلاعات بیشتر به borg_patterns مراجعه کنید.

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

با استفاده از --dry-run، می‌توانید تمام مراحل استخراج را بدون نوشتن واقعی داده‌های خروجی انجام دهید: خواندن فراداده‌ها و قطعات داده از مخزن، بررسی هش/HMAC، رمزگشایی، و از حالت فشرده خارج کردن.

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

نکته:

در حال حاضر، دستور extract همیشه داده‌ها را در دایرکتوری کاری جاری (".") می‌نویسد، بنابراین مطمئن شوید قبل از فراخوانی borg extract با دستور cd به مکان مناسب رفته‌اید.

هنگامی که دایرکتوری‌های والد استخراج نمی‌شوند (به دلیل استفاده از انتخاب فایل/دایرکتوری یا هر دلیل دیگری)، Borg نمی‌تواند فراداده‌های دایرکتوری‌های والد مانند مالک، گروه، مجوزها و غیره را بازیابی کند.

گزینه‌ها (OPTIONS)

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

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

ARCHIVE: آرشیو مورد نظر برای استخراج
PATH: مسیرهایی برای استخراج؛ از الگوها پشتیبانی می‌شود

گزینه‌ها (options)

--list: خروجی فهرست پرجزئیات از موارد (فایل‌ها، دایرکتوری‌ها و...)
-n, --dry-run: هیچ تغییری در عمل در فایل‌ها داده نشود (اجرای آزمایشی)
--numeric-owner: منسوخ شده است، به جای آن از --numeric-ids استفاده کنید
--numeric-ids: صرفاً رعایت شناسه‌های عددی کاربر و گروه
--nobsdflags: منسوخ شده است، به جای آن از --noflags استفاده کنید
--noflags: پرچم‌ها (مانند NODUMP و IMMUTABLE) استخراج یا تنظیم نشوند
--noacls: لیست‌های کنترل دسترسی (ACLها) استخراج یا تنظیم نشوند
--noxattrs: صفت‌های گسترده (xattrs) استخراج یا تنظیم نشوند
--stdout: نوشتن تمام داده‌های استخراج‌شده در خروجی استاندارد (stdout)
--sparse: ایجاد حفره در فایل تنک خروجی (sparse file) از قطعات کاملاً صفر

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

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

مثال‌ها (EXAMPLES)

# استخراج کامل آرشیو
$ borg extract /path/to/repo::my-files
# استخراج کامل آرشیو و فهرست کردن فایل‌ها در حین پردازش
$ borg extract --list /path/to/repo::my-files
# بررسی اینکه آیا آرشیو با موفقیت قابل استخراج است یا خیر، بدون نوشتن فایل‌ها روی دیسک
$ borg extract --dry-run /path/to/repo::my-files
# استخراج دایرکتوری "src"
$ borg extract /path/to/repo::my-files home/USERNAME/src
# استخراج دایرکتوری "src" اما بدون فایل‌های شیء (object files)
$ borg extract /path/to/repo::my-files home/USERNAME/src --exclude '*.o'
# استخراج فقط فایل‌های C
$ borg extract /path/to/repo::my-files 'sh:home/USERNAME/src/*.c'
# بازیابی یک دستگاه خام (raw device) (نباید در آن زمان فعال/در حال استفاده/متصل باشد)
$ borg extract --stdout /path/to/repo::my-sdx | dd of=/dev/sdx bs=10M

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

borg-common(1), borg-mount(1)

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

The Borg Collective