نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

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

برای فهرست کردن این نمایه می‌توانید از 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)

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

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