.\" -*- 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 یا members آرشیو نامیده می‌شوند) امکان‌پذیر باشد.
.PP
محتوا، حالت (مجوزها و دسترسی‌ها)، مهر زمانی، مالک و گروه فایل‌های اصلی در آرشیو حفظ می‌شوند و در هنگام استخراج می‌توان آن‌ها را بازیابی کرد.
.PP
ابزار GNU \fBar\fR می‌تواند آرشیوهایی را مدیریت کند که اعضای آن نام‌هایی با هر طولی داشته باشند؛ با این حال، بسته به نحوه پیکربندی \fBar\fR روی سیستم شما، ممکن است برای سازگاری با قالب‌های آرشیو نگهداری‌شده توسط سایر ابزارها، محدودیتی روی طول نام اعضا اعمال شود. این محدودیت در صورت وجود، اغلب ۱۵ نویسه (رایج در قالب‌های مرتبط با a.out) یا ۱۶ نویسه (رایج در قالب‌های مرتبط با coff) است.
.PP
ابزار \&\fBar\fR یک ابزار باینری به شمار می‌رود، زیرا این نوع آرشیوها بیشتر به عنوان \fIکتابخانه‌هایی\fR (libraries) که زیربرنامه‌های پرکاربرد را نگهداری می‌کنند استفاده می‌شوند. از آنجا که کتابخانه‌ها اغلب به کتابخانه‌های دیگری وابسته هستند، \&\fBar\fR می‌تواند هنگام تعیین گزینه \&\fB\-\-record\-libdeps\fR، وابستگی‌های یک کتابخانه را نیز ثبت کند.
.PP
هنگامی که اصلاح‌کننده \fBs\fR را مشخص می‌کنید، \&\fBar\fR نمایه‌ای از نمادهای تعریف‌شده در ماژول‌های شیء جابه‌جاشونده (relocatable object modules) در آرشیو ایجاد می‌کند. پس از ایجاد، هر زمان که \fBar\fR تغییری در محتویات آرشیو ایجاد کند (به جز عملیات به‌روزرسانی \fBq\fR)، این نمایه به‌روزرسانی می‌شود. آرشیوی دارای چنین نمایه‌ای، سرعت پیونددهی به کتابخانه را افزایش می‌دهد و به توابع موجود در کتابخانه امکان می‌دهد بدون توجه به موقعیت مکانی‌شان در آرشیو، یکدیگر را فراخوانی کنند.
.PP
می‌توانید از \fBnm \-s\fR یا \fBnm \-\-print\-armap\fR برای فهرست کردن جدول این نمایه استفاده کنید. اگر آرشیوی فاقد این جدول باشد، می‌توان از شکل دیگری از \fBar\fR به نام \&\fBranlib\fR تنها برای اضافه کردن جدول استفاده کرد.
.PP
ابزار GNU \fBar\fR می‌تواند در صورت تمایل یک آرشیو تنک یا لاغر (\fIthin\fR archive) ایجاد کند که حاوی نمایه نمادها و ارجاعاتی به نسخه‌های اصلی فایل‌های عضو آرشیو است. این قابلیت برای ساخت کتابخانه‌ها جهت استفاده درون یک درخت ساخت محلی، که در آن انتظار می‌رود اشیای جابه‌جاشونده همچنان در دسترس باقی بمانند بسیار مفید است، زیرا کپی کردن محتوای هر شیء تنها زمان و فضا را هدر می‌دهد.
.PP
یک آرشیو می‌تواند تنک (\fIthin\fR) یا عادی باشد و نمی‌تواند هر دو حالت را به‌طور هم‌زمان داشته باشد. پس از ایجاد آرشیو، قالب آن بدون حذف اولیه و سپس ایجاد یک آرشیو جدید به جای آن، قابل تغییر نیست.
.PP
آرشیوهای تنک همچنین تخت و مسطح (\fIflattened\fR) هستند؛ بنابراین افزودن یک آرشیو تنک به یک آرشیو تنک دیگر باعث تودرتو شدن آن نمی‌شود (برخلاف آنچه در یک آرشیو عادی اتفاق می‌افتد). در عوض، اجزای آرشیو اول به‌صورت جداگانه به آرشیو دوم افزوده می‌شوند.
.PP
مسیرهای منتهی به عناصر آرشیو به‌صورت نسبی نسبت به خود فایل آرشیو ذخیره می‌شوند.
.PP
ابزار GNU \fBar\fR طوری طراحی شده است که با دو شیوه مختلف سازگار باشد. شما می‌توانید فعالیت آن را با استفاده از گزینه‌های خط فرمان، مانند انواع مختلف \fBar\fR در سیستم‌های یونیکس کنترل کنید؛ یا اگر گزینه خط فرمان منفرد \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"
حذف ماژول‌ها از آرشیو (\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 نام ببرید به \fIانتهای\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 روی این عملیات تاثیری ندارند؛ اعضای جدید همیشه در انتهای آرشیو قرار می‌گیرند.
.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) قابل استخراج نیستند، و محدودیت‌هایی برای استخراج از آرشیوهای ایجاد شده با \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) باشد. توجه داشته باشید که \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"
تولید نکردن جدول نمادهای آرشیو. این کار می‌تواند ساخت یک کتابخانه بزرگ را در چند مرحله سرعت ببخشد. آرشیو حاصل را نمی‌توان با پیونددهنده استفاده کرد. برای ساخت جدول نمادها، باید در آخرین اجرای \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"
در حالت قطعی (\fIdeterministic\fR) عمل \fIنکن\fR. این معکوس اصلاح‌کننده \fBD\fR در بالا است: فایل‌های افزوده شده و نمایه آرشیو مقادیر واقعی UID، GID، مهر زمانی و مجوزهای فایل را دریافت خواهند کرد.
.Sp
این حالت پیش‌فرض است مگر اینکه \fIbinutils\fR با \&\fB\-\-enable\-deterministic\-archives\fR پیکربندی شده باشد.
.IP \fBv\fR 4
.IX Item "v"
این اصلاح‌کننده نسخه پرحرف و با جزئیات (\fIverbose\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 نادیده می‌گیرد. رفتار ایجادشده توسط این گزینه، رفتار پیش‌فرض برای 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 را بارگیری کند که پشتیبانی از قالب‌های فایل بیشتر، از جمله فایل‌های شیء با اطلاعات بهینه‌سازی زمان پیوند را اضافه می‌نماید.
.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"
آرشیو مشخص‌شده را به یک آرشیو تنک (\fIthin\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\-2025 Free Software Foundation, Inc.
.PP
اجازه کپی، توزیع و/یا ویرایش این سند تحت شرایط «مجوز مستندات آزاد گنو»، نسخه ۱.۳ یا هر نسخه جدیدتر منتشرشده توسط بنیاد نرم‌افزارهای آزاد داده می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متن‌های روی جلد، و بدون متن‌های پشت جلد. نسخه‌ای از مجوز در بخشی با عنوان «GNU Free Documentation License» آورده شده است.