نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

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

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

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

برنامهٔ 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

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

-U

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

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

@file

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

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

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

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

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

کپی‌رایت (c) 1991-2025 Free Software Foundation, Inc.

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