.\" -*- 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)"
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 یک فایل نماد را می‌یابد، نمادهای موجود در فایل
را پویش می‌کند تا یک جدول نماد داخلی بسازد. این کار اجازه می‌دهد
اکثر عملیات 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 و Roland H. Pesch، ژوئیه ۱۹۹۱.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر (c) 1988\-2025 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) از بنیاد نرم‌افزار آزاد در توسعهٔ گنو و ارتقای آزادی نرم‌افزار پشتیبانی می‌کند.»