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 یک بخش ".gdb_index" مربوط به پیش از DWARF 5 را به 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."

2025-12-20 gdb-17.1