.nh
.TH "desync" "1" "سپتامبر 2026" "desync" ""

.SH "نام (NAME)"
desync-extract \- خواندن یک فایل نمایه و ساخت داده خام (blob) از روی آن

.SH "خلاصه دستور (SYNOPSIS)"
\fBdesync extract <index> <output> [flags]\fP

.SH "توضیحات (DESCRIPTION)"
یک نمایه (index) را می‌خواند و با خواندن تکه‌ها (chunks) از یک یا چند مخزن تکه، یک blob می‌سازد. از '-' برای خواندن نمایه از STDIN استفاده کنید.

.PP
هنگام استفاده از \-k، فایل blob در همان محل و با بهره‌گیری از داده‌های موجود استخراج می‌شود و در صورت بروز خطا، فایل مقصد حذف نخواهد شد. این قابلیت می‌تواند برای شروع مجدد یک عملیات استخراج ناموفق پیشین بدون نیاز به بارگیری دوباره تکه‌های کامل‌شده استفاده شود.

.PP
چندین نمایه بذر (seed) اختیاری می‌توانند با \-\-seed مشخص شوند. فایل blob منطبق باید همان نام فایل نمایه را بدون پسوند .caibx داشته باشد. اگر داده‌های blob در مکان دیگری قرار داشته باشند، یا نام متفاوتی داشته باشند، مسیر می‌تواند با افزودن دو نقطه و مسیر داده به مسیر نمایه به طور صریح تعیین شود، مانند \-\-seed <index>:<blob>. اگر چندین فایل بذر و نمایه در دسترس باشند، گزینه \-\-seed\-dir می‌تواند برای انتخاب خودکار تمام فایل‌های .caibx در یک دایرکتوری به عنوان بذر استفاده شود، با این انتظار که blobهای منطبق در کنار آن‌ها قرار دارند.

.PP
اگر یک بذر نامعتبر باشد، عملیات استخراج به‌طور پیش‌فرض متوقف می‌شود. با \-\-skip\-invalid\-seeds، بذرهای نامعتبر نادیده گرفته شده و استخراج بدون آن‌ها ادامه می‌یابد. از طرف دیگر، \-\-regenerate\-invalid\-seeds نمایه‌های بذر نامعتبر را در حافظه از روی داده‌های در دسترس بازتولید می‌کند؛ نه داده‌ها و نه نمایه‌ها روی دیسک تغییر نمی‌کنند. همچنین، اگر یک بذر در حین پردازش تغییر کند، تکه‌های نامعتبر آن به جای متوقف کردن عملیات، از خود بذر یا مخزن گرفته خواهند شد.

.SH "گزینه‌ها (OPTIONS)"
\fB\-\-ca\-cert\fP=""
	اعتبار مراجع صدور گواهی در این فایل، به جای مخزن امنیتی سیستم‌عامل

.PP
\fB\-c\fP, \fB\-\-cache\fP=""
	مخزنی که به عنوان حافظه موقت (کَش) استفاده می‌شود

.PP
\fB\-r\fP, \fB\-\-cache\-repair\fP[=true]
	جایگزینی تکه‌های نامعتبر موجود در کَش از منبع اصلی

.PP
\fB\-\-client\-cert\fP=""
	مسیر گواهی کلاینت برای احراز هویت TLS

.PP
\fB\-\-client\-key\fP=""
	مسیر کلید کلاینت برای احراز هویت TLS

.PP
\fB\-n\fP, \fB\-\-concurrency\fP=10
	تعداد گوروتین‌های (goroutines) همزمان

.PP
\fB\-e\fP, \fB\-\-error\-retry\fP=3
	تعداد دفعات تلاش مجدد در صورت خطای شبکه

.PP
\fB\-b\fP, \fB\-\-error\-retry\-base\-interval\fP=500ms
	تاخیر اولیه تلاش مجدد، که با هر تلاش بعدی به صورت خطی افزایش می‌یابد

.PP
\fB\-h\fP, \fB\-\-help\fP[=false]
	راهنمای دستور extract

.PP
\fB\-k\fP, \fB\-\-in\-place\fP[=false]
	استخراج فایل در محل و نگه داشتن آن در صورت بروز خطا

.PP
\fB\-\-print\-stats\fP[=false]
	چاپ آمار استخراج در stdout پس از پایان کار

.PP
\fB\-\-regenerate\-invalid\-seeds\fP[=false]
	بازتولید نمایه‌های بذر با تکه‌های نامعتبر

.PP
\fB\-\-seed\fP=[]
	نمایه‌های بذر (seed indexes)

.PP
\fB\-\-seed\-dir\fP=[]
	دایرکتوری حاوی فایل‌های نمایه بذر

.PP
\fB\-\-skip\-invalid\-seeds\fP[=false]
	صرف‌نظر کردن از بذرهای دارای تکه‌های نامعتبر

.PP
\fB\-s\fP, \fB\-\-store\fP=[]
	مخزن یا مخازن منبع

.PP
\fB\-t\fP, \fB\-\-trust\-insecure\fP[=false]
	اعتماد به گواهی‌های نامعتبر

.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB\-\-config\fP=""
	فایل پیکربندی (پیش‌فرض $HOME/.config/desync/config.json)

.PP
\fB\-\-digest\fP="sha512-256"
	الگوریتم خلاصه پیام (digest)، sha512-256 یا sha256

.PP
\fB\-\-verbose\fP[=false]
	حالت پرحرف (verbose)

.SH "مثال‌ها (EXAMPLES)"
.EX
  desync extract -s http://192.168.1.1 -c /path/to/local file.caibx largefile.bin
  desync extract -s /mnt/store -s /tmp/other/store file.tar.caibx file.tar
  desync extract -s /mnt/store --seed /mnt/v1.caibx v2.caibx v2.vmdk
  desync extract -s /mnt/store --seed /tmp/v1.caibx:/mnt/v1 v2.caibx v2.vmdk
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBdesync(1)\fP

.SH "تاریخچه (HISTORY)"
۵ سپتامبر ۲۰۲۶، تولید خودکار توسط spf13/cobra