ATOOL(1) General Commands Manual ATOOL(1)

atool - اسکریپتی برای مدیریت پرونده‌های فشرده و آرشیو از انواع گوناگون

atool [OPTION]... ARCHIVE [FILE]...
aunpack [OPTION]... ARCHIVE [FILE]...
apack [OPTION]... ARCHIVE [FILE]...
als [OPTION]... ARCHIVE [FILE]...
acat [OPTION]... ARCHIVE [FILE]...
adiff [OPTION]... ARCHIVE ARCHIVE
arepack [OPTION]... OLD-ARCHIVE NEW-ARCHIVE

این صفحه راهنما دستورات atool را شرح می‌دهد. این دستورات برای مدیریت پرونده‌های فشرده و آرشیو از انواع گوناگون، مانند آرشیوهای tar و Zip، استفاده می‌شوند. هر دستور می‌تواند به صورت جداگانه یا با مشخص کردن گزینه‌های مناسب برای atool اجرا شود (بخش گزینه‌ها (OPTIONS) را در ادامه ببینید).

دستور aunpack پرونده‌ها را از یک آرشیو استخراج می‌کند. اغلب مایل هستیم تمام پرونده‌های درون یک آرشیو را در یک زیرپوشه استخراج کنیم. با این حال، برخی آرشیوها حاوی چندین پرونده در دایرکتوری ریشه خود هستند. برنامه aunpack این مشکل را با استخراج اولیه پرونده‌ها درون یک دایرکتوری منحصر‌به‌فرد (موقت) و سپس بازگرداندن محتویات آن در صورت امکان حل می‌کند. این کار همچنین از بازنویسی تصادفی پرونده‌های محلی جلوگیری می‌کند.

دستور apack آرشیو ایجاد می‌کند (یا پرونده‌ها را فشرده می‌سازد). اگر هیچ آرگومان پرونده‌ای مشخص نشده باشد، نام پرونده‌های موردنظر برای افزودن از ورودی استاندارد خوانده می‌شود.

دستور als پرونده‌های موجود در یک آرشیو را فهرست می‌کند.

دستور acat پرونده‌های درون یک آرشیو را در خروجی استاندارد استخراج و نمایش می‌دهد.

دستور adiff با استفاده از diff(1) تفاوت میان دو آرشیو را تولید می‌کند.

دستور arepack آرشیوها را با فرمتی دیگر بازبسته‌بندی می‌کند. این کار ابتدا با استخراج تمام پرونده‌های آرشیو قدیمی درون یک دایرکتوری موقت و سپس بسته‌بندی تمام پرونده‌های استخراج‌شده از آن دایرکتوری در آرشیو جدید انجام می‌شود. از گزینه --each (-e) در ترکیب با --format (-F) برای بازبسته‌بندی چندین آرشیو با یک بار اجرای atool استفاده کنید. توجه داشته باشید که arepack آرشیو قدیمی را حذف نخواهد کرد.

مگر اینکه گزینه --format (-F) مشخص شده باشد، فرمت آرشیو توسط پسوند پرونده آرشیو تعیین می‌شود؛ به عنوان مثال پسوند «.tar.gz» یا «.tgz» به معنای فرمت tar+gzip است. توجه داشته باشید که پسوندها به ترتیبی که در بخش فرمت‌های آرشیو (ARCHIVE TYPES) در زیر آمده است بررسی می‌شوند؛ به همین دلیل است که پرونده‌ای با پسوند «.tar.gz» به عنوان یک آرشیو tar+gzip در نظر گرفته می‌شود، نه یک پرونده فشرده‌شده ساده با gzip.

