.TH pbzip2 1
.SH "نام (NAME)"
pbzip2 \- فشرده‌ساز موازی فایل‌های bzip2، نسخه ۱.۱.۱۰
.SH "خلاصه دستور (SYNOPSIS)"
.B pbzip2
.RB [ " \-123456789 " ]
.RB [ " \-b#cdfhklm#p#qrS#tvVz " ]
[
.I "filenames \&..."
]
.SH "توضیحات (DESCRIPTION)"
.I pbzip2
یک پیاده‌سازی موازی از فشرده‌ساز فایل مبتنی بر مرتب‌سازی بلوکی bzip2 است که از pthreads استفاده می‌کند و در سیستم‌های SMP به شتاب و افزایش سرعت تقریباً خطی دست می‌یابد. خروجی این نسخه کاملاً با bzip2 نسخه ۱.۰.۲ یا جدیدتر سازگار است (یعنی هر آنچه با
.I pbzip2
فشرده شود، با bzip2 قابل استخراج و از حالت فشرده خارج کردن است).
.PP
.I pbzip2
باید روی هر سیستمی که دارای کامپایلر C++ سازگار با pthreads باشد (مانند gcc) کار کند. این برنامه روی سیستم‌عامل‌های لینوکس، ویندوز (cygwin)، سولاریس، Tru64/OSF1، HP-UX و Irix آزمایش شده است.
.PP
تنظیمات پیش‌فرض
.I pbzip2
در بیشتر موارد به خوبی کار خواهد کرد. تنها سوییچ‌هایی که احتمالاً به آن‌ها نیاز خواهید داشت عبارتند از
.B \-d
برای خارج کردن فایل‌ها از حالت فشرده و
.B \-p
برای تعیین تعداد پردازنده‌ها جهت استفاده توسط
.I pbzip2
در صورتی که تشخیص خودکار روی سیستم شما پشتیبانی نشود، یا بخواهید از تعداد مشخصی پردازنده (CPU) استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-b#
که در آن # اندازه بلوک در گام‌های 100k است (پیش‌فرض 9 = 900k)
.TP
.B \-c, \-\-stdout
ارسال خروجی به خروجی استاندارد (stdout)
.TP
.B \-d,\-\-decompress
خارج کردن فایل از حالت فشرده
.TP
.B \-f,\-\-force
اجبار، بازنویسی فایل خروجی موجود
.TP
.B \-h,\-\-help
چاپ این پیام راهنما
.TP
.B \-k,\-\-keep
نگه‌داشتن فایل ورودی، عدم حذف آن
.TP
.B \-l,\-\-loadavg
میانگین بار سیستم حداکثر تعداد پردازنده‌های مورد استفاده را تعیین می‌کند
.TP
.B \-m#
که در آن # حداکثر حافظه مصرفی در گام‌های 1MB است (پیش‌فرض 100 = 100MB)
.TP
.B \-p#
که در آن # تعداد پردازنده‌ها است (پیش‌فرض: تشخیص خودکار)
.TP
.B \-q,\-\-quiet
حالت بی‌صدا (پیش‌فرض)
.TP
.B \-r,\-\-read
خواندن کل فایل ورودی در حافظه RAM و تقسیم آن میان پردازنده‌ها
.TP
.B \-S#
اندازه پشته ریسه فرزند در گام‌های 1KB (اندازه پشته پیش‌فرض در صورت عدم تعیین)
.TP
.B \-t,\-\-test
بررسی و آزمایش یکپارچگی فایل فشرده
.TP
.B \-v,\-\-verbose
حالت پرحرف و با جزئیات
.TP
.B \-V
نمایش اطلاعات نسخه
.I pbzip2
و سپس خروج
.TP
.B \-z,\-\-compress
فشرده‌سازی فایل (پیش‌فرض)
.TP
.B \-1,\-\-fast ... \-9,\-\-best
تنظیم اندازه بلوک BWT از 100k تا 900k (پیش‌فرض 900k).
.TP
.B \-\-ignore-trailing-garbage=#
فلگ نادیده گرفتن داده‌های زائد انتهایی (1 \- نادیده گرفته شود؛ 0 \- غیرمجاز)
.PP
اگر هیچ نام فایلی داده نشود، pbzip2 از ورودی استاندارد فشرده یا از حالت فشرده خارج کرده و به خروجی استاندارد ارسال می‌کند.
.SH "اندازه فایل‌ها (FILE SIZES)"
شما باید بتوانید فایل‌های بزرگ‌تر از 4GB را با
.I pbzip2
فشرده کنید.
.PP
فایل‌هایی که با
.I pbzip2
فشرده می‌شوند به چند قطعه تقسیم شده و هر قطعه به‌صورت مستقل فشرده می‌شود. به این ترتیب
.I pbzip2
روی چندین پردازنده سریع‌تر اجرا می‌شود زیرا قطعات می‌توانند به‌طور هم‌زمان فشرده شوند. فایل نهایی ‎.bz2 ممکن است به دلیل این قطعه‌بندی، کمی بزرگ‌تر از حالتی باشد که با برنامه معمول bzip2 فشرده می‌شود (معمولاً کمتر از ۰.۲ درصد بزرگ‌تر). همچنین فایل‌هایی که با
.I pbzip2
فشرده شده‌اند، هنگام خارج شدن از حالت فشرده با استفاده از
.I pbzip2
سرعت بسیار بیشتری خواهند داشت.
.PP
فایل‌هایی که با bzip2 فشرده شده‌اند، بهبود سرعتی نخواهند داشت زیرا bzip2 داده‌ها را در یک بلوک یکپارچه بسته‌بندی می‌کند که میان پردازنده‌ها قابل تقسیم نیست.
.SH "مثال‌ها (EXAMPLES)"
مثال ۱: pbzip2 myfile.tar
.PP
این مثال فایل "myfile.tar" را در فایل فشرده "myfile.tar.bz2" فشرده می‌کند. این دستور از تعداد پردازنده‌های به‌طور خودکار شناسایی‌شده (یا ۲ پردازنده در صورت عدم پشتیبانی از تشخیص خودکار) همراه با اندازه بلوک فایل پیش‌فرض 900k و اندازه بلوک BWT پیش‌فرض 900k استفاده خواهد کرد.
.PP
مثال ۲: pbzip2 \-b15k myfile.tar
.PP
این مثال فایل "myfile.tar" را در فایل فشرده "myfile.tar.bz2" فشرده می‌کند. این دستور از تعداد پردازنده‌های به‌طور خودکار شناسایی‌شده (یا ۲ پردازنده در صورت عدم پشتیبانی از تشخیص خودکار) با اندازه بلوک فایل 1500k و اندازه بلوک BWT معادل 900k استفاده خواهد کرد. فایل "myfile.tar" پس از پایان فشرده‌سازی حذف نخواهد شد.
.PP
مثال ۳: pbzip2 \-p4 \-r \-5 myfile.tar second*.txt
.PP
این مثال فایل "myfile.tar" را در فایل فشرده "myfile.tar.bz2" فشرده می‌کند. از ۴ پردازنده با اندازه بلوک BWT معادل 500k استفاده خواهد کرد. اندازه بلوک فایل برابر با اندازه "myfile.tar" تقسیم بر ۴ (تعداد پردازنده‌ها) خواهد بود تا داده‌ها به‌طور یکنواخت میان هر پردازنده تقسیم شوند. این نیازمند آن است که حافظه RAM کافی برای pbzip2 داشته باشید تا کل فایل را برای فشرده‌سازی در حافظه بخواند. سپس pbzip2 از همان گزینه‌ها برای فشرده‌سازی تمام فایل‌های دیگری که با الگوی "second*.txt" در آن دایرکتوری مطابقت دارند استفاده خواهد کرد.
.PP
مثال ۴: tar cf myfile.tar.bz2 \-\-use\-compress\-prog=pbzip2 dir_to_compress/
.br
مثال ۴: tar \-c directory_to_compress/ | pbzip2 \-c > myfile.tar.bz2
.PP
این مثال‌ها داده‌هایی را که از طریق لوله (pipe) از TAR به pbzip2 داده می‌شوند در فایل فشرده "myfile.tar.bz2" فشرده می‌کنند. این دستور از تعداد پردازنده‌های به‌طور خودکار شناسایی‌شده (یا ۲ پردازنده در صورت عدم پشتیبانی از تشخیص خودکار) با اندازه بلوک فایل پیش‌فرض 900k و اندازه بلوک BWT پیش‌فرض 900k استفاده خواهد کرد. دستور TAR در حین کار تمام فایل‌ها را از دایرکتوری "directory_to_compress/" جمع‌آوری کرده و داده‌ها را به pbzip2 ارسال می‌کند.
.PP
مثال ۵: pbzip2 \-d \-m500 myfile.tar.bz2
.PP
این مثال فایل "myfile.tar.bz2" را به فایل فشرده‌نشده "myfile.tar" استخراج می‌کند. این دستور از تعداد پردازنده‌های به‌طور خودکار شناسایی‌شده (یا ۲ پردازنده در صورت عدم پشتیبانی از تشخیص خودکار) استفاده خواهد کرد. برای خروج از حالت فشرده حداکثر از 500MB حافظه استفاده خواهد کرد. سوییچ‌های \-b و \-r و \-1..\-9 برای خروج از حالت فشرده مجاز نیستند.
.PP
مثال ۶: pbzip2 \-dc myfile.tar.bz2 | tar x
.PP
این مثال فایل "myfile.tar.bz2" را از حالت فشرده خارج کرده و باز می‌کند (untar)، به‌طوری‌که خروجی pbzip2 در حال استخراج به tar لوله‌کشی (pipe) می‌شود.
.PP
مثال ۷: pbzip2 \-c < myfile.txt > myfile.txt.bz2
.PP
این مثال myfile.txt را از ورودی استاندارد خوانده، آن را در خروجی استاندارد فشرده می‌کند که به myfile.txt.bz2 هدایت می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR bzip2 (1),
.BR gzip (1),
.BR lzip (1),
.BR rzip (1),
.BR zip (1)
.SH "نویسنده (AUTHOR)"
Jeff Gilchrist
.PP
<http://compression.ca>