.\" -*- 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 and Roland H. Pesch, July 1991.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (c) 1988\-2025 Free Software Foundation, Inc.
.PP
اجازهٔ کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)،
نگارش 1.3 یا هر نگارش بعدی منتشر شده توسط بنیاد نرم‌افزارهای آزاد اعطا می‌شود؛
با بخش‌های تغییرناپذیر "Free Software" و "Free Software Needs Free Documentation"،
با متن روی جلد "A GNU Manual"، و با متن پشت جلد به شرح مندرج در بند (a) در زیر.
.PP
(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." (شما مجاز به نسخه‌برداری
و تغییر این راهنمای گنو هستید. خرید نسخه‌ها از GNU Press به FSF در توسعهٔ گنو
و ارتقای آزادی نرم‌افزار کمک می‌کند.)