.\" -*- 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-08-11 binutils-2.47 "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...]
.br
ar \fB\-M\fR [< mri\-script]
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
برنامه گنو
.B ar
اقدام به ایجاد، ویرایش و استخراج از آرشیوها می‌کند. یک \fIآرشیو\fR فایلی واحد است که مجموعه‌ای از فایل‌های دیگر را درون ساختاری نگهداری می‌کند که امکان بازیابی مجدد فایل‌های منفرد اولیه (که اعضا یا \fImembers\fR آرشیو نامیده می‌شوند) را فراهم می‌سازد.
.PP
محتوای فایل‌های اولیه، حالت یا مجوزها (permissions)، برچسب زمانی (timestamp)، مالک و گروه در آرشیو حفظ می‌شوند و در زمان استخراج قابل بازیابی هستند.
.PP
ابزار گنو
.B ar
می‌تواند از آرشیوهایی پشتیبانی کند که اعضای آن نام‌هایی با هر طولی داشته باشند؛ با این حال، بسته به نحوه پیکربندی
.B ar
روی سیستم شما، ممکن است برای سازگاری با قالب‌های آرشیو نگهداری‌شده توسط سایر ابزارها، محدودیتی بر طول نام اعضا اعمال شود. در صورت وجود، این محدودیت اغلب ۱۵ نویسه (رایج در قالب‌های مرتبط با a.out) یا ۱۶ نویسه (رایج در قالب‌های مرتبط با coff) است.
.PP
دستور
.B ar
یک ابزار باینری در نظر گرفته می‌شود، زیرا آرشیوهایی از این نوع اغلب به عنوان \fIکتابخانه‌ها\fR (libraries) که شامل زیرروال‌های پرکاربرد هستند استفاده می‌شوند. از آنجا که کتابخانه‌ها معمولاً به کتابخانه‌های دیگری وابسته هستند،
.B ar
همچنین می‌تواند با مشخص شدن گزینه
.B \-\-record\-libdeps
وابستگی‌های یک کتابخانه را ثبت کند.
.PP
ابزار
.B ar
هنگامی که اصلاح‌کننده
.B s
را مشخص کنید، نمایه‌ای (اندیس) از نمادهای تعریف‌شده در ماژول‌های شیء جابه‌جاشونده (relocatable object modules) درون آرشیو ایجاد می‌کند. پس از ایجاد، هر زمان که
.B ar
تغییری در محتویات آن ایجاد کند (به‌جز در عملیات به‌روزرسانی
.BR q )،
این نمایه نیز در آرشیو به‌روزرسانی می‌شود. آرشیو دارای چنین نمایه‌ای، سرعت پیوند زدن (linking) به کتابخانه را افزایش می‌دهد.
.PP
می‌توانید از
.B nm \-s
یا
.B nm \-\-print\-armap
برای فهرست کردن جدول این نمایه استفاده کنید. اگر آرشیوی فاقد این جدول باشد، شکل دیگری از
.B ar
به نام
.B ranlib
می‌تواند برای افزودن جدول نمایه به کار رود.
.PP
ابزار گنو
.B ar
می‌تواند به‌صورت اختیاری یک آرشیو \fIنازک\fR (\fIthin\fR archive) ایجاد کند که حاوی نمایه نماد و ارجاعاتی به نسخه‌های اصلی فایل‌های عضو آرشیو است. این ویژگی برای ساخت کتابخانه‌ها جهت استفاده درون درخت ساخت محلی (local build tree) مفید است، جایی که انتظار می‌رود اشیای جابه‌جاشونده در دسترس باقی بمانند و کپی کردن محتوای هر شیء صرفاً باعث هدر رفتن زمان و فضا می‌شود.
.PP
یک آرشیو یا باید \fIنازک\fR باشد یا معمولی؛ نمی‌تواند هر دو حالت را به‌طور هم‌زمان داشته باشد. پس از ایجاد آرشیو، قالب آن بدون حذف اولیه و ایجاد مجدد آرشیو در جای آن، قابل تغییر نیست.
.PP
آرشیوهای نازک همچنین تسطیح‌شده (\fIflattened\fR) هستند؛ بنابراین افزودن یک آرشیو نازک به آرشیو نازک دیگر، برخلاف آرشیوهای معمولی، آن را درون آرشیو جدید تو در تو نمی‌کند. در عوض، عناصر آرشیو اول به‌صورت جداگانه به آرشیو دوم افزوده می‌شوند.
.PP
مسیرهای عناصر آرشیو به‌صورت نسبی نسبت به خود آرشیو ذخیره می‌شوند.
.PP
ابزار گنو
.B ar
طوری طراحی شده است که با دو شیوه مختلف سازگار باشد. می‌توانید فعالیت آن را با استفاده از گزینه‌های خط فرمان کنترل کنید، مانند انواع مختلف
.B ar
در سیستم‌های یونیکس؛ یا اگر گزینه تک خط فرمانی
.B \-M
را مشخص کنید، می‌توانید آن را با یک اسکریپت که از طریق ورودی استاندارد ارائه می‌شود کنترل کنید، مانند برنامه کتابخانه‌دار (librarian) در MRI.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
ابزار گنو
.B ar
به شما اجازه می‌دهد که کد عملیات \fIp\fR و پرچم‌های اصلاح‌کننده \fImod\fR را به هر ترتیبی درون اولین آرگومان خط فرمان ترکیب کنید.
.PP
در صورت تمایل، می‌توانید اولین آرگومان خط فرمان را با یک خط تیره آغاز کنید.
.PP
حرف کلیدی \fIp\fR مشخص می‌کند چه عملیاتی اجرا شود؛ این حرف می‌تواند هر یک از موارد زیر باشد، اما باید تنها یکی از آن‌ها را مشخص کنید:
.IP \fBd\fR 4
.IX Item "d"
\&\fIحذف کردن\fR ماژول‌ها از آرشیو. نام ماژول‌های مورد نظر برای حذف را به‌صورت \fImember\fR... مشخص کنید؛ در صورتی که هیچ فایلی برای حذف مشخص نکنید، آرشیو دست‌نخورده باقی می‌ماند.
.Sp
اگر اصلاح‌کننده
.B v
را مشخص کنید،
.B ar
هر ماژول را هنگام حذف فهرست می‌کند.
.IP \fBm\fR 4
.IX Item "m"
از این عملیات برای \fIجابه‌جایی\fR اعضا در آرشیو استفاده کنید.
.Sp
ترتیب قرارگیری اعضا در آرشیو می‌تواند در نحوه پیوند خوردن برنامه‌ها با استفاده از کتابخانه تفاوت ایجاد کند، به‌ویژه اگر یک نماد در بیش از یک عضو تعریف شده باشد.
.Sp
اگر هیچ اصلاح‌کننده‌ای همراه با \f(CW\*(C`m\*(C'\fR استفاده نشود، هر عضوی که در آرگومان‌های \fImember\fR نام ببرید به \fIانتهای\fR آرشیو منتقل می‌شود؛ می‌توانید از اصلاح‌کننده‌های
.BR a ،
.B b
یا
.B i
برای انتقال آن‌ها به مکانی مشخص استفاده کنید.
.IP \fBp\fR 4
.IX Item "p"
\&\fIچاپ کردن\fR اعضای مشخص‌شده آرشیو در فایل خروجی استاندارد. اگر اصلاح‌کننده
.B v
مشخص شود، نام عضو پیش از کپی کردن محتوای آن در خروجی استاندارد نمایش داده می‌شود.
.Sp
اگر هیچ آرگومان \fImember\fR مشخص نکنید، تمام فایل‌های موجود در آرشیو چاپ می‌شوند.
.IP \fBq\fR 4
.IX Item "q"
\&\fIالحاق سریع\fR؛ از نظر تاریخی، افزودن فایل‌های \fImember\fR... به انتهای \fIarchive\fR بدون بررسی برای جایگزینی.
.Sp
اصلاح‌کننده‌های
.BR a ،
.B b
و
.B i
بر این عملیات تأثیری \fIندارند\fR؛ اعضای جدید همواره در انتهای آرشیو قرار می‌گیرند.
.Sp
اصلاح‌کننده
.B v
باعث می‌شود
.B ar
هر فایل را هنگام الحاق فهرست کند.
.Sp
از آنجا که هدف این عملیات سرعت بالا است، پیاده‌سازی‌های
.B ar
این امکان را دارند که جدول نمادهای آرشیو را (در صورت وجود) به‌روزرسانی نکنند. با این حال، سیستم‌های بسیار متعددی فرض می‌کنند که جدول‌های نماد همیشه به‌روز هستند؛ بنابراین گنو
.B ar
حتی با الحاق سریع نیز جدول را بازسازی خواهد کرد.
.Sp
نکته \- ابزار گنو
.B ar
دستور
.B qs
را مترادفی برای
.B r
در نظر می‌گیرد \- جایگزینی فایل‌های از قبل موجود در آرشیو و الحاق فایل‌های جدید به انتها.
.IP \fBr\fR 4
.IX Item "r"
درج فایل‌های \fImember\fR... درون \fIarchive\fR (همراه با \fIجایگزینی\fR). این عملیات با
.B q
در این نکته تفاوت دارد که هر عضو موجود قبلی در صورت تطابق نام با موارد در حال افزودن، حذف می‌شود.
.Sp
اگر یکی از فایل‌های مشخص‌شده در \fImember\fR... وجود نداشته باشد،
.B ar
پیام خطایی نمایش می‌دهد و اعضای موجود در آرشیو با نام منطبق را دست‌نخورده باقی می‌گذارد.
.Sp
به‌طور پیش‌فرض، اعضای جدید در انتهای فایل افزوده می‌شوند؛ اما می‌توانید از یکی از اصلاح‌کننده‌های
.BR a ،
.B b
یا
.B i
برای درخواست قرارگیری نسبت به عضوی موجود استفاده کنید.
.Sp
اصلاح‌کننده
.B v
همراه با این عملیات، برای هر فایل درج‌شده یک خط خروجی تولید می‌کند که همراه با یکی از حروف
.B a
یا
.B r
نشان می‌دهد فایل الحاق شده است (هیچ عضو قدیمی حذف نشده) یا جایگزین شده است.
.IP \fBs\fR 4
.IX Item "s"
افزودن یک نمایه به آرشیو، یا به‌روزرسانی آن در صورت وجود. توجه داشته باشید این دستور استثنایی بر قانون وجود تنها یک حرف دستوری است، زیرا می‌توان از آن هم به عنوان دستور و هم به عنوان اصلاح‌کننده استفاده کرد. در هر دو حالت، عملکرد یکسانی دارد.
.IP \fBt\fR 4
.IX Item "t"
نمایش یک \fIجدول\fR از فهرست محتویات \fIarchive\fR، یا آن دسته از فایل‌های ذکرشده در \fImember\fR... که در آرشیو موجود هستند. به‌طور معمول تنها نام عضو نشان داده می‌شود، اما اگر اصلاح‌کننده
.B O
مشخص شده باشد، آفست متناظر با عضو نیز نمایش داده می‌شود. در نهایت، برای مشاهده حالت‌ها (مجوزها/دسترسی‌ها)، برچسب زمانی، مالک، گروه و اندازه، باید اصلاح‌کننده
.B v
لحاظ شود.
.Sp
اگر \fImember\fR را مشخص نکنید، تمام فایل‌های موجود در آرشیو فهرست می‌شوند.
.Sp
اگر بیش از یک فایل با نام یکسان (مثلاً \fBfie\fR) در یک آرشیو (مثلاً \fBb.a\fR) وجود داشته باشد، دستور \fBar t b.a fie\fR تنها اولین نمونه را فهرست می‌کند؛ برای مشاهده همه آن‌ها، باید فهرست کامل را درخواست کنید \(em در مثال ما، \fBar t b.a\fR.
.IP \fBx\fR 4
.IX Item "x"
\&\fIاستخراج\fR اعضا (با نام \fImember\fR) از آرشیو. می‌توانید از اصلاح‌کننده
.B v
همراه با این عملیات استفاده کنید تا درخواست نمایید
.B ar
نام هر عضو را هنگام استخراج آن فهرست کند.
.Sp
اگر \fImember\fR را مشخص نکنید، تمام فایل‌های موجود در آرشیو استخراج می‌شوند.
.Sp
فایل‌ها را نمی‌توان از یک آرشیو نازک استخراج کرد، و محدودیت‌هایی برای استخراج از آرشیوهای ایجادشده با
.B P
وجود دارد: مسیرها نباید مطلق باشند، نباید شامل \f(CW\*(C`..\*(C'\fR باشند، و تمام زیرپوشه‌های موجود در مسیرها باید وجود داشته باشند. در صورت تمایل به اجتناب از این محدودیت‌ها، از گزینه
.B \-\-output
برای تعیین یک پوشه خروجی استفاده کنید.
.PP
تعدادی از اصلاح‌کننده‌ها (\fImod\fR) می‌توانند بلافاصله پس از حرف کلیدی \fIp\fR بیایند تا تغییراتی در رفتار عملیات مشخص کنند:
.IP \fBa\fR 4
.IX Item "a"
افزودن فایل‌های جدید \fIپس از\fR یک عضو موجود در آرشیو. اگر از اصلاح‌کننده
.B a
استفاده کنید، نام یک عضو موجود در آرشیو باید به عنوان آرگومان \fIrelpos\fR، پیش از مشخص کردن \fIarchive\fR ارائه شود.
.IP \fBb\fR 4
.IX Item "b"
افزودن فایل‌های جدید \fIپیش از\fR یک عضو موجود در آرشیو. اگر از اصلاح‌کننده
.B b
استفاده کنید، نام یک عضو موجود در آرشیو باید به عنوان آرگومان \fIrelpos\fR، پیش از مشخص کردن \fIarchive\fR ارائه شود (مشابه
.BR i ).
.IP \fBc\fR 4
.IX Item "c"
\&\fIایجاد کردن\fR آرشیو. هنگامی که درخواست به‌روزرسانی می‌کنید، در صورتی که \fIarchive\fR مشخص‌شده وجود نداشته باشد، همیشه ایجاد می‌شود؛ اما هشداری صادر خواهد شد مگر اینکه با استفاده از این اصلاح‌کننده از پیش اعلام کنید که انتظار ایجاد آن را دارید.
.IP \fBD\fR 4
.IX Item "D"
کار در حالت \fIقطعیت\fR (deterministic). هنگام افزودن فایل‌ها و نمایه آرشیو، برای UIDها، GIDها و برچسب‌های زمانی از صفر استفاده می‌شود و مجوزهای فایل یکسانی برای تمام فایل‌ها به کار می‌رود. با فعال بودن این گزینه، اگر
.B ar
با گزینه‌ها و فایل‌های ورودی کاملاً یکسان اجرا شود، دفعات مختلف اجرا فایل‌های خروجی یکسانی تولید خواهند کرد، صرف‌نظر از مالکان، گروه‌ها، مجوزها یا زمان‌های ویرایش فایل‌های ورودی.
.Sp
اگر \fIbinutils\fR با
.B \-\-enable\-deterministic\-archives
پیکربندی شده باشد، این حالت به‌طور پیش‌فرض فعال است. می‌توان آن را با اصلاح‌کننده
.B U
در زیر غیرفعال کرد.
.IP \fBf\fR 4
.IX Item "f"
کوتاه کردن نام‌ها در آرشیو. ابزار گنو
.B ar
معمولاً نام فایل‌ها با هر طولی را مجاز می‌داند. این امر ممکن است باعث ایجاد آرشیوهایی شود که با برنامه بومی
.B ar
در برخی سیستم‌ها سازگار نیستند. در صورت اهمیت این موضوع، می‌توان از اصلاح‌کننده
.B f
برای کوتاه کردن نام فایل‌ها هنگام قرار دادن آن‌ها در آرشیو استفاده کرد.
.IP \fBi\fR 4
.IX Item "i"
درج فایل‌های جدید \fIپیش از\fR یک عضو موجود در آرشیو. اگر از اصلاح‌کننده
.B i
استفاده کنید، نام یک عضو موجود در آرشیو باید به عنوان آرگومان \fIrelpos\fR، پیش از مشخص کردن \fIarchive\fR ارائه شود (مشابه
.BR b ).
.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"
حفظ تاریخ‌های \fIاصلی\fR اعضا هنگام استخراج آن‌ها. اگر این اصلاح‌کننده را مشخص نکنید، فایل‌های استخراج‌شده از آرشیو با زمان استخراج برچسب زمانی می‌خورند.
.IP \fBO\fR 4
.IX Item "O"
نمایش آفست اعضا درون آرشیو. همراه با گزینه
.B t
استفاده می‌شود.
.IP \fBP\fR 4
.IX Item "P"
استفاده از نام مسیر کامل هنگام تطبیق یا ذخیره نام‌ها در آرشیو. آرشیوهای ایجادشده با نام مسیر کامل با استاندارد POSIX سازگار نیستند و بنابراین ممکن است با ابزارهایی غیر از ابزارهای به‌روزشده گنو کار نکنند. ویرایش چنین آرشیوهایی با گنو
.B ar
بدون استفاده از
.B P
نام مسیرهای کامل را حذف خواهد کرد، مگر اینکه آرشیو یک آرشیو نازک باشد. توجه داشته باشید که
.B P
ممکن است هنگام افزودن فایل‌ها به یک آرشیو نازک مفید باشد، زیرا
.B r
بدون
.B P
هنگام انتخاب عنصری که باید جایگزین شود، مسیر را نادیده می‌گیرد. بنابراین:
.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 از پوشه جاری جایگزین شود. افزودن
.B P
مانع از این جایگزینی خواهد شد.
.IP \fBs\fR 4
.IX Item "s"
نوشتن نمایه فایل‌های شیء درون آرشیو یا به‌روزرسانی نمایه موجود، حتی اگر هیچ تغییر دیگری در آرشیو ایجاد نشود. می‌توانید این پرچم اصلاح‌کننده را همراه با هر عملیاتی یا به‌تنهایی استفاده کنید. اجرای
.B ar s
روی یک آرشیو معادل اجرای
.B ranlib
روی آن است.
.IP \fBS\fR 4
.IX Item "S"
تولید نکردن جدول نمادهای آرشیو. این کار می‌تواند ساخت یک کتابخانه بزرگ در چندین مرحله را سرعت بخشد، اما در صورتی که آرشیو حاصل با پیونددهنده استفاده شود تأثیر منفی بر کارایی خواهد گذاشت. برای ساخت جدول نماد، باید اصلاح‌کننده
.B S
را در آخرین اجرای
.B ar
حذف کنید، یا اینکه
.B ranlib
را روی آرشیو اجرا نمایید.
.IP \fBT\fR 4
.IX Item "T"
نام مستعار منسوخ‌شده برای
.BR \-\-thin .
استفاده از
.B T
توصیه نمی‌شود، زیرا در بسیاری از پیاده‌سازی‌های ar، همان‌طور که توسط رابط سیستم X/Open مشخص شده،
.B T
معنای متفاوتی دارد.
.IP \fBu\fR 4
.IX Item "u"
به‌طور معمول، دستور
.B ar r\fR...
تمام فایل‌های فهرست‌شده را در آرشیو درج می‌کند. اگر مایلید \fIتنها\fR فایل‌هایی را درج کنید که جدیدتر از اعضای هم‌نام موجود در آرشیو هستند، از این اصلاح‌کننده استفاده کنید. اصلاح‌کننده
.B u
تنها برای عملیات
.B r
(جایگزینی) مجاز است. به‌ویژه، ترکیب
.B qu
مجاز نیست؛ چرا که بررسی برچسب‌های زمانی هرگونه مزیت سرعت در عملیات
.B q
را از بین می‌برد.
.Sp
نکته \- اگر آرشیوی به شیوه قطعی (deterministic) ایجاد شده باشد، مثلاً با استفاده از اصلاح‌کننده
.BR D ،
در این صورت جایگزینی همیشه انجام می‌شود و اصلاح‌کننده
.B u
بی‌اثر خواهد بود.
.IP \fBU\fR 4
.IX Item "U"
کار \fIنکردن\fR در حالت \fIقطعیت\fR (deterministic). این حالت عکس اصلاح‌کننده
.B D
در بالا است: فایل‌های اضافه‌شده و نمایه آرشیو مقادیر واقعی UID، GID، برچسب زمانی و دسترسی‌های فایل خود را دریافت خواهند کرد.
.Sp
این حالت پیش‌فرض است، مگر اینکه \fIbinutils\fR با
.B \-\-enable\-deterministic\-archives
پیکربندی شده باشد.
.IP \fBv\fR 4
.IX Item "v"
این اصلاح‌کننده نسخه با \fIجزئیات کامل\fR (verbose) یک عملیات را درخواست می‌کند. بسیاری از عملیات هنگامی که اصلاح‌کننده
.B v
الحاق شود، اطلاعات بیشتری مانند نام فایل‌های پردازش‌شده را نمایش می‌دهند.
.IP \fBV\fR 4
.IX Item "V"
این اصلاح‌کننده شماره نسخه
.B ar
را نشان می‌دهد.
.PP
برنامه
.B ar
همچنین از برخی گزینه‌های خط فرمان پشتیبانی می‌کند که نه اصلاح‌کننده هستند و نه کنش، اما رفتار آن را به شیوه‌های خاصی تغییر می‌دهند:
.IP \fB\-\-help\fR 4
.IX Item "--help"
فهرستی از گزینه‌های خط فرمان پشتیبانی‌شده توسط
.B ar
را نمایش داده و خارج می‌شود.
.IP \fB\-\-version\fR 4
.IX Item "--version"
اطلاعات نسخه
.B ar
را نمایش داده و خارج می‌شود.
.IP \fB\-X32_64\fR 4
.IX Item "-X32_64"
دستور
.B ar
گزینه ابتدایی با نگارش
.B \-X32_64
را جهت سازگاری با AIX نادیده می‌گیرد. رفتاری که توسط این گزینه ایجاد می‌شود، حالت پیش‌فرض در گنو
.B ar
است. ابزار
.B ar
از هیچ‌یک از گزینه‌های دیگر
.B \-X
پشتیبانی نمی‌کند؛ به‌ویژه، از
.B \-X32
که پیش‌فرض
.B ar
در AIX است پشتیبانی نمی‌کند.
.IP "\fB\-\-plugin\fR \fIname\fR" 4
.IX Item "--plugin name"
سوییچ خط فرمان اختیاری
\fB\-\-plugin\fR \fIname\fR
باعث می‌شود
.B ar
افزونه‌ای با نام \fIname\fR را بارگیری کند که پشتیبانی از قالب‌های فایل بیشتر، از جمله فایل‌های شیء با اطلاعات بهینه‌سازی زمان پیوند (LTO)، را می‌افزاید.
.Sp
این گزینه تنها در صورتی در دسترس است که زنجیره ابزار (toolchain) با پشتیبانی فعال از افزونه‌ها ساخته شده باشد.
.Sp
اگر
.B \-\-plugin
ارائه نشود، اما پشتیبانی از افزونه فعال باشد،
.B ar
فایل‌های موجود در
\&\fI${libdir}/bfd\-plugins\fR
را به ترتیب حروف الفبا پیمایش کرده و نخستین افزونه‌ای که شیء مورد نظر را بپذیرد به کار گرفته می‌شود.
.Sp
لطفاً توجه داشته باشید که این پوشه جستجوی افزونه، همان پوشه‌ای \fIنیست\fR که توسط گزینه
.B \-plugin
دستور
.B ld
استفاده می‌شود. برای آنکه
.B ar
از افزونه پیونددهنده استفاده کند، باید آن را در پوشه
\&\fI${libdir}/bfd\-plugins\fR
کپی کرد. برای کامپایل‌های مبتنی بر GCC، افزونه پیونددهنده \fIliblto_plugin.so.0.0.0\fR نامیده می‌شود. برای کامپایل‌های مبتنی بر Clang، این افزونه \fILLVMgold.so\fR نام دارد. افزونه GCC همواره با نسخه‌های قبلی سازگار به عقب (backwards compatible) است، بنابراین کپی کردن جدیدترین نسخه آن کافی است.
.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"
از گزینه
.B \-\-output
می‌توان برای تعیین مسیر پوشه‌ای استفاده کرد که اعضای آرشیو باید در آن استخراج شوند. اگر این گزینه مشخص نشود، از پوشه جاری استفاده خواهد شد.
.Sp
نکته \- اگرچه وجود این گزینه حاکی از یک عملیات استخراج
.B x
است، اما آن گزینه همچنان باید در خط فرمان گنجانده شود.
.IP "\fB\-\-record\-libdeps\fR \fIlibdeps\fR" 4
.IX Item "--record-libdeps libdeps"
گزینه
.B \-\-record\-libdeps
دقیقاً مشابه اصلاح‌کننده
.B l
است، با این تفاوت که در قالب بلند به کار می‌رود.
.IP \fB\-\-thin\fR 4
.IX Item "--thin"
تبدیل \fIarchive\fR مشخص‌شده به یک آرشیو \fIنازک\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)"
کپی‌رایت \(co 1991\-2026 بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.)
.PP
اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه بعدی منتشرشده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد، و بدون متون پشت جلد. یک نسخه از این مجوز در بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.