.\" Automatically generated by Pandoc 2.7.3
.\"
.TH "brotli" "1" "14 اوت 2021" "brotli 1.0.9" "دستورات کاربر"
.hy
.SH "نام (NAME)"
brotli \- فشرده‌سازی یا باز کردن فایل‌های فشرده با الگوریتم Brotli
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[B]brotli\f[R] [\f[I]گزینه|فایل\f[R]]\&...
.PP
دستور \f[B]brcat\f[R] معادل \f[B]brotli \-\-decompress \-\-concatenated \-\-stdout\f[R] است
.PP
دستور \f[B]unbrotli\f[R] معادل \f[B]brotli \-\-decompress\f[R] است
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\f[B]brotli\f[R]
یک الگوریتم فشرده‌سازی همه‌منظوره و بدون اتلاف است که داده‌ها را با استفاده از ترکیبی از گونه‌ای نوین از الگوریتم
\f[B]LZ77\f[R]،
کدگذاری هافمن و مدل‌سازی زمینه مرتبه دوم فشرده می‌کند، همراه با نسبت فشرده‌سازی قابل مقایسه با بهترین روش‌های فشرده‌سازی همه‌منظوره موجود.
سرعت آن مشابه با deflate است اما فشرده‌سازی متراکم‌تری ارائه می‌دهد.
.PP
نحو خط فرمان
\f[B]brotli\f[R]
مشابه با
\f[B]gzip (1)\f[R]
و
\f[B]zstd (1)\f[R]
است. برخلاف
\f[B]gzip (1)\f[R]،
فایل‌های منبع به‌طور پیش‌فرض حفظ می‌شوند. امکان حذف آن‌ها پس از پردازش با استفاده از گزینه
\f[B]\-\-rm\f[R]
وجود دارد.
.PP
آرگومان‌هایی که شبیه به
\[lq]\f[B]\-\-name\f[R]\[rq]
یا
\[lq]\f[B]\-\-name=value\f[R]\[rq]
هستند، \f[I]گزینه\f[R] محسوب می‌شوند. هر \f[I]گزینه\f[R] دارای یک شکل کوتاه
\[lq]\f[B]\-x\f[R]\[rq]
یا
\[lq]\f[B]\-x value\f[R]\[rq]
است. چندین شکل کوتاه از \f[I]گزینه‌ها\f[R] می‌توانند ادغام شوند:
.IP \[bu] 2
\[lq]\f[B]\-\-decompress \-\-stdout \-\-suffix=.b\f[R]\[rq] عملکرد یکسانی با
.IP \[bu] 2
\[lq]\f[B]\-d \-s \-S .b\f[R]\[rq] و
.IP \[bu] 2
\[lq]\f[B]\-dsS .b\f[R]\[rq] دارد.
.PP
دستور
\f[B]brotli\f[R]
دارای ۳ حالت عملیاتی است:
.IP \[bu] 2
حالت پیش‌فرض فشرده‌سازی است؛
.IP \[bu] 2
گزینه
\f[B]\-\-decompress\f[R]
حالت بازگشایی (خروج از حالت فشرده) را فعال می‌کند؛
.IP \[bu] 2
گزینه
\f[B]\-\-test\f[R]
به حالت آزمایش یکپارچگی جابه‌جا می‌شود؛ این گزینه معادل
\[lq]\f[B]\-\-decompress \-\-stdout\f[R]\[rq]
است با این تفاوت که داده‌های بازگشایی‌شده به‌جای نوشته شدن در خروجی استاندارد، دور ریخته می‌شوند.
.PP
هر آرگومان غیرگزینه‌ای یک ورودی \f[I]فایل\f[R] است.
اگر هیچ \f[I]فایلی\f[R] مشخص نشود یا نام \f[I]فایل\f[R] برابر با
\[lq]\f[B]\-\f[R]\[rq]
باشد،
\f[B]brotli\f[R]
از ورودی استاندارد می‌خواند. همه آرگومان‌های پس از
\[lq]\f[B]\-\-\f[R]\[rq]
ورودی‌های \f[I]فایل\f[R] به حساب می‌آیند.
.PP
مگر اینکه
\f[B]\-\-stdout\f[R]
یا
\f[B]\-\-output\f[R]
مشخص شده باشد، \f[I]فایل‌ها\f[R] در یک فایل جدید نوشته می‌شوند که نام آن از نام \f[I]فایل\f[R] منبع مشتق شده است:
.IP \[bu] 2
هنگام فشرده‌سازی، یک پسوند به انتهای نام فایل منبع افزوده می‌شود تا نام فایل مقصد به دست آید
.IP \[bu] 2
هنگام بازگشایی، پسوند از انتهای نام فایل منبع حذف می‌شود تا نام فایل مقصد به دست آید
.PP
پسوند پیش‌فرض
\f[B].br\f[R]
است، اما می‌توان آن را با گزینه
\f[B]\-\-suffix\f[R]
تعیین کرد.
.PP
گزینه‌های (\f[I]options\f[R]) تکراری یا متناقض مجاز نیستند.
.SH "گزینه‌ها (OPTIONS)"
.IP \[bu] 2
\f[B]\-#\f[R]: سطح فشرده‌سازی (۰-۹)؛ مقادیر بزرگ‌تر باعث فشرده‌سازی متراکم‌تر اما کُندتر می‌شوند
.IP \[bu] 2
\f[B]\-c\f[R], \f[B]\-\-stdout\f[R]: نوشتن در خروجی استاندارد
.IP \[bu] 2
\f[B]\-d\f[R], \f[B]\-\-decompress\f[R]: حالت بازگشایی (خروج از حالت فشرده)
.IP \[bu] 2
\f[B]\-f\f[R], \f[B]\-\-force\f[R]: بازنویسی اجباری فایل خروجی
.IP \[bu] 2
\f[B]\-h\f[R], \f[B]\-\-help\f[R]: نمایش این راهنما و خروج
.IP \[bu] 2
\f[B]\-j\f[R], \f[B]\-\-rm\f[R]: حذف فایل(های) منبع؛ رفتاری مشابه با \f[B]gzip (1)\f[R]
.IP \[bu] 2
\f[B]\-k\f[R], \f[B]\-\-keep\f[R]: نگه‌داشتن فایل(های) منبع؛ رفتاری مشابه با \f[B]zstd (1)\f[R]
.IP \[bu] 2
\f[B]\-n\f[R], \f[B]\-\-no\-copy\-stat\f[R]: عدم کپی ویژگی‌ها و مشخصات فایل(های) منبع
.IP \[bu] 2
\f[B]\-o FILE\f[R], \f[B]\-\-output=FILE\f[R]: فایل خروجی؛ تنها زمانی معتبر است که یک ورودی تکی وجود داشته باشد
.IP \[bu] 2
\f[B]\-q NUM\f[R], \f[B]\-\-quality=NUM\f[R]: سطح فشرده‌سازی (۰-۱۱)؛ مقادیر بزرگ‌تر باعث فشرده‌سازی متراکم‌تر اما کُندتر می‌شوند
.IP \[bu] 2
\f[B]\-t\f[R], \f[B]\-\-test\f[R]: حالت آزمایش یکپارچگی فایل
.IP \[bu] 2
\f[B]\-v\f[R], \f[B]\-\-verbose\f[R]: افزایش میزان جزئیات خروجی
.IP \[bu] 2
\f[B]\-w NUM\f[R], \f[B]\-\-lgwin=NUM\f[R]: تنظیم اندازه پنجره LZ77 بین (۰، ۱۰-۲۴) (پیش‌فرض: ۲۴)؛ اندازه پنجره برابر با \f[B](pow(2, NUM) \- 16)\f[R] است؛ مقدار ۰ تصمیم‌گیری درباره مقدار بهینه را به فشرده‌ساز واگذار می‌کند؛ اندازه‌های بزرگ‌تر پنجره، تراکم را بهبود می‌بخشند؛ رمزگشا ممکن است برای اجرا به حافظه‌ای تا اندازه پنجره نیاز داشته باشد
.IP \[bu] 2
\f[B]\-C B64\f[R], \f[B]\-\-comment=B64\f[R]: تنظیم یادداشت؛ آرگومان ابتدا بر پایه base64 رمزگشایی می‌شود؛ هنگام رمزگشایی: بررسی یادداشت جریان؛ هنگام فشرده‌سازی: تعبیه یادداشت (اثرانگشت)
.IP \[bu] 2
\f[B]\-D FILE\f[R], \f[B]\-\-dictionary=FILE\f[R]: استفاده از FILE به عنوان فرهنگ‌لغت خام (LZ77)؛ الزاماً باید از یک فرهنگ‌لغت یکسان هم برای فشرده‌سازی و هم برای بازگشایی استفاده شود
.IP \[bu] 2
\f[B]\-K\f[R], \f[B]\-\-concatenated\f[R]: هنگام رمزگشایی، پذیرش جریان‌های متوالی و به‌هم‌پیوسته بروتلی به عنوان ورودی
.IP \[bu] 2
\f[B]\-S SUF\f[R], \f[B]\-\-suffix=SUF\f[R]: پسوند فایل خروجی (پیش‌فرض: \f[B].br\f[R])
.IP \[bu] 2
\f[B]\-V\f[R], \f[B]\-\-version\f[R]: نمایش نسخه و خروج
.IP \[bu] 2
\f[B]\-Z\f[R], \f[B]\-\-best\f[R]: استفاده از بهترین سطح فشرده‌سازی (پیش‌فرض)؛ معادل \[lq]\f[B]\-q 11\f[R]\[rq]
.SH "همچنین ببینید (SEE ALSO)"
.PP
قالب پرونده
\f[B]brotli\f[R]
در سند RFC 7932 تعریف شده است:
.br
<https://www.ietf.org/rfc/rfc7932.txt>
.PP
ابزار
\f[B]brotli\f[R]
تحت مجوز آزاد MIT منتشر شده است:
.br
<https://opensource.org/licenses/MIT>
.PP
فهرست پستی:
.br
<https://groups.google.com/forum/#!forum/brotli>
.SH "گزارش اشکالات (REPORTING BUGS)"
.PP
گزارش اشکالات و خطاها در:
.br
<https://github.com/google/brotli/issues>
.SH "نویسندگان (AUTHORS)"
.PP
الگوریتم و ابزار
\f[B]brotli\f[R]
توسط Jyrki Alakuijala و Zoltan Szabadka توسعه داده شده است.