نام (NAME)

xdelta3 - ابزار تفاضل‌گیری دودویی VCDIFF (RFC 3284)

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

xdelta3 [command] [options] [input [output]]

توضیحات (DESCRIPTION)

xdelta3 ابزاری برای تفاضل‌گیری دودویی است که از قالب و فشرده‌سازی VCDIFF (RFC 3284) استفاده می‌کند.

دستورها (COMMANDS)

config: پیکربندی xdelta3 را چاپ می‌کند
decode: ورودی را از حالت فشرده خارج می‌کند؛ همچنین با -d تنظیم می‌شود
encode: ورودی را فشرده می‌کند؛ همچنین با -e تنظیم می‌شود (پیش‌فرض)
test: اجرای آزمون‌های توکار
printdelta: چاپ اطلاعات مربوط به کل دلتا
printhdr: چاپ اطلاعات مربوط به پنجرهٔ نخست
printhdrs: چاپ اطلاعات مربوط به تمام پنجره‌ها
recode: کدگذاری مجدد با تنظیمات جدید برنامه/ثانویه

گزینه‌ها (OPTIONS)

گزینه‌های استاندارد:

-0 .. -9: سطح فشرده‌سازی
-c: استفاده از خروجی استاندارد (stdout)
-d: خروج از حالت فشرده
-e: فشرده‌سازی
-f: اجبار در بازنویسی
-h: نمایش راهنما
-q: حالت بی‌صدا
-v: حالت پرگو (حداکثر ۲ بار)
-V: نمایش نسخه
گزینه‌های حافظه:
-B: bytes اندازهٔ پنجرهٔ مبدأ
-W: bytes اندازهٔ پنجرهٔ ورودی
-P: size پنجرهٔ تکرارهای فشرده‌سازی
-I: size اندازهٔ بافر دستورالعمل‌ها (۰ = نامحدود)
گزینه‌های فشرده‌سازی:
-s: source فایل مبدأ برای نسخه‌برداری از آن (در صورت وجود)
-S [djw]: فعال/غیرفعال‌سازی فشرده‌سازی ثانویه
-N: غیرفعال‌سازی فشرده‌سازی تطبیق رشته‌های کوتاه
-D: غیرفعال‌سازی فشرده‌گشایی خارجی (encode/decode)
-R: غیرفعال‌سازی فشرده‌سازی مجدد خارجی (decode)
-G: حذف سطح فشرده‌سازی خارجیِ شناسایی‌شده از سربرگ برنامه (در encode). به‌طور پیش‌فرض xdelta3 سطح فشرده‌سازی را ثبت می‌کند تا decode خروجی را به‌صورت بایت‌به‌بایت یکسان دوباره فشرده کند؛ -G یک سربرگ قدیمی (legacy) برنامه ایجاد می‌کند که نسخه‌های قدیمی‌تر xdelta3 همچنان می‌توانند آن را دوباره فشرده کنند.
-n: غیرفعال‌سازی بررسی مجموع مقابله‌ای (checksum) (در encode/decode)
-a: غیرفعال‌سازی حالت زره (armor). حالت زره (اعتبارسنجی کل فایل با BLAKE3) به‌طور پیش‌فرض فعال است. هنگام فعال بودن، xdelta3 چکیده‌های BLAKE3 مبدأ و مقصد را با استفاده از نحو name#blake3 در سربرگ برنامه جای‌گذاری می‌کند. در encode، این کار نیازمند مبدأ و مقصد با قابلیت جست‌وجو (seekable) است؛ در decode، مبدأ پیش از اعمال و مقصدِ بازسازی‌شده پس از آن اعتبارسنجی می‌شوند. اگر مبدأ یک جریان (غیرقابل جست‌وجو) باشد، امکان اعتبارسنجی آن وجود ندارد؛ بنابراین xdelta3 یک هشدار چاپ کرده و ادامه می‌دهد. اگر مبدأ ارائه‌شده از پیش با چکیدهٔ مقصد دلتا مطابقت داشته باشد – یعنی وصله از قبل اعمال شده است – عمل decode گزارش “already up to date” می‌دهد و با وضعیت خروج ۲ پایان می‌یابد. -a این قابلیت را غیرفعال کرده و قالب موروثی سربرگ برنامه و رفتار جریانی غیرقابل جست‌وجو را بازیابی می‌کند. دستور merge در صورتی که تمام ورودی‌ها زره‌پوش باشند، یک زنجیرهٔ زره‌پوش از دلتاها را اعتبارسنجی می‌کند. زره، محتوای منطقی (فشرده‌گشایی‌شده‌ای) را که xdelta3 پردازش می‌کند اعتبارسنجی می‌نماید؛ بنابراین به‌درستی با فشرده‌گشایی ورودی خارجی و فشرده‌سازی مجدد خروجی ترکیب می‌شود.
-C: پیکربندی نرم (encode، مستندنشده)
-A [apphead]: غیرفعال‌سازی/تعیین سربرگ برنامه (encode)
-J: غیرفعال‌سازی خروجی (فقط بررسی/محاسبه)
-T: استفاده از جدول کد جایگزین (test)

