.\" -*- 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 حاوی زیرروال‌های پرکاربرد استفاده می‌شوند. از آنجا که کتابخانه‌ها معمولاً به کتابخانه‌های دیگری وابسته هستند، \&\fBar\fR همچنین می‌تواند در صورت تعیین گزینهٔ \&\fB\-\-record\-libdeps\fR، وابستگی‌های یک کتابخانه را ثبت کند.
.PP
هنگامی که تغییردهندهٔ \fBs\fR را تعیین می‌کنید، \&\fBar\fR یک نمایه (index) از نمادهای تعریف‌شده در پودمان‌های شیء بازآدرس‌پذیر (relocatable object modules) در بایگانی ایجاد می‌کند. پس از ایجاد، این نمایه هر بار که \&\fBar\fR تغییری در محتویات آن ایجاد کند (به‌جز عملیات به‌روزرسانی \fBq\fR)، در بایگانی به‌روزرسانی می‌شود. بایگانیِ دارای چنین نمایه‌ای، سرعت پیوند دادن به کتابخانه را افزایش می‌دهد و به روال‌های درون کتابخانه اجازه می‌دهد بدون توجه به جایگاهشان در بایگانی، یکدیگر را فراخوانی کنند.
.PP
می‌توانید برای فهرست کردن این جدول نمایه از \fBnm \-s\fR یا \fBnm \-\-print\-armap\fR استفاده کنید. اگر یک بایگانی فاقد این جدول باشد، می‌توان از شکل دیگری از \fBar\fR به نام \&\fBranlib\fR برای افزودن این جدول استفاده کرد.
.PP
ابزار GNU \fBar\fR می‌تواند به‌صورت اختیاری یک بایگانی \fIنازک\fR (thin) بسازد که شامل نمایهٔ نمادها و ارجاع‌هایی به نسخه‌های اصلی فایل‌های عضو بایگانی است. این قابلیت برای ساخت کتابخانه‌هایی جهت استفاده در درخت ساخت (build tree) محلی کاربردی است؛ جایی که انتظار می‌رود اشیای بازآدرس‌پذیر همچنان در دسترس باقی بمانند و رونویسی محتوای هر شیء تنها موجب هدر رفتن زمان و فضا می‌شود.
.PP
یک بایگانی یا می‌تواند \fIنازک\fR باشد یا عادی؛ نمی‌تواند هر دو حالت را به طور هم‌زمان داشته باشد. پس از ایجاد یک بایگانی، قالب آن بدون حذف اولیه و سپس ساخت بایگانی جدید در جای آن، قابل تغییر نیست.
.PP
بایگانی‌های نازک همچنین به‌صورت \fIهم‌سطح\fR (flattened) هستند، به طوری که افزودن یک بایگانی نازک به یک بایگانی نازک دیگر باعث تو در تو شدن آن نمی‌شود؛ بر خلاف آنچه در یک بایگانی عادی رخ می‌دهد. در عوض، عناصر بایگانی اول به‌صورت مجزا به بایگانی دوم اضافه می‌شوند.
.PP
مسیرهای منتهی به عناصر بایگانی به‌صورت نسبی نسبت به خود فایل بایگانی ذخیره می‌شوند.
.PP
ابزار GNU \fBar\fR به گونه‌ای طراحی شده است که با دو شیوهٔ کاری متفاوت سازگار باشد. شما می‌توانید عملکرد آن را با استفاده از گزینه‌های خط فرمان، مانند انواع گوناگون \fBar\fR در سیستم‌های Unix کنترل کنید؛ یا اگر گزینهٔ خط فرمان تکی \fB\-M\fR را تعیین کنید، می‌توانید آن را با یک اسکریپت که از طریق ورودی استاندارد فراهم می‌شود، همانند برنامهٔ "librarian" متعلق به MRI کنترل نمایید..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). هنگام افزودن فایل‌ها و نمایهٔ آرشیو، برای 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"
مشخص کردن وابستگی‌های این کتابخانه. وابستگی‌ها باید بلافاصله پس از این نویسهٔ گزینه بیایند، باید از همان ساختار نحوی خط فرمان پیونددهنده استفاده کنند و باید درون یک آرگومان واحد مشخص شوند. یعنی اگر به چند مورد نیاز باشد، باید برای تشکیل یک آرگومان خط فرمان واحد در گیومه قرار گیرند. برای نمونه: \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"
یک نمایه از فایل‌های شیء را در آرشیو می‌نویسد، یا نمایه موجود را به‌روزرسانی می‌کند،
حتی اگر هیچ تغییر دیگری در آرشیو ایجاد نشده باشد. می‌توانید از این پرچم
اصلاح‌گر با هر عملیاتی، یا به‌تنهایی استفاده کنید. اجرای \fBar s\fR روی یک
آرشیو معادل اجرای \fBranlib\fR روی آن است.
.IP \fBS\fR 4
.IX Item "S"
جدول نمادهای آرشیو را ایجاد نمی‌کند. این کار می‌تواند ساخت یک
کتابخانه بزرگ را در چندین مرحله تسریع کند. آرشیو حاصل را نمی‌توان
با پیونددهنده (linker) استفاده کرد. برای ایجاد جدول نمادها، باید در
آخرین اجرای \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"
در حالت \fIقطعی (deterministic)\fR عمل \fIنمی‌کند\fR. این برعکس
اصلاح‌گر \fBD\fR در بالا است: فایل‌های اضافه‌شده و نمایه آرشیو
مقادیر واقعی UID، GID، برچسب زمانی و حالت فایل (file mode) خود را دریافت می‌کنند.
.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
این گزینه تنها زمانی در دسترس است که زنجیره ابزار (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 همیشه
با نسخه‌های پیشین سازگار است، بنابراین فقط کپی کردن جدیدترین نسخه کافی خواهد بود.
.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 با نویسه فاصله (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) باشد، اعطا می‌شود. یک نسخه از این مجوز در بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.