GDB-ADD-INDEX(1) GNU Development Tools GDB-ADD-INDEX(1)

arm-none-eabi-gdb-add-index, gdb-add-index - افزودن یک نمایه به یک فایل باینری جهت تسریع بارگذاری در GDB

gdb-add-index [-h | --help] [-v | --version] [--dwarf-5] filename

هنگامی که GDB یک فایل نماد را می‌یابد، نمادهای موجود در فایل را به منظور ساخت یک جدول نمادهای داخلی پویش می‌کند. این امر باعث می‌شود که بیشتر عملیات‌های GDB به سرعت اجرا شوند--به بهای تاخیری در آغاز کار. برای برنامه‌های بزرگ، این تاخیر می‌تواند بسیار طولانی باشد، بنابراین GDB روشی را برای ایجاد یک نمایه فراهم می‌کند که سرعت راه‌اندازی را بسیار بالا می‌برد.

برای تشخیص اینکه آیا یک پرونده شامل چنین نمایه‌ای است یا خیر، از دستور "readelf -S filename"; استفاده کنید: نمایه در بخشی با نام ".gdb_index" (پیش از DWARF 5) یا ".debug_names" و ".debug_str" (در DWARF 5) ذخیره می‌شود. نمایه‌ها تنها روی سامانه‌هایی قابل تولید هستند که از باینری‌های ELF و اطلاعات اشکال‌زدایی DWARF (یعنی بخش‌هایی با نام ".debug_*") استفاده می‌کنند.

به‌طور پیش‌فرض، gdb-add-index یک بخش ".gdb_index" مربوط به پیش از DWARF 5 را به filename اضافه می‌کند. با گزینه --dwarf-5 بخش DWARF 5 به نام ".debug_names" به جای آن اضافه می‌شود.

پرونده filename باید قابل نوشتن باشد.

دستور gdb-add-index از GDB، objcopy و readelf موجود در متغیر محیطی PATH استفاده می‌کند. اگر می‌خواهید از نگارش‌های متفاوتی از این برنامه‌ها استفاده کنید، می‌توانید آن‌ها را از طریق متغیرهای محیطی مناسب تعیین نمایید (به زیر مراجعه کنید).

دستور gdb-add-index در صورت موفقیت در ساخت نمایه برای filename با وضعیت ۰ یا در صورت بروز خطا با مقداری بزرگتر از ۰ خارج می‌شود.

برای مشاهده اطلاعات بیشتر، در کتابچه راهنمای GDB به گره "Index Files" -- دستور پوسته "info -f gdb -n "Index Files"" مراجعه کنید.

افزودن بخش‌های DWARF 5 به جای بخش پیشین ".gdb_index".
فهرست کردن تمامی گزینه‌ها، همراه با توضیحات کوتاه.
نمایش اطلاعات نگارش و سپس خروج.

نام کامل پرونده برنامه "gdb" برای استفاده جهت تولید نمایه. در صورت عدم تنظیم، متغیر PATH برای برنامه "gdb" جستجو خواهد شد.
نام کامل پرونده برنامه "objcopy" برای کپی کردن اطلاعات بخش به پرونده مشخص‌شده. در صورت عدم تنظیم، متغیر PATH برای یافتن برنامه "objcopy" جستجو خواهد شد.
نام کامل پرونده برنامه "readelf" برای بررسی ویژگی‌های پرونده مشخص‌شده. در صورت عدم تنظیم، متغیر PATH برای یافتن برنامه "readelf" جستجو خواهد شد.

مستندات کامل GDB به صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های "info" و "gdb" و مستندات Texinfo گنو به درستی در سامانه شما نصب شده باشند، دستور

info gdb

باید دسترسی به راهنمای کامل را برای شما فراهم سازد.

Using GDB: A Guide to the GNU Source-Level Debugger, Richard M. Stallman and Roland H. Pesch, July 1991.

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

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

(a) متن پشت جلد FSF عبارت است از: «You are free to copy and modify this GNU Manual. Buying copies from GNU Press supports the FSF in developing GNU and promoting software freedom.»

2026-05-10 gdb-17.2