.\" -*- 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 "RANLIB 1"
.TH RANLIB 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)"
ranlib \- تولید نمایه برای یک آرشیو
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
ranlib [\fB\-\-plugin\fR \fIname\fR] [\fB\-DhHvVt\fR] \fIarchive\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور \&\fBranlib\fR نمایه‌ای برای محتوای یک آرشیو ایجاد کرده و درون همان آرشیو ذخیره می‌کند. این نمایه هر نماد (symbol) تعریف‌شده توسط اعضای آرشیو که یک فایل شیء با قابلیت جابه‌جایی (relocatable object file) هستند را فهرست می‌کند.
.PP
می‌توانید برای مشاهدهٔ این نمایه از \fBnm \-s\fR یا \fBnm \-\-print\-armap\fR استفاده کنید.
.PP
وجود چنین نمایه‌ای در یک آرشیو، سرعت پیوند دادن (linking) به کتابخانه را افزایش می‌دهد و به روال‌های (routines) داخل کتابخانه اجازه می‌دهد بدون توجه به ترتیب قرارگیری‌شان در آرشیو، یکدیگر را فراخوانی کنند.
.PP
برنامهٔ \fBranlib\fR گنو شکل دیگری از \fBar\fR گنو است؛ اجرای \&\fBranlib\fR کاملاً معادل با اجرای \fBar \-s\fR است.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-h\fR 4
.IX Item "-h"
.PD 0
.IP \fB\-H\fR 4
.IX Item "-H"
.IP \fB\-\-help\fR 4
.IX Item "--help"
.PD
نمایش اطلاعات نحوهٔ استفاده از \fBranlib\fR.
.IP \fB\-v\fR 4
.IX Item "-v"
.PD 0
.IP \fB\-V\fR 4
.IX Item "-V"
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD
نمایش شمارهٔ نگارش \fBranlib\fR.
.IP \fB\-D\fR 4
.IX Item "-D"
اجرا در حالت \fIقطعیت‌یافته\fR (deterministic). سرآیند عضو نگاشت نماد در آرشیو، مقادیر صفر را برای UID، GID و برچسب زمان (timestamp) نشان خواهد داد. با استفاده از این گزینه، اجرای چندبارهٔ دستور فایل‌های خروجی یکسانی تولید خواهد کرد.
.Sp
اگر \fIbinutils\fR با گزینهٔ \&\fB\-\-enable\-deterministic\-archives\fR پیکربندی شده باشد، این حالت به‌طور پیش‌فرض فعال است. می‌توان آن را با گزینهٔ \fB\-U\fR که در ادامه شرح داده شده، غیرفعال کرد.
.IP \fB\-t\fR 4
.IX Item "-t"
به‌روزرسانی برچسب زمان (timestamp) نگاشت نماد یک آرشیو.
.IP \fB\-U\fR 4
.IX Item "-U"
\fIعدم\fR اجرا در حالت \fIقطعیت‌یافته\fR (deterministic). این حالت معکوس گزینهٔ \fB\-D\fR در بالا است: نمایهٔ آرشیو مقادیر واقعی UID، GID، برچسب زمان و حالت فایل (file mode) را دریافت خواهد کرد.
.Sp
اگر \fIbinutils\fR \fIبدون\fR \&\fB\-\-enable\-deterministic\-archives\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"
\&\fBar\fR\|(1)، \fBnm\fR\|(1) و مدخل‌های Info برای \fIbinutils\fR.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر \(co ۱۹۹۱\-۲۰۲۵ Free Software Foundation, Inc.
.PP
اجازهٔ کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخهٔ ۱.۳ یا هر نسخهٔ بعدی منتشر شده توسط بنیاد نرم‌افزارهای آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد و بدون متون پشت جلد. نسخه‌ای از این مجوز در بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.