.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "AR 1"
.TH AR 1 2026-01-23 binutils-2.45.1 "GNU Development Tools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
ar \- ایجاد، ویرایش و استخراج از آرشیوها
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
ar [\fB\-X32_64\fR] [\fB\-\fR]\fIp\fR[\fImod\fR] [\fB\-\-plugin\fR \fIname\fR] [\fB\-\-target\fR \fIbfdname\fR] [\fB\-\-output\fR \fIdirname\fR] [\fB\-\-record\-libdeps\fR \fIlibdeps\fR] [\fB\-\-thin\fR] [\fIrelpos\fR] [\fIcount\fR] \fIarchive\fR [\fImember\fR...]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
برنامه \fBar\fR گنو آرشیوها را ایجاد، ویرایش و از آن‌ها استخراج می‌کند. یک \fIآرشیو\fR فایلی یکتا است که مجموعه‌ای از فایل‌های دیگر را در ساختاری نگهداری می‌کند تا بازیابی فایل‌های مجزای اصلی (که \fIعضوهای\fR آرشیو نامیده می‌شوند) امکان‌پذیر باشد.
.PP
محتوا، حالت (مجوزها)، برچسب زمانی، مالک و گروه فایل‌های اصلی در آرشیو حفظ می‌شوند و در هنگام استخراج قابل بازیابی هستند.
.PP
ابزار \fBar\fR گنو می‌تواند آرشیوهایی را نگهداری کند که عضوهای آن نام‌هایی با هر طولی داشته باشند؛ با این حال، بسته به نحوه پیکربندی \fBar\fR در سیستم شما، ممکن است برای سازگاری با قالب‌های آرشیو نگهداری‌شده توسط سایر ابزارها، محدودیتی برای طول نام عضو اعمال شود. در صورت وجود، این محدودیت اغلب ۱۵ نویسه (رایج در قالب‌های مربوط به a.out) یا ۱۶ نویسه (رایج در قالب‌های مربوط به coff) است.
.PP
ابزار \&\fBar\fR یک ابزار باینری به شمار می‌رود، زیرا آرشیوهایی از این دست بیشتر به عنوان \fIکتابخانه‌هایی\fR شامل زیرروال‌های پرکاربرد استفاده می‌شوند. از آنجا که کتابخانه‌ها اغلب به کتابخانه‌های دیگر وابسته خواهند بود، \&\fBar\fR در صورت مشخص شدن گزینه \&\fB\-\-record\-libdeps\fR می‌تواند وابستگی‌های یک کتابخانه را نیز ثبت کند.
.PP
هنگامی که تغییردهنده \fBs\fR را مشخص کنید، \&\fBar\fR یک نمایه از نمادهای تعریف‌شده در ماژول‌های شیء بازاستقرارپذیر (relocatable) درون آرشیو ایجاد می‌کند. این نمایه پس از ایجاد، هر بار که \&\fBar\fR تغییری در محتویات آن اعمال کند (به‌جز عملیات به‌روزرسانی \fBq\fR) در آرشیو به‌روزرسانی می‌شود. آرشیوی با چنین نمایه‌ای، سرعت پیوند به کتابخانه را افزایش می‌دهد و به روال‌های درون کتابخانه اجازه می‌دهد بدون توجه به جایگاهشان در آرشیو، یکدیگر را فراخوانی کنند.
.PP
می‌توانید از \fBnm \-s\fR یا \fBnm \-\-print\-armap\fR برای فهرست کردن این جدول نمایه استفاده کنید. اگر آرشیوی فاقد این جدول باشد، گونه دیگری از \fBar\fR به نام \&\fBranlib\fR می‌تواند برای افزودن تنها این جدول مورد استفاده قرار گیرد.
.PP
ابزار GNU \fBar\fR می‌تواند به‌صورت اختیاری یک آرشیو \fIthin\fR (سبک) ایجاد کند که حاوی یک نمایه نماد و ارجاعاتی به نسخه‌های اصلی فایل‌های عضو آرشیو است. این قابلیت برای ساخت کتابخانه‌ها جهت استفاده درون درخت ساخت محلی که در آن انتظار می‌رود اشیاء بازاستقرارپذیر در دسترس باقی بمانند، مفید است و کپی کردن محتوای هر شیء تنها زمان و فضا را هدر می‌دهد.
.PP
یک آرشیو می‌تواند \fIthin\fR یا معمولی باشد و نمی‌تواند هم‌زمان هر دو حالت را داشته باشد. پس از ایجاد یک آرشیو، قالب آن را نمی‌توان تغییر داد، مگر اینکه ابتدا حذف شود و آرشیو جدیدی به جای آن ایجاد گردد.
.PP
آرشیوهای thin همچنین مسطح (\fIflattened\fR) هستند، بنابراین افزودن یک آرشیو thin به آرشیو thin دیگر، آن را تودرتو نمی‌کند (برخلاف آنچه برای یک آرشیو معمولی رخ می‌دهد). در عوض، عناصر آرشیو اول به‌صورت جداگانه به آرشیو دوم اضافه می‌شوند.
.PP
مسیرهای منتهی به عناصر آرشیو به‌صورت نسبی نسبت به خود آرشیو ذخیره می‌شوند.
.PP
ابزار GNU \fBar\fR طوری طراحی شده است که با دو شیوه مختلف سازگار باشد. شما می‌توانید عملکرد آن را با استفاده از گزینه‌های خط فرمان، مانند گونه‌های مختلف \fBar\fR در سیستم‌های یونیکس کنترل کنید؛ یا اگر گزینه خط فرمان تکی \fB\-M\fR را مشخص کنید، می‌توانید آن را با یک اسکریپت که از طریق ورودی استاندارد ارائه می‌شود، مانند برنامه MRI \(lqlibrarian\(rq، کنترل نمایید..SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
ابزار GNU \fBar\fR به شما اجازه می‌دهد تا کد عملیات \fIp\fR و پرچم‌های تغییردهندهٔ \fImod\fR را با هر ترتیبی درون نخستین آرگومان خط فرمان ترکیب کنید.
.PP
در صورت تمایل، می‌توانید نخستین آرگومان خط فرمان را با یک خط تیره آغاز کنید.
.PP
حرف کلیدی \fIp\fR مشخص می‌کند چه عملیاتی اجرا شود؛ می‌تواند هر یک از موارد زیر باشد، اما باید تنها یکی از آن‌ها را مشخص کنید:
.IP \fBd\fR 4
.IX Item "d"
حذف (\fIDelete\fR) ماژول‌ها از آرشیو. نام ماژول‌های مورد نظر برای حذف را به‌صورت \fImember\fR... مشخص کنید؛ اگر هیچ فایلی برای حذف تعیین نکنید، آرشیو دست‌نخورده باقی می‌ماند.
.Sp
اگر تغییردهندهٔ \fBv\fR را مشخص کنید، \fBar\fR هر ماژول را هنگام حذف فهرست می‌کند.
.IP \fBm\fR 4
.IX Item "m"
از این عملیات برای انتقال (\fImove\fR) اعضا درون یک آرشیو استفاده کنید.
.Sp
ترتیب اعضا در یک آرشیو می‌تواند در نحوهٔ پیوند برنامه‌ها با استفاده از کتابخانه تفاوت ایجاد کند، اگر یک نماد در بیش از یک عضو تعریف شده باشد.
.Sp
اگر هیچ تغییردهنده‌ای همراه با \f(CW\*(C`m\*(C'\fR استفاده نشود، هر عضوی که در آرگومان‌های \fImember\fR نام ببرید به انتهای (\fIend\fR) آرشیو منتقل می‌شود؛ می‌توانید به‌جای آن از تغییردهنده‌های \fBa\fR، \fBb\fR یا \fBi\fR برای انتقال آن‌ها به مکانی مشخص استفاده کنید.
.IP \fBp\fR 4
.IX Item "p"
چاپ (\fIPrint\fR) اعضای مشخص‌شدهٔ آرشیو در خروجی استاندارد. اگر تغییردهندهٔ \fBv\fR مشخص شود، نام عضو پیش از کپی کردن محتویات آن به خروجی استاندارد نمایش داده می‌شود.
.Sp
اگر هیچ آرگومان \fImember\fR مشخص نکنید، تمام فایل‌های درون آرشیو چاپ می‌شوند.
.IP \fBq\fR 4
.IX Item "q"
الحاق سریع (\fIQuick append\fR)؛ از لحاظ تاریخی، فایل‌های \fImember\fR... را بدون بررسی برای جایگزینی، به انتهای \fIarchive\fR اضافه می‌کند.
.Sp
تغییردهنده‌های \fBa\fR، \fBb\fR و \fBi\fR بر این عملیات تاثیری \fInot\fR (ندارند)؛ اعضای جدید همواره در انتهای آرشیو قرار می‌گیرند.
.Sp
تغییردهندهٔ \fBv\fR باعث می‌شود \fBar\fR هر فایل را هنگام الحاق فهرست کند.
.Sp
از آن‌جا که هدف این عملیات سرعت است، پیاده‌سازی‌های \fBar\fR این امکان را دارند که در صورت وجود جدول نماد آرشیو، آن را به‌روزرسانی نکنند. با این حال، سیستم‌های بسیار متفاوتی فرض می‌کنند که جدول‌های نماد همیشه به‌روز هستند، بنابراین GNU \fBar\fR حتی در الحاق سریع نیز جدول را بازسازی خواهد کرد.
.Sp
نکته \- GNU \fBar\fR دستور \fBqs\fR را به‌عنوان مترادفی برای \fBr\fR در نظر می‌گیرد \- جایگزین کردن فایل‌های از پیش موجود در آرشیو و الحاق فایل‌های جدید به انتها.
.IP \fBr\fR 4
.IX Item "r"
درج فایل‌های \fImember\fR... درون \fIarchive\fR (همراه با جایگزینی یا \fIreplacement\fR). این عملیات با \fBq\fR از این نظر تفاوت دارد که اگر نام اعضای از پیش موجود با نام فایل‌های در حال اضافه شدن یکسان باشد، آن اعضا حذف می‌شوند.
.Sp
اگر یکی از فایل‌های نام‌برده در \fImember\fR... وجود نداشته باشد، \fBar\fR یک پیام خطا نمایش می‌دهد و هیچ‌یک از اعضای موجود در آرشیو را که با آن نام همخوانی دارند تغییر نمی‌دهد.
.Sp
به‌طور پیش‌فرض، اعضای جدید در انتهای فایل اضافه می‌شوند؛ اما می‌توانید از یکی از تغییردهنده‌های \fBa\fR، \fBb\fR یا \fBi\fR برای درخواست جای‌گذاری نسبت به عضوی موجود استفاده کنید.
.Sp
استفاده از تغییردهندهٔ \fBv\fR با این عملیات، یک خط خروجی به ازای هر فایل درج‌شده به همراه یکی از حروف \fBa\fR یا \fBr\fR تولید می‌کند تا مشخص شود فایل الحاق شده است (عضو قدیمی حذف نشده) یا جایگزین گشته است.
.IP \fBs\fR 4
.IX Item "s"
افزودن نمایه‌ای به آرشیو، یا به‌روزرسانی آن در صورت وجود. توجه داشته باشید که این دستور استثنایی بر این قاعده است که تنها می‌تواند یک حرف دستور وجود داشته باشد، زیرا می‌توان آن را چه به‌صورت دستور و چه به‌صورت یک تغییردهنده به کار برد. در هر دو حالت، عمل یکسانی انجام می‌دهد.
.IP \fBt\fR 4
.IX Item "t"
نمایش جدولی (\fItable\fR) از فهرست محتویات \fIarchive\fR، یا فایل‌های فهرست‌شده در \fImember\fR... که در آرشیو حاضر هستند. معمولاً فقط نام عضو نمایش داده می‌شود، اما اگر تغییردهندهٔ \fBO\fR مشخص شود، آفست متناظر با عضو نیز نمایش داده خواهد شد. در نهایت، برای مشاهدهٔ حالت‌ها (مجوزها)، برچسب زمانی، مالک، گروه، و اندازه، تغییردهندهٔ \fBv\fR باید قید شود.
.Sp
اگر هیچ \fImember\fR مشخص نکنید، تمام فایل‌های موجود در آرشیو فهرست می‌شوند.
.Sp
اگر بیش از یک فایل با نام یکسان (مثلاً \fBfie\fR) در آرشیو (مثلاً \fBb.a\fR) وجود داشته باشد، دستور \fBar t b.a fie\fR تنها اولین مورد را فهرست می‌کند؛ برای مشاهدهٔ همهٔ آن‌ها، باید یک فهرست‌بندی کامل درخواست کنید\-\-\-در مثال ما، \fBar t b.a\fR.
.IP \fBx\fR 4
.IX Item "x"
استخراج (\fIExtract\fR) اعضا (به نام \fImember\fR) از آرشیو. می‌توانید از تغییردهندهٔ \fBv\fR با این عملیات استفاده کنید تا از \fBar\fR بخواهید نام هر عضو را هنگام استخراج آن فهرست کند.
.Sp
اگر هیچ \fImember\fR مشخص نکنید، تمام فایل‌های درون آرشیو استخراج می‌شوند.
.Sp
فایل‌ها را نمی‌توان از یک thin archive استخراج کرد، و محدودیت‌هایی برای استخراج از آرشیوهای ایجادشده با \fBP\fR وجود دارد: مسیرها نباید مطلق باشند، نباید شامل \f(CW\*(C`..\*(C'\fR باشند، و هر زیردایرکتوری در مسیرها باید از قبل وجود داشته باشد. در صورت تمایل به اجتناب از این محدودیت‌ها، از گزینهٔ \fB\-\-output\fR برای مشخص کردن یک دایرکتوری خروجی استفاده کنید.
.PP
تعدادی از تغییردهنده‌ها (\fImod\fR) ممکن است بلافاصله پس از حرف کلیدی \fIp\fR بیایند تا تغییراتی را در رفتار عملیات مشخص کنند:
.IP \fBa\fR 4
.IX Item "a"
افزودن فایل‌های جدید پس از (\fIafter\fR) یک عضو موجود در آرشیو. اگر از تغییردهندهٔ \fBa\fR استفاده کنید، نام یک عضو موجود در آرشیو باید به‌عنوان آرگومان \fIrelpos\fR، پیش از مشخصهٔ \fIarchive\fR ارائه شود.
.IP \fBb\fR 4
.IX Item "b"
افزودن فایل‌های جدید پیش از (\fIbefore\fR) یک عضو موجود در آرشیو. اگر از تغییردهندهٔ \fBb\fR استفاده کنید، نام یک عضو موجود در آرشیو باید به‌عنوان آرگومان \fIrelpos\fR، پیش از مشخصهٔ \fIarchive\fR ارائه شود (همانند \fBi\fR).
.IP \fBc\fR 4
.IX Item "c"
ایجاد (\fICreate\fR) آرشیو. اگر آرشیو مشخص‌شده (\fIarchive\fR) وجود نداشته باشد، هنگام درخواست به‌روزرسانی همواره ایجاد می‌شود. اما هشداری صادر خواهد شد مگر آنکه با استفاده از این تغییردهنده از قبل مشخص کرده باشید که انتظار ایجاد آن را دارید.
.IP \fBD\fR 4
.IX Item "D"
عملکرد در حالت قطعی (\fIdeterministic\fR). هنگام افزودن فایل‌ها و نمایهٔ آرشیو، برای UIDها، GIDها و برچسب‌های زمانی از صفر استفاده می‌کند، و حالت‌های فایل یکسانی را برای تمام فایل‌ها به کار می‌گیرد. هنگامی که این گزینه استفاده می‌شود، اگر \fBar\fR با گزینه‌های یکسان و فایل‌های ورودی یکسان اجرا شود، اجراهای چندگانه بدون در نظر گرفتن مالکان، گروه‌ها، حالت‌های فایل یا زمان‌های ویرایش فایل‌های ورودی، خروجی‌های کاملاً یکسانی ایجاد خواهند کرد.
.Sp
اگر \fIbinutils\fR با \fB\-\-enable\-deterministic\-archives\fR پیکربندی شده باشد، این حالت به‌طور پیش‌فرض فعال است. می‌توان آن را با تغییردهندهٔ \fBU\fR در زیر غیرفعال کرد.
.IP \fBf\fR 4
.IX Item "f"
کوتاه کردن نام‌ها در آرشیو. GNU \fBar\fR معمولاً نام‌های فایل با هر طولی را می‌پذیرد. این امر موجب می‌شود آرشیوهایی ایجاد کند که با برنامهٔ بومی \fBar\fR در برخی سیستم‌ها سازگار نیستند. اگر این مسئله نگران‌کننده است، می‌توان از تغییردهندهٔ \fBf\fR برای کوتاه کردن نام فایل‌ها هنگام قرار دادن آن‌ها در آرشیو استفاده کرد.
.IP \fBi\fR 4
.IX Item "i"
درج فایل‌های جدید پیش از (\fIbefore\fR) یک عضو موجود در آرشیو. اگر از تغییردهندهٔ \fBi\fR استفاده کنید، نام یک عضو موجود در آرشیو باید به‌عنوان آرگومان \fIrelpos\fR، پیش از مشخصهٔ \fIarchive\fR ارائه شود (همانند \fBb\fR).
.IP \fBl\fR 4
.IX Item "l"
مشخص کردن وابستگی‌های این کتابخانه. وابستگی‌ها باید بلافاصله پس از این نویسهٔ گزینه بیایند، باید از همان نحو خط فرمان پیونددهنده استفاده کنند، و باید درون یک آرگومان واحد مشخص شوند؛ یعنی در صورت نیاز به چند مورد، باید آن‌ها را داخل علامت نقل‌قول قرار داد تا یک آرگومان خط فرمان تکی تشکیل شود. برای نمونه \fBl "\-L/usr/local/lib \-lmydep1 \-lmydep2"\fR
.IP \fBN\fR 4
.IX Item "N"
از پارامتر \fIcount\fR استفاده می‌کند. این مورد زمانی استفاده می‌شود که چندین مدخل با نام یکسان در آرشیو وجود داشته باشد. مورد شمارهٔ \fIcount\fR از نام ارائه‌شده را از آرشیو استخراج یا حذف می‌کند.
.IP \fBo\fR 4
.IX Item "o"
حفظ تاریخ‌های اصلی (\fIoriginal\fR) اعضا هنگام استخراج آن‌ها. اگر این تغییردهنده را مشخص نکنید، فایل‌های استخراج‌شده از آرشیو با زمان استخراج برچسب زمانی می‌خورند.
.IP \fBO\fR 4
.IX Item "O"
نمایش آفست اعضا درون آرشیو. همراه با گزینهٔ \fBt\fR استفاده می‌شود.
.IP \fBP\fR 4
.IX Item "P"
استفاده از نام مسیر کامل هنگام تطبیق یا ذخیرهٔ نام‌ها در آرشیو. آرشیوهایی که با نام‌های مسیر کامل ایجاد می‌شوند با POSIX سازگار نیستند، و بنابراین ممکن است با ابزارهایی غیر از ابزارهای به‌روز GNU کار نکنند. ویرایش چنین آرشیوهایی با GNU \fBar\fR بدون استفاده از \fBP\fR نام‌های مسیر کامل را حذف خواهد کرد، مگر اینکه آرشیو یک thin archive باشد. توجه داشته باشید که \fBP\fR ممکن است هنگام افزودن فایل‌ها به یک thin archive مفید باشد، زیرا \fBr\fR بدون \fBP\fR مسیر را هنگام انتخاب عنصری که باید جایگزین شود نادیده می‌گیرد. بنابراین
.Sp
.Vb 1
\&        ar rcST archive.a subdir/file1 subdir/file2 file1
.Ve
.Sp
منجر به این خواهد شد که نخستین \f(CW\*(C`subdir/file1\*(C'\fR با \f(CW\*(C`file1\*(C'\fR از دایرکتوری جاری جایگزین شود. افزودن \fBP\fR جلوی این جایگزینی را خواهد گرفت.
.IP \fBs\fR 4
.IX Item "s"
نوشتن نمایهٔ فایل هدف درون آرشیو، یا به‌روزرسانی نمونهٔ موجود، حتی اگر هیچ تغییر دیگری در آرشیو ایجاد نشود. می‌توانید از این پرچم تغییردهنده چه به همراه هر عملیاتی و چه به‌تنهایی استفاده کنید. اجرای \fBar s\fR روی یک آرشیو معادل اجرای \fBranlib\fR بر روی آن است..IP \fBS\fR 4
.IX Item "S"
جدول نمادهای آرشیو را ایجاد نمی‌کند. این کار می‌تواند ساخت یک
کتابخانهٔ بزرگ در چند مرحله را سرعت بخشد. آرشیو حاصل را نمی‌توان
همراه با پیونددهنده استفاده کرد. برای ساخت جدول نمادها، باید در آخرین
اجرای \fBar\fR از اصلاح‌کنندهٔ \&\fBS\fR صرف‌نظر کنید، یا این‌که
\&\fBranlib\fR را روی آرشیو اجرا نمایید.
.IP \fBT\fR 4
.IX Item "T"
یک نام مستعار منسوخ‌شده برای \fB\-\-thin\fR. استفاده از \fBT\fR توصیه نمی‌شود
زیرا در بسیاری از پیاده‌سازی‌های ar، طبق آنچه توسط X/Open System Interface
مشخص شده است، \fBT\fR معنی متفاوتی دارد.
.IP \fBu\fR 4
.IX Item "u"
به‌طور معمول، دستور ...\fBar r\fR تمام فایل‌های
فهرست‌شده را درون آرشیو قرار می‌دهد. اگر می‌خواهید \fIتنها\fR فایل‌هایی
را درج کنید که از اعضای هم‌نامِ موجود جدیدتر هستند، از این اصلاح‌کننده
استفاده کنید. اصلاح‌کنندهٔ \fBu\fR تنها برای عملیات \fBr\fR (جایگزینی)
مجاز است. به‌طور خاص، ترکیب \fBqu\fR مجاز نیست، زیرا بررسی برچسب‌های
زمانی، هرگونه مزیت سرعتی حاصل از عملیات \fBq\fR را از بین می‌برد.
.Sp
نکته \- اگر آرشیو به شیوه‌ای قطعی (deterministic) ایجاد شده باشد، برای نمونه
از طریق استفاده از اصلاح‌کنندهٔ \fBD\fR، در این صورت جایگزینی همواره انجام خواهد
شد و اصلاح‌کنندهٔ \fBu\fR بی‌اثر خواهد بود.
.IP \fBU\fR 4
.IX Item "U"
در حالت \fIقطعیت‌یافته (deterministic)\fR عمل \fIنکن\fR. این برعکس
اصلاح‌کنندهٔ \fBD\fR در بالا است: فایل‌های اضافه‌شده و نمایهٔ آرشیو، مقادیر
واقعی UID، GID، برچسب زمانی و حالت فایل (file mode) خود را دریافت خواهند کرد.
.Sp
این حالت پیش‌فرض است، مگر این‌که \fIbinutils\fR با گزینهٔ
\&\fB\-\-enable\-deterministic\-archives\fR پیکربندی شده باشد.
.IP \fBv\fR 4
.IX Item "v"
این اصلاح‌کننده نسخهٔ با \fIجزئیات کامل (verbose)\fR یک عملیات را درخواست می‌کند.
بسیاری از عملیات در صورت افزوده شدن اصلاح‌کنندهٔ \fBv\fR، اطلاعات بیشتری مانند
نام فایل‌های پردازش‌شده را نمایش می‌دهند.
.IP \fBV\fR 4
.IX Item "V"
این اصلاح‌کننده شماره نسخهٔ \fBar\fR را نمایش می‌دهد.
.PP
برنامهٔ \fBar\fR همچنین از چند گزینهٔ خط فرمان پشتیبانی می‌کند که
نه اصلاح‌کننده هستند و نه عملیات، اما رفتار آن را به شیوه‌های
خاصی تغییر می‌دهند:
.IP \fB\-\-help\fR 4
.IX Item "--help"
فهرست گزینه‌های خط فرمان پشتیبانی‌شده توسط \fBar\fR را نمایش می‌دهد
و سپس خارج می‌شود.
.IP \fB\-\-version\fR 4
.IX Item "--version"
اطلاعات نسخهٔ \fBar\fR را نمایش می‌دهد و سپس خارج می‌شود.
.IP \fB\-X32_64\fR 4
.IX Item "-X32_64"
دستور \&\fBar\fR برای سازگاری با AIX، گزینهٔ ابتدایی به شکل \fB\-X32_64\fR را
نادیده می‌گیرد. رفتار حاصل از این گزینه، حالت پیش‌فرض در GNU \fBar\fR است.
\&\fBar\fR از هیچ‌یک از گزینه‌های دیگر \fB\-X\fR پشتیبانی نمی‌کند؛ به‌ویژه، از
\&\fB\-X32\fR که پیش‌فرض برای AIX \fBar\fR است پشتیبانی نمی‌کند.
.IP "\fB\-\-plugin\fR \fIname\fR" 4
.IX Item "--plugin name"
سوئیچ اختیاری خط فرمان \fB\-\-plugin\fR \fIname\fR باعث می‌شود
\&\fBar\fR پلاگینی به‌نام \fIname\fR را بارگیری کند که پشتیبانی
از قالب‌های فایل بیشتری، از جمله فایل‌های شیءِ حاوی اطلاعات
بهینه‌سازی زمان پیوند (LTO)، را می‌افزاید.
.Sp
این گزینه تنها در صورتی در دسترس است که زنجیره ابزار (toolchain) با فعال بودن
پشتیبانی از پلاگین ساخته شده باشد.
.Sp
اگر \fB\-\-plugin\fR مشخص نشده باشد اما پشتیبانی از پلاگین فعال باشد،
\&\fBar\fR فایل‌های درون \&\fI${libdir}/bfd\-plugins\fR را به ترتیب
الفبایی بررسی کرده و نخستین پلاگینی که شیء مورد نظر را بپذیرد استفاده خواهد شد.
.Sp
لطفاً توجه داشته باشید که این دایرکتوری جستجوی پلاگین، همان دایرکتوری مورد استفاده
توسط گزینهٔ \fB\-plugin\fR در \fBld\fR نیست. برای این‌که \&\fBar\fR از پلاگین
پیونددهنده استفاده کند، باید آن را درون دایرکتوری \&\fI${libdir}/bfd\-plugins\fR کپی کرد.
برای کامپایل‌های مبتنی بر GCC نام پلاگین پیونددهنده \fIliblto_plugin.so.0.0.0\fR
است. برای کامپایل‌های مبتنی بر Clang نام آن \fILLVMgold.so\fR است. پلاگین GCC
همواره با نسخه‌های قبلی سازگار با گذشته است، بنابراین تنها کپی کردن جدیدترین نسخه کافی است.
.IP "\fB\-\-target\fR \fItarget\fR" 4
.IX Item "--target target"
سوئیچ اختیاری خط فرمان \fB\-\-target\fR \fIbfdname\fR مشخص می‌کند
که اعضای آرشیو در قالب کد شیئی متفاوتی از قالب پیش‌فرض سیستم شما
قرار دارند. ببینید
.IP "\fB\-\-output\fR \fIdirname\fR" 4
.IX Item "--output dirname"
از گزینهٔ \fB\-\-output\fR می‌توان برای تعیین مسیر دایرکتوری‌ای استفاده کرد
که اعضای آرشیو باید در آن استخراج شوند. اگر این گزینه مشخص نشود، از
دایرکتوری فعلی استفاده خواهد شد.
.Sp
نکته \- اگرچه وجود این گزینه دلالت بر عملیات استخراج \fBx\fR دارد،
اما آن گزینه همچنان باید در خط فرمان درج شود.
.IP "\fB\-\-record\-libdeps\fR \fIlibdeps\fR" 4
.IX Item "--record-libdeps libdeps"
گزینهٔ \fB\-\-record\-libdeps\fR کاملاً همانند اصلاح‌کنندهٔ \fBl\fR است،
و صرفاً در قالب بلند به کار می‌رود.
.IP \fB\-\-thin\fR 4
.IX Item "--thin"
\fIarchive\fR مشخص‌شده را به یک آرشیو \fIthin\fR تبدیل می‌کند. اگر آرشیو
از قبل وجود داشته باشد و یک آرشیو معمولی باشد، اعضای موجود باید در همان
دایرکتوریِ \fIarchive\fR حضور داشته باشند.
.IP \fB@\fR\fIfile\fR 4
.IX Item "@file"
گزینه‌های خط فرمان را از \fIfile\fR می‌خواند. گزینه‌های خوانده‌شده
به جای گزینهٔ اصلی @\fIfile\fR قرار می‌گیرند. اگر \fIfile\fR
وجود نداشته باشد یا قابل خواندن نباشد، با این گزینه به عنوان یک عبارت لفظی
برخورد می‌شود و حذف نخواهد شد.
.Sp
گزینه‌ها در \fIfile\fR با نویسهٔ فاصله از هم جدا می‌شوند. یک نویسهٔ فاصله
می‌تواند با قرار دادن کل گزینه درون گیومهٔ تکی یا دوگانه، در یک
گزینه قرار گیرد. هر نویسه‌ای (از جمله بک‌اسلش) می‌تواند با درج یک بک‌اسلش
پیش از آن وارد شود. خودِ \fIfile\fR نیز می‌تواند حاوی گزینه‌های دیگر @\fIfile\fR
باشد؛ هر یک از این گزینه‌ها به‌صورت بازگشتی پردازش خواهند شد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBnm\fR\|(1)، \fBranlib\fR\|(1)، و مدخل‌های Info برای \fIbinutils\fR..SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر (c) 1991\-2025 متعلق است به Free Software Foundation, Inc.
.PP
اجازهٔ کپی، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (GNU Free Documentation License)، نسخهٔ 1.3 یا هر نسخهٔ متأخرتری که توسط Free Software Foundation منتشر شده است، داده می‌شود؛ بدون هیچ‌یک از بخش‌های تغییرناپذیر (Invariant Sections)، بدون متون روی جلد (Front\-Cover Texts)، و بدون متون پشت جلد (Back\-Cover Texts). نسخه‌ای از این مجوز در بخشی با عنوان \(lqGNU Free Documentation License\(rq آمده است.