.\" -*- 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"
برنامهٔ GNU \fBar\fR فایل‌های آرشیو را ایجاد، اصلاح و محتویات آن‌ها را استخراج می‌کند. یک \fIآرشیو\fR (archive) فایلی یگانه است که مجموعه‌ای از فایل‌های دیگر را در ساختاری نگهداری می‌کند که امکان بازیابی تک‌تک فایل‌های اولیه (که به آن‌ها \fIعضوهای\fR آرشیو گفته می‌شود) را فراهم می‌سازد.
.PP
محتویات فایل‌های اصلی، حالت دسترسی‌ها (permissions)، برچسب زمانی، مالک و گروه در آرشیو حفظ می‌شوند و در هنگام استخراج قابل بازیابی هستند.
.PP
ابزار GNU \fBar\fR می‌تواند آرشیوهایی را نگهداری کند که عضوهای آن نام‌هایی با هر طولی داشته باشند؛ با این حال، بسته به نحوهٔ پیکربندی \fBar\fR در سیستم شما، ممکن است محدودیتی در طول نام اعضا برای سازگاری با قالب‌های آرشیوی که توسط ابزارهای دیگر نگهداری می‌شوند اعمال شود. در صورت وجود، این محدودیت اغلب ۱۵ نویسه (معمول در قالب‌های مربوط به a.out) یا ۱۶ نویسه (معمول در قالب‌های مربوط به coff) است.
.PP
دستور \&\fBar\fR یک ابزار باینری به شمار می‌رود، زیرا این نوع آرشیوها بیشتر به عنوان \fIکتابخانه‌ها\fR برای نگهداری زیربرنامه‌های پرکاربرد استفاده می‌شوند. از آنجا که کتابخانه‌ها اغلب به کتابخانه‌های دیگر وابسته هستند، \&\fBar\fR می‌تواند در صورت مشخص شدن گزینهٔ \&\fB\-\-record\-libdeps\fR، وابستگی‌های یک کتابخانه را نیز ثبت کند.
.PP
هنگامی که تغییردهندهٔ \fBs\fR را مشخص می‌کنید، \&\fBar\fR یک نمایه (index) از نمادهای تعریف‌شده در ماژول‌های شیء بازمکان‌پذیر (relocatable object modules) در آرشیو ایجاد می‌کند. پس از ایجاد، این نمایه هر بار که \&\fBar\fR تغییری در محتویات آن ایجاد کند (به‌جز عملیات به‌روزرسانی \fBq\fR) به‌روز می‌شود. وجود چنین نمایه‌ای در آرشیو، پیوند دادن (linking) به کتابخانه را سرعت می‌بخشد و به توابع موجود در کتابخانه امکان می‌دهد بدون در نظر گرفتن جایگاهشان در آرشیو، یکدیگر را فراخوانی کنند.
.PP
شما می‌توانید از \fBnm \-s\fR یا \fBnm \-\-print\-armap\fR برای فهرست کردن جدول نمایه استفاده کنید. اگر آرشیوی فاقد این جدول باشد، می‌توان از شکل دیگری از \fBar\fR به نام \&\fBranlib\fR تنها برای افزودن جدول مذکور استفاده کرد.
.PP
ابزار GNU \fBar\fR می‌تواند به‌طور اختیاری یک آرشیو \fIکم‌حجم\fR (thin) ایجاد کند که حاوی نمایهٔ نمادها و ارجاعاتی به نسخه‌های اصلی فایل‌های عضو آرشیو است. این قابلیت برای ساخت کتابخانه‌ها جهت استفاده درون یک درخت ساخت محلی (local build tree) بسیار مفید است، جایی که انتظار می‌رود اشیاء بازمکان‌پذیر در دسترس باقی بمانند و کپی کردن محتوای هر شیء تنها موجب هدر رفتن زمان و فضا می‌شود.
.PP
یک آرشیو می‌تواند یا \fIکم‌حجم\fR (thin) باشد یا معمولی؛ نمی‌تواند هر دو حالت را به‌طور هم‌زمان داشته باشد. وقتی آرشیوی ایجاد شد، قالب آن را نمی‌توان بدون حذف و ایجاد مجدد یک آرشیو جدید تغییر داد.
.PP
آرشیوهای کم‌حجم همچنین به‌صورت \fIتخت‌شده\fR (flattened) هستند؛ بنابراین افزودن یک آرشیو کم‌حجم به یک آرشیو کم‌حجم دیگر مانند آرشیوهای عادی باعث تو در تو شدن آن نمی‌شود. در عوض، عناصر آرشیو اول به‌طور جداگانه به آرشیو دوم اضافه می‌شوند.
.PP
مسیرهای منتهی به عناصر آرشیو، به‌صورت نسبی نسبت به خود فایل آرشیو ذخیره می‌شوند.
.PP
ابزار GNU \fBar\fR به‌گونه‌ای طراحی شده است که با دو سازوکار مختلف سازگار باشد. شما می‌توانید رفتار آن را با استفاده از گزینه‌های خط فرمان کنترل کنید، مانند گونه‌های مختلف \fBar\fR در سیستم‌های یونیکس؛ یا در صورتی که گزینهٔ تک خط فرمانی \fB\-M\fR را مشخص کنید، می‌توانید آن را با یک اسکریپت ارسال‌شده از طریق ورودی استاندارد، مانند برنامهٔ "librarian" متعلق به MRI، مدیریت نمایید..SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
ابزار GNU \fBar\fR این امکان را فراهم می‌آورد تا کد عملیات \fIp\fR و پرچم‌های تغییردهندهٔ \fImod\fR را به هر ترتیبی، درون نخستین آرگومان خط فرمان با یکدیگر ترکیب کنید.
.PP
در صورت تمایل، می‌توانید نخستین آرگومان خط فرمان را با یک خط فاصله (dash) آغاز کنید.
.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 این امکان را دارند که در صورت وجود جدول نماد آرشیو، آن را به‌روزرسانی نکنند. با این حال، سیستم‌های بسیار زیادی فرض می‌کنند که جدول‌های نماد همیشه به‌روز هستند، بنابراین GNU \fBar\fR حتی در الحاق سریع نیز جدول را بازسازی خواهد کرد.
.Sp
نکته \- GNU \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
فایل‌ها را نمی‌توان از یک آرشیو thin استخراج کرد، و همچنین محدودیت‌هایی در استخراج از آرشیوهای ایجادشده با \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"
کارکرد در حالت \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"
درج فایل‌های جدید \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 سازگار نیستند و
بنابراین ممکن است با ابزارهایی غیر از ابزارهای به‌روز 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"
یک نمایهٔ فایل شیء (object\-file index) را درون آرشیو می‌نویسد، یا نمایهٔ موجود را به‌روزرسانی می‌کند،
حتی اگر هیچ تغییر دیگری در آرشیو ایجاد نشده باشد. می‌توانید از این پرچمِ
تغییردهنده همراه با هر عملیاتی، یا به‌تنهایی استفاده کنید. اجرای \fBar s\fR روی یک
آرشیو معادل اجرای \fBranlib\fR روی آن است.
.IP \fBS\fR 4
.IX Item "S"
جدول نمادهای آرشیو را ایجاد نمی‌کند. این کار می‌تواند ساخت یک
کتابخانهٔ بزرگ را در چندین مرحله سرعت ببخشد. آرشیو حاصل را نمی‌توان
با پیونددهنده (linker) استفاده کرد. برای ساخت جدول نمادها، باید تغییردهندهٔ
\&\fBS\fR را در آخرین اجرای \fBar\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قطعی\fR (deterministic) عمل \fIنمی‌کند\fR. این برعکس
تغییردهندهٔ \fBD\fR در بالا است: فایل‌های اضافه‌شده و نمایهٔ آرشیو
مقادیر واقعی UID، GID، برچسب زمانی و حالت فایل (file mode) خود را دریافت خواهند کرد.
.Sp
این حالت پیش‌فرض است مگر اینکه \fIbinutils\fR با
\&\fB\-\-enable\-deterministic\-archives\fR پیکربندی شده باشد.
.IP \fBv\fR 4
.IX Item "v"
این تغییردهنده نسخهٔ \fIهمراه با جزئیات\fR (verbose) یک عملیات را درخواست می‌کند. بسیاری از
عملیات‌ها هنگام افزوده شدن تغییردهندهٔ \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
لطفاً توجه داشته باشید که این دایرکتوریِ جستجوی افزونه، آن دایرکتوری \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 همیشه با
نسخه‌های پیشین سازگار به عقب (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"
از گزینهٔ \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
وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به‌صورت
لغوی (literal) برخورد شده و حذف نخواهد شد.
.Sp
گزینه‌ها در \fIfile\fR با نویسه‌های فاصله (whitespace) جدا می‌شوند. یک نویسهٔ فاصله
می‌تواند با محصور کردن کل گزینه در علامت‌های نقل‌قول تکی یا دوگانه
درون یک گزینه گنجانده شود. هر نویسه‌ای (از جمله یک بک‌اسلش) را می‌توان با
قرار دادن یک پیشوند بک‌اسلش پیش از آن اضافه کرد. خود \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"
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 آورده شده است.