.\" -*- 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 فایلی منفرد است که مجموعه‌ای از فایل‌های دیگر را درون ساختاری نگهداری می‌کند که بازیابی تک‌تک فایل‌های اولیه (که \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)، به‌روزرسانی می‌شود. یک بایگانی دارای چنین نمایه‌ای، سرعت پیونددهی (linking) به کتابخانه را افزایش می‌دهد و به روال‌های درون کتابخانه اجازه می‌دهد بدون توجه به مکان قرارگیری‌شان در بایگانی، یکدیگر را فراخوانی کنند.
.PP
می‌توانید از \fBnm \-s\fR یا \fBnm \-\-print\-armap\fR برای فهرست کردن جدول این نمایه استفاده کنید. اگر بایگانی فاقد این جدول باشد، می‌توان از شکل دیگری از \fBar\fR به نام \&\fBranlib\fR برای افزودن صرفاً همین جدول استفاده کرد.
.PP
ابزار GNU \fBar\fR می‌تواند به صورت اختیاری یک بایگانی \fIنازک\fR (\fIthin\fR) ایجاد کند که حاوی یک نمایهٔ نمادها و ارجاعاتی به نسخه‌های اصلیِ فایل‌های عضو بایگانی است. این ویژگی برای ساخت کتابخانه‌ها جهت استفاده در یک درخت ساخت محلی که در آن انتظار می‌رود اشیاء جابه‌جاشونده در دسترس باقی بمانند و کپی کردن محتوای هر شیء تنها موجب اتلاف زمان و فضا می‌شود، کاربرد دارد.
.PP
یک بایگانی می‌تواند \fIنازک\fR (\fIthin\fR) یا عادی باشد و نمی‌تواند هر دو حالت را به‌طور هم‌زمان داشته باشد. پس از ایجاد یک بایگانی، قالب آن بدون حذف اولیه و ایجاد یک بایگانی جدید به جای آن، قابل تغییر نیست.
.PP
بایگانی‌های نازک همچنین \fIمسطح\fR (\fIflattened\fR) هستند؛ بنابراین اضافه کردن یک بایگانی نازک به یک بایگانی نازک دیگر باعث تودرتو شدن آن نمی‌شود (اتفاقی که در بایگانی‌های معمولی رخ می‌دهد). در عوض، عناصر بایگانی اول به‌طور مجزا به بایگانی دوم اضافه می‌شوند.
.PP
مسیرهای منتهی به عناصر بایگانی به صورت نسبی نسبت به خود بایگانی ذخیره می‌شوند.
.PP
ابزار GNU \fBar\fR به گونه‌ای طراحی شده است که با دو سازوکار متفاوت سازگار باشد. شما می‌توانید عملکرد آن را با استفاده از گزینه‌های خط فرمان کنترل کنید، مانند گونه‌های مختلف \fBar\fR در سیستم‌های یونیکس؛ یا اگر گزینهٔ تک‌خط فرمانی \fB\-M\fR را مشخص کنید، می‌توانید آن را با یک اسکریپت که از طریق ورودی استاندارد فراهم می‌شود، مانند برنامهٔ MRI \(lqlibrarian\(rq، کنترل نمایید..SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
ابزار GNU \fBar\fR به شما اجازه می‌دهد کد عملیات \fIp\fR و پرچم‌های تغییردهندهٔ \fImod\fR را به هر ترتیبی درون نخستین آرگومان خط فرمان ترکیب کنید.
.PP
در صورت تمایل، می‌توانید نخستین آرگومان خط فرمان را با یک خط تیره (\-) آغاز کنید.
.PP
حرف کلیدی \fIp\fR مشخص می‌کند چه عملیاتی باید اجرا شود؛ این حرف می‌تواند هر یک از موارد زیر باشد، اما تنها باید یکی از آن‌ها را مشخص کنید:
.IP \fBd\fR 4
.IX Item "d"
\&\fIحذف (Delete)\fR ماژول‌ها از بایگانی. نام ماژول‌های مورد نظر برای حذف را به صورت ...\fImember\fR مشخص کنید؛ اگر هیچ فایلی را برای حذف مشخص نکنید، بایگانی دست‌نخورده باقی می‌ماند.
.Sp
اگر تغییردهندهٔ \fBv\fR را مشخص کنید، \fBar\fR هر ماژول را هنگام حذف شدن فهرست می‌کند.
.IP \fBm\fR 4
.IX Item "m"
از این عملیات برای \fIجابه‌جایی (move)\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چاپ (Print)\fR اعضای مشخص‌شده از بایگانی در فایل خروجی استاندارد. اگر تغییردهندهٔ \fBv\fR مشخص شود، پیش از رونوشت محتویات عضو در خروجی استاندارد، نام آن نمایش داده می‌شود.
.Sp
اگر هیچ آرگومان \fImember\fR مشخص نکنید، تمام فایل‌های موجود در بایگانی چاپ می‌شوند.
.IP \fBq\fR 4
.IX Item "q"
\&\fIالحاق سریع (Quick append)\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استخراج (Extract)\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ایجاد (Create)\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"
کوتاه کردن (truncate) نام‌ها در بایگانی. ابزار 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 باشد. توجه داشته باشید که \fBP\fR ممکن است هنگام افزودن فایل‌ها به
یک آرشیو thin مفید باشد، زیرا \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"
جدول نمادهای آرشیو را تولید نمی‌کند. این کار می‌تواند ساخت یک
کتابخانه بزرگ در چندین مرحله را تسریع کند. آرشیو حاصل را نمی‌توان همراه با
پیونددهنده (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قطعی (deterministic)\fR عمل \fIنمی‌کند\fR. این برعکسِ
اصلاح‌کننده \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 نادیده می‌گیرد. رفتاری که این گزینه ایجاد می‌کند، رفتار
پیش‌فرض برای 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
این گزینه تنها در صورتی در دسترس است که زنجیره ابزار با
فعال بودن پشتیبانی از افزونه ساخته شده باشد.
.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 همیشه با نسخه‌های
پیشین سازگار به عقب است، بنابراین فقط کپی کردن جدیدترین نسخه کافی است.
.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
وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به‌صورت
لفظی رفتار خواهد شد و حذف نمی‌شود.
.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"
کپی‌رایت (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 گنجانده شده است.