نام (NAME)

aarch64-linux-gnu-ranlib - ایجاد نمایه برای آرشیوها در معماری aarch64

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

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

توضیحات (DESCRIPTION)

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

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

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

حق نشر (COPYRIGHT)

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

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