GDB-ADD-INDEX(1) GNU Development Tools GDB-ADD-INDEX(1)

loongarch64-linux-gnu-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.

حق نشر © 1988-2025 Free Software Foundation, Inc.

مجوز کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخه 1.3 یا هر نسخه متأخر دیگری که توسط بنیاد نرم‌افزار آزاد منتشر شده است اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، همراه با متن‌های روی جلد «یک راهنمای GNU» و با متن‌های پشت جلد طبق بخش (a) در ادامه.

(a) متن پشت جلد FSF عبارت است از: «شما در کپی و تغییر این راهنمای GNU آزاد هستید. خرید نسخه‌ها از انتشارات GNU Press از FSF در توسعه GNU و پیشبرد آزادی نرم‌افزار حمایت می‌کند.»

2026-05-10 gdb-17.2