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 یک فایل نمادها (symbol file) را پیدا می‌کند، نمادهای موجود در فایل را به منظور ساخت جدول نمادهای درونی پویش می‌کند. این کار به بیشتر عملیات‌های 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 عبارت است از: «شما مجاز به رونوشت‌برداری و ویرایش این راهنمای GNU هستید. خرید نسخه‌ها از انتشارات GNU از بنیاد FSF در توسعه GNU و پیشبرد آزادی نرم‌افزار پشتیبانی می‌کند.»

2025-12-20 gdb-17.1