.\" -*- 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-26 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)"
loongarch64\-linux\-gnu\-ar \- ایجاد، ویرایش و استخراج از آرشیوهای باینری معماری LoongArch64
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
loongarch64\-linux\-gnu\-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...]
loongarch64\-linux\-gnu\-ar \fB\-M\fR [< mri\-script]
.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
یک نمایه (index) از نمادهای تعریف‌شده در ماژول‌های شیء قابل بازنشانی در آرشیو ایجاد می‌کند. پس از ایجاد، این نمایه هر زمان که
\&\fBar\fR
تغییری در محتویات ایجاد کند (به جز عملیات به‌روزرسانی
\&\fBq\fR)
در آرشیو به‌روزرسانی می‌شود. آرشیوی با چنین نمایه‌ای پیوند دادن به کتابخانه را سریع‌تر می‌کند.
.PP
می‌توانید از
\&\fBnm \-s\fR
یا
\&\fBnm \-\-print\-armap\fR
برای فهرست کردن این جدول نمایه استفاده کنید. اگر آرشیو فاقد جدول باشد، می‌توان از شکل دیگری از
\&\fBar\fR
به نام
\&\fBranlib\fR
فقط برای افزودن جدول استفاده کرد.
.PP
ابزار
\&\fBar\fR
گنو می‌تواند به صورت اختیاری یک آرشیو
\&\fIنازک (thin)\fR
ایجاد کند که شامل نمایه نمادها و ارجاع به نسخه‌های اصلی فایل‌های عضو آرشیو است. این قابلیت برای ساخت کتابخانه‌ها جهت استفاده درون یک درخت ساخت محلی مفید است، جایی که انتظار می‌رود اشیاء قابل بازنشانی همچنان در دسترس باشند و کپی کردن محتوای هر شیء فقط زمان و فضا را هدر می‌دهد.
.PP
یک آرشیو می‌تواند یا
\&\fIنازک (thin)\fR
باشد یا معمولی. نمی‌تواند هم‌زمان هر دو باشد. پس از ایجاد آرشیو، فرمت آن بدون حذف اولیه و سپس ایجاد یک آرشیو جدید به جای آن، قابل تغییر نیست.
.PP
آرشیوهای نازک همچنین
\&\fIتخت (flattened)\fR
می‌شوند، به طوری که افزودن یک آرشیو نازک به یک آرشیو نازک دیگر باعث تودرتو شدن آن نمی‌شود (برخلاف آنچه در آرشیوهای معمولی رخ می‌دهد). در عوض، عناصر آرشیو اول به صورت جداگانه به آرشیو دوم اضافه می‌شوند.
.PP
مسیرهای منتهی به عناصر آرشیو به صورت نسبی نسبت به خود فایل آرشیو ذخیره می‌شوند.
.PP
ابزار
\&\fBar\fR
گنو طوری طراحی شده است که با دو شیوه مختلف سازگار باشد. شما می‌توانید فعالیت آن را با استفاده از گزینه‌های خط فرمان، مانند انواع مختلف
\&\fBar\fR
در سیستم‌های یونیکس کنترل کنید؛ یا اگر گزینه خط فرمان تکی
\&\fB\-M\fR
را مشخص کنید، می‌توانید آن را با یک اسکریپت از طریق ورودی استاندارد، مانند برنامه MRI "librarian" کنترل نمایید.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
ابزار
\&\fBar\fR
گنو به شما امکان می‌دهد کد عملیات
\&\fIp\fR
و فلگ‌های اصلاح‌کننده
\&\fImod\fR
را به هر ترتیبی درون اولین آرگومان خط فرمان ترکیب کنید.
.PP
در صورت تمایل، می‌توانید اولین آرگومان خط فرمان را با یک خط تیره شروع کنید.
.PP
حرف کلیدی
\&\fIp\fR
مشخص می‌کند چه عملیاتی اجرا شود؛ این حرف می‌تواند هر یک از موارد زیر باشد، اما باید فقط یکی از آن‌ها را مشخص کنید:
.IP \fBd\fR 4
.IX Item "d"
\&\fIحذف\fR
ماژول‌ها از آرشیو. نام ماژول‌های مورد نظر برای حذف را به عنوان
\&\fImember\fR...
مشخص کنید؛ اگر فایلی برای حذف مشخص نکنید، آرشیو دست‌نخورده باقی می‌ماند.
.Sp
اگر اصلاح‌کننده
\&\fBv\fR
را مشخص کنید،
\&\fBar\fR
هر ماژول را هنگام حذف فهرست می‌کند.
.IP \fBm\fR 4
.IX Item "m"
از این عملیات برای
\&\fIجابه‌جایی\fR
اعضا در یک آرشیو استفاده کنید.
.Sp
اگر یک نماد در بیش از یک عضو تعریف شده باشد، ترتیب اعضا در یک آرشیو می‌تواند در نحوه پیوند برنامه‌ها با استفاده از کتابخانه تفاوت ایجاد کند.
.Sp
اگر هیچ اصلاح‌کننده‌ای با
\&\f(CW\*(C`m\*(C'\fR
استفاده نشود، هر عضوی که در آرگومان‌های
\&\fImember\fR
نام ببرید به
\&\fIانتهای\fR
آرشیو منتقل می‌شود؛ می‌توانید از اصلاح‌کننده‌های
\&\fBa\fR،
\&\fBb\fR
یا
\&\fBi\fR
برای انتقال آن‌ها به یک مکان مشخص استفاده کنید.
.IP \fBp\fR 4
.IX Item "p"
\&\fIچاپ\fR
اعضای مشخص‌شده آرشیو در فایل خروجی استاندارد. اگر اصلاح‌کننده
\&\fBv\fR
مشخص شده باشد، نام عضو پیش از کپی محتوای آن در خروجی استاندارد نمایش داده می‌شود.
.Sp
اگر آرگومان
\&\fImember\fR
را مشخص نکنید، تمام فایل‌های موجود در آرشیو چاپ می‌شوند.
.IP \fBq\fR 4
.IX Item "q"
\&\fIالحاق سریع\fR؛
از نظر تاریخی، فایل‌های
\&\fImember\fR...
را بدون بررسی جایگزینی به انتهای
\&\fIarchive\fR
اضافه می‌کند.
.Sp
اصلاح‌کننده‌های
\&\fBa\fR،
\&\fBb\fR
و
\&\fBi\fR
بر این عملیات تأثیری
\&\fIندارند\fR؛
اعضای جدید همیشه در انتهای آرشیو قرار می‌گیرند.
.Sp
اصلاح‌کننده
\&\fBv\fR
باعث می‌شود
\&\fBar\fR
هر فایل را هنگام الحاق فهرست کند.
.Sp
از آنجا که هدف این عملیات سرعت است، پیاده‌سازی‌های
\&\fBar\fR
این امکان را دارند که جدول نمادهای آرشیو را در صورت وجود به‌روزرسانی نکنند. با این حال سیستم‌های بسیار زیادی فرض می‌کنند که جداول نمادها همیشه به‌روز هستند، بنابراین
\&\fBar\fR
گنو حتی با یک الحاق سریع نیز جدول را دوباره می‌سازد.
.Sp
توجه:
\&\fBar\fR
گنو دستور
\&\fBqs\fR
را مترادفی برای
\&\fBr\fR
می‌داند \- جایگزینی فایل‌های موجود در آرشیو و الحاق فایل‌های جدید در انتها.
.IP \fBr\fR 4
.IX Item "r"
درج فایل‌های
\&\fImember\fR...
در
\&\fIarchive\fR
(همراه با
\&\fIجایگزینی\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"
نمایش یک
\&\fIجدول\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"
\&\fIاستخراج\fR
اعضا (با نام
\&\fImember\fR)
از آرشیو. می‌توانید از اصلاح‌کننده
\&\fBv\fR
همراه با این عملیات استفاده کنید تا درخواست کنید
\&\fBar\fR
هر نام را هنگام استخراج فهرست کند.
.Sp
اگر فایلی در
\&\fImember\fR
مشخص نکنید، تمام فایل‌های موجود در آرشیو استخراج می‌شوند.
.Sp
فایل‌ها را نمی‌توان از یک آرشیو نازک استخراج کرد، و همچنین محدودیت‌هایی برای استخراج از آرشیوهای ایجادشده با
\&\fBP\fR
وجود دارد: مسیرها نباید مطلق باشند، نباید شامل
\&\f(CW\*(C`..\*(C'\fR
باشند، و هر زیرپوشه‌ای در مسیرها باید وجود داشته باشد. اگر می‌خواهید از این محدودیت‌ها اجتناب کنید، از گزینه
\&\fB\-\-output\fR
برای مشخص کردن پوشه خروجی استفاده کنید.
.PP
تعدادی از اصلاح‌کننده‌ها
(\fImod\fR)
می‌توانند بلافاصله پس از حرف کلیدی
\&\fIp\fR
بیایند تا تغییرات رفتاری یک عملیات را مشخص کنند:
.IP \fBa\fR 4
.IX Item "a"
افزودن فایل‌های جدید
\&\fIپس از\fR
یک عضو موجود در آرشیو. اگر از اصلاح‌کننده
\&\fBa\fR
استفاده می‌کنید، نام یک عضو موجود در آرشیو باید به عنوان آرگومان
\&\fIrelpos\fR
قبل از مشخص کردن
\&\fIarchive\fR
حضور داشته باشد.
.IP \fBb\fR 4
.IX Item "b"
افزودن فایل‌های جدید
\&\fIقبل از\fR
یک عضو موجود در آرشیو. اگر از اصلاح‌کننده
\&\fBb\fR
استفاده می‌کنید، نام یک عضو موجود در آرشیو باید به عنوان آرگومان
\&\fIrelpos\fR
قبل از مشخص کردن
\&\fIarchive\fR
حضور داشته باشد (مشابه
\&\fBi\fR).
.IP \fBc\fR 4
.IX Item "c"
\&\fIایجاد\fR
آرشیو. اگر هنگام درخواست به‌روزرسانی،
\&\fIarchive\fR
مشخص‌شده وجود نداشته باشد، همیشه ایجاد می‌شود. اما هشدار داده خواهد شد مگر اینکه با استفاده از این اصلاح‌کننده از قبل مشخص کنید که انتظار ایجاد آن را دارید.
.IP \fBD\fR 4
.IX Item "D"
فعالیت در حالت
\&\fIقطعیت‌یافته (deterministic)\fR.
هنگام افزودن فایل‌ها و نمایه آرشیو، از صفر برای UIDها، GIDها و زمان‌بندی‌ها استفاده می‌کند و حالت‌های فایل یکسانی را برای همه فایل‌ها به کار می‌گیرد. وقتی از این گزینه استفاده شود، در صورتی که
\&\fBar\fR
با گزینه‌ها و فایل‌های ورودی یکسان اجرا شود، اجراهای چندگانه فایل‌های خروجی یکسانی ایجاد خواهند کرد، صرف‌نظر از مالکان، گروه‌ها، مجوزها یا زمان‌های تغییر فایل‌های ورودی.
.Sp
اگر
\&\fIbinutils\fR
با
\&\fB\-\-enable\-deterministic\-archives\fR
پیکربندی شده باشد، این حالت به طور پیش‌فرض روشن است. می‌توان آن را با اصلاح‌کننده
\&\fBU\fR
در زیر غیرفعال کرد.
.IP \fBf\fR 4
.IX Item "f"
کوتاه کردن نام‌ها در آرشیو. ابزار
\&\fBar\fR
گنو به طور معمول نام فایل‌ها با هر طولی را مجاز می‌داند. این امر باعث می‌شود آرشیوهایی ایجاد کند که با برنامه بومی
\&\fBar\fR
در برخی سیستم‌ها سازگار نیستند. اگر این موضوع نگران‌کننده است، می‌توان از اصلاح‌کننده
\&\fBf\fR
برای کوتاه کردن نام فایل‌ها هنگام قرار دادن آن‌ها در آرشیو استفاده کرد.
.IP \fBi\fR 4
.IX Item "i"
درج فایل‌های جدید
\&\fIقبل از\fR
یک عضو موجود در آرشیو. اگر از اصلاح‌کننده
\&\fBi\fR
استفاده می‌کنید، نام یک عضو موجود در آرشیو باید به عنوان آرگومان
\&\fIrelpos\fR
قبل از مشخص کردن
\&\fIarchive\fR
حضور داشته باشد (مشابه
\&\fBb\fR).
.IP \fBl\fR 4
.IX Item "l"
مشخص کردن وابستگی‌های این کتابخانه. وابستگی‌ها باید بلافاصله پس از این نویسه گزینه بیایند، باید از همان ساختار خط فرمان پیونددهنده (linker) استفاده کنند و باید درون یک آرگومان واحد مشخص شوند. یعنی اگر چندین مورد نیاز است، باید برای تشکیل یک آرگومان خط فرمان تکی درون نقل‌قول قرار گیرند. به عنوان مثال
\&\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"
نمایش آفست‌های اعضا درون آرشیو. همراه با گزینه
\&\fBt\fR
استفاده شود.
.IP \fBP\fR 4
.IX Item "P"
استفاده از مسیر کامل نام هنگام تطبیق یا ذخیره نام‌ها در آرشیو. آرشیوهای ایجادشده با نام‌های مسیر کامل با استاندارد POSIX سازگار نیستند و بنابراین ممکن است با ابزارهایی غیر از ابزارهای به‌روز گنو کار نکنند. ویرایش چنین آرشیوهایی با
\&\fBar\fR
گنو بدون استفاده از
\&\fBP\fR
نام‌های مسیر کامل را حذف می‌کند مگر اینکه آرشیو یک آرشیو نازک باشد. توجه داشته باشید که
\&\fBP\fR
ممکن است هنگام افزودن فایل‌ها به یک آرشیو نازک مفید باشد، زیرا
\&\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"
عدم تولید جدول نمادهای آرشیو. این می‌تواند سرعت ساخت یک کتابخانه بزرگ را در چند مرحله افزایش دهد، اما در صورتی که آرشیو حاصل با پیونددهنده استفاده شود، تأثیر منفی بر عملکرد خواهد گذاشت. برای ساخت جدول نمادها، باید اصلاح‌کننده
\&\fBS\fR
را در آخرین اجرای
\&\fBar\fR
حذف کنید، یا باید
\&\fBranlib\fR
را روی آرشیو اجرا نمایید.
.IP \fBT\fR 4
.IX Item "T"
نام مستعار منسوخ‌شده برای
\&\fB\-\-thin\fR.
گزینه
\&\fBT\fR
توصیه نمی‌شود زیرا در بسیاری از پیاده‌سازی‌های ar، گزینه
\&\fBT\fR
معنای متفاوتی طبق مشخصات X/Open System Interface دارد.
.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عدم\fR
فعالیت در حالت قطعیت‌یافته (deterministic). این معکوس اصلاح‌کننده
\&\fBD\fR
در بالا است: فایل‌های اضافه‌شده و نمایه آرشیو مقادیر واقعی UID، GID، زمان‌بندی و حالت فایل را دریافت خواهند کرد.
.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
گزینه اولیه
\&\fB\-X32_64\fR
را برای سازگاری با AIX نادیده می‌گیرد. رفتار حاصل از این گزینه حالت پیش‌فرض برای
\&\fBar\fR
گنو است. ابزار
\&\fBar\fR
از هیچ‌یک از گزینه‌های دیگر
\&\fB\-X\fR
پشتیبانی نمی‌کند؛ به ویژه از
\&\fB\-X32\fR
که گزینه پیش‌فرض برای
\&\fBar\fR
در AIX است پشتیبانی نمی‌کند.
.IP "\fB\-\-plugin\fR \fIname\fR" 4
.IX Item "--plugin name"
گزینه اختیاری خط فرمان
\&\fB\-\-plugin\fR \fIname\fR
باعث می‌شود
\&\fBar\fR
پلاگینی به نام
\&\fIname\fR
را بارگذاری کند که پشتیبانی از فرمت‌های فایل بیشتر، از جمله فایل‌های شیء با اطلاعات بهینه‌سازی زمان پیوند (LTO) را اضافه می‌کند.
.Sp
این گزینه تنها در صورتی در دسترس است که زنجیره ابزار با فعال بودن پشتیبانی از پلاگین ساخته شده باشد.
.Sp
اگر
\&\fB\-\-plugin\fR
ارائه نشود، اما پشتیبانی از پلاگین فعال شده باشد،
\&\fBar\fR
فایل‌های موجود در
\&\fI${libdir}/bfd\-plugins\fR
را به ترتیب الفبایی پیمایش کرده و از اولین پلاگینی که ادعای شناسایی شیء مورد نظر را داشته باشد استفاده می‌کند.
.Sp
لطفاً توجه داشته باشید که این پوشه جستجوی پلاگین
\&\fIهمان\fR
پوشه مورد استفاده گزینه
\&\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
مشخص‌شده به یک آرشیو
\&\fIنازک (thin)\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)، نسخه ۱.۳ یا هر نسخه جدیدتر منتشرشده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متن‌های روی جلد، و بدون متن‌های پشت جلد. نسخه‌ای از این مجوز در بخشی با عنوان «مجوز مستندات آزاد گنو» گنجانده شده است.