نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

دستور ranlib نمایه‌ای از محتویات یک بایگانی (archive) تولید کرده و آن را درون خود بایگانی ذخیره می‌کند. این نمایه هر نمادی (symbol) را که توسط یکی از اعضای بایگانی از نوع فایل شیء بازآدرس‌پذیر (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 با نویسه‌های فاصله خالی (whitespace) از هم جدا می‌شوند. با قرار دادن کل گزینه در میان علامت‌های نقل‌قول تکی یا جفتی، می‌توان یک نویسهٔ فاصله را در یک گزینه گنجاند. هر نویسه‌ای (از جمله بک‌اسلش) را می‌توان با درج یک بک‌اسلش پیش از آن اضافه کرد. خود file نیز می‌تواند شامل گزینه‌های @file دیگری باشد؛ با این گزینه‌ها به‌صورت بازگشتی رفتار خواهد شد.

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

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

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

حق نشر © 1991-2025 بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.)

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