نام (NAME)

ranlib - تولید نمایه‌ای برای یک آرشیو

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

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

توضیحات (DESCRIPTION)

دستور ranlib نمایه‌ای از محتویات یک آرشیو تولید کرده و آن را در خود آرشیو ذخیره می‌کند. این نمایه تمامی نمادهای تعریف‌شده توسط اعضای آرشیو را که یک فایل شیئی بازمکان‌پذیر (relocatable object file) هستند، فهرست می‌کند.

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

وجود چنین نمایه‌ای در یک آرشیو، فرآیند پیوند (linking) به کتابخانه را سرعت می‌بخشد.

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

گزینه‌ها (OPTIONS)

-h

-H

--help

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

-v

-V

--version

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

-D

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

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

-t

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

-U

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

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

@file

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

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

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

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

کپی‌رایت (COPYRIGHT)

کپی‌رایت © 1991-2026 بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.)

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