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

aarch64-linux-gnu-gdb-add-index - افزودن نمایه به فایل ELF برای سرعت بخشیدن به 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 مربوط به GDB به درستی در سامانه شما نصب شده باشند، دستور

info gdb

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

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

حق نشر © ۱۹۸۸-۲۰۲۵ بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.)

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

(a) متن پشت جلد بنیاد FSF عبارت است از: «شما در کپی و تغییر این راهنمای گنو آزاد هستید. خرید نسخه‌ها از انتشارات گنو (GNU Press) از بنیاد FSF در توسعه گنو و ارتقای آزادی نرم‌افزار پشتیبانی می‌کند.»

2026-05-10 gdb-17.2