وضعیت خروج (EXIT STATUS)

0: موفقیت‌آمیز.
2: مبدأ دلتای زره‌پوشِ رمزگشایی‌شده از قبل با چکیدهٔ مقصد آن مطابقت دارد؛ وصله از پیش اعمال شده و کاری انجام نگرفت.
1: هر خطای دیگر.

نکات (NOTES)

هنگامی که xdelta3 به‌طور خودکار یک ورودی فشرده‌شده به‌صورت خارجی (bzip2، gzip، xz، یا compress) را فشرده‌گشایی می‌کند، سطح فشرده‌سازی شناسایی‌شده را در سربرگ برنامه ثبت کرده و هنگام decode آن را به ابزار فشرده‌سازی مجدد منتقل می‌کند تا خروجی دوباره فشرده‌شده، سطح فشرده‌سازی اولیه را بازتولید کند. سطح اندازهٔ بلوک bzip2 به‌طور دقیق بازیابی می‌شود؛ سطوح gzip و xz بر اساس بیشترین تلاش از روی سربرگ جریان حدس زده می‌شوند و در صورتی که سطح دقیق قابل تشخیص نباشد، ممکن است مقدار پیش‌فرض قالب انتخاب شود. این امر موجب می‌شود فیلد فشرده‌ساز در سربرگ برنامه (B, G, Z, Y) به‌صورت اختیاری حامل یک رقم سطح در انتها باشد، مانند B9. از -R برای غیرفعال‌سازی فشرده‌سازی مجدد، از -D برای غیرفعال‌سازی کامل فشرده‌گشایی، یا از -G برای حذف سطح از سربرگ جهت سازگاری با نسخه‌های قدیمی‌تر استفاده کنید.

متغیر محیطی XDELTA می‌تواند شامل آرگومان‌های اضافه باشد:

XDELTA="-s source-x.y.tar.gz" \
tar --use-compress-program=xdelta3 -cf \
target-x.z.tar.gz.vcdiff target-x.y/

مثال‌ها (EXAMPLES)

فشرده‌سازی تفاوت‌های میان SOURCE و TARGET و تولید OUT، با استفاده از فشرده‌سازی ثانویهٔ “djw”:

xdelta3 -S djw -s SOURCE TARGET OUT

انجام همین کار با استفاده از ورودی و خروجی استاندارد:

xdelta3 -S djw -s SOURCE < TARGET > OUT

برای فشرده‌گشایی OUT با استفاده از SOURCE و تولید TARGET:

xdelta3 -d -s SOURCE OUT TARGET

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

برنامهٔ xdelta3 توسط Josh MacDonald <josh.macdonald@gmail.com> نوشته شده است.

این صفحهٔ راهنما توسط Leo 'costela' Antunes <costela@debian.org> برای پروژهٔ دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).