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