.\" -*- 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)"
aarch64-linux-gnu-gdb-add-index \- افزودن نمایه به فایل ELF برای سرعت بخشیدن به GDB
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
gdb-add-index [\-h | \-\-help] [\-v | \-\-version] [\-\-dwarf\-5] \fIfilename\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
هنگامی که GDB یک فایل نماد را می‌یابد، نمادهای موجود در فایل را به منظور ساخت یک جدول نمادهای داخلی پویش می‌کند. این امر باعث می‌شود که بیشتر عملیات‌های 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 یک بخش \f(CW\*(C`.gdb_index\*(C'\fR مربوط به پیش از DWARF 5 را به \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 با وضعیت ۰ یا در صورت بروز خطا با مقداری بزرگتر از ۰ خارج می‌شود.
.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 ۱۹۸۸\-۲۰۲۵ بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.)
.PP
مجوز کپی، توزیع و/یا ویرایش این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه بعدی منتشرشده توسط بنیاد نرم‌افزارهای آزاد؛ با بخش‌های ناوردا شامل «Free Software» و «Free Software Needs Free Documentation»، با متن‌های روی جلد شامل «A GNU Manual»، و با متن‌های پشت جلد به شرح بند (a) زیر اعطا می‌شود.
.PP
(a) متن پشت جلد بنیاد FSF عبارت است از: «شما در کپی و تغییر این راهنمای گنو آزاد هستید. خرید نسخه‌ها از انتشارات گنو (GNU Press) از بنیاد FSF در توسعه گنو و ارتقای آزادی نرم‌افزار پشتیبانی می‌کند.»