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، ژوئیه ۱۹۹۱.

Copyright (c) 1988-2025 Free Software Foundation, Inc.

اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخهٔ پسین منتشرشده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود؛ با این شرط که بخش‌های تغییرناپذیر "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