.\" t .\" .\" Author: Lasse Collin .\" .\" This file has been put into the public domain. .\" You can do whatever you want with this file. .\" .TH XZ 1 "2022-12-01" "Tukaani" "XZ Utils" . .SH "نام (NAME)" xz, unxz, xzcat, lzma, unlzma, lzcat \- فشرده‌سازی یا بازگشایی فایل‌های .xz و .lzma . .SH "خلاصه دستور (SYNOPSIS)" .B xz .RI [ option... ] .RI [ file... ] . .SH "نام‌های مستعار دستور (COMMAND ALIASES)" .B unxz معادل است با .BR "xz \-\-\decompress" . .br .B xzcat معادل است با .BR "xz \-\-\decompress \-\-\stdout" . .br .B lzma معادل است با .BR "xz \-\-\format=lzma" . .br .B unlzma معادل است با .BR "xz \-\-\format=lzma \-\-\decompress" . .br .B lzcat معادل است با .BR "xz \-\-\format=lzma \-\-\decompress \-\-\stdout" . .PP هنگام نوشتن اسکریپت‌هایی که نیاز به بازگشایی فایل‌ها دارند، توصیه می‌شود همیشه از نام .B xz با آرگومان‌های مناسب .RB ( "xz \-d" یا .BR "xz \-dc" ) به جای نام‌های .B unxz و .B xzcat استفاده شود. . .SH "توضیحات (DESCRIPTION)" دستور .B xz یک ابزار همه‌منظوره برای فشرده‌سازی داده‌ها با نحوی در خط فرمان شبیه به .BR gzip (1) و .BR bzip2 (1) است. قالب فایل بومی آن قالب .B .xz است، اما قالب قدیمی .B .lzma مورد استفاده توسط LZMA Utils و جریان‌های خام فشرده بدون سرایندهای قالب ظرف نیز پشتیبانی می‌شوند. علاوه بر این، بازگشایی فشرده‌سازی قالب .B .lz مورد استفاده توسط .B lzip پشتیبانی می‌شود. .PP دستور .B xz هر .I file را بر اساس حالت عملیات انتخاب‌شده فشرده یا بازگشایی می‌کند. اگر هیچ .IR file \(hyی مشخص نشود یا اگر .I file برابر با .B \- باشد، .B xz از ورودی استاندارد می‌خواند و داده‌های پردازش‌شده را در خروجی استاندارد می‌نویسد. اگر خروجی استاندارد یک ترمینال باشد، .B xz از نوشتن داده‌های فشرده‌شده در آن خودداری می‌کند (یک خطا نمایش می‌دهد و از .I file صرف‌نظر می‌کند). به همین ترتیب، .B xz از خواندن داده‌های فشرده‌شده از ورودی استاندارد در صورتی که ترمینال باشد خودداری خواهد کرد. .PP مگر اینکه .B \-\-\stdout مشخص شده باشد، .IR file \(hyهای دیگری غیر از .B \- در فایل جدیدی نوشته می‌شوند که نام آن از نام .I file منبع مشتق می‌شود: .IP \(bu 3 هنگام فشرده‌سازی، پسوند قالب فایل مقصد .RB ( .xz یا .BR .lzma ) به انتهای نام فایل منبع افزوده می‌شود تا نام فایل مقصد به دست آید. .IP \(bu 3 هنگام بازگشایی، پسوند .BR .xz ، .BR .lzma یا .B .lz از انتهای نام فایل حذف می‌شود تا نام فایل مقصد به دست آید. همچنین .B xz پسوندهای .B .txz و .B .tlz را می‌شناسد و آن‌ها را با پسوند .B .tar جایگزین می‌کند. .PP اگر فایل مقصد از قبل وجود داشته باشد، یک خطا نمایش داده شده و از .I file صرف‌نظر می‌شود. .PP مگر در صورت نوشتن در خروجی استاندارد، .B xz یک هشدار نمایش می‌دهد و در صورت برقراری هر یک از شرایط زیر از .I file صرف‌نظر می‌کند: .IP \(bu 3 مورد .I File یک فایل معمولی نباشد. پیوندهای نمادین دنبال نمی‌شوند، و بنابراین فایل معمولی در نظر گرفته نمی‌شوند. .IP \(bu 3 مورد .I File بیش از یک پیوند سخت داشته باشد. .IP \(bu 3 مورد .I File دارای بیت‌های setuid، setgid یا sticky تنظیم‌شده باشد. .IP \(bu 3 حالت عملیات روی فشرده‌سازی تنظیم شده باشد و .I file از قبل پسوند قالب فایل مقصد را داشته باشد .RB ( .xz یا .B .txz هنگام فشرده‌سازی به قالب .BR .xz ، و .B .lzma یا .B .tlz هنگام فشرده‌سازی به قالب .BR .lzma ). .IP \(bu 3 حالت عملیات روی بازگشایی تنظیم شده باشد و .I file پسوند هیچ‌یک از قالب‌های فایل پشتیبانی‌شده را نداشته باشد .RB ( .xz ، .BR .txz ، .BR .lzma ، .BR .tlz یا .BR .lz ). .PP پس از فشرده‌سازی یا بازگشایی موفقیت‌آمیز .IR file ، دستور .B xz مالک، گروه، مجوزها، زمان دسترسی و زمان تغییر را از .I file منبع به فایل مقصد کپی می‌کند. اگر کپی گروه ناموفق باشد، مجوزها به گونه‌ای اصلاح می‌شوند که فایل مقصد برای کاربرانی که اجازه دسترسی به .I file منبع را نداشتند، قابل دسترس نشود. دستور .B xz هنوز از کپی فراداده‌های دیگر مانند فهرست‌های کنترل دسترسی (ACL) یا ویژگی‌های توسعه‌یافته پشتیبانی نمی‌کند. .PP پس از بسته شدن موفقیت‌آمیز فایل مقصد، .I file منبع حذف می‌شود مگر اینکه .B \-\-\keep مشخص شده باشد. اگر خروجی در خروجی استاندارد نوشته شود یا اگر خطایی رخ دهد، .I file منبع هرگز حذف نمی‌شود. .PP ارسال سیگنال .B SIGINFO یا .B SIGUSR1 به فرایند .B xz باعث می‌شود اطلاعات پیشرفت کار در خطای استاندارد چاپ شود. این قابلیت کاربرد محدودی دارد زیرا هنگامی که خطای استاندارد یک ترمینال باشد، استفاده از .B \-\-\verbose یک نشانگر پیشرفت با به‌روزرسانی خودکار را نمایش می‌دهد. . .SS "میزان مصرف حافظه (Memory usage)" میزان مصرف حافظه .B xz بسته به تنظیمات فشرده‌سازی از چند صد کیلوبایت تا چندین گیگابایت متغیر است. تنظیمات استفاده‌شده هنگام فشرده‌سازی یک فایل، نیازمندی‌های حافظه بازگشا (decompressor) را تعیین می‌کند. به‌طور معمول بازگشا به ۵\ % تا ۲۰\ % از مقدار حافظه‌ای که فشرده‌ساز هنگام ایجاد فایل نیاز داشته است، احتیاج دارد. برای مثال، بازگشایی فایلی که با .B xz \-9 ایجاد شده در حال حاضر به ۶۵\ MiB حافظه نیاز دارد. با این وجود، ممکن است فایل‌های .B .xz وجود داشته باشند که برای بازگشایی به چندین گیگابایت حافظه نیاز داشته باشند. .PP به‌ویژه کاربران سامانه‌های قدیمی‌تر ممکن است احتمال مصرف بسیار بالای حافظه را آزاردهنده بدانند. برای جلوگیری از غافلگیری‌های ناخوشایند، .B xz یک محدودکننده توکار مصرف حافظه دارد که به‌طور پیش‌فرض غیرفعال است. اگرچه برخی سیستم‌عامل‌ها روش‌هایی برای محدود کردن مصرف حافظه فرایندها ارائه می‌دهند، اما اتکا به آن‌ها به اندازه کافی انعطاف‌پذیر دانسته نشد (برای مثال، استفاده از .BR ulimit (1) برای محدود کردن حافظه مجازی تمایل دارد کارکرد .BR mmap (2) را مختل کند). .PP محدودکننده مصرف حافظه را می‌توان با گزینه خط فرمان \fB\-\-\memlimit=\fIlimit\fR فعال کرد. اغلب راحت‌تر است که این محدودکننده با تنظیم متغیر محیطی .B XZ_DEFAULTS به‌طور پیش‌فرض فعال شود، برای مثال .BR XZ_DEFAULTS=\-\-\memlimit=150MiB . امکان تنظیم جداگانه محدودیت‌ها برای فشرده‌سازی و بازگشایی با استفاده از .BI \-\-\memlimit\-compress= limit و \fB\-\-\memlimit\-decompress=\fIlimit\fR وجود دارد. استفاده از این دو گزینه خارج از .B XZ_DEFAULTS به‌ندرت مفید است زیرا یک اجرای واحد از .B xz نمی‌تواند هم‌زمان هم فشرده‌سازی و هم بازگشایی را انجام دهد و تایپ .BI \-\-\memlimit= limit (یا .B \-M .IR limit ) در خط فرمان کوتاه‌تر است. .PP اگر سقف مصرف حافظه مشخص‌شده هنگام بازگشایی رد شود، .B xz یک خطا نمایش می‌دهد و بازگشایی فایل با شکست مواجه می‌شود. اگر سقف مصرف هنگام فشرده‌سازی رد شود، .B xz تلاش می‌کند تنظیمات را کاهش دهد تا محدودیت دیگر رد نشود (مگر هنگام استفاده از .B \-\-\format=raw یا .BR \-\-\no\-adjust ). به این ترتیب عملیات با شکست مواجه نخواهد شد مگر اینکه سقف تعیین‌شده بسیار کوچک باشد. کاهش مقیاس تنظیمات در مراحلی انجام می‌شود که با سطوح پیش‌تنظیم فشرده‌سازی مطابقت ندارند؛ برای مثال، اگر سقف فقط اندکی کمتر از مقدار مورد نیاز برای .BR "xz \-9" باشد، تنظیمات تنها کمی کاهش می‌یابند، نه اینکه تا حد .BR "xz \-8" پایین بیایند. . .SS "الحاق و فاصله‌گذاری در فایل‌های .xz (Concatenation and padding with .xz files)" امکان الحاق فایل‌های .B .xz به همان صورت اصلی وجود دارد. دستور .B xz چنین فایل‌هایی را طوری بازگشایی می‌کند که گویی یک فایل .B .xz واحد بوده‌اند. .PP امکان درج فاصله‌گذاری (padding) بین بخش‌های الحاق‌شده یا پس از آخرین بخش وجود دارد. فاصله‌گذاری باید شامل بایت‌های صفر (null) باشد و اندازه آن باید مضربی از چهار بایت باشد. این ویژگی برای مثال زمانی مفید است که فایل .B .xz روی رسانه‌ای ذخیره می‌شود که اندازه فایل را در بلوک‌های ۵۱۲ بایتی اندازه‌گیری می‌کند. .PP الحاق و درج فاصله‌گذاری برای فایل‌های .B .lzma یا جریان‌های خام مجاز نیست. . .SH "گزینه‌ها (OPTIONS)" . .SS "پسوندهای عدد صحیح و مقادیر ویژه (Integer suffixes and special values)" در بیشتر جاهایی که یک آرگومان از نوع عدد صحیح مورد انتظار است، یک پسوند اختیاری برای مشخص کردن آسان اعداد صحیح بزرگ پشتیبانی می‌شود. نباید هیچ فاصله‌ای بین عدد صحیح و پسوند وجود داشته باشد. .TP .B KiB ضرب عدد صحیح در ۱٬۰۲۴ (2^10). پسوندهای .BR Ki ، .BR k ، .BR kB ، .BR K و .B KB به عنوان مترادف‌های .B KiB پذیرفته می‌شوند. .TP .B MiB ضرب عدد صحیح در ۱٬۰۴۸٬۵۷۶ (2^20). پسوندهای .BR Mi ، .BR m ، .BR M و .B MB به عنوان مترادف‌های .B MiB پذیرفته می‌شوند. .TP .B GiB ضرب عدد صحیح در ۱٬۰۷۳٬۷۴۱٬۸۲۴ (2^30). پسوندهای .BR Gi ، .BR g ، .BR G و .B GB به عنوان مترادف‌های .B GiB پذیرفته می‌شوند. .PP مقدار ویژه .B max می‌تواند برای مشخص کردن حداکثر مقدار عدد صحیح پشتیبانی‌شده توسط گزینه استفاده شود. . .SS "حالت عملیات (Operation mode)" اگر چندین گزینه حالت عملیات مشخص شوند، آخرین گزینه اعمال می‌شود. .TP .BR \-z ", " \-\-\compress فشرده‌سازی. این حالت عملیات پیش‌فرض است هنگامی که هیچ گزینه حالت عملیاتی مشخص نشده باشد و حالت عملیات دیگری از نام دستور استنباط نشود (برای مثال، .B unxz حالت .B \-\-\decompress را تداعی می‌کند). .TP .BR \-d ", " \-\-\decompress ", " \-\-\uncompress بازگشایی فشرده‌سازی. .TP .BR \-t ", " \-\-\test آزمون یکپارچگی و صحت .IR file \(hyهای فشرده‌شده. این گزینه معادل با .B "\-\-\decompress \-\-\stdout" است، با این تفاوت که داده‌های بازگشایی‌شده به جای نوشته شدن در خروجی استاندارد، دور ریخته می‌شوند. هیچ فایلی ایجاد یا حذف نمی‌شود. .TP .BR \-l ", " \-\-\list چاپ اطلاعات درباره .IR file \(hyهای فشرده‌شده. هیچ خروجی بازگشایی‌شده‌ای تولید نمی‌شود، و هیچ فایلی ایجاد یا حذف نمی‌گردد. در حالت فهرست، برنامه نمی‌تواند داده‌های فشرده‌شده را از ورودی استاندارد یا از دیگر منابع فاقد قابلیت جستجو (unseekable) بخواند. .IP "" فهرست پیش‌فرض اطلاعات پایه‌ای درباره .IR file \(hyها را نمایش می‌دهد، هر فایل در یک سطر. برای دریافت اطلاعات دقیق‌تر، از گزینه .B \-\-\verbose نیز استفاده کنید. برای اطلاعات باز هم بیشتر، .B \-\-\verbose را دو بار به کار ببرید؛ اما توجه داشته باشید که این کار ممکن است کُند باشد، زیرا دریافت تمام اطلاعات اضافی نیازمند پیمایش‌های (seek) زیادی است. عرض خروجی پرجزئیات بیش از ۸۰ نویسه است، بنابراین هدایت خروجی به ابزارهایی مانند .B "less\ \-S" در صورتی که عرض ترمینال کافی نباشد، می‌تواند مناسب باشد. .IP "" خروجی دقیق ممکن است بین نسخه‌های .B xz و محلی‌سازی‌های (locales) مختلف متفاوت باشد. برای خروجی خوانا توسط ماشین، باید از .B \-\-\robot \-\-\list استفاده شود. . .SS "اصلاح‌کننده‌های عملیات (Operation modifiers)" .TP .BR \-k ", " \-\-\keep عدم حذف فایل‌های ورودی. .IP "" از نسخه .B xz 5.2.6، این گزینه همچنین باعث می‌شود .B xz حتی اگر ورودی یک پیوند نمادین به یک فایل معمولی باشد، بیش از یک پیوند سخت داشته باشد، یا دارای بیت‌های setuid، setgid یا sticky تنظیم‌شده باشد، فشرده‌سازی یا بازگشایی را انجام دهد. بیت‌های setuid، setgid و sticky به فایل مقصد کپی نمی‌شوند. در نسخه‌های پیشین این کار تنها با گزینه .B \-\-\force انجام می‌شد. .TP .BR \-f ", " \-\-\force این گزینه چندین اثر دارد: .RS .IP \(bu 3 اگر فایل مقصد از قبل وجود داشته باشد، پیش از فشرده‌سازی یا بازگشایی آن را حذف می‌کند. .IP \(bu 3 حتی اگر ورودی یک پیوند نمادین به یک فایل معمولی باشد، بیش از یک پیوند سخت داشته باشد، یا بیت‌های setuid، setgid یا sticky برای آن تنظیم شده باشد، فشرده‌سازی یا بازگشایی را انجام می‌دهد. بیت‌های setuid، setgid و sticky به فایل مقصد کپی نمی‌شوند. .IP \(bu 3 هنگامی که به همراه .B \-\-\decompress و .B \-\-\stdout استفاده شود و .B xz نتواند نوع فایل منبع را تشخیص دهد، فایل منبع را همان‌گونه که هست در خروجی استاندارد کپی می‌کند. این امر اجازه می‌دهد .B xzcat .B \-\-\force مانند .BR cat (1) برای فایل‌هایی که با .B xz فشرده نشده‌اند استفاده شود. توجه داشته باشید که در آینده، .B xz ممکن است از قالب‌های فشرده جدید پشتیبانی کند، که این امر ممکن است باعث شود .B xz انواع بیشتری از فایل‌ها را به جای کپی کردن مستقیم در خروجی استاندارد، بازگشایی کند. می‌توان از \BI\-\-\format=\fIformat\fR برای محدود کردن .B xz به بازگشایی تنها یک قالب فایل خاص استفاده کرد. .RE .TP .BR \-c ", " \-\-\stdout ", " \-\-\to\-stdout نوشتن داده‌های فشرده یا بازگشایی‌شده در خروجی استاندارد به جای فایل. این گزینه متضمن .B \-\-\keep است. .TP .B \-\-\single\-stream تنها اولین جریان .B .xz را بازگشایی می‌کند، و داده‌های ورودی باقی‌مانده احتمالی پس از جریان را نادیده می‌گیرد. معمولاً چنین داده‌های زباله پایانی باعث می‌شود .B xz یک خطا نمایش دهد. .IP "" دستور .B xz هرگز بیش از یک جریان را از فایل‌های .B .lzma یا جریان‌های خام بازگشایی نمی‌کند، اما این گزینه همچنان باعث می‌شود .B xz داده‌های اضافی احتمالی پس از فایل .B .lzma یا جریان خام را نادیده بگیرد. .IP "" اگر حالت عملیات روی .B \-\-\decompress یا .B \-\-\test تنظیم نشده باشد، این گزینه هیچ اثری ندارد. .TP .B \-\-\no\-sparse غیرفعال کردن ایجاد فایل‌های خلوت (sparse files). به‌طور پیش‌فرض، هنگام بازگشایی به یک فایل معمولی، .B xz در صورتی که داده‌های بازگشایی‌شده حاوی دنباله‌های طولانی از صفر باینری باشند، تلاش می‌کند فایل را خلوت بسازد. این کار هنگام نوشتن در خروجی استاندارد نیز تا زمانی که خروجی استاندارد به یک فایل معمولی متصل باشد و شرایط ایمنی معین برقرار باشد، کار می‌کند. ایجاد فایل‌های خلوت ممکن است با کاهش میزان ورودی/خروجی دیسک، در فضای دیسک صرفه‌جویی کرده و سرعت بازگشایی را افزایش دهد. .TP \fB\-S\fR \fI.suf\fR, \fB\-\-\suffix=\fI.suf\fR هنگام فشرده‌سازی، از .I .suf به عنوان پسوند فایل مقصد به جای .B .xz یا .B .lzma استفاده می‌کند. اگر در خروجی استاندارد نوشته نشود و فایل منبع از قبل پسوند .I .suf را داشته باشد، یک هشدار نمایش داده شده و از فایل صرف‌نظر می‌شود. .IP "" هنگام بازگشایی، فایل‌های دارای پسوند .I .suf را علاوه بر فایل‌های دارای پسوندهای .BR .xz ، .BR .txz ، .BR .lzma ، .B .tlz یا .B .lz تشخیص می‌دهد. اگر فایل منبع پسوند .I .suf را داشته باشد، این پسوند برای به دست آوردن نام فایل مقصد حذف می‌شود. .IP "" هنگام فشرده‌سازی یا بازگشایی جریان‌های خام .RB ( \-\-\format=raw )، پسوند باید همیشه مشخص شود مگر اینکه در خروجی استاندارد نوشته شود، زیرا هیچ پسوند پیش‌فرضی برای جریان‌های خام وجود ندارد. .TP \fB\-\-\files\fR[\fB=\fIfile\fR] خواندن نام فایل‌های مورد پردازش از .IR file ؛ اگر .I file حذف شود، نام فایل‌ها از ورودی استاندارد خوانده می‌شوند. نام فایل‌ها باید با نویسه خط جدید (newline) خاتمه یابند. یک خط فاصله .RB ( \- ) به عنوان نام یک فایل معمولی در نظر گرفته می‌شود و به معنی ورودی استاندارد نیست. اگر نام فایل‌ها به عنوان آرگومان‌های خط فرمان نیز داده شوند، پیش از نام فایل‌های خوانده‌شده از .I file پردازش می‌شوند. .TP \fB\-\-\files0\fR[\fB=\fIfile\fR] این گزینه کاملاً شبیه به \fB\-\-\files\fR[\fB=\fIfile\fR] است جز اینکه هر نام فایل باید با نویسه تهی (null) خاتمه یابد. . .SS "قالب پایه فایل و گزینه‌های فشرده‌سازی (Basic file format and compression options)" .TP \fB\-F\fR \fIformat\fR, \fB\-\-\format=\fIformat\fR تعیین .I format فایل برای فشرده‌سازی یا بازگشایی: .RS .TP .B auto این حالت پیش‌فرض است. هنگام فشرده‌سازی، .B auto معادل با .B xz است. هنگام بازگشایی، قالب فایل ورودی به‌طور خودکار تشخیص داده می‌شود. توجه داشته باشید که جریان‌های خام (ایجادشده با .BR \-\-\format=raw ) نمی‌توانند به‌طور خودکار تشخیص داده شوند. .TP .B xz فشرده‌سازی به قالب فایل .BR .xz ، یا پذیرش تنها فایل‌های .B .xz هنگام بازگشایی. .TP .BR lzma ", " alone فشرده‌سازی به قالب قدیمی فایل .BR .lzma ، یا پذیرش تنها فایل‌های .B .lzma هنگام بازگشایی. نام جایگزین .B alone برای سازگاری با نسخه‌های پیشین LZMA Utils ارائه شده است. .TP .B lzip پذیرش تنها فایل‌های .B .lz هنگام بازگشایی. فشرده‌سازی به این قالب پشتیبانی نمی‌شود. .IP "" نسخه 0 و نسخه توسعه‌نیافته 1 از قالب .B .lz پشتیبانی می‌شوند. فایل‌های نسخه 0 توسط .B lzip نسخه 1.3 و قدیمی‌تر تولید می‌شدند. چنین فایل‌هایی رایج نیستند اما ممکن است در آرشیوهای فایل یافت شوند، زیرا چند بسته کد منبع در این قالب منتشر شدند. همچنین ممکن است افراد فایل‌های شخصی قدیمی در این قالب داشته باشند. پشتیبانی از بازگشایی نسخه 0 در .B lzip 1.18 حذف شد. .IP "" دستور .B lzip 1.4 و بالاتر فایل‌هایی در نسخه 1 قالب ایجاد می‌کنند. افزونه نشانگر تخلیه همگام (sync flush marker) به نسخه 1 در .B lzip 1.6 اضافه شد. این افزونه به‌ندرت استفاده می‌شود و توسط .B xz پشتیبانی نمی‌شود (به عنوان ورودی خراب تشخیص داده می‌شود). .TP .B raw فشرده‌سازی یا بازگشایی یک جریان خام (بدون سرایند). این گزینه فقط برای کاربران پیشرفته در نظر گرفته شده است. برای رمزگشایی جریان‌های خام، باید از .B \-\-\format=raw استفاده کرده و زنجیره پالایه‌ها (filter chain) را به صراحت مشخص کنید؛ اطلاعاتی که در حالت عادی در سرایندهای ظرف ذخیره می‌شد. .RE .TP \fB\-C\fR \fIcheck\fR, \fB\-\-\check=\fIcheck\fR تعیین نوع بررسی یکپارچگی. مقدار بررسی از داده‌های فشرده‌نشده محاسبه شده و در فایل .B .xz ذخیره می‌شود. این گزینه تنها هنگام فشرده‌سازی به قالب .B .xz اثر دارد؛ قالب .B .lzma از بررسی یکپارچگی پشتیبانی نمی‌کند. بررسی یکپارچگی (در صورت وجود) هنگامی که فایل .B .xz بازگشایی می‌شود، راستی‌آزمایی می‌گردد. .IP "" انواع .I check پشتیبانی‌شده: .RS .TP .B none عدم محاسبه بررسی یکپارچگی. این معمولاً ایده بدی است. این گزینه در صورتی می‌تواند مفید باشد که یکپارچگی داده‌ها به روش‌های دیگر راستی‌آزمایی شود. .TP .B crc32 محاسبه CRC32 با استفاده از چندجمله‌ای استاندارد IEEE-802.3 (اتِرنت). .TP .B crc64 محاسبه CRC64 با استفاده از چندجمله‌ای ECMA-182. این حالت پیش‌فرض است، زیرا در تشخیص فایل‌های آسیب‌دیده اندکی بهتر از CRC32 عمل می‌کند و اختلاف سرعت آن ناچیز است. .TP .B sha256 محاسبه SHA-256. این گزینه تا حدی کُندتر از CRC32 و CRC64 است. .RE .IP "" یکپارچگی سرایندهای .B .xz همیشه با CRC32 بررسی می‌شود. تغییر یا غیرفعال کردن آن امکان‌پذیر نیست. .TP .B \-\-\ignore\-check هنگام بازگشایی، بررسی یکپارچگی داده‌های فشرده‌شده راستی‌آزمایی نشود. مقادیر CRC32 در سرایندهای .B .xz همچنان به‌طور عادی راستی‌آزمایی خواهند شد. .IP "" .B "از این گزینه استفاده نکنید مگر اینکه بدانید چه کار می‌کنید." دلایل احتمالی برای استفاده از این گزینه: .RS .IP \(bu 3 تلاش برای بازیابی داده‌ها از یک فایل خراب .xz. .IP \(bu 3 افزایش سرعت بازگشایی. این مورد بیشتر در خصوص SHA-256 یا فایل‌هایی که بسیار خوب فشرده شده‌اند اهمیت دارد. توصیه می‌شود برای این منظور از این گزینه استفاده نکنید مگر اینکه یکپارچگی فایل از روش دیگری به‌طور خارجی تأیید شده باشد. .RE .TP .BR \-0 " ... " \-9 انتخاب سطح پیش‌تنظیم فشرده‌سازی. مقدار پیش‌فرض .B \-6 است. اگر چندین سطح پیش‌تنظیم مشخص شوند، آخرین سطح اثرگذار خواهد بود. اگر یک زنجیره پالایه سفارشی از قبل مشخص شده باشد، تعیین سطح پیش‌تنظیم فشرده‌سازی زنجیره سفارشی را پاک می‌کند. .IP "" تفاوت‌های میان سطوح پیش‌تنظیم بسیار چشمگیرتر از .BR gzip (1) و .BR bzip2 (1) است. تنظیمات فشرده‌سازی انتخاب‌شده میزان حافظه مورد نیاز بازگشا را تعیین می‌کند، بنابراین استفاده از یک سطح بسیار بالا ممکن است بازگشایی فایل را در سامانه‌های قدیمی با رم کم دردسرساز کند. به‌ویژه، .B "ایده خوبی نیست که کورکورانه از \-9 برای همه‌چیز استفاده کنید" همان‌طور که اغلب در مورد .BR gzip (1) و .BR bzip2 (1) انجام می‌شود. .RS .TP .BR "\-0" " ... " "\-3" این‌ها سطوح نسبتاً سریع هستند. سطح .B \-0 گاهی اوقات سریع‌تر از .B "gzip \-9" است در حالی که بسیار بهتر فشرده می‌کند. سطوح بالاتر اغلب سرعتی قابل مقایسه با .BR bzip2 (1) با نسبت فشرده‌سازی مشابه یا بهتر دارند، گرچه نتایج بستگی زیادی به نوع داده‌های در حال فشرده‌سازی دارد. .TP .BR "\-4" " ... " "\-6" فشرده‌سازی خوب تا بسیار خوب در حالی که میزان مصرف حافظه بازگشا حتی برای سامانه‌های قدیمی در حد معقول حفظ می‌شود. سطح .B \-6 حالت پیش‌فرض است، که معمولاً انتخابی عالی برای توزیع فایل‌هایی است که باید حتی در سامانه‌هایی با تنها ۱۶\ MiB رم قابل بازگشایی باشند. .RB ( \-5e یا .B \-6e نیز ممکن است ارزش بررسی داشته باشند. گزینه .B \-\-\extreme را ببینید.) .TP .B "\-7 ... \-9" این‌ها شبیه به .B \-6 هستند اما با نیازمندی‌های حافظه بالاتر برای فشرده‌ساز و بازگشا. این سطوح تنها هنگام فشرده‌سازی فایل‌های بزرگ‌تر از ۸\ MiB، ۱۶\ MiB و ۳۲\ MiB مفید واقع می‌شوند. .RE .IP "" روی سخت‌افزار یکسان، سرعت بازگشایی تقریباً برابر با تعداد ثابتی از بایت‌های داده فشرده در هر ثانیه است. به عبارت دیگر، هرچه فشرده‌سازی بهتر باشد، سرعت بازگشایی معمولاً بیشتر خواهد بود. این همچنین بدان معنی است که مقدار خروجی فشرده‌نشده تولیدشده در ثانیه می‌تواند بسیار متغیر باشد. .IP "" جدول زیر ویژگی‌های سطوح پیش‌تنظیم را خلاصه می‌کند: .RS .RS .PP .TS tab(;); c c c c c n n n n n. Preset;DictSize;CompCPU;CompMem;DecMem \-0;256 KiB;0;3 MiB;1 MiB \-1;1 MiB;1;9 MiB;2 MiB \-2;2 MiB;2;17 MiB;3 MiB \-3;4 MiB;3;32 MiB;5 MiB \-4;4 MiB;4;48 MiB;5 MiB \-5;8 MiB;5;94 MiB;9 MiB \-6;8 MiB;6;94 MiB;9 MiB \-7;16 MiB;6;186 MiB;17 MiB \-8;32 MiB;6;370 MiB;33 MiB \-9;64 MiB;6;674 MiB;65 MiB .TE .RE .RE .IP "" توضیحات ستون‌ها: .RS .IP \(bu 3 ستون DictSize اندازه لغت‌نامه LZMA2 است. استفاده از لغت‌نامه‌ای بزرگ‌تر از اندازه فایل فشرده‌نشده، اتلاف حافظه است. به همین دلیل بهتر است از استفاده از سطوح .BR \-7 " ... " \-9 در مواقعی که نیاز واقعی به آن‌ها نیست خودداری شود. در سطح .B \-6 و پایین‌تر، مقدار حافظه هدررفته معمولاً آن‌قدر کم است که اهمیتی ندارد. .IP \(bu 3 ستون CompCPU نمایش ساده‌شده‌ای از تنظیمات LZMA2 است که بر سرعت فشرده‌سازی تأثیر می‌گذارند. اندازه لغت‌نامه نیز بر سرعت اثر دارد، بنابراین اگرچه CompCPU برای سطوح .BR \-6 " ... " \-9 یکسان است، اما سطوح بالاتر همچنان اندکی کُندتر هستند. برای دستیابی به فشرده‌سازی حتی کُندتر و احتمالاً بهتر، گزینه .B \-\-\extreme را ببینید. .IP \(bu 3 ستون CompMem شامل نیازمندی‌های حافظه فشرده‌ساز در حالت تک‌رشته‌ای است. این مقدار ممکن است بین نسخه‌های .B xz کمی تفاوت داشته باشد. نیازمندی‌های حافظه برخی از حالت‌های چندرشته‌ای آینده ممکن است به مراتب بیشتر از حالت تک‌رشته‌ای باشد. .IP \(bu 3 ستون DecMem شامل نیازمندی‌های حافظه بازگشا است. به این معنا که تنظیمات فشرده‌سازی نیازمندی‌های حافظه بازگشا را تعیین می‌کنند. مصرف دقیق حافظه بازگشا اندکی بیشتر از اندازه لغت‌نامه LZMA2 است، اما مقادیر موجود در جدول به سمت بالا و به مگابایت کامل بعدی گرد شده‌اند. .RE .TP .BR \-e ", " \-\-\extreme استفاده از یک نوع کُندتر از سطح پیش‌تنظیم فشرده‌سازی انتخاب‌شده .RB ( \-0 " ... " \-9 ) تا با خوش‌شانسی نسبت فشرده‌سازی اندکی بهتر حاصل شود، اما با بدشانسی این کار می‌تواند آن را بدتر کند. میزان مصرف حافظه بازگشا تحت تأثیر قرار نمی‌گیرد، اما مصرف حافظه فشرده‌ساز در سطوح .BR \-0 " ... " \-3 کمی افزایش می‌یابد. .IP "" از آنجا که دو پیش‌تنظیم با اندازه‌های لغت‌نامه ۴\ MiB و ۸\ MiB وجود دارند، پیش‌تنظیم‌های .B \-3e و .B \-5e از تنظیمات اندکی سریع‌تر (CompCPU پایین‌تر) نسبت به .B \-4e و .BR \-6e استفاده می‌کنند. به این ترتیب هیچ دو پیش‌تنظیمی یکسان نیستند. .RS .RS .PP .TS tab(;); c c c c c n n n n n. Preset;DictSize;CompCPU;CompMem;DecMem \-0e;256 KiB;8;4 MiB;1 MiB \-1e;1 MiB;8;13 MiB;2 MiB \-2e;2 MiB;8;25 MiB;3 MiB \-3e;4 MiB;7;48 MiB;5 MiB \-4e;4 MiB;8;48 MiB;5 MiB \-5e;8 MiB;7;94 MiB;9 MiB \-6e;8 MiB;8;94 MiB;9 MiB \-7e;16 MiB;8;186 MiB;17 MiB \-8e;32 MiB;8;370 MiB;33 MiB \-9e;64 MiB;8;674 MiB;65 MiB .TE .RE .RE .IP "" برای مثال، در مجموع چهار پیش‌تنظیم وجود دارند که از لغت‌نامه ۸\ MiB استفاده می‌کنند و ترتیب آن‌ها از سریع‌ترین به کُندترین عبارت است از .BR \-5 ، .BR \-6 ، .B \-5e و .BR \-6e . .TP .B \-\-\fast .PD 0 .TP .B \-\-\best .PD این‌ها نام‌های مستعار تا حدی گمراه‌کننده برای .B \-0 و .BR \-9 هستند. این گزینه‌ها فقط برای سازگاری با LZMA Utils ارائه شده‌اند. از استفاده از آن‌ها خودداری کنید. .TP \BI\-\-\block\-size=\fIsize\fR هنگام فشرده‌سازی به قالب .BR .xz ، داده‌های ورودی را به بلوک‌هایی به اندازه .I size بایت تقسیم می‌کند. بلوک‌ها مستقل از یکدیگر فشرده می‌شوند، که به چندرشتگی کمک کرده و بازگشایی فشرده‌سازی با دسترسی تصادفی محدود را امکان‌پذیر می‌سازد. این گزینه معمولاً برای لغو اندازه بلوک پیش‌فرض در حالت چندرشته‌ای استفاده می‌شود، اما می‌تواند در حالت تک‌رشته‌ای نیز به کار رود. .IP "" در حالت چندرشته‌ای حدود سه برابر .I size بایت در هر رشته برای بافر کردن ورودی و خروجی تخصیص می‌یابد. اندازه پیش‌فرض .I size سه برابر اندازه لغت‌نامه LZMA2 یا ۱ MiB است، هر کدام که بیشتر باشد. معمولاً یک مقدار خوب ۲\(en۴ برابر اندازه لغت‌نامه LZMA2 یا حداقل ۱ MiB است. استفاده از .I size کمتر از اندازه لغت‌نامه LZMA2 اتلاف رم است زیرا بافر لغت‌نامه LZMA2 هرگز به‌طور کامل استفاده نخواهد شد. اندازه بلوک‌ها در سرایندهای بلوک ذخیره می‌شود، که نسخه‌های آینده .B xz از آن برای بازگشایی چندرشته‌ای استفاده خواهند کرد. .IP "" در حالت تک‌رشته‌ای به‌طور پیش‌فرض هیچ تقسیم‌بندی بلوکی انجام نمی‌شود. تنظیم این گزینه بر مصرف حافظه تأثیری ندارد. هیچ اطلاعات اندازه‌ای در سرایندهای بلوک ذخیره نمی‌شود، بنابراین فایل‌های ایجادشده در حالت تک‌رشته‌ای با فایل‌های ایجادشده در حالت چندرشته‌ای یکسان نخواهند بود. فقدان اطلاعات اندازه همچنین بدان معناست که نسخه آینده .B xz نخواهد توانست این فایل‌ها را در حالت چندرشته‌ای بازگشایی کند. .TP \BI\-\-\block\-list=\fIsizes\fR هنگام فشرده‌سازی به قالب .BR .xz ، پس از فواصل مشخص‌شده از داده‌های فشرده‌نشده، یک بلوک جدید آغاز شود. .IP "" اندازه‌های فشرده‌نشده .I sizes بلوک‌ها به صورت فهرستی جداشده با کاما مشخص می‌شوند. حذف یک اندازه (دو یا چند کامای متوالی) روشی کوتاه‌شده برای استفاده از اندازه بلوک قبلی است. .IP "" اگر فایل ورودی بزرگ‌تر از مجموع .I sizes باشد، آخرین مقدار در .I sizes تا انتهای فایل تکرار می‌شود. مقدار ویژه .B 0 می‌تواند به عنوان آخرین مقدار استفاده شود تا نشان دهد باقی‌مانده فایل باید به عنوان یک تک‌بلوک کدگذاری شود. .IP "" اگر مقادیری برای .I sizes مشخص شوند که از اندازه بلوک کدگذار تجاوز کنند (چه مقدار پیش‌فرض در حالت چندرشته‌ای یا مقدار مشخص‌شده با \fB\-\-\block\-size=\fIsize\fR)، کدگذار بلوک‌های اضافی ایجاد می‌کند در حالی که مرزهای مشخص‌شده در .I sizes را حفظ می‌نماید. برای مثال، اگر فردی .B \-\-\block\-size=10MiB .B \-\-\block\-list=5MiB,10MiB,8MiB,12MiB,24MiB را مشخص کند و فایل ورودی ۸۰ MiB باشد، ۱۱ بلوک حاصل خواهد شد: ۵، ۱۰، ۸، ۱۰، ۲، ۱۰، ۱۰، ۴، ۱۰، ۱۰ و ۱ MiB. .IP "" در حالت چندرشته‌ای اندازه بلوک‌ها در سرایندهای بلوک ذخیره می‌شود. این کار در حالت تک‌رشته‌ای انجام نمی‌شود، بنابراین خروجی کدگذاری‌شده با حالت چندرشته‌ای یکسان نخواهد بود. .TP \BI\-\-\flush\-timeout=\fItimeout\fR هنگام فشرده‌سازی، اگر بیش از .I timeout میلی‌ثانیه (یک عدد صحیح مثبت) از تخلیه (flush) قبلی گذشته باشد و خواندن ورودی بیشتر مسدودکننده (block) باشد، تمام داده‌های ورودی معلق از کدگذار تخلیه شده و در جریان خروجی در دسترس قرار می‌گیرند. این گزینه می‌تواند زمانی مفید باشد که .B xz برای فشرده‌سازی داده‌هایی که از طریق شبکه جریان دارند استفاده می‌شود. مقادیر کوچک .I timeout داده‌ها را با تأخیر کمی در سمت دریافت‌کننده در دسترس قرار می‌دهند، اما مقادیر بزرگ .I timeout نسبت فشرده‌سازی بهتری به همراه دارند. .IP "" این ویژگی به‌طور پیش‌فرض غیرفعال است. اگر این گزینه بیش از یک بار مشخص شود، آخرین مورد اثر می‌کند. مقدار ویژه .B 0 برای .I timeout می‌تواند برای غیرفعال کردن صریح این ویژگی استفاده شود. .IP "" این قابلیت در سامانه‌های غیر POSIX در دسترس نیست. .IP "" .\" FIXME .B "این ویژگی هنوز آزمایشی است." در حال حاضر .B xz به دلیل نحوه بافر کردن، برای بازگشایی جریان در زمان واقعی نامناسب است. .TP \BI\-\-\memlimit\-compress=\fIlimit\fR تنظیم محدودیت مصرف حافظه برای فشرده‌سازی. اگر این گزینه چند بار مشخص شود، آخرین مورد اعمال می‌شود. .IP "" اگر تنظیمات فشرده‌سازی از .I limit تجاوز کند، .B xz تلاش می‌کند تنظیمات را کاهش دهد تا محدودیت دیگر رد نشود و پیامی مبنی بر انجام تنظیم خودکار نمایش می‌دهد. تعدیل‌ها به این ترتیب انجام می‌شوند: کاهش تعداد رشته‌ها، تغییر به حالت تک‌رشته‌ای اگر حتی یک رشته در حالت چندرشته‌ای از .I limit تجاوز کند، و در نهایت کاهش اندازه لغت‌نامه LZMA2. .IP "" هنگام فشرده‌سازی با .B \-\-\format=raw یا اگر .B \-\-\no\-adjust مشخص شده باشد، تنها تعداد رشته‌ها ممکن است کاهش یابد زیرا این کار بدون تأثیر بر خروجی فشرده انجام‌پذیر است. .IP "" اگر .I limit حتی با تعدیل‌های توصیف‌شده در بالا برآورده نشود، یک خطا نمایش داده می‌شود و .B xz با وضعیت خروج 1 خارج خواهد شد. .IP "" مقدار .I limit می‌تواند به چندین روش مشخص شود: .RS .IP \(bu 3 مقدار .I limit می‌تواند یک مقدار مطلق به بایت باشد. استفاده از یک پسوند عدد صحیح مانند .B MiB می‌تواند مفید باشد. مثال: .B "\-\-\memlimit\-compress=80MiB" .IP \(bu 3 مقدار .I limit می‌تواند به عنوان درصدی از کل حافظه فیزیکی (RAM) مشخص شود. این مورد به‌ویژه هنگام تنظیم متغیر محیطی .B XZ_DEFAULTS در یک اسکریپت راه‌اندازی شل که بین رایانه‌های مختلف به اشتراک گذاشته می‌شود، مفید است. به این ترتیب سقف مجاز به‌طور خودکار در سامانه‌های با حافظه بیشتر بزرگ‌تر خواهد بود. مثال: .B "\-\-\memlimit\-compress=70%" .IP \(bu 3 مقدار .I limit می‌تواند با تنظیم روی .B 0 به مقدار پیش‌فرض خود بازنشانی شود. این کار در حال حاضر معادل تنظیم .I limit روی .B max (بدون محدودیت مصرف حافظه) است. .RE .IP "" برای نسخه ۳۲ بیتی .B xz یک حالت ویژه وجود دارد: اگر .I limit بیش از .B "4020\ MiB" باشد، مقدار .I limit روی .B "4020\ MiB" تنظیم می‌شود. در معماری MIPS32 به جای آن از .B "2000\ MiB" استفاده می‌شود. (مقادیر .B 0 و .B max تحت تأثیر این موضوع قرار نمی‌گیرند. ویژگی مشابهی برای بازگشایی وجود ندارد.) این می‌تواند زمانی مفید باشد که یک فایل اجرایی ۳۲ بیتی به فضای آدرس ۴\ GiB (۲ GiB در MIPS32) دسترسی دارد در حالی که امیدواریم در شرایط دیگر آسیبی نرساند. .IP "" همچنین بخش .B "میزان مصرف حافظه (Memory usage)" را ببینید. .TP \BI\-\-\memlimit\-decompress=\fIlimit\fR تنظیم سقف مصرف حافظه برای بازگشایی فشرده‌سازی. این گزینه همچنین بر حالت .B \-\-\list اثر می‌گذارد. اگر عملیات بدون تجاوز از .I limit امکان‌پذیر نباشد، .B xz یک خطا نمایش می‌دهد و بازگشایی فایل ناموفق خواهد بود. بخش \BI\-\-\memlimit\-compress=\fIlimit\fR را برای روش‌های ممکن تعیین .I limit ببینید. .TP \BI\-\-\memlimit\-mt\-decompress=\fIlimit\fR تنظیم سقف مصرف حافظه برای بازگشایی چندرشته‌ای. این گزینه تنها می‌تواند بر تعداد رشته‌ها تأثیر بگذارد؛ هرگز باعث نمی‌شود .B xz از بازگشایی یک فایل خودداری کند. اگر .I limit برای مجاز دانستن هرگونه چندرشتگی بسیار کم باشد، .I limit نادیده گرفته شده و .B xz در حالت تک‌رشته‌ای ادامه می‌دهد. توجه داشته باشید که اگر .B \-\-\memlimit\-decompress نیز استفاده شود، همیشه هم بر حالت تک‌رشته‌ای و هم چندرشته‌ای اعمال می‌شود، و بنابراین .I limit مؤثر برای چندرشتگی هرگز بیشتر از سقف تعیین‌شده با .B \-\-\memlimit\-decompress نخواهد بود. .IP "" برخلاف سایر گزینه‌های محدودیت مصرف حافظه، \BI\-\-\memlimit\-mt\-decompress=\fIlimit\fR دارای یک .I limit پیش‌فرض وابسته به سامانه است. می‌توان از .B "xz \-\-\info\-memory" برای دیدن مقدار فعلی استفاده کرد. .IP "" این گزینه و مقدار پیش‌فرض آن به این دلیل وجود دارند که بدون هیچ محدودیتی، بازگشای چندرشته‌ای ممکن است در برخی فایل‌های ورودی مقدار جنون‌آمیزی از حافظه را تخصیص دهد. اگر .I limit پیش‌فرض در سامانه شما بسیار کم است، می‌توانید .I limit را افزایش دهید اما هرگز آن را به مقداری بیشتر از حافظه رم قابل استفاده تنظیم نکنید، زیرا با فایل‌های ورودی مناسب .B xz تلاش می‌کند تا آن مقدار حافظه را حتی با تعداد کمی رشته مصرف کند. تمام شدن حافظه یا انتقال داده به دیسک (swapping) کارایی بازگشایی را بهبود نخواهد بخشید. .IP "" برای روش‌های ممکن تعیین .IR limit ، گزینه \BI\-\-\memlimit\-compress=\fIlimit\fR را ببینید. تنظیم .I limit روی .B 0 مقدار .I limit را به مقدار پیش‌فرض وابسته به سامانه بازنشانی می‌کند. .IP "" .TP \fB\-M\fR \fIlimit\fR, \fB\-\-\memlimit=\fIlimit\fR, \fB\-\-\memory=\fIlimit\fR این معادل است با مشخص کردن .BI \-\-\memlimit\-compress= limit .BI \-\-\memlimit\-decompress= limit \fB\-\-\memlimit\-mt\-decompress=\fIlimit\fR. .TP .B \-\-\no\-adjust در صورتی که سقف مصرف حافظه بدون تعدیل تنظیماتی که بر خروجی فشرده تأثیر می‌گذارند برآورده نشود، یک خطا نمایش داده و خارج شود. به این معنا که این گزینه مانع از تغییر کدگذار از حالت چندرشته‌ای به تک‌رشته‌ای و مانع از کاهش اندازه لغت‌نامه LZMA2 توسط .B xz می‌شود. حتی زمانی که این گزینه استفاده شود، تعداد رشته‌ها ممکن است برای برآورده کردن سقف حافظه کاهش یابد زیرا این امر تأثیری بر خروجی فشرده نخواهد داشت. .IP "" تعدیل خودکار همیشه هنگام ایجاد جریان‌های خام .RB ( \-\-\format=raw ) غیرفعال است. .TP \fB\-T\fR \fIthreads\fR, \fB\-\-\threads=\fIthreads\fR تعیین تعداد رشته‌های کاری مورد استفاده. تنظیم .I threads روی مقدار ویژه .B 0 باعث می‌شود .B xz حداکثر به اندازه تعداد رشته‌هایی که پردازنده(های) سامانه پشتیبانی می‌کنند از رشته‌ها استفاده کند. اگر فایل ورودی برای چندرشتگی با تنظیمات داده‌شده به اندازه کافی بزرگ نباشد، یا اگر استفاده از رشته‌های بیشتر از سقف مصرف حافظه تجاوز کند، تعداد واقعی رشته‌ها می‌تواند کمتر از .I threads باشد. .IP "" فشرده‌سازهای تک‌رشته‌ای و چندرشته‌ای خروجی متفاوتی تولید می‌کنند. فشرده‌ساز تک‌رشته‌ای کمترین اندازه فایل را به همراه خواهد داشت، اما تنها خروجی فشرده‌ساز چندرشته‌ای را می‌توان با استفاده از چندین رشته بازگشایی کرد. تنظیم .I threads روی .B 1 از حالت تک‌رشته‌ای استفاده خواهد کرد. تنظیم .I threads روی هر مقدار دیگر، از جمله .BR 0 ، از فشرده‌ساز چندرشته‌ای استفاده می‌کند حتی اگر سامانه تنها از یک رشته سخت‌افزاری پشتیبانی کند. .RB ( xz نسخه 5.2.x در این شرایط از حالت تک‌رشته‌ای استفاده می‌کرد.) .IP "" برای استفاده از حالت چندرشته‌ای با تنها یک رشته، .I threads را روی .B +1 تنظیم کنید. پیشوند .B + روی مقادیری غیر از .B 1 هیچ اثری ندارد. محدودیت مصرف حافظه همچنان می‌تواند باعث شود .B xz به حالت تک‌رشته‌ای تغییر یابد مگر اینکه از .B \-\-\no\-adjust استفاده شود. پشتیبانی از پیشوند .B + در .B xz 5.4.0 اضافه شد. .IP "" اگر تعداد خودکار رشته‌ها درخواست شده باشد و هیچ محدودیتی برای مصرف حافظه مشخص نشده باشد، یک حد ملایم (soft limit) پیش‌فرض وابسته به سامانه برای محدود کردن احتمالی تعداد رشته‌ها استفاده خواهد شد. این یک حد ملایم است به این معنا که اگر تعداد رشته‌ها یک شود نادیده گرفته می‌شود، بنابراین یک حد ملایم هرگز مانع از فشرده‌سازی یا بازگشایی توسط .B xz نخواهد شد. این حد ملایم پیش‌فرض باعث نخواهد شد که .B xz از حالت چندرشته‌ای به حالت تک‌رشته‌ای تغییر وضعیت دهد. محدودیت‌های فعال را می‌توان با .B "xz \-\-\info\-memory" مشاهده کرد. .IP "" در حال حاضر تنها روش چندرشتگی تقسیم ورودی به بلوک‌ها و فشرده‌سازی آن‌ها به‌طور مستقل از یکدیگر است. اندازه بلوک پیش‌فرض به سطح فشرده‌سازی بستگی دارد و می‌توان آن را با گزینه \BI\-\-\block\-size=\fIsize\fR بازنویسی کرد. .IP "" بازگشایی چندرشته‌ای تنها روی فایل‌هایی کار می‌کند که شامل چندین بلوک با اطلاعات اندازه در سرایندهای بلوک باشند. تمام فایل‌های به اندازه کافی بزرگ فشرده‌شده در حالت چندرشته‌ای این شرط را برآورده می‌کنند، اما فایل‌های فشرده‌شده در حالت تک‌رشته‌ای حتی اگر از \BI\-\-\block\-size=\fIsize\fR استفاده شده باشد این شرط را برآورده نمی‌کنند. . .SS "زنجیره‌های سفارشی پالایه فشرده‌ساز (Custom compressor filter chains)" یک زنجیره پالایه (filter chain) سفارشی اجازه می‌دهد تنظیمات فشرده‌سازی با جزئیات دقیق به جای اتکا به تنظیمات مرتبط با سطوح پیش‌تنظیم مشخص شوند. هنگامی که یک زنجیره پالایه سفارشی مشخص می‌شود، گزینه‌های پیش‌تنظیم .RB ( \-0 \&...\& .B \-9 و .BR \-\-\extreme ) که پیش‌تر در خط فرمان آمده‌اند فراموش می‌شوند. اگر یک گزینه پیش‌تنظیم پس از یک یا چند گزینه زنجیره پالایه سفارشی مشخص شود، پیش‌تنظیم جدید اعمال شده و گزینه‌های زنجیره پالایه سفارشی که قبلاً مشخص شده بودند فراموش می‌شوند. .PP یک زنجیره پالایه قابل مقایسه با لوله‌کشی (piping) در خط فرمان است. هنگام فشرده‌سازی، ورودی فشرده‌نشده وارد پالایه نخست می‌شود، که خروجی آن به پالایه بعدی (در صورت وجود) می‌رود. خروجی آخرین پالایه در فایل فشرده نوشته می‌شود. حداکثر تعداد پالایه‌ها در زنجیره چهار عدد است، اما معمولاً یک زنجیره پالایه تنها یک یا دو پالایه دارد. .PP بسیاری از پالایه‌ها محدودیت‌هایی در مورد جایگاهشان در زنجیره پالایه دارند: برخی پالایه‌ها تنها می‌توانند به عنوان آخرین پالایه در زنجیره عمل کنند، برخی تنها به عنوان پالایه غیر آخر، و برخی در هر جایگاهی در زنجیره کار می‌کنند. بسته به پالایه، این محدودیت یا ناشی از طراحی ذاتی پالایه است یا برای جلوگیری از مشکلات امنیتی وجود دارد. .PP یک زنجیره پالایه سفارشی با استفاده از یک یا چند گزینه پالایه به ترتیبی که در زنجیره پالایه مورد نظر است مشخص می‌شود. به این معنا که ترتیب گزینه‌های پالایه مهم و معنادار است! هنگام رمزگشایی جریان‌های خام .RB ( \-\-\format=raw )، زنجیره پالایه به همان ترتیبی مشخص می‌شود که هنگام فشرده‌سازی مشخص شده بود. .PP پالایه‌ها .I options مخصوص خود را به صورت فهرستی جداشده با کاما دریافت می‌کنند. کاما‌های اضافی در .I options نادیده گرفته می‌شوند. هر گزینه دارای یک مقدار پیش‌فرض است، بنابراین تنها کافی است مواردی را که می‌خواهید تغییر دهید مشخص نمایید. .PP برای مشاهده کل زنجیره پالایه و .IR options ، از .B "xz \-vv" (یعنی دو بار استفاده از .BR \-\-\verbose ) استفاده کنید. این دستور همچنین برای مشاهده گزینه‌های زنجیره پالایه مورد استفاده توسط پیش‌تنظیم‌ها کار می‌کند. .TP \fB\-\-\lzma1\fR[\fB=\fIoptions\fR] .PD 0 .TP \fB\-\-\lzma2\fR[\fB=\fIoptions\fR] .PD افزودن پالایه LZMA1 یا LZMA2 به زنجیره پالایه. این پالایه‌ها تنها می‌توانند به عنوان آخرین پالایه در زنجیره استفاده شوند. .IP "" پالایه LZMA1 یک پالایه قدیمی است که تقریباً صرفاً به دلیل قالب قدیمی فایل .B .lzma پشتیبانی می‌شود، قالبی که تنها از LZMA1 پشتیبانی می‌کند. پالایه LZMA2 نسخه به‌روزشده‌ای از LZMA1 است تا برخی مشکلات کاربردی LZMA1 را برطرف کند. قالب .B .xz از LZMA2 استفاده می‌کند و اصلاً از LZMA1 پشتیبانی نمی‌کند. سرعت و نسبت فشرده‌سازی LZMA1 و LZMA2 عملاً یکسان است. .IP "" پالایه‌های LZMA1 و LZMA2 مجموعه یکسانی از .I options را به اشتراک می‌گذارند: .RS .TP \BI preset=\fIpreset\fR بازنشانی تمام .I options پالایه LZMA1 یا LZMA2 به .IR preset . مورد .I Preset شامل یک عدد صحیح است که ممکن است با اصلاح‌کننده‌های پیش‌تنظیم تک‌حرفی دنبال شود. این عدد صحیح می‌تواند از .B 0 تا .BR 9 باشد، منطبق با گزینه‌های خط فرمان .B \-0 \&...\& .BR \-9 . تنها اصلاح‌کننده پشتیبانی‌شده در حال حاضر .B e است که با .B \-\-\extreme مطابقت دارد. اگر هیچ .B preset مشخص نشود، مقادیر پیش‌فرض .I options برای LZMA1 یا LZMA2 از پیش‌تنظیم .B 6 گرفته می‌شود. .TP \BI dict=\fIsize\fR اندازه لغت‌نامه (بافر تاریخچه) .I size مشخص می‌کند که چند بایت از داده‌های فشرده‌نشده پردازش‌شده اخیر در حافظه نگهداری شود. الگوریتم تلاش می‌کند دنباله‌های بایت تکراری (تطابق‌ها) را در داده‌های فشرده‌نشده پیدا کرده و آن‌ها را با ارجاعاتی به داده‌های موجود در لغت‌نامه جایگزین کند. هرچه لغت‌نامه بزرگ‌تر باشد، شانس یافتن تطابق بیشتر است. بنابراین، افزایش .I size لغت‌نامه معمولاً نسبت فشرده‌سازی را بهبود می‌بخشد، اما لغت‌نامه‌ای بزرگ‌تر از اندازه فایل فشرده‌نشده اتلاف حافظه است. .IP "" اندازه معمول لغت‌نامه .I size از ۶۴\ KiB تا ۶۴\ MiB است. حداقل آن ۴\ KiB است. حداکثر برای فشرده‌سازی در حال حاضر ۱٫۵\ GiB (۱۵۳۶\ MiB) است. بخش بازگشا از لغت‌نامه‌هایی تا یک بایت کمتر از ۴\ GiB پشتیبانی می‌کند، که حداکثر مجاز برای قالب‌های جریان LZMA1 و LZMA2 است. .IP "" اندازه لغت‌نامه .I size و تطابق‌یاب .RI ( mf ) با یکدیگر مصرف حافظه کدگذار LZMA1 یا LZMA2 را تعیین می‌کنند. همان اندازه (یا بزرگ‌تر) لغت‌نامه .I size برای بازگشایی مورد نیاز است که هنگام فشرده‌سازی استفاده شده بود، بنابراین میزان مصرف حافظه رمزگشا بر اساس اندازه لغت‌نامه استفاده‌شده هنگام فشرده‌سازی تعیین می‌شود. سرایندهای .B .xz اندازه لغت‌نامه .I size را به صورت .RI "2^" n یا .RI "2^" n " + 2^(" n "\-1)" ذخیره می‌کنند، بنابراین این .I sizes تا حدی برای فشرده‌سازی ترجیح داده می‌شوند. سایر .I sizes هنگام ذخیره در سرایندهای .B .xz به سمت بالا گرد خواهند شد. .TP \BI lc=\fIlc\fR تعیین تعداد بیت‌های زمینه لفظی (literal context bits). حداقل ۰ و حداکثر ۴ است؛ مقدار پیش‌فرض ۳ می‌باشد. علاوه بر این، مجموع .I lc و .I lp نباید از ۴ تجاوز کند. .IP "" تمام بایت‌هایی که نمی‌توانند به عنوان تطابق کدگذاری شوند، به صورت مقادیر لفظی (literals) کدگذاری می‌شوند. به این معنا که مقادیر لفظی صرفاً بایت‌های ۸ بیتی هستند که یکی‌یکی کدگذاری می‌شوند. .IP "" کدگذاری مقادیر لفظی این فرض را در نظر می‌گیرد که بالاترین بیت‌های .I lc از بایت فشرده‌نشده قبلی با بایت بعدی همبستگی دارند. برای مثال، در یک متن انگلیسی معمول، یک حرف بزرگ اغلب با یک حرف کوچک دنبال می‌شود، و یک حرف کوچک معمولاً با حرف کوچک دیگری همراه است. در مجموعه نویسه‌های US-ASCII، سه بیت بالاتر برای حروف بزرگ 010 و برای حروف کوچک 011 است. هنگامی که .I lc حداقل ۳ باشد، کدگذاری مقادیر لفظی می‌تواند از این ویژگی در داده‌های فشرده‌نشده بهره ببرد. .IP "" مقدار پیش‌فرض (3) معمولاً مناسب است. اگر خواهان حداکثر فشرده‌سازی هستید، .B lc=4 را آزمایش کنید. گاهی این کار اندکی کمک می‌کند، و گاهی فشرده‌سازی را بدتر می‌سازد. اگر آن را بدتر کرد، .B lc=2 را نیز امتحان کنید. .TP \BI lp=\fIlp\fR تعیین تعداد بیت‌های موقعیت لفظی (literal position bits). حداقل ۰ و حداکثر ۴ است؛ مقدار پیش‌فرض ۰ است. .IP "" مقدار .I Lp بر نوع تراز فرضی در داده‌های فشرده‌نشده هنگام کدگذاری مقادیر لفظی تأثیر می‌گذارد. برای اطلاعات بیشتر درباره تراز، .I pb را در زیر ببینید. .TP \BI pb=\fIpb\fR تعیین تعداد بیت‌های موقعیت (position bits). حداقل ۰ و حداکثر ۴ است؛ مقدار پیش‌فرض ۲ است. .IP "" مقدار .I Pb بر نوع تراز فرضی در داده‌های فشرده‌نشده به‌طور کلی تأثیر می‌گذارد. مقدار پیش‌فرض به معنای تراز چهار بایتی است .RI (2^ pb =2^2=4)، که معمولاً در صورت نبود حدس بهتر، انتخاب خوبی است. .IP "" هنگامی که تراز مشخص است، تنظیم متناسب .I pb می‌تواند اندازه فایل را اندکی کاهش دهد. برای مثال، در فایل‌های متنی با تراز یک بایتی (US-ASCII، ISO-8859-*، UTF-8)، تنظیم .B pb=0 می‌تواند فشرده‌سازی را اندکی بهبود بخشد. برای متن UTF-16، تنظیم .B pb=1 انتخاب مناسبی است. اگر تراز یک عدد فرد مانند ۳ بایت باشد، .B pb=0 ممکن است بهترین انتخاب باشد. .IP "" اگرچه تراز فرضی را می‌توان با .I pb و .I lp تنظیم کرد، LZMA1 و LZMA2 همچنان کمی تراز ۱۶ بایتی را ترجیح می‌دهند. شاید ارزش داشته باشد هنگام طراحی قالب‌های فایلی که احتمالاً اغلب با LZMA1 یا LZMA2 فشرده می‌شوند، این نکته در نظر گرفته شود. .TP \BI mf=\fImf\fR تطابق‌یاب (match finder) تأثیر عمده‌ای بر سرعت کدگذار، مصرف حافظه و نسبت فشرده‌سازی دارد. معمولاً تطابق‌یاب‌های زنجیره هش (Hash Chain) سریع‌تر از تطابق‌یاب‌های درخت دودویی (Binary Tree) هستند. مقدار پیش‌فرض به .I preset بستگی دارد: سطح 0 از .B hc3 استفاده می‌کند، سطوح ۱\(en۳ از .BR hc4 ، و بقیه از .B bt4 استفاده می‌نمایند. .IP "" تطابق‌یاب‌های زیر پشتیبانی می‌شوند. فرمول‌های مصرف حافظه زیر تقریب‌های کلی هستند که در شرایطی که .I dict توانی از دو باشد بیشترین نزدیکی را به واقعیت دارند. .RS .TP .B hc3 زنجیره هش با هشینگ ۲ و ۳ بایتی .br حداقل مقدار برای .IR nice : 3 .br میزان مصرف حافظه: .br .I dict * 7.5 (اگر .I dict <= 16 MiB باشد)؛ .br .I dict * 5.5 + 64 MiB (اگر .I dict > 16 MiB باشد) .TP .B hc4 زنجیره هش با هشینگ ۲، ۳ و ۴ بایتی .br حداقل مقدار برای .IR nice : 4 .br میزان مصرف حافظه: .br .I dict * 7.5 (اگر .I dict <= 32 MiB باشد)؛ .br .I dict * 6.5 (اگر .I dict > 32 MiB باشد) .TP .B bt2 درخت دودویی با هشینگ ۲ بایتی .br حداقل مقدار برای .IR nice : 2 .br میزان مصرف حافظه: .I dict * 9.5 .TP .B bt3 درخت دودویی با هشینگ ۲ و ۳ بایتی .br حداقل مقدار برای .IR nice : 3 .br میزان مصرف حافظه: .br .I dict * 11.5 (اگر .I dict <= 16 MiB باشد)؛ .br .I dict * 9.5 + 64 MiB (اگر .I dict > 16 MiB باشد) .TP .B bt4 درخت دودویی با هشینگ ۲، ۳ و ۴ بایتی .br حداقل مقدار برای .IR nice : 4 .br میزان مصرف حافظه: .br .I dict * 11.5 (اگر .I dict <= 32 MiB باشد)؛ .br .I dict * 10.5 (اگر .I dict > 32 MiB باشد) .RE .TP \BI mode=\fImode\fR حالت فشرده‌سازی .I mode روش تجزیه و تحلیل داده‌های تولیدشده توسط تطابق‌یاب را مشخص می‌کند. حالت‌های .I modes پشتیبانی‌شده عبارتند از .B fast و .BR normal . مقدار پیش‌فرض .B fast برای .I presets ۰\(en۳ و .B normal برای .I presets ۴\(en۹ است. .IP "" معمولاً .B fast با تطابق‌یاب‌های زنجیره هش و .B normal با تطابق‌یاب‌های درخت دودویی استفاده می‌شود. این همان کاری است که .I presets انجام می‌دهند. .TP \BI nice=\fInice\fR مشخص می‌کند چه طولی برای یک تطابق، طول مناسب (nice) در نظر گرفته شود. به محض اینکه تطابقی به اندازه حداقل .I nice بایت پیدا شود، الگوریتم جستجو برای تطابق‌های احتمالاً بهتر را متوقف می‌کند. .IP "" مقدار .I Nice می‌تواند ۲\(en۲۷۳ بایت باشد. مقادیر بالاتر تمایل دارند نسبت فشرده‌سازی بهتری را به قیمت کاهش سرعت ارائه دهند. مقدار پیش‌فرض به .I preset بستگی دارد. .TP \BI depth=\fIdepth\fR تعیین حداکثر عمق جستجو در تطابق‌یاب. مقدار پیش‌فرض مقدار ویژه 0 است که باعث می‌شود فشرده‌ساز یک .I depth معقول را بر اساس .I mf و .I nice تعیین کند. .IP "" مقدار معقول .I depth برای زنجیره‌های هش ۴\(en۱۰۰ و برای درخت‌های دودویی ۱۶\(en۱۰۰۰ است. استفاده از مقادیر بسیار بالا برای .I depth می‌تواند کدگذار را در پردازش برخی فایل‌ها فوق‌العاده کُند کند. از تنظیم .I depth بیش از ۱۰۰۰ خودداری کنید مگر اینکه آماده باشید در صورتی که فشرده‌سازی بیش از حد طول کشید آن را قطع کنید. .RE .IP "" هنگام رمزگشایی جریان‌های خام .RB ( \-\-\format=raw )، پالایه LZMA2 تنها به اندازه لغت‌نامه .I size نیاز دارد. پالایه LZMA1 همچنین به .IR lc ، .I lp و .I pb احتیاج دارد. .TP \fB\-\-\x86\fR[\fB=\fIoptions\fR] .PD 0 .TP \fB\-\-\arm\fR[\fB=\fIoptions\fR] .TP \fB\-\-\armthumb\fR[\fB=\fIoptions\fR] .TP \fB\-\-\arm64\fR[\fB=\fIoptions\fR] .TP \fB\-\-\powerpc\fR[\fB=\fIoptions\fR] .TP \fB\-\-\ia64\fR[\fB=\fIoptions\fR] .TP \fB\-\-\sparc\fR[\fB=\fIoptions\fR] .PD افزودن یک پالایه انشعاب/فراخوانی/پرش (BCJ) به زنجیره پالایه. این پالایه‌ها تنها می‌توانند به عنوان پالایه غیر آخر در زنجیره پالایه استفاده شوند. .IP "" یک پالایه BCJ آدرس‌های نسبی در کد ماشین را به معادل‌های مطلق آن‌ها تبدیل می‌کند. این کار اندازه داده‌ها را تغییر نمی‌دهد اما افزونگی (redundancy) را افزایش می‌دهد، که می‌تواند به LZMA2 کمک کند تا فایل .B .xz تولیدی بین ۰ تا ۱۵\ % کوچک‌تر شود. پالایه‌های BCJ همیشه برگشت‌پذیر هستند، بنابراین استفاده از پالایه BCJ برای نوع داده نادرست باعث هیچ‌گونه از دست رفتن داده‌ها نمی‌شود، اگرچه ممکن است نسبت فشرده‌سازی را اندکی بدتر کند. پالایه‌های BCJ بسیار سریع هستند و مقدار ناچیزی از حافظه را مصرف می‌کنند. .IP "" این پالایه‌های BCJ مشکلات شناخته‌شده‌ای در رابطه با نسبت فشرده‌سازی دارند: .RS .IP \(bu 3 برخی انواع فایل‌های حاوی کد اجرایی (برای مثال، فایل‌های شیء، کتابخانه‌های ایستا و ماژول‌های کرنل لینوکس) آدرس‌های موجود در دستورالعمل‌ها را با مقادیر پرکننده پر کرده‌اند. این پالایه‌های BCJ همچنان تبدیل آدرس را انجام می‌دهند که باعث بدتر شدن فشرده‌سازی در این فایل‌ها خواهد شد. .IP \(bu 3 اگر یک پالایه BCJ روی یک آرشیو اعمال شود، ممکن است نسبت فشرده‌سازی را نسبت به عدم استفاده از پالایه BCJ بدتر کند. برای مثال، اگر فایل‌های اجرایی مشابه یا حتی یکسانی وجود داشته باشند، فیلتر کردن احتمالاً فایل‌ها را کمتر شبیه به یکدیگر می‌کند و بنابراین فشرده‌سازی بدتر می‌شود. محتوای فایل‌های غیر اجرایی در همان آرشیو نیز می‌تواند اهمیت داشته باشد. در عمل فرد باید با و بدون پالایه BCJ آزمایش کند تا ببیند در هر شرایط کدام بهتر است. .RE .IP "" مجموعه دستورالعمل‌های مختلف ترازهای متفاوتی دارند: فایل اجرایی باید با مضربی از این مقدار در داده‌های ورودی تراز شده باشد تا پالایه کار کند. .RS .RS .PP .TS tab(;); l n l l n l. Filter;Alignment;Notes x86;1;32-bit or 64-bit x86 ARM;4; ARM-Thumb;2; ARM64;4;4096-byte alignment is best PowerPC;4;Big endian only IA-64;16;Itanium SPARC;4; .TE .RE .RE .IP "" از آنجا که داده‌های پالایش‌شده با BCJ معمولاً با LZMA2 فشرده می‌شوند، در صورتی که گزینه‌های LZMA2 طوری تنظیم شوند که با تراز پالایه BCJ انتخاب‌شده مطابقت داشته باشند، ممکن است نسبت فشرده‌سازی اندکی بهبود یابد. برای مثال، با پالایه IA-64، خوب است که .B pb=4 یا حتی .B pb=4,lp=4,lc=0 را در LZMA2 تنظیم کنید (2^4=16). پالایه x86 یک استثنا است؛ هنگام فشرده‌سازی فایل‌های اجرایی x86 معمولاً بهتر است به تراز چهار بایتی پیش‌فرض LZMA2 پایبند بمانید. .IP "" تمام پالایه‌های BCJ از گزینه‌های .I options یکسانی پشتیبانی می‌کنند: .RS .TP \BI start=\fIoffset\fR تعیین .I offset آغازین که هنگام تبدیل بین آدرس‌های نسبی و مطلق استفاده می‌شود. مقدار .I offset باید مضربی از تراز پالایه باشد (جدول بالا را ببینید). مقدار پیش‌فرض صفر است. در عمل، مقدار پیش‌فرض مناسب است؛ تعیین یک .I offset سفارشی تقریباً هرگز مفید نیست. .RE .TP \fB\-\-\delta\fR[\fB=\fIoptions\fR] افزودن پالایه دلتا (Delta) به زنجیره پالایه. پالایه دلتا تنها می‌تواند به عنوان پالایه غیر آخر در زنجیره پالایه استفاده شود. .IP "" در حال حاضر تنها محاسبه دلتای بایتی ساده پشتیبانی می‌شود. این گزینه می‌تواند هنگام فشرده‌سازی مواردی مانند تصاویر بیت‌مپ فشرده‌نشده یا صدای PCM فشرده‌نشده مفید باشد. با این حال، الگوریتم‌های با کاربرد خاص ممکن است نتایج بسیار بهتری نسبت به Delta + LZMA2 ارائه دهند. این امر به‌ویژه در مورد صدا صادق است، که برای مثال با .BR flac (1) سریع‌تر و بهتر فشرده می‌شود. .IP "" گزینه‌های .I options پشتیبانی‌شده: .RS .TP \BI dist=\fIdistance\fR تعیین .I distance محاسبه دلتا به بایت. مقدار .I distance باید ۱\(en۲۵۶ باشد. مقدار پیش‌فرض 1 است. .IP "" برای مثال، با .B dist=2 و ورودی هشت بایتی A1 B1 A2 B3 A3 B5 A4 B7، خروجی برابر با A1 B1 01 02 01 02 01 02 خواهد بود. .RE . .SS "سایر گزینه‌ها (Other options)" .TP .BR \-q ", " \-\-\quiet فرونشاندن هشدارها و پیام‌ها. این گزینه را دو بار مشخص کنید تا خطاها نیز فرونشانده شوند. این گزینه هیچ تأثیری بر وضعیت خروج ندارد. به این معنا که حتی اگر هشداری فرونشانده شده باشد، همچنان از وضعیت خروج نشان‌دهنده هشدار استفاده می‌شود. .TP .BR \-v ", " \-\-\verbose حالت پرجزئیات. اگر خطای استاندارد به یک ترمینال متصل باشد، .B xz یک نشانگر پیشرفت را نمایش خواهد داد. مشخص کردن دو بار .B \-\-\verbose خروجی پرجزئیات‌تری ارائه می‌دهد. .IP "" نشانگر پیشرفت اطلاعات زیر را نشان می‌دهد: .RS .IP \(bu 3 درصد تکمیل در صورتی که اندازه فایل ورودی مشخص باشد نمایش داده می‌شود. به این معنا که درصد پیشرفت در لوله‌ها (pipes) قابل نمایش نیست. .IP \(bu 3 مقدار داده‌های فشرده تولیدشده (در فشرده‌سازی) یا مصرف‌شده (در بازگشایی). .IP \(bu 3 مقدار داده‌های فشرده‌نشده مصرف‌شده (در فشرده‌سازی) یا تولیدشده (در بازگشایی). .IP \(bu 3 نسبت فشرده‌سازی، که از تقسیم مقدار داده‌های فشرده پردازش‌شده تاکنون بر مقدار داده‌های فشرده‌نشده پردازش‌شده تاکنون به دست می‌آید. .IP \(bu 3 سرعت فشرده‌سازی یا بازگشایی. این سرعت به عنوان مقدار داده‌های فشرده‌نشده مصرف‌شده (فشرده‌سازی) یا تولیدشده (بازگشایی) در ثانیه اندازه‌گیری می‌شود. این مقدار پس از گذشت چند ثانیه از شروع پردازش فایل توسط .B xz نمایش داده می‌شود. .IP \(bu 3 زمان سپری‌شده در قالب M:SS یا H:MM:SS. .IP \(bu 3 زمان تخمینی باقی‌مانده تنها زمانی نمایش داده می‌شود که اندازه فایل ورودی مشخص باشد و چند ثانیه از شروع پردازش فایل توسط .B xz گذشته باشد. زمان در قالبی با دقت کمتر نمایش داده می‌شود که هرگز شامل دو نقطه نیست، برای مثال 2 min 30 s. .RE .IP "" هنگامی که خطای استاندارد ترمینال نباشد، .B \-\-\verbose باعث می‌شود .B xz نام فایل، اندازه فشرده، اندازه فشرده‌نشده، نسبت فشرده‌سازی و احتمالاً سرعت و زمان سپری‌شده را پس از فشرده‌سازی یا بازگشایی فایل در یک خط در خطای استاندارد چاپ کند. سرعت و زمان سپری‌شده تنها در صورتی گنجانده می‌شوند که عملیات حداقل چند ثانیه طول کشیده باشد. اگر عملیات کامل نشود، برای مثال به دلیل وقفه توسط کاربر، درصد تکمیل نیز در صورت مشخص بودن اندازه فایل ورودی چاپ می‌شود. .TP .BR \-Q ", " \-\-\no\-warn وضعیت خروج را روی 2 تنظیم نکن حتی اگر شرایطی مستحق هشدار شناسایی شده باشد. این گزینه بر سطح پرجزئیاتی تأثیری ندارد، بنابراین هر دو گزینه .B \-\-\quiet و .B \-\-\no\-warn باید استفاده شوند تا هشدارها نمایش داده نشوند و وضعیت خروج تغییر نکند. .TP .B \-\-\robot چاپ پیام‌ها در قالبی خوانا برای ماشین. این گزینه برای سهولت در نوشتن رابط‌هایی که می‌خواهند از .B xz به جای liblzma استفاده کنند در نظر گرفته شده است، که ممکن است در اسکریپت‌های مختلف کاربرد داشته باشد. خروجی با فعال بودن این گزینه طوری طراحی شده که در نسخه‌های مختلف .B xz پایدار بماند. برای جزئیات بیشتر به بخش .B "حالت ربات (ROBOT MODE)" مراجعه کنید. .TP .B \-\-\info\-memory نمایش مقدار حافظه فیزیکی (RAM) و تعداد رشته‌های پردازنده‌ای که .B xz فکر می‌کند سامانه در اختیار دارد و محدودیت‌های مصرف حافظه برای فشرده‌سازی و بازگشایی در قالبی خوانا برای انسان، و خروج موفقیت‌آمیز. .TP .BR \-h ", " \-\-\help نمایش پیام کمکی توصیف‌کننده گزینه‌های پرکاربردتر، و خروج موفقیت‌آمیز. .TP .BR \-H ", " \-\-\long\-help نمایش پیام کمکی توصیف‌کننده تمام ویژگی‌های .BR xz ، و خروج موفقیت‌آمیز. .TP .BR \-V ", " \-\-\version نمایش شماره نسخه .B xz و liblzma در قالبی خوانا برای انسان. برای دریافت خروجی قابل تجزیه توسط ماشین، .B \-\-\robot را قبل از .B \-\-\version مشخص کنید. . .SH "حالت ربات (ROBOT MODE)" حالت ربات با گزینه .B \-\-\robot فعال می‌شود. این حالت خروجی .B xz را برای تجزیه توسط برنامه‌های دیگر آسان‌تر می‌کند. در حال حاضر .B \-\-\robot تنها همراه با گزینه‌های .BR \-\-\version ، .B \-\-\info\-memory و .B \-\-\list پشتیبانی می‌شود. این قابلیت در آینده برای فشرده‌سازی و بازگشایی نیز پشتیبانی خواهد شد. . .SS "نسخه (Version)" دستور .B "xz \-\-\robot \-\-\version" شماره نسخه .B xz و liblzma را در قالب زیر چاپ می‌کند: .PP \BI XZ_VERSION=\fIXYYYZZZS\fR .br \BI LIBLZMA_VERSION=\fIXYYYZZZS\fR .TP .I X نسخه اصلی (Major). .TP .I YYY نسخه فرعی (Minor). اعداد زوج پایدار هستند. اعداد فرد نسخه‌های آلفا یا بتا می‌باشند. .TP .I ZZZ سطح وصله (patch level) برای انتشارهای پایدار یا صرفاً یک شمارنده برای نسخه‌های توسعه. .TP .I S پایداری. 0 نشان‌دهنده آلفا، 1 بتا و 2 پایدار است. مقدار .I S زمانی که .I YYY زوج باشد همیشه باید ۲ باشد. .PP اگر .B xz و liblzma از یک انتشار واحد XZ Utils باشند، مقادیر .I XYYYZZZS در هر دو خط یکسان هستند. .PP مثال‌ها: نسخه 4.999.9beta برابر با .B 49990091 و نسخه 5.0.0 برابر با .B 50000002 است. . .SS "اطلاعات محدودیت حافظه (Memory limit information)" دستور .B "xz \-\-\robot \-\-\info\-memory" یک سطر منفرد با ستون‌هایی جداشده با تب چاپ می‌کند: .IP 1. 4 کل حافظه فیزیکی (RAM) به بایت. .IP 2. 4 سقف مصرف حافظه برای فشرده‌سازی به بایت .RB ( \-\-\memlimit\-compress ). مقدار ویژه .B 0 نشان‌دهنده تنظیم پیش‌فرض است که برای حالت تک‌رشته‌ای همان بدون محدودیت است. .IP 3. 4 سقف مصرف حافظه برای بازگشایی به بایت .RB ( \-\-\memlimit\-decompress ). مقدار ویژه .B 0 نشان‌دهنده تنظیم پیش‌فرض است که برای حالت تک‌رشته‌ای همان بدون محدودیت است. .IP 4. 4 از .B xz 5.3.4alpha: میزان مصرف حافظه برای بازگشایی چندرشته‌ای به بایت .RB ( \-\-\memlimit\-mt\-decompress ). این مقدار هرگز صفر نیست زیرا در صورتی که هیچ محدودیتی به صراحت مشخص نشده باشد از مقدار پیش‌فرض وابسته به سامانه که در ستون ۵ نشان داده شده استفاده می‌شود. این مقدار همچنین هرگز بزرگ‌تر از مقدار ستون ۳ نیست حتی اگر مقدار بزرگ‌تری با .B \-\-\memlimit\-mt\-decompress مشخص شده باشد. .IP 5. 4 از .B xz 5.3.4alpha: یک سقف مصرف حافظه پیش‌فرض وابسته به سامانه که برای محدود کردن تعداد رشته‌ها هنگام فشرده‌سازی با تعداد رشته خودکار .RB ( \-\-\threads=0 ) و بدون محدودیت مشخص‌شده برای مصرف حافظه .RB ( \-\-\memlimit\-compress ) استفاده می‌شود. این مقدار همچنین به عنوان مقدار پیش‌فرض برای .B \-\-\memlimit\-mt\-decompress استفاده می‌شود. .IP 6. 4 از .B xz 5.3.4alpha: تعداد رشته‌های پردازنده در دسترس. .PP در آینده، خروجی .B "xz \-\-\robot \-\-\info\-memory" ممکن است ستون‌های بیشتری داشته باشد، اما هرگز بیش از یک خط نخواهد بود. . .SS "حالت فهرست (List mode)" دستور .B "xz \-\-\robot \-\-\list" از خروجی جداشده با تب استفاده می‌کند. ستون اول هر سطر دارای رشته‌ای است که نوع اطلاعات موجود در آن سطر را مشخص می‌کند: .TP .B name این همیشه اولین سطر هنگام شروع فهرست کردن یک فایل است. ستون دوم در این سطر، نام فایل است. .TP .B file این سطر حاوی اطلاعات کلی درباره فایل .B .xz است. این سطر همیشه پس از سطر .B name چاپ می‌شود. .TP .B stream این نوع سطر تنها زمانی استفاده می‌شود که .B \-\-\verbose مشخص شده باشد. به تعداد جریان‌های موجود در فایل .B .xz سطرهای .B stream وجود دارد. .TP .B block این نوع سطر تنها زمانی استفاده می‌شود که .B \-\-\verbose مشخص شده باشد. به تعداد بلوک‌های موجود در فایل .B .xz سطرهای .B block وجود دارد. سطرهای .B block پس از تمام سطرهای .B stream نمایش داده می‌شوند؛ انواع مختلف سطرها با یکدیگر در هم نمی‌آمیزند. .TP .B summary این نوع سطر تنها زمانی استفاده می‌شود که .B \-\-\verbose دو بار مشخص شده باشد. این سطر پس از تمام سطرهای .B block چاپ می‌شود. همانند سطر .BR file ، سطر .B summary شامل اطلاعات کلی درباره فایل .B .xz است. .TP .B totals این سطر همیشه آخرین سطر خروجی فهرست است. این سطر تعداد و اندازه‌های کلی را نشان می‌دهد. .PP ستون‌های سطرهای .BR file : .PD 0 .RS .IP 2. 4 تعداد جریان‌ها در فایل .IP 3. 4 تعداد کل بلوک‌ها در جریان(ها) .IP 4. 4 اندازه فشرده فایل .IP 5. 4 اندازه فشرده‌نشده فایل .IP 6. 4 نسبت فشرده‌سازی، برای مثال .BR 0.123 . اگر نسبت بیش از ۹٫۹۹۹ باشد، سه خط تیره .RB ( \-\-\-\- ) به جای نسبت نمایش داده می‌شود. .IP 7. 4 فهرست جداشده با کاما از نام‌های بررسی یکپارچگی. رشته‌های زیر برای انواع بررسی شناخته‌شده استفاده می‌شوند: .BR None ، .BR CRC32 ، .BR CRC64 و .BR SHA\-256 . برای انواع بررسی ناشناخته، \BI Unknown\-\fIN\fR استفاده می‌شود، که در آن .I N شناسه بررسی به صورت یک عدد ده‌دهی (یک یا دو رقم) است. .IP 8. 4 اندازه کل فاصله‌گذاری جریان (stream padding) در فایل .RE .PD .PP ستون‌های سطرهای .BR stream : .PD 0 .RS .IP 2. 4 شماره جریان (جریان اول ۱ است) .IP 3. 4 تعداد بلوک‌ها در جریان .IP 4. 4 آفست آغازین فشرده .IP 5. 4 آفست آغازین فشرده‌نشده .IP 6. 4 اندازه فشرده (شامل فاصله‌گذاری جریان نمی‌شود) .IP 7. 4 اندازه فشرده‌نشده .IP 8. 4 نسبت فشرده‌سازی .IP 9. 4 نام بررسی یکپارچگی .IP 10. 4 اندازه فاصله‌گذاری جریان .RE .PD .PP ستون‌های سطرهای .BR block : .PD 0 .RS .IP 2. 4 شماره جریان حاوی این بلوک .IP 3. 4 شماره بلوک نسبت به ابتدای جریان (بلوک اول ۱ است) .IP 4. 4 شماره بلوک نسبت به ابتدای فایل .IP 5. 4 آفست آغازین فشرده نسبت به ابتدای فایل .IP 6. 4 آفست آغازین فشرده‌نشده نسبت به ابتدای فایل .IP 7. 4 اندازه کل فشرده بلوک (شامل سرایندها) .IP 8. 4 اندازه فشرده‌نشده .IP 9. 4 نسبت فشرده‌سازی .IP 10. 4 نام بررسی یکپارچگی .RE .PD .PP اگر .B \-\-\verbose دو بار مشخص شده باشد، ستون‌های اضافی در سطرهای .B block گنجانده می‌شوند. این موارد با یک بار .B \-\-\verbose نمایش داده نمی‌شوند، زیرا دریافت این اطلاعات نیازمند جستجوهای فراوان روی دیسک است و می‌تواند کُند باشد: .PD 0 .RS .IP 11. 4 مقدار بررسی یکپارچگی در مبنای شانزده (هگزادسیمال) .IP 12. 4 اندازه سرایند بلوک .IP 13. 4 پرچم‌های بلوک: .B c نشان می‌دهد که اندازه فشرده وجود دارد، و .B u نشان می‌دهد که اندازه فشرده‌نشده وجود دارد. اگر پرچم تنظیم نشده باشد، یک خط تیره .RB ( \- ) به جای آن نشان داده می‌شود تا طول رشته ثابت بماند. پرچم‌های جدید ممکن است در آینده به انتهای رشته اضافه شوند. .IP 14. 4 اندازه داده‌های فشرده واقعی در بلوک (این مقدار شامل سرایند بلوک، فاصله‌گذاری بلوک و فیلدهای بررسی نمی‌شود) .IP 15. 4 مقدار حافظه (به بایت) مورد نیاز برای بازگشایی این بلوک با این نسخه از .B xz .IP 16. 4 زنجیره پالایه. توجه داشته باشید که بیشتر گزینه‌های استفاده‌شده در زمان فشرده‌سازی قابل بازیابی نیستند، زیرا تنها گزینه‌هایی که برای بازگشایی مورد نیاز هستند در سرایندهای .B .xz ذخیره می‌شوند. .RE .PD .PP ستون‌های سطرهای .BR summary : .PD 0 .RS .IP 2. 4 مقدار حافظه (به بایت) مورد نیاز برای بازگشایی این فایل با این نسخه از .B xz .IP 3. 4 .B yes یا .B no که نشان می‌دهد آیا در تمام سرایندهای بلوک هر دو اندازه فشرده و فشرده‌نشده ذخیره شده‌اند یا خیر .PP .I از .B xz .IR 5.1.2alpha : .IP 4. 4 حداقل نسخه .B xz مورد نیاز برای بازگشایی فایل .RE .PD .PP ستون‌های سطر .BR totals : .PD 0 .RS .IP 2. 4 تعداد جریان‌ها .IP 3. 4 تعداد بلوک‌ها .IP 4. 4 اندازه فشرده .IP 5. 4 اندازه فشرده‌نشده .IP 6. 4 میانگین نسبت فشرده‌سازی .IP 7. 4 فهرست جداشده با کاما از نام‌های بررسی یکپارچگی که در فایل‌ها وجود داشتند .IP 8. 4 اندازه فاصله‌گذاری جریان .IP 9. 4 تعداد فایل‌ها. این مورد برای حفظ ترتیب ستون‌های پیشین همانند سطرهای .B file در اینجا قرار گرفته است. .PD .RE .PP اگر .B \-\-\verbose دو بار مشخص شده باشد، ستون‌های اضافی در سطر .B totals گنجانده می‌شوند: .PD 0 .RS .IP 10. 4 حداکثر مقدار حافظه (به بایت) مورد نیاز برای بازگشایی فایل‌ها با این نسخه از .B xz .IP 11. 4 .B yes یا .B no که نشان می‌دهد آیا در تمام سرایندهای بلوک هر دو اندازه فشرده و فشرده‌نشده ذخیره شده‌اند یا خیر .PP .I از .B xz .IR 5.1.2alpha : .IP 12. 4 حداقل نسخه .B xz مورد نیاز برای بازگشایی فایل .RE .PD .PP نسخه‌های آینده ممکن است انواع سطرهای جدیدی اضافه کنند و ستون‌های جدیدی می‌توانند به انواع سطرهای موجود اضافه شوند، اما ستون‌های موجود تغییر نخواهند کرد. .TP .B 0 همه‌چیز مرتب است و عملیات با موفقیت انجام شد. .TP .B 1 خطایی رخ داد. .TP .B 2 موردی شایسته هشدار رخ داد، اما هیچ خطای واقعی اتفاق نیفتاد. .PP پیام‌های اطلاع‌رسانی (که هشدار یا خطا نیستند) چاپ‌شده در خطای استاندارد بر وضعیت خروج تأثیری ندارند. . .SH "متغیرهای محیطی (ENVIRONMENT)" دستور .B xz فهرست‌های جداشده با فاصله از گزینه‌ها را از متغیرهای محیطی .B XZ_DEFAULTS و .BR XZ_OPT ، به همین ترتیب، پیش از تجزیه گزینه‌ها از خط فرمان تجزیه می‌کند. توجه داشته باشید که تنها گزینه‌ها از متغیرهای محیطی استخراج می‌شوند؛ تمام موارد غیر گزینه بی کم‌وکاست نادیده گرفته می‌شوند. تجزیه با استفاده از .BR getopt_long (3) انجام می‌شود که برای آرگومان‌های خط فرمان نیز به کار می‌رود. .TP .B XZ_DEFAULTS گزینه‌های پیش‌فرض کاربر یا سامانه. معمولاً این متغیر در اسکریپت راه‌اندازی شل تنظیم می‌شود تا محدودکننده مصرف حافظه .B xz به‌طور پیش‌فرض فعال شود. به جز اسکریپت‌های راه‌اندازی شل و موارد خاص مشابه، اسکریپت‌ها هرگز نباید .B XZ_DEFAULTS را مقداردهی یا پاک کنند. .TP .B XZ_OPT این متغیر برای ارسال گزینه‌ها به .B xz است در زمانی که امکان تعیین مستقیم گزینه‌ها در خط فرمان .B xz وجود ندارد. این حالت زمانی است که .B xz توسط یک اسکریپت یا ابزار دیگر، مانند GNU .BR tar (1) اجرا می‌شود: .RS .RS .PP .nf .ft CW XZ_OPT=\-2v tar caf foo.tar.xz foo .ft R .fi .RE .RE .IP "" اسکریپت‌ها ممکن است از .B XZ_OPT برای مثال جهت تنظیم گزینه‌های پیش‌فرض فشرده‌سازی مخصوص اسکریپت استفاده کنند. همچنان توصیه می‌شود به کاربران اجازه داده شود تا در صورت لزوم .B XZ_OPT را لغو و بازنویسی کنند. برای مثال در اسکریپت‌های .BR sh (1) می‌توان از چیزی شبیه به این استفاده کرد: .RS .RS .PP .nf .ft CW XZ_OPT=${XZ_OPT\-"\-7e"} export XZ_OPT .ft R .fi .RE .RE . .SH "سازگاری با LZMA UTILS (LZMA UTILS COMPATIBILITY)" نحو خط فرمان .B xz عملاً یک ابرمجموعه از .BR lzma ، .BR unlzma و .B lzcat در نسخه 4.32.x از LZMA Utils است. در بیشتر موارد، امکان جایگزینی LZMA Utils با XZ Utils بدون شکستن اسکریپت‌های موجود وجود دارد. با این حال، برخی ناسازگاری‌ها وجود دارند که ممکن است گاهی مشکل‌ساز شوند. . .SS "سطوح پیش‌تنظیم فشرده‌سازی (Compression preset levels)" شماره‌گذاری سطوح پیش‌تنظیم فشرده‌سازی در .B xz و LZMA Utils یکسان نیست. مهم‌ترین تفاوت نحوه نگاشت اندازه‌های لغت‌نامه به پیش‌تنظیم‌های مختلف است. اندازه لغت‌نامه تقریباً برابر با میزان مصرف حافظه بازگشا است. .RS .PP .TS tab(;); c c c c n n. Level;xz;LZMA Utils \-0;256 KiB;N/A \-1;1 MiB;64 KiB \-2;2 MiB;1 MiB \-3;4 MiB;512 KiB \-4;4 MiB;1 MiB \-5;8 MiB;2 MiB \-6;8 MiB;4 MiB \-7;16 MiB;8 MiB \-8;32 MiB;16 MiB \-9;64 MiB;32 MiB .TE .RE .PP تفاوت‌های اندازه لغت‌نامه بر میزان مصرف حافظه فشرده‌ساز نیز تأثیر می‌گذارد، اما تفاوت‌های دیگری نیز میان LZMA Utils و XZ Utils وجود دارد که این اختلاف را باز هم بیشتر می‌کند: .RS .PP .TS tab(;); c c c c n n. Level;xz;LZMA Utils 4.32.x \-0;3 MiB;N/A \-1;9 MiB;2 MiB \-2;17 MiB;12 MiB \-3;32 MiB;12 MiB \-4;48 MiB;16 MiB \-5;94 MiB;26 MiB \-6;94 MiB;45 MiB \-7;186 MiB;83 MiB \-8;370 MiB;159 MiB \-9;674 MiB;311 MiB .TE .RE .PP سطح پیش‌تنظیم پیش‌فرض در LZMA Utils برابر با .B \-7 است در حالی که در XZ Utils برابر با .B \-6 می‌باشد، بنابراین هر دو به‌طور پیش‌فرض از یک لغت‌نامه ۸ MiB استفاده می‌کنند. . .SS "فایل‌های .lzma جریانی در برابر غیرجریانی (Streamed vs. non-streamed .lzma files)" اندازه فشرده‌نشده فایل می‌تواند در سرایند .B .lzma ذخیره شود. مجموعه LZMA Utils هنگام فشرده‌سازی فایل‌های معمولی این کار را انجام می‌دهد. روش جایگزین این است که اندازه فشرده‌نشده ناشناخته علامت‌گذاری شود و از نشانگر پایان بار داده (end-of-payload marker) برای تعیین جایی که بازگشا باید متوقف شود استفاده گردد. مجموعه LZMA Utils زمانی که اندازه فشرده‌نشده مشخص نباشد از این روش استفاده می‌کند، که برای مثال در لوله‌ها (pipes) صادق است. .PP دستور .B xz از بازگشایی فایل‌های .B .lzma با نشانگر یا بدون نشانگر پایان بار داده پشتیبانی می‌کند، اما تمام فایل‌های .B .lzma ایجادشده توسط .B xz از نشانگر پایان بار داده استفاده خواهند کرد و اندازه فشرده‌نشده در سرایند .B .lzma ناشناخته علامت‌گذاری خواهد شد. این امر ممکن است در برخی شرایط نادر مشکل‌ساز شود. برای مثال، یک بازگشای .B .lzma در یک دستگاه تعبیه‌شده ممکن است تنها با فایل‌هایی کار کند که اندازه فشرده‌نشده آن‌ها مشخص باشد. اگر با این مشکل مواجه شدید، باید از LZMA Utils یا LZMA SDK برای ایجاد فایل‌های .B .lzma با اندازه فشرده‌نشده مشخص استفاده کنید. . .SS "فایل‌های .lzma پشتیبانی‌نشده (Unsupported .lzma files)" قالب .B .lzma مقادیر .I lc را تا ۸ و مقادیر .I lp را تا ۴ مجاز می‌داند. مجموعه LZMA Utils می‌تواند فایل‌هایی با هر مقدار .I lc و .I lp را بازگشایی کند، اما همیشه فایل‌هایی با .B lc=3 و .B lp=0 ایجاد می‌نماید. ایجاد فایل‌هایی با سایر مقادیر .I lc و .I lp با .B xz و LZMA SDK امکان‌پذیر است. .PP پیاده‌سازی پالایه LZMA1 در liblzma نیازمند آن است که مجموع .I lc و .I lp نباید از ۴ تجاوز کند. بنابراین فایل‌های .B .lzma که از این محدودیت تجاوز می‌کنند نمی‌توانند با .B xz بازگشایی شوند. .PP مجموعه LZMA Utils تنها فایل‌های .B .lzma را ایجاد می‌کند که اندازه لغت‌نامه آن‌ها .RI "2^" n (توانی از ۲) باشد، اما فایل‌هایی با هر اندازه لغت‌نامه را می‌پذیرد. کتابخانه liblzma تنها فایل‌های .B .lzma را می‌پذیرد که اندازه لغت‌نامه آن‌ها .RI "2^" n یا .RI "2^" n " + 2^(" n "\-1)" باشد. این کار برای کاهش موارد مثبت کاذب هنگام تشخیص فایل‌های .B .lzma است. .PP این محدودیت‌ها در عمل نباید مشکلی ایجاد کنند، چرا که عملاً تمام فایل‌های .B .lzma با تنظیماتی فشرده شده‌اند که liblzma آن‌ها را می‌پذیرد. . .SS "زباله پایانی (Trailing garbage)" هنگام بازگشایی، LZMA Utils بدون هیچ پیامی تمام داده‌های بعد از نخستین جریان .B .lzma را نادیده می‌گیرد. در بیشتر شرایط، این یک باگ است. این همچنین بدان معنی است که LZMA Utils از بازگشایی فایل‌های الحاق‌شده .B .lzma پشتیبانی نمی‌کند. .PP اگر داده‌ای پس از نخستین جریان .B .lzma باقی بماند، .B xz فایل را خراب تلقی می‌کند مگر اینکه از .B \-\-\single\-stream استفاده شده باشد. این رفتار ممکن است اسکریپت‌های قدیمی و نادری را که فرض کرده بودند زباله پایانی نادیده گرفته می‌شود، دچار اختلال کند. . .SH "نکات (NOTES)" . .SS "خروجی فشرده‌شده ممکن است متفاوت باشد (Compressed output may vary)" خروجی فشرده دقیق تولیدشده از یک فایل ورودی فشرده‌نشده یکسان ممکن است بین نسخه‌های مختلف XZ Utils حتی با وجود یکسان بودن گزینه‌های فشرده‌سازی متفاوت باشد. دلیل این امر آن است که کدگذار می‌تواند بدون تأثیر بر قالب فایل بهبود یابد (فشرده‌سازی سریع‌تر یا بهتر). خروجی حتی می‌تواند بین ساخت‌های (builds) مختلف از یک نسخه واحد XZ Utils، در صورت استفاده از گزینه‌های ساخت متفاوت، متغیر باشد. .PP مطلب فوق بدان معناست که پس از پیاده‌سازی گزینه .BR \-\-\rsyncable ، فایل‌های حاصل لزوماً قابلیت rsync نخواهند داشت مگر اینکه هر دو فایل قدیمی و جدید با نسخه یکسانی از xz فشرده شده باشند. این مشکل در صورتی قابل حل است که بخشی از پیاده‌سازی کدگذار ثابت (freeze) نگه داشته شود تا خروجی سازگار با rsync در نسخه‌های مختلف xz پایدار بماند. . .SS "بازگشاهای تعبیه‌شده .xz (Embedded .xz decompressors)" پیاده‌سازی‌های بازگشای تعبیه‌شده .B .xz مانند XZ Embedded لزوماً از فایل‌های ایجادشده با انواع بررسی یکپارچگی .I check دیگری غیر از .B none و .B crc32 پشتیبانی نمی‌کنند. از آنجا که مقدار پیش‌فرض .B \-\-\check=crc64 است، هنگام ایجاد فایل برای سامانه‌های تعبیه‌شده (embedded) باید از .B \-\-\check=none یا .B \-\-\check=crc32 استفاده کنید. .PP خارج از سامانه‌های تعبیه‌شده، تمام بازگشاهای قالب .B .xz از تمام انواع .I check پشتیبانی می‌کنند، یا دست‌کم قادرند فایل را بدون راستی‌آزمایی بررسی یکپارچگی در صورتی که آن نوع خاص .I check پشتیبانی نشود، بازگشایی کنند. .PP مجموعه XZ Embedded از پالایه‌های BCJ پشتیبانی می‌کند، اما تنها با آفست آغازین پیش‌فرض. . .SH "مثال‌ها (EXAMPLES)" . .SS "پایه‌ای (Basics)" فشرده‌سازی فایل .I foo به .I foo.xz با استفاده از سطح فشرده‌سازی پیش‌فرض .RB ( \-6 )، و حذف .I foo در صورت موفقیت‌آمیز بودن فشرده‌سازی: .RS .PP .nf .ft CW xz foo .ft R .fi .RE .PP بازگشایی .I bar.xz به .I bar و عدم حذف .I bar.xz حتی در صورت موفقیت‌آمیز بودن بازگشایی: .RS .PP .nf .ft CW xz \-dk bar.xz .ft R .fi .RE .PP ایجاد .I baz.tar.xz با پیش‌تنظیم .B \-4e .RB ( "\-4 \-\-extreme" )، که کندتر از پیش‌فرض .B \-6 است، اما به حافظه کمتری برای فشرده‌سازی و بازگشایی نیاز دارد (به ترتیب 48\ MiB و 5\ MiB): .RS .PP .nf .ft CW tar cf \- baz | xz \-4e > baz.tar.xz .ft R .fi .RE .PP ترکیبی از فایل‌های فشرده‌شده و فشرده‌نشده را می‌توان با یک دستور واحد به خروجی استاندارد بازگشایی کرد: .RS .PP .nf .ft CW xz \-dcf a.txt b.txt.xz c.txt d.txt.lzma > abcd.txt .ft R .fi .RE . .SS "فشرده‌سازی موازی چندین فایل (Parallel compression of many files)" در سامانه‌های GNU و *BSD، می‌توان از .BR find (1) و .BR xargs (1) برای موازی‌سازی فشرده‌سازی چندین فایل استفاده کرد: .RS .PP .nf .ft CW find . \-type f \e! \-name '*.xz' \-print0 \e | xargs \-0r \-P4 \-n16 xz \-T1 .ft R .fi .RE .PP گزینه .B \-P در .BR xargs (1) تعداد فرآیندهای موازی .B xz را تعیین می‌کند. بهترین مقدار برای گزینه .B \-n بستگی به این دارد که چه تعداد فایل برای فشرده‌سازی وجود دارد. اگر فقط چند فایل وجود دارد، مقدار آن احتمالاً باید 1 باشد؛ با ده‌ها هزار فایل، 100 یا حتی بیشتر ممکن است مناسب باشد تا تعداد فرآیندهای .B xz ایجادشده توسط .BR xargs (1) کاهش یابد. .PP گزینه .B \-T1 برای .B xz به این دلیل آمده است که آن را مجبور به حالت تک‌رشته‌ای کند، زیرا .BR xargs (1) برای کنترل میزان موازی‌سازی استفاده می‌شود. . .SS "حالت ربات (Robot mode)" محاسبه مجموع بایت‌های ذخیره‌شده پس از فشرده‌سازی چندین فایل: .RS .PP .nf .ft CW xz \-\-robot \-\-list *.xz | awk '/^totals/{print $5\-$4}' .ft R .fi .RE .PP ممکن است اسکریپتی بخواهد بداند آیا از نسخه به‌اندازه کافی جدید .B xz استفاده می‌کند یا خیر. اسکریپت .BR sh (1) زیر بررسی می‌کند که شماره نسخه ابزار .B xz حداقل 5.0.0 باشد. این روش با نسخه‌های آزمایشی قدیمی که از گزینه .B \-\-robot پشتیبانی نمی‌کردند سازگار است: .RS .PP .nf .ft CW if ! eval "$(xz \-\-robot \-\-version 2> /dev/null)" || [ "$XZ_VERSION" \-lt 50000002 ]; then echo "Your xz is too old." fi unset XZ_VERSION LIBLZMA_VERSION .ft R .fi .RE .PP تعیین محدودیت مصرف حافظه برای بازگشایی با استفاده از .BR XZ_OPT ، اما اگر محدودیت از قبل تعیین شده باشد، مقدار آن افزایش نیابد: .RS .PP .nf .ft CW NEWLIM=$((123 << 20))\ \ # 123 MiB OLDLIM=$(xz \-\-robot \-\-info\-memory | cut \-f3) if [ $OLDLIM \-eq 0 \-o $OLDLIM \-gt $NEWLIM ]; then XZ_OPT="$XZ_OPT \-\-memlimit\-decompress=$NEWLIM" export XZ_OPT fi .ft R .fi .RE . .SS "زنجیره‌های پالایه سفارشی فشرده‌ساز (Custom compressor filter chains)" ساده‌ترین کاربرد زنجیره‌های پالایه سفارشی، شخصی‌سازی یک پیش‌تنظیم LZMA2 است. این امر می‌تواند مفید باشد، زیرا پیش‌تنظیم‌ها تنها زیرمجموعه‌ای از ترکیبات بالقوه مفید تنظیمات فشرده‌سازی را پوشش می‌دهند. .PP ستون‌های CompCPU در جدول‌های موجود در توضیحات گزینه‌های .BR "\-0" " ... " "\-9" و .B \-\-extreme هنگام سفارشی‌سازی پیش‌تنظیم‌های LZMA2 مفید هستند. در اینجا بخش‌های مربوطه گردآوری‌شده از آن دو جدول آمده است: .RS .PP .TS tab(;); c c n n. Preset;CompCPU \-0;0 \-1;1 \-2;2 \-3;3 \-4;4 \-5;5 \-6;6 \-5e;7 \-6e;8 .TE .RE .PP اگر می‌دانید که فایلی برای فشرده‌سازی خوب به لغت‌نامه تا حدی بزرگ (به عنوان مثال، 32\ MiB) نیاز دارد، اما می‌خواهید آن را سریع‌تر از .B "xz \-8" فشرده کنید، می‌توان یک پیش‌تنظیم با مقدار CompCPU پایین (برای مثال 1) را طوری تغییر داد که از لغت‌نامه بزرگ‌تری استفاده کند: .RS .PP .nf .ft CW xz \-\-lzma2=preset=1,dict=32MiB foo.tar .ft R .fi .RE .PP برای فایل‌های خاص، دستور بالا ممکن است سریع‌تر از .B "xz \-6" باشد در حالی که فشرده‌سازی به مراتب بهتری ارائه می‌دهد. با این حال، باید تأکید شود که تنها برخی فایل‌ها از یک لغت‌نامه بزرگ با حفظ مقدار CompCPU پایین بهره‌مند می‌شوند. واضح‌ترین وضعیتی که یک لغت‌نامه بزرگ می‌تواند کمک شایانی کند، آرشیوی شامل فایل‌های بسیار مشابه است که هر کدام دست‌کم چند مگابایت حجم دارند. اندازه لغت‌نامه باید به مراتب بزرگ‌تر از هر تک‌فایل باشد تا به LZMA2 اجازه دهد از شباهت‌های بین فایل‌های متوالی بیشترین استفاده را ببرد. .PP اگر مصرف بسیار بالای حافظه فشرده‌ساز و بازگشا مشکلی نداشته باشد، و فایلی که فشرده می‌شود دست‌کم چند صد مگابایت باشد، استفاده از لغت‌نامه‌ای حتی بزرگ‌تر از 64\ MiB که .B "xz \-9" استفاده می‌کند ممکن است سودمند باشد: .RS .PP .nf .ft CW xz \-vv \-\-lzma2=dict=192MiB big_foo.tar .ft R .fi .RE .PP استفاده از .B \-vv .RB ( "\-\-verbose \-\-verbose" ) همانند مثال بالا می‌تواند برای مشاهده نیازمندی‌های حافظه فشرده‌ساز و بازگشا مفید باشد. به یاد داشته باشید که استفاده از لغت‌نامه‌ای بزرگ‌تر از اندازه فایل فشرده‌نشده هدر دادن حافظه است، بنابراین دستور بالا برای فایل‌های کوچک کاربردی ندارد. .PP گاهی اوقات زمان فشرده‌سازی اهمیتی ندارد، اما مصرف حافظه بازگشا باید پایین نگه داشته شود، برای مثال، جهت امکان بازگشایی فایل در یک سامانه تعبیه‌شده. دستور زیر از .B \-6e .RB ( "\-6 \-\-extreme" ) به عنوان پایه استفاده کرده و لغت‌نامه را تنها روی 64\ KiB تنظیم می‌کند. فایل حاصل را می‌توان با XZ Embedded (دلیل حضور .B \-\-check=crc32 همین است) با مصرف حدود 100\ KiB حافظه بازگشایی کرد. .RS .PP .nf .ft CW xz \-\-check=crc32 \-\-lzma2=preset=6e,dict=64KiB foo .ft R .fi .RE .PP اگر می‌خواهید تا جای ممکن تک‌تک بایت‌ها فشرده شوند، تنظیم تعداد بیت‌های زمینه لفظی .RI ( lc ) و تعداد بیت‌های موقعیت .RI ( pb ) گاهی می‌تواند کمک‌کننده باشد. تنظیم تعداد بیت‌های موقعیت لفظی .RI ( lp ) نیز ممکن است مفید باشد، اما معمولاً .I lc و .I pb مهم‌تر هستند. به عنوان مثال، یک آرشیو کد منبع عمدتاً شامل متن US-ASCII است، بنابراین چیزی شبیه به دستور زیر ممکن است فایلی کمی (مثلاً 0.1\ %) کوچک‌تر از .B "xz \-6e" تولید کند (همچنین بدون .B lc=4 نیز امتحان کنید): .RS .PP .nf .ft CW xz \-\-lzma2=preset=6e,pb=0,lc=4 source_code.tar .ft R .fi .RE .PP استفاده از یک پالایه دیگر در کنار LZMA2 می‌تواند فشرده‌سازی را برای انواع خاصی از فایل‌ها بهبود بخشد. به عنوان مثال، برای فشرده‌سازی یک کتابخانه مشترک x86-32 یا x86-64 با استفاده از پالایه BCJ مربوط به x86: .RS .PP .nf .ft CW xz \-\-x86 \-\-lzma2 libfoo.so .ft R .fi .RE .PP توجه داشته باشید که ترتیب گزینه‌های پالایه اهمیت دارد. اگر .B \-\-x86 پس از .B \-\-lzma2 مشخص شود، .B xz خطا خواهد داد، زیرا هیچ پالایه‌ای نمی‌تواند پس از LZMA2 قرار گیرد، و همچنین به این دلیل که پالایه BCJ برای x86 نمی‌تواند به عنوان آخرین پالایه در زنجیره استفاده شود. .PP پالایه دلتا (Delta) به همراه LZMA2 می‌تواند نتایج خوبی در تصاویر بیتی (bitmap) به همراه داشته باشد. این ترکیب معمولاً باید عملکردی بهتر از PNG داشته باشد، که از چند پالایه پیشرفته‌تر از دلتای ساده استفاده می‌کند اما از Deflate برای فشرده‌سازی واقعی بهره می‌برد. .PP تصویر باید در یک قالب فشرده‌نشده، مثلاً به صورت TIFF فشرده‌نشده ذخیره شده باشد. پارامتر فاصله (distance) در پالایه دلتا طوری تنظیم می‌شود که با تعداد بایت‌های هر پیکسل در تصویر مطابقت داشته باشد. به عنوان مثال، تصویر بیتی 24-بیتی RGB به .B dist=3 نیاز دارد، و همچنین مناسب است که .B pb=0 به LZMA2 ارسال شود تا هم‌ترازی سه‌بایتی رعایت گردد: .RS .PP .nf .ft CW xz \-\-delta=dist=3 \-\-lzma2=pb=0 foo.tiff .ft R .fi .RE .PP اگر چندین تصویر در یک آرشیو واحد قرار گرفته باشند (به عنوان مثال .BR .tar )، پالایه دلتا روی آن نیز کار خواهد کرد مشروط بر اینکه همه تصاویر تعداد بایت در پیکسل یکسانی داشته باشند. . .SH "همچنین ببینید (SEE ALSO)" .BR xzdec (1)، .BR xzdiff (1)، .BR xzgrep (1)، .BR xzless (1)، .BR xzmore (1)، .BR gzip (1)، .BR bzip2 (1)، .BR 7z (1) .PP مجموعه XZ Utils: .br مجموعه XZ Embedded: .br مجموعه کدهای توسعه LZMA SDK: . .SH "نویسنده (AUTHOR)" Lasse Collin . .SH "گزارش باگ‌ها (REPORTING BUGS)" گزارش باگ‌ها به: (به زبان انگلیسی یا فنلاندی). .br همچنین فهرست پستی پروژه XZ Utils و سامانه رهگیری باگ در GitHub: . .SH "حق نشر (COPYRIGHT)" حق نشر \(co 2009\-2022 Lasse Collin و پدیدآورندگان XZ Utils. .br این فایل و کد منبع مرتبط در مالکیت عمومی (Public Domain) قرار دارند. شما می‌توانید هر کاری می‌خواهید با این فایل انجام دهید.