.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "GDB-ADD-INDEX 1"
.TH GDB-ADD-INDEX 1 2026-05-10 gdb-17.2 "GNU Development Tools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
loongarch64-linux-gnu-gdb-add-index \- افزودن ایندکس به فایل باینری جهت افزایش سرعت بارگذاری GDB
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
gdb-add-index [\-h | \-\-help] [\-v | \-\-version] [\-\-dwarf\-5] \fIfilename\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
هنگامی که GDB یک فایل نماد (symbol file) را می‌یابد، نمادهای موجود در فایل را جهت ساخت جدول نمادهای داخلی بررسی و پیمایش می‌کند. این کار باعث می‌شود اکثر عملیات‌های GDB با سرعت بالا اجرا شوند، اما در ابتدای کار مقداری تأخیر ایجاد می‌کند. برای برنامه‌های بزرگ، این تأخیر می‌تواند بسیار طولانی باشد؛ از این رو GDB روشی را برای ساخت یک ایندکس ارائه می‌دهد که سرعت راه‌اندازی را به میزان قابل توجهی افزایش می‌دهد.
.PP
برای تشخیص اینکه آیا یک فایل حاوی چنین ایندکسی است یا خیر، از دستور
\&\f(CW\*(C`readelf \-S filename\*(C'\fR
استفاده کنید: ایندکس در بخشی با نام
\&\f(CW\*(C`.gdb_index\*(C'\fR
(پیش از DWARF 5) یا
\&\f(CW\*(C`.debug_names\*(C'\fR
و
\&\f(CW\*(C`.debug_str\*(C'\fR
(در DWARF 5) ذخیره می‌شود. ایندکس‌ها تنها در سیستم‌هایی قابل تولید هستند که از باینری‌های ELF و اطلاعات دیباگ DWARF (یعنی بخش‌هایی با نام
\&\f(CW\*(C`.debug_*\*(C'\fR)
استفاده می‌کنند.
.PP
به‌طور پیش‌فرض،
\&\fBgdb-add-index\fR
یک بخش پیش از DWARF 5 با نام
\&\f(CW\*(C`.gdb_index\*(C'\fR
را به
\&\fIfilename\fR
اضافه می‌کند. با استفاده از گزینه
\&\fB\-\-dwarf\-5\fR
بخش مربوط به DWARF 5 با نام
\&\f(CW\*(C`.debug_names\*(C'\fR
به جای آن اضافه خواهد شد.
.PP
فایل
\&\fIfilename\fR
باید دسترسی نوشتن داشته باشد.
.PP
دستور
\&\fBgdb-add-index\fR
از برنامه‌های GDB،
\&\fBobjcopy\fR
و
\&\fBreadelf\fR
موجود در متغیر محیطی
\&\fBPATH\fR
استفاده می‌کند. اگر می‌خواهید از نسخه‌های متفاوتی از این برنامه‌ها استفاده کنید، می‌توانید آن‌ها را از طریق متغیرهای محیطی مربوطه مشخص نمایید (به بخش زیر مراجعه کنید).
.PP
دستور
\&\fBgdb-add-index\fR
در صورت موفقیت در ایجاد ایندکس برای
\&\fIfilename\fR
با وضعیت 0 و در صورت وقوع خطا با وضعیتی بزرگ‌تر از 0 خارج می‌شود.
.PP
برای اطلاعات بیشتر به راهنمای GDB در گره
\&\f(CW\*(C`Index Files\*(C'\fR
\&\-\- دستور خط فرمان
\&\f(CW\*(C`info \-f gdb \-n "Index Files"\*(C'\fR
مراجعه کنید.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-dwarf\-5\fR 4
.IX Item "--dwarf-5"
افزودن بخش‌های DWARF 5 به جای بخش پیشین \f(CW\*(C`.gdb_index\*(C'\fR.
.IP \fB\-\-help\fR 4
.IX Item "--help"
.PD 0
.IP \fB\-h\fR 4
.IX Item "-h"
.PD
نمایش فهرستی از تمام گزینه‌ها همراه با توضیحات مختصر.
.IP \fB\-\-version\fR 4
.IX Item "--version"
.PD 0
.IP \fB\-v\fR 4
.IX Item "-v"
.PD
چاپ اطلاعات نسخه و سپس خروج.
.SH "محیط (ENVIRONMENT)"
.IX Header "ENVIRONMENT"
.IP \fBGDB\fR 4
.IX Item "GDB"
نام یا مسیر کامل فایل اجرایی برنامه \f(CW\*(C`gdb\*(C'\fR جهت استفاده برای تولید ایندکس.
اگر تنظیم نشده باشد، متغیر \fBPATH\fR برای یافتن برنامه \f(CW\*(C`gdb\*(C'\fR جستجو می‌شود.
.IP \fBOBJCOPY\fR 4
.IX Item "OBJCOPY"
نام یا مسیر کامل فایل اجرایی برنامه \f(CW\*(C`objcopy\*(C'\fR جهت کپی کردن اطلاعات بخش‌ها در فایل داده‌شده.
اگر تنظیم نشده باشد، متغیر \fBPATH\fR برای یافتن برنامه \f(CW\*(C`objcopy\*(C'\fR جستجو می‌شود.
.IP \fBREADELF\fR 4
.IX Item "READELF"
نام یا مسیر کامل فایل اجرایی برنامه \f(CW\*(C`readelf\*(C'\fR جهت بررسی ویژگی‌های فایل داده‌شده.
اگر تنظیم نشده باشد، متغیر \fBPATH\fR برای یافتن برنامه \f(CW\*(C`readelf\*(C'\fR جستجو می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
مستندات کامل GDB به صورت یک راهنمای Texinfo نگهداری می‌شود.
اگر برنامه‌های \f(CW\*(C`info\*(C'\fR و \f(CW\*(C`gdb\*(C'\fR و مستندات Texinfo مربوط به GDB به درستی روی سیستم شما نصب شده باشند، دستور
.PP
.Vb 1
\&        info gdb
.Ve
.PP
باید دسترسی به راهنمای کامل را برای شما فراهم کند.
.PP
\&\fIUsing GDB: A Guide to the GNU Source-Level Debugger\fR,
Richard M. Stallman and Roland H. Pesch, July 1991.
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر \(co 1988\-2025 Free Software Foundation, Inc.
.PP
مجوز کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخه 1.3 یا هر نسخه متأخر دیگری که توسط بنیاد نرم‌افزار آزاد منتشر شده است اعطا می‌شود؛ بدون بخش‌های تغییرناپذیر، همراه با متن‌های روی جلد «یک راهنمای GNU» و با متن‌های پشت جلد طبق بخش (a) در ادامه.
.PP
(a) متن پشت جلد FSF عبارت است از: «شما در کپی و تغییر این راهنمای GNU آزاد هستید. خرید نسخه‌ها از انتشارات GNU Press از FSF در توسعه GNU و پیشبرد آزادی نرم‌افزار حمایت می‌کند.»