.\" -*- 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-31 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...] ar \fB\-M\fR [< mri\-script] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" برنامهٔ GNU \fBar\fR وظیفهٔ ایجاد، ویرایش و استخراج از آرشیوها را بر عهده دارد. یک \fIآرشیو\fR فایلی یکتا است که مجموعه‌ای از فایل‌های دیگر را درون ساختاری نگهداری می‌کند که امکان بازیابی فایل‌های مجزای اصلی (که \fIاعضای\fR آرشیو نامیده می‌شوند) را فراهم می‌آورد. .PP محتوای فایل‌های اصلی، حالت (مجوزها)، برچسب زمان، مالک و گروه آن‌ها در آرشیو حفظ می‌شود و هنگام استخراج قابل بازیابی است. .PP ابزار GNU \fBar\fR می‌تواند آرشیوهایی با اعضایی با طول نام نامحدود را نگهداری کند؛ با این حال، بسته به نحوهٔ پیکربندی \fBar\fR روی سیستم شما، ممکن است برای سازگاری با قالب‌های آرشیو نگهداری‌شده توسط سایر ابزارها، محدودیتی روی طول نام اعضا اعمال شود. در صورت وجود، این محدودیت معمولاً ۱۵ نویسه (رایج در قالب‌های مرتبط با a.out) یا ۱۶ نویسه (رایج در قالب‌های مرتبط با coff) است. .PP ابزار \&\fBar\fR یک ابزار باینری به‌شمار می‌رود، زیرا آرشیوهایی از این دست اغلب به عنوان \fIکتابخانه‌هایی\fR حاوی زیرروال‌های پرکاربرد استفاده می‌شوند. از آنجا که کتابخانه‌ها معمولاً به کتابخانه‌های دیگر وابسته‌اند، با مشخص شدن گزینهٔ \&\fB\-\-record\-libdeps\fR، ابزار \&\fBar\fR می‌تواند وابستگی‌های یک کتابخانه را نیز ثبت کند. .PP با تعیین تغییردهندهٔ \fBs\fR، ابزار \&\fBar\fR نمایه‌ای از نمادهای تعریف‌شده در ماژول‌های شیء جابه‌جاپذیر در آرشیو ایجاد می‌کند. پس از ایجاد، این نمایه هر زمان که \&\fBar\fR تغییری در محتویات آرشیو ایجاد کند (به‌جز در عملیات به‌روزرسانی \fBq\fR) به‌روزرسانی می‌شود. وجود چنین نمایه‌ای در آرشیو، سرعت پیوند زدن به کتابخانه را افزایش می‌دهد. .PP می‌توانید از \fBnm \-s\fR یا \fBnm \-\-print\-armap\fR برای فهرست کردن جدول این نمایه استفاده کنید. اگر آرشیوی فاقد این جدول باشد، می‌توان از شکل دیگری از \fBar\fR با نام \&\fBranlib\fR تنها برای افزودن جدول استفاده کرد. .PP ابزار GNU \fBar\fR می‌تواند به صورت اختیاری یک آرشیو \fIکم‌حجم\fR (\fIthin\fR) ایجاد کند که حاوی نمایهٔ نمادها و ارجاعاتی به نسخه‌های اصلی فایل‌های عضو آرشیو است. این قابلیت برای ساخت کتابخانه‌ها جهت استفاده در یک درخت ساخت محلی مفید است، جایی که انتظار می‌رود اشیای جابه‌جاپذیر در دسترس باقی بمانند و کپی کردن محتوای هر شیء تنها زمان و فضا را هدر می‌دهد. .PP یک آرشیو می‌تواند یا \fIthin\fR (کم‌حجم) باشد یا عادی. نمی‌تواند همزمان هر دو باشد. پس از ایجاد آرشیو، قالب آن بدون حذف اولیه و سپس ایجاد آرشیو جدیدی به جای آن، قابل تغییر نیست. .PP آرشیوهای کم‌حجم همچنین \fIمسطح\fR (\fIflattened\fR) هستند، بنابراین افزودن یک آرشیو کم‌حجم به یک آرشیو کم‌حجم دیگر، برخلاف آنچه در آرشیوهای عادی رخ می‌دهد، آن را تودرتو نمی‌کند. در عوض، عناصر آرشیو نخست به صورت تک‌به‌تک به آرشیو دوم اضافه می‌شوند. .PP مسیرهای منتهی به عناصر آرشیو به صورت نسبی نسبت به خود فایل آرشیو ذخیره می‌شوند. .PP ابزار GNU \fBar\fR به گونه‌ای طراحی شده است که با دو شیوهٔ کارکرد مختلف سازگار باشد. شما می‌توانید فعالیت آن را با استفاده از گزینه‌های خط فرمان، مانند انواع مختلف \fBar\fR در سیستم‌های Unix کنترل کنید؛ یا چنانچه گزینهٔ تک‌حرفی خط فرمان \fB\-M\fR را مشخص نمایید، می‌توانید آن را با اسکریپتی که از طریق ورودی استاندارد ارائه می‌شود، مانند برنامهٔ MRI "librarian" هدایت کنید..SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" برنامهٔ GNU \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 این امکان را دارند که در صورت وجود جدول نمادهای آرشیو، آن را به‌روزرسانی نکنند. با این حال، سیستم‌های بسیار زیادی فرض می‌کنند که جدول‌های نمادها همواره به‌روز هستند، بنابراین 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 archive) استخراج کرد، و محدودیت‌هایی برای استخراج از آرشیوهای ایجادشده با \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تکرارپذیر\fR (deterministic). هنگام افزودن فایل‌ها و نمایهٔ آرشیو، برای UIDs، GIDs و برچسب‌های زمانی از صفر استفاده کنید و برای همهٔ فایل‌ها حالت‌های فایل سازگار به کار ببرید. وقتی از این گزینه استفاده شود، اگر \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" مشخص کردن وابستگی‌های این کتابخانه. وابستگی‌ها باید بلافاصله پس از این نویسهٔ گزینه بیایند، باید از همان نحو خط فرمان پیونددهنده استفاده کنند، و باید درون یک آرگومان واحد مشخص شوند؛ یعنی در صورت نیاز به چند مورد، باید داخل نقل‌قول قرار گیرند تا یک آرگومان خط فرمان واحد تشکیل دهند. برای مثال: \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 ممکن است هنگام افزودن فایل‌ها به یک آرشیو نازک مفید باشد، زیرا \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" نوشتن یک نمایه (index) از فایل‌های شیء در آرشیو، یا به‌روزرسانی نمایه‌ی موجود، حتی اگر هیچ تغییر دیگری در آرشیو ایجاد نشود. می‌توانید از این پرچم تغییردهنده هم با هر عملیاتی، و هم به تنهایی استفاده کنید. اجرای \fBar s\fR روی یک آرشیو معادل اجرای \fBranlib\fR بر روی آن است. .IP \fBS\fR 4 .IX Item "S" عدم ایجاد جدول نمادهای (symbol table) آرشیو. این کار می‌تواند ساخت یک کتابخانه بزرگ را در چند مرحله سرعت بخشد، اما اگر آرشیو حاصل با پیونددهنده استفاده شود، تأثیر منفی بر کارایی خواهد گذاشت. برای ساختن یک جدول نمادها، باید تغییردهنده \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، برچسب زمانی و حالت فایل خود را دریافت خواهند کرد. .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 گزینه اولیه با نام \fB\-X32_64\fR را برای سازگاری با AIX نادیده می‌گیرد. رفتاری که توسط این گزینه ایجاد می‌شود، پیش‌فرض 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 را بارگیری کند که پشتیبانی از قالب‌های فایل بیشتری را اضافه می‌کند، از جمله فایل‌های شیء با اطلاعات بهینه‌سازی زمان پیوند (link\-time optimization). .Sp این گزینه تنها در صورتی در دسترس است که زنجیره ابزار (toolchain) با پشتیبانی فعال از افزونه ساخته شده باشد. .Sp اگر \fB\-\-plugin\fR مشخص نشود، اما پشتیبانی از افزونه فعال شده باشد، \fBar\fR فایل‌های موجود در \&\fI${libdir}/bfd\-plugins\fR را به ترتیب الفبا پیمایش می‌کند و اولین افزونه‌ای که شیء مورد نظر را پشتیبانی کند استفاده می‌شود. .Sp لطفاً توجه داشته باشید این دایرکتوری جستجوی افزونه، همان دایرکتوری مورد استفاده توسط گزینه \fB\-plugin\fR در \fBld\fR \fIنیست\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 مشخص‌شده را به یک آرشیو \fIنازک\fR تبدیل می‌کند. اگر از قبل وجود داشته باشد و یک آرشیو معمولی باشد، اعضای موجود باید در همان دایرکتوری \fIarchive\fR قرار داشته باشند. .IP \fB@\fR\fIfile\fR 4 .IX Item "@file" گزینه‌های خط فرمان را از \fIfile\fR می‌خواند. گزینه‌های خوانده شده به جای گزینه اصلی @\fIfile\fR درج می‌شوند. اگر \fIfile\fR وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به صورت تحت‌اللفظی رفتار خواهد شد و حذف نخواهد شد. .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\-2026 Free Software Foundation, Inc. .PP مجوز کپی، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (GNU Free Documentation License)، نسخهٔ ۱.۳ یا هر نسخهٔ بعدی منتشرشده توسط بنیاد نرم‌افزارهای آزاد (Free Software Foundation) اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر (Invariant Sections)، بدون متون روی جلد (Front\-Cover Texts)، و بدون متون پشت جلد (Back\-Cover Texts). نسخه‌ای از این مجوز در بخشی با عنوان \(lqGNU Free Documentation License\(rq آورده شده است.