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 و Roland H. Pesch، ژوئیه ۱۹۹۱.

حق نشر (c) 1988-2025 Free Software Foundation, Inc.

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

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

2026-05-10 gdb-17.2