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 استفاده می‌کند. اگر می‌خواهید از نسخه‌های دیگری از این برنامه‌ها استفاده کنید، می‌توانید آن‌ها را از طریق متغیرهای محیطی مناسب تعیین کنید (پایین را ببینید).

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

برای اطلاعات بیشتر، بخش "Index Files" را در راهنمای GDB ببینید -- دستور پوستهٔ "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 Foundation) منتشر شده است، داده می‌شود؛ با بخش‌های تغییرناپذیرِ "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."

2025-12-20 gdb-17.1