نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

دستور ranlib نمایه‌ای برای محتوای یک آرشیو ایجاد کرده و درون همان آرشیو ذخیره می‌کند. این نمایه هر نماد (symbol) تعریف‌شده توسط اعضای آرشیو که یک فایل شیء با قابلیت جابه‌جایی (relocatable object file) هستند را فهرست می‌کند.

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

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

برنامهٔ 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 با فاصله (whitespace) از یکدیگر جدا می‌شوند. با قرار دادن کل گزینه در گیومهٔ تکی یا دوگانه می‌توان نویسه‌های فاصله را نیز درون آن گنجاند. هر نویسه‌ای (از جمله بک‌اسلش) را می‌توان با افزودن یک پیشوند بک‌اسلش پیش از آن در گزینه درج کرد. خود file نیز می‌تواند شامل گزینه‌های @file دیگری باشد؛ چنین گزینه‌هایی به‌صورت بازگشتی پردازش خواهند شد.

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

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

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

حق نشر © ۱۹۹۱-۲۰۲۵ Free Software Foundation, Inc.

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