.\" -*- 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 نمایه‌ای از محتویات یک بایگانی تولید کرده و آن را در همان بایگانی ذخیره می‌کند. این نمایه هر نمادی را که توسط عضوی از بایگانی که یک فایل شیءِ بازآدرس‌پذیر (relocatable object file) است تعریف شده باشد، فهرست می‌کند.
.PP
برای فهرست کردن این نمایه می‌توانید از \fBnm \-s\fR یا \fBnm \-\-print\-armap\fR استفاده کنید.
.PP
وجود چنین نمایه‌ای در بایگانی، پیونددادن به کتابخانه را تسریع می‌کند و به زیرروال‌های درون کتابخانه اجازه می‌دهد بدون توجه به محل قرارگیری‌شان در بایگانی، یکدیگر را فراخوانی کنند.
.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"
به‌روزرسانی برچسب زمانی نگاشت نماد در یک بایگانی.
.IP \fB\-U\fR 4
.IX Item "-U"
در حالت \fIقطعی\fR (deterministic) عمل \fIنمی‌کند\fR. این گزینه معکوس گزینهٔ \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 با نویسه‌های فاصله از یکدیگر جدا می‌شوند. یک نویسهٔ فاصله می‌تواند با قرار دادن کل گزینه در گیومهٔ تکی یا دوتایی درون آن گنجانده شود. هر نویسه‌ای (از جمله یک ممیز وارونه یا backslash) می‌تواند با افزودن یک ممیز وارونه به عنوان پیشوند به آن نویسه، در گزینه گنجانده شود. خود \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"
کپی‌رایت (c) 1991\-2025 Free Software Foundation, Inc.
.PP
اجازهٔ نسخه‌برداری، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (GNU Free Documentation License)، نسخهٔ ۱.۳ یا هر نسخهٔ متأخر دیگری که توسط بنیاد نرم‌افزار آزاد منتشر شده باشد، داده می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متن‌های روی جلد و بدون متن‌های پشت جلد. نسخه‌ای از این مجوز در بخشی با عنوان "GNU Free Documentation License" گنجانده شده است.