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

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 بخش قبل از DWARF 5 به نام ".gdb_index" را به filename اضافه می‌کند. با گزینهٔ --dwarf-5 به‌جای آن، بخش مربوط به DWARF 5 یعنی ".debug_names" افزوده می‌شود.

فایل filename باید قابل نوشتن باشد.

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

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

برای اطلاعات بیشتر، راهنمای 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.

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

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

2026-05-10 gdb-17.2