نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

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

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

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

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

گزینه‌ها (OPTIONS)

-h

-H

--help

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

-v

-V

--version

نمایش شماره نگارش ranlib.

-D

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

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

-t

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

-U

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

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

@file

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

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

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

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

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

حق نشر (c) 1991-2025 Free Software Foundation, Inc.

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