این برنامه‌ها از قواعد معمول نحو خط فرمان گنو (GNU) پیروی می‌کنند که در آن گزینه‌های طولانی با دو خط تیره (`-') آغاز می‌شوند. خلاصه‌ای از گزینه‌ها در زیر آورده شده است.

فهرست کردن پرونده‌های درون آرشیو. این گزینه هنگام اجرای als به طور خودکار فعال در نظر گرفته می‌شود.
استخراج پرونده‌ها از آرشیو. این گزینه هنگام اجرای aunpack به طور خودکار فعال در نظر گرفته می‌شود.
استخراج پرونده‌ها از آرشیو در دایرکتوری مشخص‌شده. هنگام باز کردن پرونده‌های فشرده، PATH می‌تواند به یک نام پرونده یا یک دایرکتوری موجود اشاره کند.
ایجاد آرشیو. این گزینه هنگام اجرای apack به طور خودکار فعال در نظر گرفته می‌شود.
استخراج یک پرونده از آرشیو به خروجی استاندارد (نمایش آن روی صفحه). این گزینه هنگام اجرای acat به طور خودکار فعال در نظر گرفته می‌شود.
استخراج دو آرشیو و استفاده از diff(1) برای تولید تفاوت‌های میان آن‌ها. این گزینه هنگام اجرای adiff به طور خودکار فعال در نظر گرفته می‌شود.
به ازای هر آرگومان، دستور مشخص‌شده را اجرا می‌کند. این گزینه می‌تواند برای استخراج، فهرست کردن یا ایجاد سریع چندین آرشیو استفاده شود (بخش مثال‌ها (EXAMPLES) را در ادامه ببینید). این گزینه را نمی‌توان همراه با دستور cat استفاده کرد.
مشخص کردن دستی فرمت آرشیو (بخش فرمت‌های آرشیو (ARCHIVE TYPES) را در ادامه ببینید).
اجرای atool در حالت شبیه‌سازی. هیچ تغییری در سیستم‌فایل (نظیر نوشتن داده‌ها) اعمال نخواهد شد و به جای آن تمام دستوراتی که قرار است اجرا شوند نمایش داده می‌شوند. این گزینه را نمی‌توان با --explain ترکیب کرد (زیرا خود شامل آن است).
توجه داشته باشید تضمینی وجود ندارد که دستورات چاپ‌شده در حالت شبیه‌سازی دقیقاً همان‌هایی باشند که در حالت غیرشبیه‌سازی اجرا می‌شوند. علت این است که برخی عملیات به این بستگی دارد که آرشیوها حاوی چه پرونده‌هایی هستند، و atool در این حالت تنها با استخراج آرشیوها می‌تواند آن را تشخیص دهد.
نمایش دستوراتی که توسط atool اجرا می‌شوند. این گزینه را نمی‌توان با --simulate ترکیب کرد.
هدایت خروجی به یک صفحه‌بندی‌کننده (pager)، معمولاً pager مگر اینکه متغیر محیطی PAGER تنظیم شده باشد.
هنگام استخراج پرونده‌ها، اجازه بازنویسی روی پرونده‌های محلی را می‌دهد. هنگام ایجاد یک آرشیو، در صورتی که پرونده آرشیو از قبل وجود داشته باشد، اجازه بازنویسی آن را می‌دهد. توجه داشته باشید که امکان افزودن پرونده‌ها به آرشیوهای موجود RAR و Zip وجود دارد (این کار برای بسیاری از فرمت‌های دیگر امکان‌پذیر نیست).
هنگام استخراج آرشیوها، همیشه یک دایرکتوری جدید برای آرشیو ایجاد می‌کند، حتی اگر آرشیو تنها حاوی یک پرونده در دایرکتوری ریشه خود باشد.
-0, --null
اگر هنگام ایجاد یا افزودن پرونده‌ها به آرشیوها هیچ آرگومان پرونده‌ای مشخص نشده باشد، فهرست پرونده‌ها از ورودی استاندارد خوانده می‌شود. به طور معمول این نام پرونده‌ها با نویسه خط جدید (newline) از هم جدا می‌شوند، اما با این گزینه با بایت‌های خالی (null-bytes) جدا می‌شوند. این گزینه همراه با گزینه -print0 در GNU find بسیار کاربردی است.
کاهش سطح پرگویی به میزان یک واحد. این مقدار از سطح پرگویی پیش‌فرض یا سطح مشخص‌شده با --verbosity کسر می‌شود. این گزینه می‌تواند چندین بار مشخص شود تا atool پیام‌های کمتری نمایش دهد.
افزایش سطح پرگویی به میزان یک واحد. این مقدار به سطح پرگویی پیش‌فرض یا سطح مشخص‌شده با --verbosity اضافه می‌شود. این گزینه می‌تواند چندین بار مشخص شود تا atool پیام‌های با جزئیات بیشتری نمایش دهد.
تعیین سطح پرگویی. سطح پیش‌فرض برابر با 1 است که به معنای «پرگویی عادی» است؛ به عنوان مثال هنگام ایجاد و استخراج از آرشیوها، پرونده‌ها فهرست می‌شوند.
بارگذاری پیکربندی از پرونده مشخص‌شده. هنگام استفاده از این گزینه، پرونده‌های پیکربندی سراسری سیستم و کاربر بارگذاری نخواهند شد. اگر پرونده مشخص‌شده وجود نداشته باشد یا قابل خواندن نباشد، atool با یک پیام خطا متوقف می‌شود.
بازنویسی یک گزینه پیکربندی. این گزینه‌ها پس از خواندن پرونده‌های پیکربندی اعمال می‌شوند.
می‌توانید این گزینه را چندین بار برای بازنویسی گزینه‌های مختلف مشخص کنید.
ارسال گزینه‌های اضافی به دستور آرشیوکننده. این گزینه می‌تواند هنگام مشخص کردن گزینه‌های فشرده‌سازی برای برخی آرشیوها کاربردی باشد؛ به عنوان مثال:
apack -F7z -O-mx=9 archive.7z dir
می‌توانید این گزینه را چندین بار برای افزودن گزینه‌های مختلف مشخص کنید.
هنگام استخراج پرونده‌ها، نام دایرکتوری‌ای را که آرشیو در آن استخراج شده است، در پرونده مشخص‌شده ذخیره می‌کند. اگر دستور `extract' نبوده یا آرشیو در یک دایرکتوری جدید استخراج نشده باشد، چیزی در پرونده مشخص‌شده نوشته نخواهد شد. اگر چندین آرشیو مشخص شده باشند (با -e)، تنها آخرین دایرکتوری‌ای که پرونده‌ها در آن استخراج شده‌اند در FILE نوشته خواهد شد.
این گزینه به صورت داخلی استفاده می‌شود (بخش مثال‌ها (EXAMPLES) را در ادامه ببینید).
نمایش چکیده گزینه‌ها.
نمایش اطلاعات نسخه و خروج.

مگر اینکه گزینه -f (--format) مشخص شده باشد، فرمت آرشیو توسط پسوند پرونده آرشیو تعیین می‌شود؛ به عنوان مثال پسوند «.tar.gz» یا «.tgz» به معنای فرمت tar+gzip است. توجه داشته باشید که پسوندها به ترتیبی که در بالا فهرست شده است بررسی می‌شوند؛ به همین دلیل است که پرونده‌ای با پسوند «.tar.gz» به عنوان یک آرشیو tar+gzip در نظر گرفته می‌شود، نه یک آرشیو ساده gzip.

دستور diff در هر جایی که دستور extract پشتیبانی شود، پشتیبانی می‌شود.

انواع آرشیو پشتیبانی‌شده عبارتند از:

tar+gzip (.tar.gz, .tgz)
از تمام دستورات پشتیبانی می‌شود.
tar+bzip (.tar.bz, .tbz)
از تمام دستورات پشتیبانی می‌شود.
tar+bzip2 (.tar.bz2, .tbz2)
از تمام دستورات پشتیبانی می‌شود.
tar+compress (.tar.Z, .tZ)
از تمام دستورات پشتیبانی می‌شود.
tar+lzop (.tar.lzo, .tzo)
از تمام دستورات پشتیبانی می‌شود.
tar+lzip (.tar.lz, .tlz)
از تمام دستورات پشتیبانی می‌شود.
tar+xz (.tar.xz, .txz)
از تمام دستورات پشتیبانی می‌شود.
tar+7z (.tar.7z, .t7z)
از تمام دستورات پشتیبانی می‌شود.
tar (.tar)
از تمام دستورات پشتیبانی می‌شود.
zip (.zip)
از تمام دستورات پشتیبانی می‌شود.
jar (.jar, .war)
از دستورات list، extract و add پشتیبانی می‌شود. در صورت غیرفعال بودن use_jar_program، دستور Cat پشتیبانی می‌شود.
rar (.rar)
از تمام دستورات پشتیبانی می‌شود.
lha (.lha, .lzh)
از تمام دستورات پشتیبانی می‌شود.
7z (.7z)
از دستورات extract، list و add پشتیبانی می‌شود.
alzip (.alz)
از دستور extract پشتیبانی می‌شود.
ace (.ace)
از دستورات extract و list پشتیبانی می‌شود.
ar (.a)
از تمام دستورات پشتیبانی می‌شود.
arj (.arj)
از دستورات list، extract و add پشتیبانی می‌شود.
arc (.arc)
از تمام دستورات پشتیبانی می‌شود. (توجه داشته باشید که arc هنگام استفاده از دستور cat یک خط جدید اضافی چاپ می‌کند.)
rpm (.rpm)
از دستورات extract و list پشتیبانی می‌شود.
deb (.deb)
از دستورات extract و list پشتیبانی می‌شود.
cab (.cab)
از دستورات cat، extract و list پشتیبانی می‌شود.
gzip (.gz)
از دستورات cat، extract و add پشتیبانی می‌شود.
bzip (.bz)
از دستورات cat، extract و add پشتیبانی می‌شود.
bzip2 (.bz2)
از دستورات cat، extract و add پشتیبانی می‌شود.
compress (.Z)
از دستورات cat، extract و add پشتیبانی می‌شود.
lzma (.lzma)
از دستورات cat، extract و add پشتیبانی می‌شود.
lzop (.lzo)
از دستورات extract و add پشتیبانی می‌شود. دستور cat پشتیبانی نمی‌شود زیرا lzop تمایلی به استخراج پرونده‌ها در خروجی استاندارد ندارد مگر اینکه فلگ -f داده شود.
lzip (.lz)
از دستورات cat، extract و add پشتیبانی می‌شود.
xz (.xz)
از دستورات cat، extract و add پشتیبانی می‌شود.
rzip (.rz)
از دستورات extract و add پشتیبانی می‌شود.
lrzip (.lrz)
از دستورات extract و add پشتیبانی می‌شود.
7zip (.7z)
از تمام دستورات پشتیبانی می‌شود. (توجه داشته باشید که 7z در صورتی که خروجی استاندارد یک ترمینال باشد از نوشتن پرونده‌های استخراج‌شده در خروجی استاندارد خودداری می‌کند. هنگام خواندن در ترمینال، از -p استفاده کنید یا خروجی atool/acat را به یک صفحه‌بندی‌کننده پایپ کنید.)
cpio (.cpio)
از دستورات list، extract و add پشتیبانی می‌شود.

از نسخه 0.8.0، ابزار atool می‌تواند پرونده‌های پیکربندی سفارشی را بخواند. ابتدا مقادیر پیش‌فرض هاردکد شده در پرونده برنامه atool ارزیابی می‌شوند. سپس مقادیر پیکربندی سراسری سیستم در صورت وجود پرونده از /etc/atool.conf بارگذاری می‌شوند. در نهایت، مقادیر پیکربندی اختصاصی کاربر از .atoolrc در دایرکتوری خانگی کاربر جاری بارگذاری می‌شوند.

فرمت پرونده‌های پیکربندی ساده است:

variable value

در اینجا variable یکی از متغیرهای فهرست‌شده در زیر است و value مقداری است که باید به این متغیر اختصاص داده شود. variable و value باید حداقل با یک نویسه فاصله خالی (فاصله، تب و غیره) از هم جدا شوند. خطوط خالی و خطوطی که با # آغاز می‌شوند نادیده گرفته می‌شوند.

مقدار `1' به معنای فعال بودن گزینه است و `0' به معنای غیرفعال بودن آن. رشته‌ها نباید درون نقل‌قول قرار گیرند، زیرا از اولین نویسه غیرفاصله شروع شده و در انتهای خط پایان می‌یابند.

گزینه‌ها عبارتند از:

اگر از GNU tar استفاده می‌کنید و از گزینه --bzip2 برای فیلتر کردن پرونده‌های bzip2 از طریق bzip2 پشتیبانی می‌کند، این گزینه را فعال کنید. نسخه‌های 1.13.6 یا جدیدتر GNU tar از --bzip2 پشتیبانی می‌کنند. بنابراین اگر از نسخه‌های قدیمی‌تر GNU tar قبل از 1.13.6 استفاده می‌کنید، باید این گزینه را غیرفعال کنید.
این گزینه قبلاً use_tar_j_option بود، اما استفاده از --bzip2 سازگاری و قابلیت حمل بیشتری دارد.
اگر از GNU tar استفاده می‌کنید و از گزینه --lzip برای فیلتر کردن پرونده‌های lzip از طریق lzip پشتیبانی می‌کند، این گزینه را فعال کنید. نسخه‌های 1.23 یا جدیدتر GNU tar از --lzip پشتیبانی می‌کنند. بنابراین اگر از نسخه‌های قدیمی‌تر GNU tar قبل از 1.23 استفاده می‌کنید، باید این گزینه را غیرفعال کنید.
اگر از GNU tar استفاده می‌کنید و از گزینه -z برای فیلتر کردن پرونده‌های gzip از طریق gzip پشتیبانی می‌کند، این گزینه را فعال کنید. در صورتی که از GNU tar استفاده نمی‌کنید، باید این گزینه و use_tar_j_option را غیرفعال کنید.
غیرفعال کردن این دو گزینه به این معنی نیست که atool نمی‌تواند پرونده‌های bzip2/gzip را استخراج کند. در صورت غیرفعال بودن، atool در عوض از یک پایپ برای ارسال خروجی از bzip2/gzip به tar استفاده می‌کند.
در صورت امکان، این گزینه‌ها باید فعال باشند زیرا مدیریت خطا هنگامی که فیلترسازی توسط tar انجام می‌شود بهتر است.
اگر از GNU tar استفاده می‌کنید و از گزینه --lzma برای فیلتر کردن پرونده‌های فشرده lzma از طریق lzma پشتیبانی می‌کند، این گزینه را فعال کنید. نسخه‌های 1.20 یا جدیدتر GNU tar از --lzma پشتیبانی می‌کنند.
اگر از GNU tar استفاده می‌کنید و از گزینه --lzop برای فیلتر کردن پرونده‌های فشرده lzop از طریق lzop پشتیبانی می‌کند، این گزینه را فعال کنید. نسخه‌های 1.21 یا جدیدتر GNU tar از --lzop پشتیبانی می‌کنند.
اگر از GNU tar استفاده می‌کنید و از گزینه --xz برای فیلتر کردن پرونده‌های فشرده xz از طریق xz پشتیبانی می‌کند، این گزینه را فعال کنید. نسخه‌های 1.22 یا جدیدتر GNU tar از --xz پشتیبانی می‌کنند.
اگر می‌خواهید هنگام باز کردن پرونده‌های فشرده‌شده با compress (پرونده‌های `.Z') به جای uncompress از gzip استفاده شود، این گزینه را فعال کنید.
اگر می‌خواهید در صورت امکان همیشه به جای unrar از rar استفاده شود، این گزینه را فعال کنید. این کار باعث می‌شود atool حتی هنگام فهرست کردن و استخراج پرونده‌های RAR از دستور rar (path_rar) استفاده کند.
اگر می‌خواهید در صورت امکان همیشه به جای nomarch از arc استفاده شود، این گزینه را فعال کنید. این کار باعث می‌شود atool حتی هنگام فهرست کردن و استخراج پرونده‌های ARC از دستور arc (path_arc) استفاده کند.
اگر می‌خواهید در صورت امکان همیشه به جای unarj از arj استفاده شود، این گزینه را فعال کنید. این کار باعث می‌شود atool حتی هنگام فهرست کردن و استخراج پرونده‌های ARJ از دستور arj (path_arj) استفاده کند.
اگر find از گزینه -print0 و cpio از گزینه -0 پشتیبانی می‌کند، این گزینه را فعال کنید. بدون آن، ایجاد آرشیوهای cpio از پرونده‌هایی که در نام آن‌ها نویسه خط جدید وجود دارد غیرممکن یا بسیار سخت‌تر خواهد بود.
پرونده‌های بسته دبیان (.deb) حاوی اطلاعات کنترلی در یک دایرکتوری به نام DEBIAN هستند، به ویژه پرونده "control" بسته. اگر می‌خواهید هنگام استخراج علاوه بر پرونده‌های معمولی، اطلاعات کنترلی نیز استخراج شوند، این گزینه را فعال کنید.
انواع خاصی از پرونده‌ها در واقع آرشیو هستند، اما پسوند آن‌ها این موضوع را نشان نمی‌دهد. به عنوان مثال می‌توان به اسناد Open Office (پرونده‌های Zip) و اسناد Gnumeric (پرونده‌های فشرده gzip) اشاره کرد. از آنجا که پسوندهای این پرونده‌ها برای atool ناشناخته هستند، با تنظیم این گزینه روی 0 پسوند آن‌ها حذف نخواهد شد. پرونده خروجی در آن حالت چیزی شبیه به Unpack-XYZW خواهد بود. تنظیم این گزینه روی 1 باعث می‌شود که پسوند در عوض حذف شود.
اگر می‌خواهید به جای bzip2 از pbzip2 استفاده کنید، این گزینه را فعال کنید. لطفاً توجه داشته باشید که در صورت فعال بودن use_tar_bzip2_option، دستور tar صرف نظر از گزینه use_pbzip2 از bzip2 استفاده خواهد کرد. بنابراین اگر می‌خواهید tar به جای bzip2 از pbzip2 استفاده کند، use_pbzip2 را روی 1 و use_tar_bzip2_option را روی 0 تنظیم کنید.
اگر می‌خواهید به جای bzip2 از lbzip2 استفاده کنید، این گزینه را فعال کنید. لطفاً توجه داشته باشید که در صورت فعال بودن use_tar_bzip2_option، دستور tar صرف نظر از گزینه use_lbzip2 از bzip2 استفاده خواهد کرد. بنابراین اگر می‌خواهید tar به جای bzip2 از lbzip2 استفاده کند، use_lbzip2 را روی 1 و use_tar_bzip2_option را روی 0 تنظیم کنید.
اگر می‌خواهید به جای gzip از pigz استفاده کنید، این گزینه را فعال کنید. لطفاً توجه داشته باشید که در صورت فعال بودن use_tar_z_option، دستور tar صرف نظر از گزینه use_pigz از gzip استفاده خواهد کرد. بنابراین اگر می‌خواهید tar به جای gzip از pigz استفاده کند، use_pigz را روی 1 و use_tar_z_option را روی 0 تنظیم کنید.
اگر می‌خواهید به جای lzip از plzip استفاده کنید، این گزینه را فعال کنید. لطفاً توجه داشته باشید که در صورت فعال بودن use_tar_lzip_option، دستور tar صرف نظر از گزینه use_plzip از lzip استفاده خواهد کرد. بنابراین اگر می‌خواهید tar به جای lzip از plzip استفاده کند، use_plzip را روی 1 و use_tar_lzip_option را روی 0 تنظیم کنید.
اگر می‌خواهید برای مدیریت آرشیوهای jar از jar استفاده کنید، این گزینه را فعال کنید. اگر این گزینه را غیرفعال کنید، از zip استفاده خواهد شد (که باید به همان خوبی کار کند و احتمالاً سریع‌تر نیز خواهد بود).
این گزینه به صورت پیش‌فرض غیرفعال است، زیرا استخراج پرونده‌ها به خروجی استاندارد (`cat') توسط jar پشتیبانی نمی‌شود.
اگر می‌خواهید atool با استفاده از file(1) نوع پرونده‌ها را برای پرونده‌هایی با پسوند ناشناخته (یا بدون پسوند) شناسایی کند، این گزینه را فعال کنید.
اگر می‌خواهید atool همیشه و صرف نظر از پسوند پرونده، آرشیوها را با استفاده از file(1) شناسایی کند، این گزینه را فعال کنید. لطفاً توجه داشته باشید که این کار در حال حاضر معایبی دارد، از جمله عدم توانایی در شناسایی تمام انواع آرشیو (به‌ویژه آرشیوهای tar فشرده‌شده با 7zip، lzop، szip و غیره).
ابزار atool استخراج را در یک دایرکتوری موقت ایجادشده در دایرکتوری جاری انجام می‌دهد تا هیچ پرونده‌ای بازنویسی نشود. این متغیر نام آن دایرکتوری موقت را تعیین می‌کند.
رشته `%d' در این متغیر با یک عدد تصادفی بین 0 تا 9999 جایگزین می‌شود. می‌توان قالب این عدد را با استفاده از چیزی غیر از `%d' تغییر داد - printf(3) را ببینید.
هنگام استفاده از pbzip2 و ایجاد آرشیوها، لازم است یک پرونده موقت ایجاد شود. این گزینه نام آن پرونده را تعیین می‌کند. برای جزئیات بیشتر درباره فرمت، tmpdir_name را ببینید.
این متغیرها همگی مسیر برنامه‌های متناظر هستند. معمولاً بهتر است آن‌ها را به همان صورت پیش‌فرض رها کنید، چرا که به این ترتیب مکان آن‌ها از متغیر محیطی PATH جستجو می‌شود.
این متغیر آرگومان‌های خط فرمان را برای ارسال به دستور diff (همان‌طور که توسط path_diff مشخص شده است) هنگام استفاده از adiff تعیین می‌کند. نویسه‌های فاصله در این رشته آرگومان‌ها را از یکدیگر جدا می‌کنند.
(این متغیر فقط می‌تواند در پرونده برنامه atool تنظیم شود.) این متغیر دایرکتوری محل قرارگیری پرونده پیکربندی سراسری سیستم را مشخص می‌کند.
(این متغیر فقط می‌تواند در پرونده برنامه atool و پرونده پیکربندی سراسری سیستم تنظیم شود.) این متغیر محل قرارگیری پرونده پیکربندی کاربر را مشخص می‌کند. توجه داشته باشید که اگر این نام پرونده نسبی باشد (یعنی با `/` شروع نشود)، نسبت به دایرکتوری خانگی کاربر جاری (که توسط متغیر محیطی HOME تعیین می‌شود) در نظر گرفته خواهد شد.
این مقدار سطح پرگویی پیش‌فرض atool است. با استفاده از گزینه‌های -q و -v می‌توان سطح پرگویی را افزایش یا کاهش داد. سطح 1 به معنای «پرگویی عادی» است - به عنوان مثال هنگام ایجاد و استخراج از آرشیوها، پرونده‌ها فهرست می‌شوند.
اگر این گزینه روی 1 تنظیم شود، دستور aunpack همیشه نشان می‌دهد چه پرونده یا دایرکتوری‌ای استخراج شده است. در غیر این صورت فقط زمانی چاپ خواهد شد که آرشیو در مکانی غیرمنتظره استخراج شده باشد (در نتیجه وجود پرونده‌های محلی از قبل یا داشتن چندین پرونده در دایرکتوری ریشه آرشیو).
این گزینه می‌تواند در ترکیب با `default_verbosity 0' بسیار مفید باشد. توجه داشته باشید که این گزینه هنگام استفاده از گزینه -X همراه با aunpack هیچ تاثیری نخواهد داشت و روی پرونده‌های فشرده‌شده نیز بی‌اثر است.
هنگام فشرده‌سازی یک پرونده با gzip یا bzip2، پرونده اصلی (فشرده‌نشده) معمولاً پس از فشرده‌سازی حذف می‌شود؛ یعنی اگر پرونده "test" را فشرده کنید، تنها یک پرونده "test.gz" خواهید داشت. با تنظیم این گزینه روی 1، به atool می‌گویید که پرونده اصلی را نیز نگه دارد. رفتار اولیه با تنظیم این گزینه روی 0 به دست می‌آید.
این گزینه همچنین اثر مشابهی بر باز کردن پرونده‌های فشرده دارد. با تنظیم روی 1، پرونده اصلی (فشرده) نگهداری خواهد شد. در غیر این صورت حذف می‌شود.
البته توجه داشته باشید که این گزینه هنگام بسته‌بندی یک پرونده فشرده با گزینه -X (برای تعیین دایرکتوری یا پرونده خروجی) هیچ تاثیری ندارد. در آن حالت پرونده اصلی همیشه نگه داشته می‌شود.
هنگام باز کردن یک پرونده فشرده با دستوراتی مانند gzip یا bzip2، پرونده از حالت فشرده خارج‌شده معمولاً در همان دایرکتوری پرونده فشرده قرار می‌گیرد. با تنظیم این گزینه روی 1، پرونده به جای آن در دایرکتوری کاری جاری قرار می‌گیرد.
توجه داشته باشید که این گزینه هنگام استفاده از -X هیچ تاثیری ندارد.

صفحه‌بندی‌کننده پیش‌فرض برای استفاده هنگام مشخص شدن گزینه -p/--page.

برای استخراج تمام پرونده‌ها از آرشیو `foobar.tar.gz' به یک زیرپوشه (یا دایرکتوری جاری در صورتی که فقط حاوی یک پرونده باشد):
aunpack foobar.tar.gz

برای استخراج تمام پرونده‌ها از تمامی آرشیوهای `.tar.gz' در دایرکتوری جاری:
aunpack -e *.tar.gz

برای ایجاد یک آرشیو zip از دو پرونده `foo' و `bar':
apack myarchive.zip foo bar

برای نمایش پرونده `baz' در آرشیو `myarchive.zip' از طریق صفحه‌بندی‌کننده (pager):
acat -p myarchive.zip baz

برای فهرست کردن محتویات آرشیو rar با نام `stuff.rar':
als stuff.rar

برای ایجاد سه آرشیو `dir1.tar.gz'، `dir2.tar.gz' و `dir3.tar.gz' به طوری که اولی حاوی تمام پرونده‌های dir1، دومی حاوی تمام پرونده‌های dir2 و سومی شامل تمام پرونده‌های dir3 باشد:
apack -e -F .tar.gz dir1 dir2 dir3

برای نمایش تمام تفاوت‌های بین نسخه 2.4.17 و 2.4.18 کرنل لینوکس:
adiff linux-2.4.17.tar.gz linux-2.4.18.tar.gz

برای بازبسته‌بندی تمام آرشیوهای .tar.gz موجود در دایرکتوری جاری به فرمت .tar.7z (آرشیو قدیمی بدون تغییر باقی می‌ماند):
arepack -F.tar.7z -e *.tar.gz

در اینجا یک تابع شل آورده شده است که باعث می‌شود دستور aunpack پس از استخراج به دایرکتوری محل استخراج پرونده‌ها تغییر مسیر دهد:
aunpack () {
TMP=`mktemp /tmp/aunpack.XXXXXXXXXX`
atool -x --save-outdir=$TMP "$@"
DIR="`cat $TMP`"
[ "$DIR" != "" -a -d "$DIR" ] && cd "$DIR"
rm $TMP
}
اگر برنامه mktemp را ندارید، می‌توانید خط دوم را با عبارت زیر جایگزین کنید (توجه داشته باشید که این کار کاملاً امن نیست):
TMP="/tmp/atool_outdir.$$"

تلاش برای استخراج پرونده‌های gzip و سایر پرونده‌های فشرده بدون پسوند .gz (یا .bz2 و غیره) کار نخواهد کرد:


aunpack: foo: format not known, identifying using file
aunpack: foo: format is `gzip'
gzip: foo: unknown suffix -- ignored

این خطای آخر در بالا توسط gzip -d foo تولید می‌شود.

اگر با اشکالی روبرو شدید که در اینجا ذکر نشده است، لطفاً آن را به <oskar@osk.mine.nu> گزارش دهید.

گزارش اشکالات را به <oskar@osk.mine.nu> ارسال کنید.

نویسنده atool و این صفحه راهنما Oskar Liljeblad <oskar@osk.mine.nu> است.

Copyright © 2001, 2002, 2003, 2004, 2005, 2007, 2008, 2009, 2011, 2012 Oskar Liljeblad

این نرم‌افزار آزاد است؛ برای شرایط نسخه‌برداری منبع را ببینید. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب برای یک هدف خاص.

August 8, 2009 atool