.nh
.TH "desync" "1" "Sep 2026" "desync" ""

.SH "نام (NAME)"
desync-tar \- ذخیره ساختار درختی دایرکتوری در یک بایگانی catar یا نمایه


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


.SH "توضیحات (DESCRIPTION)"
یک ساختار درختی دایرکتوری را در قالب یک بایگانی catar یا به صورت یک فایل نمایه همراه با قطعه‌بندی بایگانی در یک مخزن، کدگذاری می‌کند. برای نوشتن خروجی (catar یا نمایه) در خروجی استاندارد (STDOUT) از '-' استفاده کنید.

.PP
اگر خروجی مورد نظر به جای catar یک فایل نمایه (caidx) باشد، می‌توان گزینه \fB-i\fP را همراه با یک مخزن مشخص کرد. استفاده از \fB-i\fP معادل این است که ابتدا با دستور tar یک بایگانی catar ایجاد کرده و سپس با دستور make آن را درون مخزن قطعه‌بندی کرده و فایل نمایه تولید کنید. با گزینه \fB-i\fP، به دلیل ایجاد نشدن فایل واسط catar، فضای کمتری از دیسک اشغال می‌شود. با این حال بسته به اندازه فایل، ممکن است تفاوتی در عملکرد وجود داشته باشد.

.PP
به طور پیش‌فرض، ورودی از دیسک محلی خوانده می‌شود. با استفاده از \fB--input-format=tar\fP، ورودی می‌تواند یک فایل tar یا جریانی از ورودی استاندارد (STDIN) با '-' باشد.


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

.PP
\fB-r\fP, \fB--cache-repair\fP[=true]
	جایگزینی قطعات نامعتبر در حافظه موقت (cache) از منبع

.PP
\fB-m\fP, \fB--chunk-size\fP="16:64:256"
	حداقل:میانگین:حداکثر اندازه هر قطعه بر حسب کیلوبایت

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

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

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

.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]
	راهنمای دستور tar

.PP
\fB-i\fP, \fB--index\fP[=false]
	ایجاد فایل نمایه (caidx)، نه فایل catar

.PP
\fB--input-format\fP="disk"
	قالب ورودی، 'disk' یا 'tar'

.PP
\fB--no-time\fP[=false]
	تنظیم برچسب‌های زمانی فایل‌ها روی صفر در بایگانی

.PP
\fB-x\fP, \fB--one-file-system\fP[=false]
	عدم عبور از مرزهای سیستم فایل

.PP
\fB-s\fP, \fB--store\fP=""
	مخزن مقصد (استفاده‌شده همراه با \fB-i\fP)

.PP
\fB--tar-add-root\fP[=false]
	در نظر گرفتن یک دایرکتوری ریشه مشترک برای تمام عناصر tar

.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]
	حالت پرگو (اطلاعات تفصیلی)


.SH "مثال (EXAMPLE)"
.EX
  desync tar documents.catar $HOME/Documents
  desync tar -i -s /path/to/local pics.caidx $HOME/Pictures
.EE


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


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