نام (NAME)

ranlib - ایجاد نمایه برای یک بایگانی

خلاصه دستور (SYNOPSIS)

ranlib [--plugin name] [-DhHvVt] archive

توضیحات (DESCRIPTION)

ranlib یک نمایه برای محتویات یک بایگانی تولید کرده و آن را درون بایگانی ذخیره می‌کند. این نمایه هر نمادی را که توسط عضوی از بایگانی که یک فایل شیء بازتخصیص‌پذیر است تعریف شده باشد، فهرست می‌کند.

می‌توانید برای فهرست کردن این نمایه از nm -s یا nm --print-armap استفاده کنید.

یک بایگانی دارای چنین نمایه‌ای، سرعت پیوند دادن به کتابخانه را افزایش می‌دهد.

برنامه GNU ranlib شکل دیگری از GNU ar است؛ اجرای ranlib کاملاً معادل اجرای ar -s است.

گزینه‌ها (OPTIONS)

-h

-H

--help

نمایش اطلاعات نحوه استفاده از ranlib.

-v

-V

--version

نمایش شماره نسخه ranlib.

-D

کارکرد در حالت قطعی (deterministic). سرآیند عضو نگاشت نماد در بایگانی برای UID، GID و برچسب زمانی مقدار صفر را نشان خواهد داد. با استفاده از این گزینه، چندین بار اجرای دستور فایل‌های خروجی یکسانی تولید خواهد کرد.

اگر binutils با گزینه --enable-deterministic-archives پیکربندی شده باشد، این حالت به صورت پیش‌فرض فعال است. می‌توان آن را با گزینه -U که در ادامه شرح داده شده غیرفعال کرد.

-t

به‌روزرسانی برچسب زمانی نگاشت نماد یک بایگانی.

-U

عدم کارکرد در حالت قطعی (deterministic). این حالت معکوس گزینه -D در بالا است: نمایه بایگانی مقادیر واقعی UID، GID، برچسب زمانی و حالت دسترسی فایل را دریافت خواهد کرد.

اگر binutils بدون --enable-deterministic-archives پیکربندی شده باشد، این حالت به صورت پیش‌فرض فعال است.

@file

خواندن گزینه‌های خط فرمان از file. گزینه‌های خوانده‌شده به جای گزینه اصلی @file قرار می‌گیرند. اگر file وجود نداشته باشد یا قابل خواندن نباشد، با گزینه به‌صورت تحت‌اللفظی رفتار خواهد شد و حذف نمی‌شود.

گزینه‌ها در file با نویسه‌های فاصله خالی (whitespace) از یکدیگر جدا می‌شوند. برای گنجاندن یک نویسه فاصله خالی در یک گزینه، می‌توان کل گزینه را درون نقل‌قول تکی یا دوتایی قرار داد. هر نویسه‌ای (از جمله بک‌اسلش) را می‌توان با افزودن یک پیشوند بک‌اسلش به آن درج کرد. خود file می‌تواند شامل گزینه‌های @file دیگری نیز باشد؛ هرکدام از این گزینه‌ها به‌صورت بازگشتی پردازش خواهند شد.

همچنین ببینید (SEE ALSO)

ar(1)، nm(1) و مدخل‌های Info برای binutils.

کپی‌رایت و تکثیر (COPYRIGHT)

Copyright (c) 1991-2026 Free Software Foundation, Inc.

اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخه 1.3 یا هر نسخه بالاتر منتشر شده توسط بنیاد نرم‌افزارهای آزاد اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد و بدون متون پشت جلد. نسخه‌ای از این مجوز در بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.