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."

2025-12-20 gdb-17.1