.\" -*- 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-03 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"
برنامهٔ \fBar\fR گنو بایگانی‌ها را ایجاد و ویرایش کرده و داده‌ها را از آن‌ها استخراج می‌کند. یک \fIبایگانی\fR (archive) فایلی منفرد است که مجموعه‌ای از فایل‌های دیگر را در ساختاری نگه می‌دارد که بازیابی فایل‌های اصلی اولیه (که \fIعضوهای\fR بایگانی یا \fImembers\fR نامیده می‌شوند) را ممکن می‌سازد.
.PP
محتوا، حالت دسترسی (مجوزها)، برچسب زمانی، مالک و گروه فایل‌های اصلی درون بایگانی حفظ می‌شوند و هنگام استخراج قابل بازیابی هستند.
.PP
ابزار \fBar\fR گنو می‌تواند از بایگانی‌هایی نگهداری کند که اعضای آن نام‌هایی با هر طولی داشته باشند؛ با این حال، بسته به نحوهٔ پیکربندی \fBar\fR روی سیستم شما، ممکن است برای سازگاری با قالب‌های بایگانی ایجادشده توسط ابزارهای دیگر، محدودیت‌هایی روی طول نام عضوها اعمال شود. در صورت وجود، این محدودیت اغلب ۱۵ نویسه (رایج در قالب‌های مرتبط با a.out) یا ۱۶ نویسه (رایج در قالب‌های مرتبط با coff) است.
.PP
برنامهٔ \&\fBar\fR یک ابزار باینری به شمار می‌رود، زیرا بایگانی‌هایی از این نوع اغلب به عنوان \fIکتابخانه‌هایی\fR حاوی زیرروال‌های پرکاربرد استفاده می‌شوند. از آنجا که کتابخانه‌ها معمولاً به کتابخانه‌های دیگری وابسته هستند، \&\fBar\fR می‌تواند در صورت تعیین گزینهٔ \&\fB\-\-record\-libdeps\fR، وابستگی‌های کتابخانه را نیز ثبت کند.
.PP
هنگامی که تغییردهندهٔ \fBs\fR را مشخص می‌کنید، \&\fBar\fR یک نمایه (index) از نمادهای تعریف‌شده در ماژول‌های شیء بازآدرس‌پذیر در بایگانی می‌سازد. پس از ایجاد، هر زمان که \fBar\fR تغییری در محتویات ایجاد کند (به‌جز عملیات به‌روزرسانی \fBq\fR)، این نمایه در بایگانی به‌روزرسانی می‌شود. وجود چنین نمایه‌ای در یک بایگانی، پیوند دادن به کتابخانه را سرعت می‌بخشد.
.PP
می‌توانید از \fBnm \-s\fR یا \fBnm \-\-print\-armap\fR برای فهرست کردن جدول این نمایه استفاده کنید. اگر یک بایگانی فاقد این جدول باشد، شکل دیگری از \fBar\fR به نام \&\fBranlib\fR می‌تواند صرفاً برای افزودن این جدول به کار رود.
.PP
ابزار \fBar\fR گنو می‌تواند به‌صورت اختیاری یک بایگانی \fIکم‌حجم\fR (thin) ایجاد کند؛ این نوع بایگانی شامل نمایه‌ای از نمادها و ارجاعاتی به نسخه‌های اصلی فایل‌های عضو بایگانی است. این قابلیت برای ساخت کتابخانه‌ها جهت استفاده در درخت ساخت محلی مفید است، جایی که انتظار می‌رود اشیاءِ بازآدرس‌پذیر در دسترس بمانند و کپی کردن محتوای هر شیء صرفاً اتلاف وقت و فضای دیسک خواهد بود.
.PP
یک بایگانی می‌تواند یا \fIکم‌حجم\fR (thin) باشد یا معمولی، و نمی‌تواند هم‌زمان هر دو حالت را داشته باشد. پس از ایجاد یک بایگانی، قالب آن بدون حذف اولیه و سپس ایجاد یک بایگانی جدید در جای آن، قابل تغییر نیست.
.PP
بایگانی‌های کم‌حجم همچنین به‌صورت \fIتخت\fR (flattened) درمی‌آیند؛ بنابراین افزودن یک بایگانی کم‌حجم به یک بایگانی کم‌حجم دیگر موجب تودرتو شدن (nesting) آن نمی‌شود (اتفاقی که در یک بایگانی معمولی رخ می‌دهد). در عوض، عناصر بایگانی اول به‌طور جداگانه به بایگانی دوم افزوده می‌شوند.
.PP
مسیرهای منتهی به عناصر بایگانی به‌صورت نسبی نسبت به خودِ فایل بایگانی ذخیره می‌شوند.
.PP
ابزار \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
نام‌های مسیر کامل را حذف خواهد کرد، مگر اینکه بایگانی یک بایگانی باریک
باشد. توجه داشته باشید که \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"
جدول نمادهای آرشیو را ایجاد نمی‌کند. این کار می‌تواند ساخت یک کتابخانهٔ بزرگ در چند مرحله را تسریع کند، اما در صورتی که آرشیو نهایی با پیونددهنده (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 مجاز نیست، زیرا بررسی مهرزمان‌ها (timestamps) هرگونه برتری سرعت ناشی از عملیات \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 همچنین از برخی گزینه‌های خط فرمان پشتیبانی می‌کند که نه اصلاح‌گر هستند و نه کنش (action)، اما رفتار آن را به شیوه‌های خاصی تغییر می‌دهند:
.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
لطفاً توجه داشته باشید که این پوشهٔ جستجوی افزونه، پوشه‌ای \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"
\fIآرشیو\fR مشخص‌شده را به یک آرشیو \fIنازک\fR (thin) تبدیل می‌کند. اگر این آرشیو از قبل موجود بوده و یک آرشیو معمولی باشد، اعضای موجود باید در همان پوشهٔ \fIآرشیو\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)، نسخه 1.3 یا هر نسخه جدیدتر منتشرشده توسط Free Software Foundation داده می‌شود؛ بدون بخش‌های ناوردا (Invariant Sections)، بدون متون روی جلد (Front\-Cover Texts)، و بدون متون پشت جلد (Back\-Cover Texts). نسخه‌ای از این مجوز در بخشی با عنوان \(lqGNU Free Documentation License\(rq گنجانده شده است.