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) ۱۹۸۸-۲۰۲۵ Free Software Foundation, Inc.

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

(الف) متن پشت جلد 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