.\" 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-extract" "1" "2026-07-18" "" "ابزار پشتیبان‌گیری borg"
.SH "نام (NAME)"
borg-extract \- استخراج محتویات یک آرشیو پشتیبان
.SH "خلاصه دستور (SYNOPSIS)"
.sp
borg [گزینه‌های عمومی] extract [گزینه‌ها] ARCHIVE [PATH...]
.SH "توضیحات (DESCRIPTION)"
.sp
این دستور محتویات یک آرشیو را استخراج می‌کند.
.sp
به‌طور پیش‌فرض، کل آرشیو استخراج می‌شود، اما می‌توان با ارسال فهرستی از آرگومان‌های
\fBPATH\fP
زیرمجموعه‌ای از فایل‌ها و دایرکتوری‌ها را انتخاب کرد. تفسیر پیش‌فرض برای مسیرهای استخراج
\fIpp:\fP
است که تطابق دقیق پیشوند مسیر را انجام می‌دهد. اگر می‌خواهید مثلاً از کاراکترهای عام (wildcard) استفاده کنید، باید سبک الگوی متفاوتی مانند
\fIsh:\fP
یا
\fIfm:\fP\&
را انتخاب کنید. برای اطلاعات بیشتر به
\fIborg_patterns\fP
مراجعه کنید.
.sp
انتخاب فایل‌ها را می‌توان با استفاده از گزینه
\fB\-\-exclude\fP
بیشتر محدود کرد. برای راهنمایی بیشتر درباره الگوهای گنجاندن/مستثنی‌کردن، خروجی دستور
\fIborg_patterns\fP
را ببینید.
.sp
با استفاده از
\fB\-\-dry\-run\fP\c
، می‌توانید تمام مراحل استخراج را بدون نوشتن واقعی داده‌های خروجی انجام دهید: خواندن فراداده‌ها و قطعات داده از مخزن، بررسی هش/HMAC، رمزگشایی، و از حالت فشرده خارج کردن.
.sp
گزینه
\fB\-\-progress\fP
می‌تواند از حالت بدون نمایش پیشرفت کندتر باشد، زیرا یک دور اضافی بر روی فراداده‌های آرشیو انجام می‌دهد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
در حال حاضر، دستور extract همیشه داده‌ها را در دایرکتوری کاری جاری (\(dq.\(dq) می‌نویسد، بنابراین مطمئن شوید قبل از فراخوانی
\fBborg extract\fP\&
با دستور
\fBcd\fP
به مکان مناسب رفته‌اید.
.sp
هنگامی که دایرکتوری‌های والد استخراج نمی‌شوند (به دلیل استفاده از انتخاب فایل/دایرکتوری یا هر دلیل دیگری)، Borg نمی‌تواند فراداده‌های دایرکتوری‌های والد مانند مالک، گروه، مجوزها و غیره را بازیابی کند.
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.sp
برای مشاهده گزینه‌های عمومی دستورات Borg، به
\fIborg\-common(1)\fP
مراجعه کنید.
.SS "آرگومان‌ها (arguments)"
.INDENT 0.0
.TP
.B ARCHIVE
آرشیو مورد نظر برای استخراج
.TP
.B PATH
مسیرهایی برای استخراج؛ از الگوها پشتیبانی می‌شود
.UNINDENT
.SS "گزینه‌ها (options)"
.INDENT 0.0
.TP
.B  \-\-list
خروجی فهرست پرجزئیات از موارد (فایل‌ها، دایرکتوری‌ها و...)
.TP
.B  \-n\fP,\fB  \-\-dry\-run
هیچ تغییری در عمل در فایل‌ها داده نشود (اجرای آزمایشی)
.TP
.B  \-\-numeric\-owner
منسوخ شده است، به جای آن از \fB\-\-numeric\-ids\fP استفاده کنید
.TP
.B  \-\-numeric\-ids
صرفاً رعایت شناسه‌های عددی کاربر و گروه
.TP
.B  \-\-nobsdflags
منسوخ شده است، به جای آن از \fB\-\-noflags\fP استفاده کنید
.TP
.B  \-\-noflags
پرچم‌ها (مانند NODUMP و IMMUTABLE) استخراج یا تنظیم نشوند
.TP
.B  \-\-noacls
لیست‌های کنترل دسترسی (ACLها) استخراج یا تنظیم نشوند
.TP
.B  \-\-noxattrs
صفت‌های گسترده (xattrs) استخراج یا تنظیم نشوند
.TP
.B  \-\-stdout
نوشتن تمام داده‌های استخراج‌شده در خروجی استاندارد (stdout)
.TP
.B  \-\-sparse
ایجاد حفره در فایل تنک خروجی (sparse file) از قطعات کاملاً صفر
.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
# استخراج کامل آرشیو
$ borg extract /path/to/repo::my\-files

# استخراج کامل آرشیو و فهرست کردن فایل‌ها در حین پردازش
$ borg extract \-\-list /path/to/repo::my\-files

# بررسی اینکه آیا آرشیو با موفقیت قابل استخراج است یا خیر، بدون نوشتن فایل‌ها روی دیسک
$ borg extract \-\-dry\-run /path/to/repo::my\-files

# استخراج دایرکتوری \(dqsrc\(dq
$ borg extract /path/to/repo::my\-files home/USERNAME/src

# استخراج دایرکتوری \(dqsrc\(dq اما بدون فایل‌های شیء (object files)
$ borg extract /path/to/repo::my\-files home/USERNAME/src \-\-exclude \(aq*.o\(aq

# استخراج فقط فایل‌های C
$ borg extract /path/to/repo::my\-files \(aqsh:home/USERNAME/src/*.c\(aq

# بازیابی یک دستگاه خام (raw device) (نباید در آن زمان فعال/در حال استفاده/متصل باشد)
$ borg extract \-\-stdout /path/to/repo::my\-sdx | dd of=/dev/sdx bs=10M
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fIborg\-common(1)\fP, \fIborg\-mount(1)\fP
.SH "نویسندگان (Author)"
The Borg Collective
.\" End of generated man page.