نام (NAME)

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

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

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

توضیحات (DESCRIPTION)

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

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

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

برنامهٔ GNU ranlib شکل دیگری از GNU 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، timestamp و حالت دسترسی فایل (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)، نسخهٔ 1.3 یا هر نسخهٔ متأخر دیگری که توسط بنیاد نرم‌افزار آزاد منتشر شده است، داده می‌شود؛ بدون بخش‌های تغییرناپذیر، بدون متون روی جلد، و بدون متون پشت جلد. نسخه‌ای از این مجوز در بخشی با عنوان «GNU Free Documentation License» گنجانده شده است.