.\"                                      -*- nroff -*-
.\" atool.1 - Manual page for atool.
.\"
.\" Copyright (C) 2001, 2002, 2003, 2004, 2005, 2007, 2008,
.\" 2009, 2011 Oskar Liljeblad
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU Library General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License along
.\" with this program; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
.\"
.TH ATOOL "1" "August 8, 2009" "atool"
.SH "نام (NAME)"
atool \- اسکریپتی برای مدیریت پرونده‌های فشرده و آرشیو از انواع گوناگون
.SH "خلاصه دستور (SYNOPSIS)"
.B atool
.RI [ OPTION ]... " ARCHIVE " [ FILE ]...
.br
.B aunpack
.RI [ OPTION ]... " ARCHIVE " [ FILE ]...
.br
.B apack
.RI [ OPTION ]... " ARCHIVE " [ FILE ]...
.br
.B als
.RI [ OPTION ]... " ARCHIVE " [ FILE ]...
.br
.B acat
.RI [ OPTION ]... " ARCHIVE " [ FILE ]...
.br
.B adiff
.RI [ OPTION ]... " ARCHIVE " "" ARCHIVE
.br
.B arepack
.RI [ OPTION ]... " OLD-ARCHIVE " "" NEW-ARCHIVE
.SH "توضیحات (DESCRIPTION)"
این صفحه راهنما دستورات \fBatool\fP را شرح می‌دهد.
این دستورات برای مدیریت پرونده‌های فشرده و آرشیو از انواع گوناگون، مانند آرشیوهای tar و Zip، استفاده می‌شوند. هر دستور می‌تواند به صورت جداگانه یا با مشخص کردن گزینه‌های مناسب برای \fBatool\fP اجرا شود (بخش \fBگزینه‌ها (OPTIONS)\fP را در ادامه ببینید).
.PP
دستور \fBaunpack\fP پرونده‌ها را از یک آرشیو استخراج می‌کند. اغلب مایل هستیم تمام پرونده‌های درون یک آرشیو را در یک زیرپوشه استخراج کنیم. با این حال، برخی آرشیوها حاوی چندین پرونده در دایرکتوری ریشه خود هستند. برنامه aunpack این مشکل را با استخراج اولیه پرونده‌ها درون یک دایرکتوری منحصر‌به‌فرد (موقت) و سپس بازگرداندن محتویات آن در صورت امکان حل می‌کند. این کار همچنین از بازنویسی تصادفی پرونده‌های محلی جلوگیری می‌کند.
.PP
دستور \fBapack\fP آرشیو ایجاد می‌کند (یا پرونده‌ها را فشرده می‌سازد). اگر هیچ آرگومان پرونده‌ای مشخص نشده باشد، نام پرونده‌های موردنظر برای افزودن از ورودی استاندارد خوانده می‌شود.
.PP
دستور \fBals\fP پرونده‌های موجود در یک آرشیو را فهرست می‌کند.
.PP
دستور \fBacat\fP پرونده‌های درون یک آرشیو را در خروجی استاندارد استخراج و نمایش می‌دهد.
.PP
دستور \fBadiff\fP با استفاده از
.BR diff (1)
تفاوت میان دو آرشیو را تولید می‌کند.
.PP
دستور \fBarepack\fP آرشیوها را با فرمتی دیگر بازبسته‌بندی می‌کند. این کار ابتدا با استخراج تمام پرونده‌های آرشیو قدیمی درون یک دایرکتوری موقت و سپس بسته‌بندی تمام پرونده‌های استخراج‌شده از آن دایرکتوری در آرشیو جدید انجام می‌شود. از گزینه
.BR \-\-each " (" \-e )
در ترکیب با
.BR \-\-format " (" \-F )
برای بازبسته‌بندی چندین آرشیو با یک بار اجرای atool استفاده کنید. توجه داشته باشید که arepack آرشیو قدیمی را حذف نخواهد کرد.
.PP
مگر اینکه گزینه
.BR \-\-format " (" \-F )
مشخص شده باشد، فرمت آرشیو توسط پسوند پرونده آرشیو تعیین می‌شود؛ به عنوان مثال پسوند «.tar.gz» یا «.tgz» به معنای فرمت tar+gzip است. توجه داشته باشید که پسوندها به ترتیبی که در بخش
\fBفرمت‌های آرشیو (ARCHIVE TYPES)\fP
در زیر آمده است بررسی می‌شوند؛ به همین دلیل است که پرونده‌ای با پسوند «.tar.gz» به عنوان یک آرشیو tar+gzip در نظر گرفته می‌شود، نه یک پرونده فشرده‌شده ساده با gzip.
.SH "گزینه‌ها (OPTIONS)"
این برنامه‌ها از قواعد معمول نحو خط فرمان گنو (GNU) پیروی می‌کنند که در آن گزینه‌های طولانی با دو خط تیره (`-') آغاز می‌شوند.
خلاصه‌ای از گزینه‌ها در زیر آورده شده است.
.TP
.B \-l, \-\-list
فهرست کردن پرونده‌های درون آرشیو.
این گزینه هنگام اجرای \fBals\fP به طور خودکار فعال در نظر گرفته می‌شود.
.TP
.B \-x, \-\-extract
استخراج پرونده‌ها از آرشیو.
این گزینه هنگام اجرای \fBaunpack\fP به طور خودکار فعال در نظر گرفته می‌شود.
.TP
.B \-X, \-\-extract-to\fR=\fIPATH\fR
استخراج پرونده‌ها از آرشیو در دایرکتوری مشخص‌شده. هنگام باز کردن پرونده‌های فشرده، PATH می‌تواند به یک نام پرونده یا یک دایرکتوری موجود اشاره کند.
.TP
.B \-a, \-\-add
ایجاد آرشیو.
این گزینه هنگام اجرای \fBapack\fP به طور خودکار فعال در نظر گرفته می‌شود.
.TP
.B \-c, \-\-cat
استخراج یک پرونده از آرشیو به خروجی استاندارد (نمایش آن روی صفحه).
این گزینه هنگام اجرای \fBacat\fP به طور خودکار فعال در نظر گرفته می‌شود.
.TP
.B \-d, \-\-diff
استخراج دو آرشیو و استفاده از diff(1) برای تولید تفاوت‌های میان آن‌ها.
این گزینه هنگام اجرای \fBadiff\fP به طور خودکار فعال در نظر گرفته می‌شود.
.TP
.B \-e, \-\-each
به ازای هر آرگومان، دستور مشخص‌شده را اجرا می‌کند. این گزینه می‌تواند برای استخراج، فهرست کردن یا ایجاد سریع چندین آرشیو استفاده شود (بخش \fBمثال‌ها (EXAMPLES)\fP را در ادامه ببینید). این گزینه را نمی‌توان همراه با دستور cat استفاده کرد.
.TP
.B \-F, \-\-format\fR=\fIEXTENSION\fR
مشخص کردن دستی فرمت آرشیو (بخش \fBفرمت‌های آرشیو (ARCHIVE TYPES)\fP را در ادامه ببینید).
.TP
.B \-S, \-\-simulate
اجرای atool در حالت شبیه‌سازی. هیچ تغییری در سیستم‌فایل (نظیر نوشتن داده‌ها) اعمال نخواهد شد و به جای آن تمام دستوراتی که قرار است اجرا شوند نمایش داده می‌شوند. این گزینه را نمی‌توان با \fB\-\-explain\fP ترکیب کرد (زیرا خود شامل آن است).
.IP
توجه داشته باشید تضمینی وجود ندارد که دستورات چاپ‌شده در حالت شبیه‌سازی دقیقاً همان‌هایی باشند که در حالت غیرشبیه‌سازی اجرا می‌شوند. علت این است که برخی عملیات به این بستگی دارد که آرشیوها حاوی چه پرونده‌هایی هستند، و atool در این حالت تنها با استخراج آرشیوها می‌تواند آن را تشخیص دهد.
.TP
.B \-E, \-\-explain
نمایش دستوراتی که توسط atool اجرا می‌شوند. این گزینه را نمی‌توان با \fB\-\-simulate\fP ترکیب کرد.
.TP
.B \-p, \-\-page
هدایت خروجی به یک صفحه‌بندی‌کننده (pager)، معمولاً \fBpager\fP مگر اینکه متغیر محیطی \fBPAGER\fP تنظیم شده باشد.
.TP
.B \-f, \-\-force
هنگام استخراج پرونده‌ها، اجازه بازنویسی روی پرونده‌های محلی را می‌دهد.
هنگام ایجاد یک آرشیو، در صورتی که پرونده آرشیو از قبل وجود داشته باشد، اجازه بازنویسی آن را می‌دهد. توجه داشته باشید که امکان افزودن پرونده‌ها به آرشیوهای موجود RAR و Zip وجود دارد (این کار برای بسیاری از فرمت‌های دیگر امکان‌پذیر نیست).
.TP
.B \-D, \-\-subdir
هنگام استخراج آرشیوها، همیشه یک دایرکتوری جدید برای آرشیو ایجاد می‌کند، حتی اگر آرشیو تنها حاوی یک پرونده در دایرکتوری ریشه خود باشد.
.TP
.B \-0, \-\-null
اگر هنگام ایجاد یا افزودن پرونده‌ها به آرشیوها هیچ آرگومان پرونده‌ای مشخص نشده باشد، فهرست پرونده‌ها از ورودی استاندارد خوانده می‌شود. به طور معمول این نام پرونده‌ها با نویسه خط جدید (newline) از هم جدا می‌شوند، اما با این گزینه با بایت‌های خالی (null-bytes) جدا می‌شوند. این گزینه همراه با گزینه \-print0 در GNU find بسیار کاربردی است.
.TP
.B \-q, \-\-quiet
کاهش سطح پرگویی به میزان یک واحد. این مقدار از سطح پرگویی پیش‌فرض یا سطح مشخص‌شده با \fB\-\-verbosity\fP کسر می‌شود. این گزینه می‌تواند چندین بار مشخص شود تا atool پیام‌های کمتری نمایش دهد.
.TP
.B \-v, \-\-verbose
افزایش سطح پرگویی به میزان یک واحد. این مقدار به سطح پرگویی پیش‌فرض یا سطح مشخص‌شده با \fB\-\-verbosity\fP اضافه می‌شود. این گزینه می‌تواند چندین بار مشخص شود تا atool پیام‌های با جزئیات بیشتری نمایش دهد.
.TP
.B \-V, \-\-verbosity\fR=\fILEVEL\fR
تعیین سطح پرگویی. سطح پیش‌فرض برابر با 1 است که به معنای «پرگویی عادی» است؛ به عنوان مثال هنگام ایجاد و استخراج از آرشیوها، پرونده‌ها فهرست می‌شوند.
.TP
.B \-\-config\fR=\fIFILE\fR
بارگذاری پیکربندی از پرونده مشخص‌شده. هنگام استفاده از این گزینه، پرونده‌های پیکربندی سراسری سیستم و کاربر بارگذاری نخواهند شد. اگر پرونده مشخص‌شده وجود نداشته باشد یا قابل خواندن نباشد، atool با یک پیام خطا متوقف می‌شود.
.TP
.B \-o, \-\-option\fR=\fIKEY=VALUE\fR
بازنویسی یک گزینه پیکربندی. این گزینه‌ها پس از خواندن پرونده‌های پیکربندی اعمال می‌شوند.
.IP
می‌توانید این گزینه را چندین بار برای بازنویسی گزینه‌های مختلف مشخص کنید.
.TP
.B \-O, \-\-format\-option\fR=\fIOPTION\fR
ارسال گزینه‌های اضافی به دستور آرشیوکننده. این گزینه می‌تواند هنگام مشخص کردن گزینه‌های فشرده‌سازی برای برخی آرشیوها کاربردی باشد؛ به عنوان مثال:
.br
        \fBapack \-F7z \-O-mx=9 archive.7z dir\fP
.br
می‌توانید این گزینه را چندین بار برای افزودن گزینه‌های مختلف مشخص کنید.
.TP
.B \-\-save\-outdir\fR=\fIFILE\fR
هنگام استخراج پرونده‌ها، نام دایرکتوری‌ای را که آرشیو در آن استخراج شده است، در پرونده مشخص‌شده ذخیره می‌کند. اگر دستور `extract' نبوده یا آرشیو در یک دایرکتوری جدید استخراج نشده باشد، چیزی در پرونده مشخص‌شده نوشته نخواهد شد. اگر چندین آرشیو مشخص شده باشند (با \-e)، تنها آخرین دایرکتوری‌ای که پرونده‌ها در آن استخراج شده‌اند در FILE نوشته خواهد شد.
.IP
این گزینه به صورت داخلی استفاده می‌شود (بخش \fBمثال‌ها (EXAMPLES)\fP را در ادامه ببینید).
.TP
.B \-\-help
نمایش چکیده گزینه‌ها.
.TP
.B \-\-version
نمایش اطلاعات نسخه و خروج.
.SH "فرمت‌های آرشیو (ARCHIVE TYPES)"
مگر اینکه گزینه
.BR \-f " (" \-\-format )
مشخص شده باشد، فرمت آرشیو توسط پسوند پرونده آرشیو تعیین می‌شود؛ به عنوان مثال پسوند «.tar.gz» یا «.tgz» به معنای فرمت tar+gzip است. توجه داشته باشید که پسوندها به ترتیبی که در بالا فهرست شده است بررسی می‌شوند؛ به همین دلیل است که پرونده‌ای با پسوند «.tar.gz» به عنوان یک آرشیو tar+gzip در نظر گرفته می‌شود، نه یک آرشیو ساده gzip.
.PP
دستور diff در هر جایی که دستور extract پشتیبانی شود، پشتیبانی می‌شود.
.PP
انواع آرشیو پشتیبانی‌شده عبارتند از:
.TP
.RI \fBtar+gzip\fP " " ( .tar.gz ", " .tgz )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBtar+bzip\fP " " ( .tar.bz ", " .tbz )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBtar+bzip2\fP " " ( .tar.bz2 ", " .tbz2 )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBtar+compress\fP " " ( .tar.Z ", " .tZ )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBtar+lzop\fP " " ( .tar.lzo ", " .tzo )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBtar+lzip\fP " " ( .tar.lz ", " .tlz )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBtar+xz\fP " " ( .tar.xz ", " .txz )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBtar+7z\fP " " ( .tar.7z ", " .t7z )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBtar\fP " " ( .tar )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBzip\fP " " ( .zip )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBjar\fP " " ( .jar ", " .war )
از دستورات list، extract و add پشتیبانی می‌شود.
در صورت غیرفعال بودن use_jar_program، دستور Cat پشتیبانی می‌شود.
.TP
.RI \fBrar\fP " " ( .rar )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBlha\fP " " ( .lha ", " .lzh )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fB7z\fP " " ( .7z )
از دستورات extract، list و add پشتیبانی می‌شود.
.TP
.RI \fBalzip\fP " " ( .alz )
از دستور extract پشتیبانی می‌شود.
.TP
.RI \fBace\fP " " ( .ace )
از دستورات extract و list پشتیبانی می‌شود.
.TP
.RI \fBar\fP " " ( .a )
از تمام دستورات پشتیبانی می‌شود.
.TP
.RI \fBarj\fP " " ( .arj )
از دستورات list، extract و add پشتیبانی می‌شود.
.TP
.RI \fBarc\fP " " ( .arc )
از تمام دستورات پشتیبانی می‌شود.
(توجه داشته باشید که arc هنگام استفاده از دستور cat یک خط جدید اضافی چاپ می‌کند.)
.TP
.RI \fBrpm\fP " " ( .rpm )
از دستورات extract و list پشتیبانی می‌شود.
.TP
.RI \fBdeb\fP " " ( .deb )
از دستورات extract و list پشتیبانی می‌شود.
.TP
.RI \fBcab\fP " " ( .cab )
از دستورات cat، extract و list پشتیبانی می‌شود.
.TP
.RI \fBgzip\fP " " ( .gz )
از دستورات cat، extract و add پشتیبانی می‌شود.
.TP
.RI \fBbzip\fP " " ( .bz )
از دستورات cat، extract و add پشتیبانی می‌شود.
.TP
.RI \fBbzip2\fP " " ( .bz2 )
از دستورات cat، extract و add پشتیبانی می‌شود.
.TP
.RI \fBcompress\fP " " ( .Z )
از دستورات cat، extract و add پشتیبانی می‌شود.
.TP
.RI \fBlzma\fP " " ( .lzma )
از دستورات cat، extract و add پشتیبانی می‌شود.
.TP
.RI \fBlzop\fP " " ( .lzo )
از دستورات extract و add پشتیبانی می‌شود. دستور cat پشتیبانی نمی‌شود زیرا lzop تمایلی به استخراج پرونده‌ها در خروجی استاندارد ندارد مگر اینکه فلگ \-f داده شود.
.TP
.RI \fBlzip\fP " " ( .lz )
از دستورات cat، extract و add پشتیبانی می‌شود.
.TP
.RI \fBxz\fP " " ( .xz )
از دستورات cat، extract و add پشتیبانی می‌شود.
.TP
.RI \fBrzip\fP " " ( .rz )
از دستورات extract و add پشتیبانی می‌شود.
.TP
.RI \fBlrzip\fP " " ( .lrz )
از دستورات extract و add پشتیبانی می‌شود.
.TP
.RI \fB7zip\fP " " ( .7z )
از تمام دستورات پشتیبانی می‌شود.
(توجه داشته باشید که 7z در صورتی که خروجی استاندارد یک ترمینال باشد از نوشتن پرونده‌های استخراج‌شده در خروجی استاندارد خودداری می‌کند. هنگام خواندن در ترمینال، از \-p استفاده کنید یا خروجی atool/acat را به یک صفحه‌بندی‌کننده پایپ کنید.)
.TP
.RI \fBcpio\fP " " ( .cpio )
از دستورات list، extract و add پشتیبانی می‌شود.
.SH "پیکربندی (CONFIGURATION)"
از نسخه 0.8.0، ابزار atool می‌تواند پرونده‌های پیکربندی سفارشی را بخواند.
ابتدا مقادیر پیش‌فرض هاردکد شده در پرونده برنامه atool ارزیابی می‌شوند.
سپس مقادیر پیکربندی سراسری سیستم در صورت وجود پرونده از \fI/etc/atool.conf\fR بارگذاری می‌شوند. در نهایت، مقادیر پیکربندی اختصاصی کاربر از \fI.atoolrc\fR در دایرکتوری خانگی کاربر جاری بارگذاری می‌شوند.
.PP
فرمت پرونده‌های پیکربندی ساده است:
.IP
variable value
.PP
در اینجا \fBvariable\fR یکی از متغیرهای فهرست‌شده در زیر است و \fBvalue\fR مقداری است که باید به این متغیر اختصاص داده شود. \fBvariable\fR و \fBvalue\fR باید حداقل با یک نویسه فاصله خالی (فاصله، تب و غیره) از هم جدا شوند. خطوط خالی و خطوطی که با # آغاز می‌شوند نادیده گرفته می‌شوند.
.PP
مقدار `1' به معنای فعال بودن گزینه است و `0' به معنای غیرفعال بودن آن. رشته‌ها نباید درون نقل‌قول قرار گیرند، زیرا از اولین نویسه غیرفاصله شروع شده و در انتهای خط پایان می‌یابند.
.PP
گزینه‌ها عبارتند از:
.TP
.B use_tar_bzip2_option \fR(پیش‌فرض: 1)\fR
اگر از GNU tar استفاده می‌کنید و از گزینه \fB\-\-bzip2\fP برای فیلتر کردن پرونده‌های bzip2 از طریق bzip2 پشتیبانی می‌کند، این گزینه را فعال کنید. نسخه‌های 1.13.6 یا جدیدتر GNU tar از \fB\-\-bzip2\fP پشتیبانی می‌کنند. بنابراین اگر از نسخه‌های قدیمی‌تر GNU tar قبل از 1.13.6 استفاده می‌کنید، باید این گزینه را غیرفعال کنید.
.IP
این گزینه قبلاً \fBuse_tar_j_option\fP بود، اما استفاده از \-\-bzip2 سازگاری و قابلیت حمل بیشتری دارد.
.TP
.B use_tar_lzip_option \fR(پیش‌فرض: 0)\fR
اگر از GNU tar استفاده می‌کنید و از گزینه \fB\-\-lzip\fP برای فیلتر کردن پرونده‌های lzip از طریق lzip پشتیبانی می‌کند، این گزینه را فعال کنید. نسخه‌های 1.23 یا جدیدتر GNU tar از \fB\-\-lzip\fP پشتیبانی می‌کنند. بنابراین اگر از نسخه‌های قدیمی‌تر GNU tar قبل از 1.23 استفاده می‌کنید، باید این گزینه را غیرفعال کنید.
.TP
.B use_tar_z_option \fR(پیش‌فرض: 1)\fR
اگر از GNU tar استفاده می‌کنید و از گزینه \fB\-z\fP برای فیلتر کردن پرونده‌های gzip از طریق gzip پشتیبانی می‌کند، این گزینه را فعال کنید. در صورتی که از GNU tar استفاده نمی‌کنید، باید این گزینه و \fIuse_tar_j_option\fR را غیرفعال کنید.
.IP
غیرفعال کردن این دو گزینه به این معنی نیست که atool نمی‌تواند پرونده‌های bzip2/gzip را استخراج کند. در صورت غیرفعال بودن، atool در عوض از یک پایپ برای ارسال خروجی از bzip2/gzip به tar استفاده می‌کند.
.IP
در صورت امکان، این گزینه‌ها باید فعال باشند زیرا مدیریت خطا هنگامی که فیلترسازی توسط tar انجام می‌شود بهتر است.
.TP
.B use_tar_lzma_option \fR(پیش‌فرض: 1)\fR
اگر از GNU tar استفاده می‌کنید و از گزینه \fB\-\-lzma\fP برای فیلتر کردن پرونده‌های فشرده lzma از طریق lzma پشتیبانی می‌کند، این گزینه را فعال کنید. نسخه‌های 1.20 یا جدیدتر GNU tar از \fB\-\-lzma\fP پشتیبانی می‌کنند.
.TP
.B use_tar_lzop_option \fR(پیش‌فرض: 0)\fR
اگر از GNU tar استفاده می‌کنید و از گزینه \fB\-\-lzop\fP برای فیلتر کردن پرونده‌های فشرده lzop از طریق lzop پشتیبانی می‌کند، این گزینه را فعال کنید. نسخه‌های 1.21 یا جدیدتر GNU tar از \fB\-\-lzop\fP پشتیبانی می‌کنند.
.TP
.B use_tar_xz_option \fR(پیش‌فرض: 0)\fR
اگر از GNU tar استفاده می‌کنید و از گزینه \fB\-\-xz\fP برای فیلتر کردن پرونده‌های فشرده xz از طریق xz پشتیبانی می‌کند، این گزینه را فعال کنید. نسخه‌های 1.22 یا جدیدتر GNU tar از \fB\-\-xz\fP پشتیبانی می‌کنند.
.TP
.B use_gzip_for_z \fR(پیش‌فرض: 1)\fR
اگر می‌خواهید هنگام باز کردن پرونده‌های فشرده‌شده با compress (پرونده‌های `.Z') به جای uncompress از gzip استفاده شود، این گزینه را فعال کنید.
.TP
.B use_rar_for_unpack \fR(پیش‌فرض: 0)\fR
اگر می‌خواهید در صورت امکان همیشه به جای unrar از rar استفاده شود، این گزینه را فعال کنید. این کار باعث می‌شود atool حتی هنگام فهرست کردن و استخراج پرونده‌های RAR از دستور rar (path_rar) استفاده کند.
.TP
.B use_arc_for_unpack \fR(پیش‌فرض: 0)\fR
اگر می‌خواهید در صورت امکان همیشه به جای nomarch از arc استفاده شود، این گزینه را فعال کنید. این کار باعث می‌شود atool حتی هنگام فهرست کردن و استخراج پرونده‌های ARC از دستور arc (path_arc) استفاده کند.
.TP
.B use_arj_for_unpack \fR(پیش‌فرض: 0)\fR
اگر می‌خواهید در صورت امکان همیشه به جای unarj از arj استفاده شود، این گزینه را فعال کنید. این کار باعث می‌شود atool حتی هنگام فهرست کردن و استخراج پرونده‌های ARJ از دستور arj (path_arj) استفاده کند.
.TP
.B use_find_cpio_print0 \fR(پیش‌فرض: 1)\fR
اگر find از گزینه \-print0 و cpio از گزینه \-0 پشتیبانی می‌کند، این گزینه را فعال کنید. بدون آن، ایجاد آرشیوهای cpio از پرونده‌هایی که در نام آن‌ها نویسه خط جدید وجود دارد غیرممکن یا بسیار سخت‌تر خواهد بود.
.TP
.B extract_deb_control \fR(پیش‌فرض: 1)\fR
پرونده‌های بسته دبیان (.deb) حاوی اطلاعات کنترلی در یک دایرکتوری به نام DEBIAN هستند، به ویژه پرونده "control" بسته. اگر می‌خواهید هنگام استخراج علاوه بر پرونده‌های معمولی، اطلاعات کنترلی نیز استخراج شوند، این گزینه را فعال کنید.
.TP
.B strip_unknown_ext \fR(پیش‌فرض: 1)\fR
انواع خاصی از پرونده‌ها در واقع آرشیو هستند، اما پسوند آن‌ها این موضوع را نشان نمی‌دهد. به عنوان مثال می‌توان به اسناد Open Office (پرونده‌های Zip) و اسناد Gnumeric (پرونده‌های فشرده gzip) اشاره کرد. از آنجا که پسوندهای این پرونده‌ها برای atool ناشناخته هستند، با تنظیم این گزینه روی 0 پسوند آن‌ها حذف نخواهد شد. پرونده خروجی در آن حالت چیزی شبیه به Unpack-XYZW خواهد بود. تنظیم این گزینه روی 1 باعث می‌شود که پسوند در عوض حذف شود.
.TP
.B use_pbzip2 \fR(پیش‌فرض: 0)\fR
اگر می‌خواهید به جای bzip2 از pbzip2 استفاده کنید، این گزینه را فعال کنید. لطفاً توجه داشته باشید که در صورت فعال بودن use_tar_bzip2_option، دستور tar صرف نظر از گزینه use_pbzip2 از bzip2 استفاده خواهد کرد. بنابراین اگر می‌خواهید tar به جای bzip2 از pbzip2 استفاده کند، use_pbzip2 را روی 1 و use_tar_bzip2_option را روی 0 تنظیم کنید.
.TP
.B use_lbzip2 \fR(پیش‌فرض: 0)\fR
اگر می‌خواهید به جای bzip2 از lbzip2 استفاده کنید، این گزینه را فعال کنید. لطفاً توجه داشته باشید که در صورت فعال بودن use_tar_bzip2_option، دستور tar صرف نظر از گزینه use_lbzip2 از bzip2 استفاده خواهد کرد. بنابراین اگر می‌خواهید tar به جای bzip2 از lbzip2 استفاده کند، use_lbzip2 را روی 1 و use_tar_bzip2_option را روی 0 تنظیم کنید.
.TP
.B use_pigz \fR(پیش‌فرض: 0)\fR
اگر می‌خواهید به جای gzip از pigz استفاده کنید، این گزینه را فعال کنید. لطفاً توجه داشته باشید که در صورت فعال بودن use_tar_z_option، دستور tar صرف نظر از گزینه use_pigz از gzip استفاده خواهد کرد. بنابراین اگر می‌خواهید tar به جای gzip از pigz استفاده کند، use_pigz را روی 1 و use_tar_z_option را روی 0 تنظیم کنید.
.TP
.B use_plzip \fR(پیش‌فرض: 0)\fR
اگر می‌خواهید به جای lzip از plzip استفاده کنید، این گزینه را فعال کنید. لطفاً توجه داشته باشید که در صورت فعال بودن use_tar_lzip_option، دستور tar صرف نظر از گزینه use_plzip از lzip استفاده خواهد کرد. بنابراین اگر می‌خواهید tar به جای lzip از plzip استفاده کند، use_plzip را روی 1 و use_tar_lzip_option را روی 0 تنظیم کنید.
.TP
.B use_jar \fR(پیش‌فرض: 0)\fR
اگر می‌خواهید برای مدیریت آرشیوهای jar از jar استفاده کنید، این گزینه را فعال کنید. اگر این گزینه را غیرفعال کنید، از zip استفاده خواهد شد (که باید به همان خوبی کار کند و احتمالاً سریع‌تر نیز خواهد بود).
.IP
این گزینه به صورت پیش‌فرض غیرفعال است، زیرا استخراج پرونده‌ها به خروجی استاندارد (`cat') توسط jar پشتیبانی نمی‌شود.
.TP
.B use_file \fR(پیش‌فرض: 1)\fR
اگر می‌خواهید atool با استفاده از file(1) نوع پرونده‌ها را برای پرونده‌هایی با پسوند ناشناخته (یا بدون پسوند) شناسایی کند، این گزینه را فعال کنید.
.TP
.B use_file_always \fR(پیش‌فرض: 0)\fR
اگر می‌خواهید atool همیشه و صرف نظر از پسوند پرونده، آرشیوها را با استفاده از file(1) شناسایی کند، این گزینه را فعال کنید. لطفاً توجه داشته باشید که این کار در حال حاضر معایبی دارد، از جمله عدم توانایی در شناسایی تمام انواع آرشیو (به‌ویژه آرشیوهای tar فشرده‌شده با 7zip، lzop، szip و غیره).
.TP
.B tmpdir_name \fR(پیش‌فرض: Unpack-%04d)\fR
ابزار atool استخراج را در یک دایرکتوری موقت ایجادشده در دایرکتوری جاری انجام می‌دهد تا هیچ پرونده‌ای بازنویسی نشود. این متغیر نام آن دایرکتوری موقت را تعیین می‌کند.
.IP
رشته `%d' در این متغیر با یک عدد تصادفی بین 0 تا 9999 جایگزین می‌شود. می‌توان قالب این عدد را با استفاده از چیزی غیر از `%d' تغییر داد - printf(3) را ببینید.
.TP
.B tmpfile_name \fR(پیش‌فرض: Pack-%04d)\fR
هنگام استفاده از pbzip2 و ایجاد آرشیوها، لازم است یک پرونده موقت ایجاد شود. این گزینه نام آن پرونده را تعیین می‌کند. برای جزئیات بیشتر درباره فرمت، tmpdir_name را ببینید.
.TP
.B path_pager \fR(پیش‌فرض: pager)\fR
.TP
.B path_jar \fR(پیش‌فرض: jar)\fR
.TP
.B path_tar \fR(پیش‌فرض: tar)\fR
.TP
.B path_zip \fR(پیش‌فرض: zip)\fR
.TP
.B path_unzip \fR(پیش‌فرض: unzip)\fR
.TP
.B path_gzip \fR(پیش‌فرض: gzip)\fR
.TP
.B path_bzip \fR(پیش‌فرض: bzip)\fR
.TP
.B path_bzip2 \fR(پیش‌فرض: bzip2)\fR
.TP
.B path_pbzip2 \fR(پیش‌فرض: pbzip2)\fR
.TP
.B path_compress \fR(پیش‌فرض: compress)\fR
.TP
.B path_lzma \fR(پیش‌فرض: lzma)\fR
.TP
.B path_lzop \fR(پیش‌فرض: lzop)\fR
.TP
.B path_lzip \fR(پیش‌فرض: lzip)\fR
.TP
.B path_rar \fR(پیش‌فرض: rar)\fR
.TP
.B path_unrar \fR(پیش‌فرض: unrar)\fR
.TP
.B path_lbzip2 \fR(پیش‌فرض: lbzip2)\fR
.TP
.B path_pigz \fR(پیش‌فرض: pigz)\fR
.TP
.B path_cabextract \fR(پیش‌فرض: cabextract)\fR
.TP
.B path_7z \fR(پیش‌فرض: 7z)\fR
.TP
.B path_unalz \fR(پیش‌فرض: unalz)\fR
.TP
.B path_lha \fR(پیش‌فرض: lha)\fR
.TP
.B path_unace \fR(پیش‌فرض: unace)\fR
.TP
.B path_ar \fR(پیش‌فرض: ar)\fR
.TP
.B path_arj \fR(پیش‌فرض: arj)\fR
.TP
.B path_unarj \fR(پیش‌فرض: unarj)\fR
.TP
.B path_arc \fR(پیش‌فرض: arc)\fR
.TP
.B path_nomarch \fR(پیش‌فرض: nomarch)\fR
.TP
.B path_rpm \fR(پیش‌فرض: rpm)\fR
.TP
.B path_rpm2cpio \fR(پیش‌فرض: rpm2cpio)\fR
.TP
.B path_dpkg_deb \fR(پیش‌فرض: dpkg-deb)\fR
.TP
.B path_cpio \fR(پیش‌فرض: cpio)\fR
.TP
.B path_file \fR(پیش‌فرض: file)\fR
.TP
.B path_find \fR(پیش‌فرض: find)\fR
.TP
.B path_xargs \fR(پیش‌فرض: xargs)\fR
.TP
.B path_cat \fR(پیش‌فرض: cat)\fR
.TP
.B path_diff \fR(پیش‌فرض: diff)\fR
این متغیرها همگی مسیر برنامه‌های متناظر هستند. معمولاً بهتر است آن‌ها را به همان صورت پیش‌فرض رها کنید، چرا که به این ترتیب مکان آن‌ها از متغیر محیطی PATH جستجو می‌شود.
.TP
.B args_diff \fR(پیش‌فرض: \-ru)\fR
این متغیر آرگومان‌های خط فرمان را برای ارسال به دستور diff (همان‌طور که توسط path_diff مشخص شده است) هنگام استفاده از adiff تعیین می‌کند. نویسه‌های فاصله در این رشته آرگومان‌ها را از یکدیگر جدا می‌کنند.
.TP
.B path_syscfg \fR(پیش‌فرض: /etc/atool.conf)\fR
(این متغیر فقط می‌تواند در پرونده برنامه atool تنظیم شود.)
این متغیر دایرکتوری محل قرارگیری پرونده پیکربندی سراسری سیستم را مشخص می‌کند.
.TP
.B path_usercfg \fR(پیش‌فرض: .atoolrc)\fR
(این متغیر فقط می‌تواند در پرونده برنامه atool و پرونده پیکربندی سراسری سیستم تنظیم شود.)
این متغیر محل قرارگیری پرونده پیکربندی کاربر را مشخص می‌کند. توجه داشته باشید که اگر این نام پرونده نسبی باشد (یعنی با `/` شروع نشود)، نسبت به دایرکتوری خانگی کاربر جاری (که توسط متغیر محیطی HOME تعیین می‌شود) در نظر گرفته خواهد شد.
.TP
.B default_verbosity \fR(پیش‌فرض: 1)\fR
این مقدار سطح پرگویی پیش‌فرض atool است. با استفاده از گزینه‌های \-q و \-v می‌توان سطح پرگویی را افزایش یا کاهش داد.
سطح 1 به معنای «پرگویی عادی» است - به عنوان مثال هنگام ایجاد و استخراج از آرشیوها، پرونده‌ها فهرست می‌شوند.
.TP
.B show_extracted \fR(پیش‌فرض: 1)\fR
اگر این گزینه روی 1 تنظیم شود، دستور aunpack همیشه نشان می‌دهد چه پرونده یا دایرکتوری‌ای استخراج شده است. در غیر این صورت فقط زمانی چاپ خواهد شد که آرشیو در مکانی غیرمنتظره استخراج شده باشد (در نتیجه وجود پرونده‌های محلی از قبل یا داشتن چندین پرونده در دایرکتوری ریشه آرشیو).
.IP
این گزینه می‌تواند در ترکیب با `default_verbosity 0' بسیار مفید باشد.
توجه داشته باشید که این گزینه هنگام استفاده از گزینه \-X همراه با aunpack هیچ تاثیری نخواهد داشت و روی پرونده‌های فشرده‌شده نیز بی‌اثر است.
.TP
.B keep_compressed \fR(پیش‌فرض: 1)\fR
هنگام فشرده‌سازی یک پرونده با gzip یا bzip2، پرونده اصلی (فشرده‌نشده) معمولاً پس از فشرده‌سازی حذف می‌شود؛ یعنی اگر پرونده "test" را فشرده کنید، تنها یک پرونده "test.gz" خواهید داشت. با تنظیم این گزینه روی 1، به atool می‌گویید که پرونده اصلی را نیز نگه دارد. رفتار اولیه با تنظیم این گزینه روی 0 به دست می‌آید.
.IP
این گزینه همچنین اثر مشابهی بر باز کردن پرونده‌های فشرده دارد. با تنظیم روی 1، پرونده اصلی (فشرده) نگهداری خواهد شد. در غیر این صورت حذف می‌شود.
.IP
البته توجه داشته باشید که این گزینه هنگام بسته‌بندی یک پرونده فشرده با گزینه \-X (برای تعیین دایرکتوری یا پرونده خروجی) هیچ تاثیری ندارد. در آن حالت پرونده اصلی همیشه نگه داشته می‌شود.
.TP
.B decompress_to_cwd \fR(پیش‌فرض: 1)\fR
هنگام باز کردن یک پرونده فشرده با دستوراتی مانند gzip یا bzip2، پرونده از حالت فشرده خارج‌شده معمولاً در همان دایرکتوری پرونده فشرده قرار می‌گیرد. با تنظیم این گزینه روی 1، پرونده به جای آن در دایرکتوری کاری جاری قرار می‌گیرد.
.IP
توجه داشته باشید که این گزینه هنگام استفاده از \-X هیچ تاثیری ندارد.
.SH "محیط (ENVIRONMENT)"
.TP
.B PAGER
صفحه‌بندی‌کننده پیش‌فرض برای استفاده هنگام مشخص شدن گزینه
.BR \-p / \-\-page .
.SH "مثال‌ها (EXAMPLES)"
برای استخراج تمام پرونده‌ها از آرشیو `foobar.tar.gz' به یک زیرپوشه (یا دایرکتوری جاری در صورتی که فقط حاوی یک پرونده باشد):
.br
	\fBaunpack foobar.tar.gz\fP
.PP
برای استخراج تمام پرونده‌ها از تمامی آرشیوهای `.tar.gz' در دایرکتوری جاری:
.br
	\fBaunpack \-e *.tar.gz\fP
.PP
برای ایجاد یک آرشیو zip از دو پرونده `foo' و `bar':
.br
	\fBapack myarchive.zip foo bar\fP
.PP
برای نمایش پرونده `baz' در آرشیو `myarchive.zip' از طریق صفحه‌بندی‌کننده (pager):
.br
	\fBacat \-p myarchive.zip baz\fP
.PP
برای فهرست کردن محتویات آرشیو rar با نام `stuff.rar':
.br
	\fBals stuff.rar\fP
.PP
برای ایجاد سه آرشیو `dir1.tar.gz'، `dir2.tar.gz' و `dir3.tar.gz' به طوری که اولی حاوی تمام پرونده‌های dir1، دومی حاوی تمام پرونده‌های dir2 و سومی شامل تمام پرونده‌های dir3 باشد:
.br
	\fBapack \-e \-F .tar.gz dir1 dir2 dir3\fP
.PP
برای نمایش تمام تفاوت‌های بین نسخه 2.4.17 و 2.4.18 کرنل لینوکس:
.br
	\fBadiff linux-2.4.17.tar.gz linux-2.4.18.tar.gz\fP
.PP
برای بازبسته‌بندی تمام آرشیوهای .tar.gz موجود در دایرکتوری جاری به فرمت .tar.7z (آرشیو قدیمی بدون تغییر باقی می‌ماند):
.br
	\fBarepack \-F.tar.7z \-e *.tar.gz\fP
.PP
در اینجا یک تابع شل آورده شده است که باعث می‌شود دستور aunpack پس از استخراج به دایرکتوری محل استخراج پرونده‌ها تغییر مسیر دهد:
.br
	\fBaunpack () {\fP
.br
	\fB  TMP=`mktemp /tmp/aunpack.XXXXXXXXXX`\fP
.br
	\fB  atool \-x \-\-save-outdir=$TMP "$@"\fP
.br
	\fB  DIR="`cat $TMP`"\fP
.br
	\fB  [ "$DIR" != "" \-a \-d "$DIR" ] && cd "$DIR"\fP
.br
	\fB  rm $TMP\fP
.br
	\fB}\fP
.br
اگر برنامه mktemp را ندارید، می‌توانید خط دوم را با عبارت زیر جایگزین کنید (توجه داشته باشید که این کار کاملاً امن نیست):
.br
	\fB  TMP="/tmp/atool_outdir.$$"\fP
.PP
.SH "اشکالات (BUGS)"
تلاش برای استخراج پرونده‌های gzip و سایر پرونده‌های فشرده بدون پسوند .gz (یا .bz2 و غیره) کار نخواهد کرد:
.PP
  aunpack: foo: format not known, identifying using file
  aunpack: foo: format is `gzip'
  gzip: foo: unknown suffix -- ignored
.PP
این خطای آخر در بالا توسط \fBgzip \-d foo\fP تولید می‌شود.
.PP
اگر با اشکالی روبرو شدید که در اینجا ذکر نشده است، لطفاً آن را به <oskar@osk.mine.nu> گزارش دهید.
.SH "گزارش اشکالات (REPORTING BUGS)"
گزارش اشکالات را به <\fIoskar@osk.mine.nu\fP> ارسال کنید.
.SH "نویسندگان (AUTHORS)"
نویسنده \fBatool\fP و این صفحه راهنما Oskar Liljeblad <\fIoskar@osk.mine.nu\fP> است.
.SH "حق نشر (COPYRIGHT)"
Copyright \(co 2001, 2002, 2003, 2004, 2005, 2007, 2008, 2009, 2011, 2012 Oskar Liljeblad
.PP
این نرم‌افزار آزاد است؛ برای شرایط نسخه‌برداری منبع را ببینید. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب برای یک هدف خاص.