.\" به‌طور خودکار توسط Pod::Man 4.14 (Pod::Simple 3.42) تولید شده است
.\"
.\" مقدمهٔ استاندارد:
.\" ========================================================================
.de Sp \" فاصلهٔ عمودی (زمانی که نمی‌توان از .PP استفاده کرد)
.if t .sp .5v
.if n .sp
..
.de Vb \" شروع متن عین کلمه (verbatim)
.ft CW
.nf
.ne \\$1
..
.de Ve \" پایان متن عین کلمه (verbatim)
.ft R
.fi
..
.\" تنظیم برخی تبدیل‌های نویسه‌ای و رشته‌های از پیش‌تعریف‌شده. \*(-- یک
.\" خط تیرهٔ نشکن ارائه می‌دهد، \*(PI نماد pi را می‌دهد، \*(L" علامت نقل‌قول
.\" جفتی چپ و \*(R" علامت نقل‌قول جفتی راست را ارائه می‌کند. \*(C+ شکل
.\" زیباتری از C++ را فراهم می‌سازد. از امگای بزرگ برای خط تیره‌های نشکن استفاده
.\" می‌شود و بنابراین در دسترس نخواهد بود. \*(C` و \*(C' در nroff به `' و در
.\" troff به هیچ گسترش می‌یابند، برای استفاده همراه با C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" گریز از نقل‌قول‌های تکی در رشته‌های لفظی برای جلوگیری از تبدیل یونیکد groff.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" اگر ثبات F بزرگ‌تر از ۰ باشد، مدخل‌های نمایه را روی stderr برای
.\" عنوان‌ها (.TH)، سرآیندها (.SH)، زیربخش‌ها (.SS)، آیتم‌ها (.Ip) و مدخل‌های
.\" نمایه علامت‌گذاری‌شده با X<> در POD تولید می‌کنیم. البته باید
.\" خودتان خروجی را به شکلی معنادار پردازش کنید.
.\"
.\" جلوگیری از هشدار groff در مورد ثبات تعریف‌نشدهٔ '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
.\"
.\" تعاریف نشانه‌های اعراب (@(#)ms.acc 1.5 88/02/08 SMI؛ برگرفته از UCB 4.2).
.\" بترسید. فرار کنید. جان خود را نجات دهید. هیچ بخش قابل‌تعمیری توسط کاربر وجود ندارد.
.    \" ضرایب اصلاحی برای nroff و troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" اعراب‌های ساده برای nroff و troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" اعراب‌های troff و nroff (چرخ آفتابگردانی/daisy-wheel)
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" تصحیحات برای vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" برای دستگاه‌های با وضوح پایین (crt و lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "GDB 1"
.TH GDB 1 "2025-12-20" "gdb-17.1" "ابزارهای توسعه گنو"
.\" برای nroff تراز متن را خاموش کنید. همیشه شکستن کلمات با خط تیره را غیرفعال کنید؛ چرا که
.\" خطاهای بسیار زیادی در اسناد فنی ایجاد می‌کند.
.if n .ad l
.nh.SH "نام (NAME)"
gdb \- اشکال‌زدای گنو
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
gdb [\s-1OPTIONS\s0] [\fIprog\fR|\fIprog\fR \fIprocID\fR|\fIprog\fR \fIcore\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
هدف یک اشکال‌زدا مانند \s-1GDB\s0 این است که به شما امکان دهد ببینید حین اجرای یک برنامهٔ دیگر، \*(L"درون\*(R" آن چه می‌گذرد \*(-- یا اینکه برنامهٔ دیگر در لحظهٔ فروپاشی (crash) مشغول انجام چه کاری بوده است.
.PP
\&\s-1GDB\s0 می‌تواند چهار دسته کار اصلی (به همراه موارد دیگری در پشتیبانی از آن‌ها) انجام دهد تا به شما در به دام انداختن باگ‌ها در حین وقوع کمک کند:
.IP "\(bu" 4
شروع برنامهٔ شما، با مشخص کردن هر چیزی که ممکن است بر رفتار آن تأثیر بگذارد.
.IP "\(bu" 4
متوقف ساختن برنامهٔ شما در شرایط مشخص‌شده.
.IP "\(bu" 4
بررسی آنچه رخ داده است، هنگامی که برنامهٔ شما متوقف شده است.
.IP "\(bu" 4
تغییر دادن موارد مختلف در برنامهٔ شما، تا بتوانید تأثیر اصلاح یک باگ را بیازمایید و برای شناخت باگ دیگر پیش بروید.
.PP
می‌توانید از \s-1GDB\s0 برای اشکال‌زدایی برنامه‌های نوشته‌شده به زبان‌های C، \*(C+، Fortran و Modula\-2 استفاده کنید.
.PP
\&\s-1GDB\s0 با دستور پوستهٔ \f(CW\*(C`gdb\*(C'\fR فراخوانی می‌شود. پس از شروع، دستورها را از پایانه می‌خواند تا زمانی که با دستور \f(CW\*(C`quit\*(C'\fR یا \f(CW\*(C`exit\*(C'\fR در \s-1GDB\s0 به آن فرمان خروج دهید. می‌توانید با استفاده از دستور \f(CW\*(C`help\*(C'\fR، از خودِ \s-1GDB\s0 راهنمای برخط دریافت کنید.
.PP
می‌توانید \f(CW\*(C`gdb\*(C'\fR را بدون هیچ آرگومان یا گزینه‌ای اجرا کنید؛ اما معمول‌ترین راه برای شروع \s-1GDB\s0 با یک یا دو آرگومان است که در آن یک برنامهٔ اجرایی به عنوان آرگومان تعیین می‌شود:
.PP
.Vb 1
\&        gdb program
.Ve
.PP
همچنین می‌توانید آن را با تعیین هم‌زمان یک برنامهٔ اجرایی و یک فایل core اجرا کنید:
.PP
.Vb 1
\&        gdb program core
.Ve
.PP
اگر می‌خواهید یک فرایند در حال اجرا را اشکال‌زدایی کنید، می‌توانید به عنوان آرگومان دوم یک شناسهٔ فرایند (\s-1ID\s0) تعیین کرده یا از گزینهٔ \f(CW\*(C`\-p\*(C'\fR استفاده کنید:
.PP
.Vb 2
\&        gdb program 1234
\&        gdb \-p 1234
.Ve
.PP
این دستور \s-1GDB\s0 را به فرایند \f(CW1234\fR متصل خواهد کرد. با گزینهٔ \fB\-p\fR می‌توانید از ذکر نام فایل \fIprogram\fR صرف‌نظر کنید.
.PP
در اینجا برخی از پرکاربردترین دستورهای \s-1GDB\s0 آورده شده است:
.IP "\fBbreak [\fR\fIfile\fR\fB:][\fR\fIfunction\fR\fB|\fR\fIline\fR\fB]\fR" 4
.IX Item "break [file:][function|line]"
تنظیم یک نقطه توقف (breakpoint) در \fIfunction\fR یا \fIline\fR (در \fIfile\fR).
.IP "\fBrun [\fR\fIarglist\fR\fB]\fR" 4
.IX Item "run [arglist]"
شروع برنامهٔ شما (با \fIarglist\fR، در صورت تعیین شدن).
.IP "\fBbt\fR" 4
.IX Item "bt"
ردیابی به عقب (Backtrace): نمایش پشتهٔ برنامه.
.IP "\fBprint\fR \fIexpr\fR" 4
.IX Item "print expr"
نمایش مقدار یک عبارت.
.IP "\fBc\fR" 4
.IX Item "c"
ادامهٔ اجرای برنامه (پس از توقف، برای نمونه در یک نقطه توقف).
.IP "\fBnext\fR" 4
.IX Item "next"
اجرای سطر بعدی برنامه (پس از توقف)؛ رد شدن از روی (\fIover\fR) هر فراخوانی تابع در آن سطر.
.IP "\fBedit [\fR\fIfile\fR\fB:]\fR\fIfunction\fR" 4
.IX Item "edit [file:]function"
مشاهدهٔ سطر برنامه‌ای که در حال حاضر در آن متوقف شده است.
.IP "\fBlist [\fR\fIfile\fR\fB:]\fR\fIfunction\fR" 4
.IX Item "list [file:]function"
چاپ متن برنامه در حوالی جایی که در حال حاضر متوقف شده است.
.IP "\fBstep\fR" 4
.IX Item "step"
اجرای سطر بعدی برنامه (پس از توقف)؛ ورود به (\fIinto\fR) هر فراخوانی تابع در آن سطر.
.IP "\fBhelp [\fR\fIname\fR\fB]\fR" 4
.IX Item "help [name]"
نمایش اطلاعات دربارهٔ دستور \fIname\fR در \s-1GDB\s0، یا اطلاعات کلی دربارهٔ استفاده از \s-1GDB.\s0
.IP "\fBquit\fR" 4
.IX Item "quit"
.PD 0
.IP "\fBexit\fR" 4
.IX Item "exit"
.PD
خروج از \s-1GDB.\s0
.PP
برای آگاهی از جزئیات کامل \s-1GDB،\s0
به \fIUsing \s-1GDB: A\s0 Guide to the \s-1GNU\s0 Source-Level Debugger\fR،
اثر Richard M. Stallman و Roland H. Pesch مراجعه کنید. همین متن به صورت برخط به عنوان مدخل \f(CW\*(C`gdb\*(C'\fR در برنامهٔ \f(CW\*(C`info\*(C'\fR در دسترس است.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
هر آرگومانی غیر از گزینه‌ها یک فایل اجرایی و یک فایل core (یا شناسهٔ فرایند \s-1ID\s0) را مشخص می‌کند؛ یعنی، نخستین آرگومانِ فاقد هرگونه پرچمِ گزینهٔ مرتبط، معادل گزینهٔ \fB\-\-se\fR است، و دومی، در صورت وجود، چنانچه نام یک فایل باشد معادل گزینهٔ \fB\-c\fR خواهد بود.
بسیاری از گزینه‌ها هر دو شکل بلند و کوتاه دارند؛ هر دو در اینجا نشان داده شده‌اند. شکل‌های بلند در صورتی که آن‌ها را کوتاه کنید نیز قابل شناسایی هستند، تا زمانی که به اندازهٔ کافی از گزینه وجود داشته باشد تا بدون ابهام باشد.
.PP
شکل‌های کوتاه در اینجا با \fB\-\fR و شکل‌های بلند با \fB\-\-\fR نشان داده شده‌اند تا بازتاب‌دهندهٔ شیوهٔ نمایش آن‌ها در \fB\-\-help\fR باشند. با این حال، \s-1GDB\s0 همهٔ قواعد زیر را برای اکثر گزینه‌ها به رسمیت می‌شناسد:
.ie n .IP """\-\-option=\fIvalue\fP""" 4
.el .IP "\f(CW\-\-option=\f(CIvalue\f(CW\fR" 4
.IX Item "--option=value"
.PD 0
.ie n .IP """\-\-option \fIvalue\fP""" 4
.el .IP "\f(CW\-\-option \f(CIvalue\f(CW\fR" 4
.IX Item "--option value"
.ie n .IP """\-option=\fIvalue\fP""" 4
.el .IP "\f(CW\-option=\f(CIvalue\f(CW\fR" 4
.IX Item "-option=value"
.ie n .IP """\-option \fIvalue\fP""" 4
.el .IP "\f(CW\-option \f(CIvalue\f(CW\fR" 4
.IX Item "-option value"
.ie n .IP """\-\-o=\fIvalue\fP""" 4
.el .IP "\f(CW\-\-o=\f(CIvalue\f(CW\fR" 4
.IX Item "--o=value"
.ie n .IP """\-\-o \fIvalue\fP""" 4
.el .IP "\f(CW\-\-o \f(CIvalue\f(CW\fR" 4
.IX Item "--o value"
.ie n .IP """\-o=\fIvalue\fP""" 4
.el .IP "\f(CW\-o=\f(CIvalue\f(CW\fR" 4
.IX Item "-o=value"
.ie n .IP """\-o \fIvalue\fP""" 4
.el .IP "\f(CW\-o \f(CIvalue\f(CW\fR" 4
.IX Item "-o value"
.PD
.PP
همهٔ گزینه‌ها و آرگومان‌های خط فرمانی که ارائه می‌دهید به ترتیب پشت‌سرهم پردازش می‌شوند. هنگام استفاده از گزینهٔ \fB\-x\fR، این ترتیب تفاوت ایجاد می‌کند.
.IP "\fB\-\-help\fR" 4
.IX Item "--help"
.PD 0
.IP "\fB\-h\fR" 4
.IX Item "-h"
.PD
فهرست کردن همهٔ گزینه‌ها، همراه با توضیحات کوتاه.
.IP "\fB\-\-symbols=\fR\fIfile\fR" 4
.IX Item "--symbols=file"
.PD 0
.IP "\fB\-s\fR \fIfile\fR" 4
.IX Item "-s file"
.PD
خواندن جدول نمادها از \fIfile\fR.
.IP "\fB\-\-write\fR" 4
.IX Item "--write"
فعال کردن امکان نوشتن در فایل‌های اجرایی و فایل‌های core.
.IP "\fB\-\-exec=\fR\fIfile\fR" 4
.IX Item "--exec=file"
.PD 0
.IP "\fB\-e\fR \fIfile\fR" 4
.IX Item "-e file"
.PD
استفاده از \fIfile\fR به عنوان فایل اجرایی جهت اجرا در مواقع مناسب، و برای بررسی داده‌های خالص در ارتباط با یک core dump.
.IP "\fB\-\-se=\fR\fIfile\fR" 4
.IX Item "--se=file"
خواندن جدول نمادها از \fIfile\fR و استفاده از آن به عنوان فایل اجرایی.
.IP "\fB\-\-core=\fR\fIfile\fR" 4
.IX Item "--core=file"
.PD 0
.IP "\fB\-c\fR \fIfile\fR" 4
.IX Item "-c file"
.PD
استفاده از \fIfile\fR به عنوان یک core dump جهت بررسی.
.IP "\fB\-\-command=\fR\fIfile\fR" 4
.IX Item "--command=file"
.PD 0
.IP "\fB\-x\fR \fIfile\fR" 4
.IX Item "-x file"
.PD
اجرای دستورهای \s-1GDB\s0 از \fIfile\fR.
.IP "\fB\-\-eval\-command=\fR\fIcommand\fR" 4
.IX Item "--eval-command=command"
.PD 0
.IP "\fB\-ex\fR \fIcommand\fR" 4
.IX Item "-ex command"
.PD
اجرای \fIcommand\fR داده‌شده در \s-1GDB\s0.
.IP "\fB\-\-init\-eval\-command=\fR\fIcommand\fR" 4
.IX Item "--init-eval-command=command"
.PD 0.IP "\fB\-iex\fR" 4
.IX Item "-iex"
.PD
اجرای \fIدستور\fR \s-1GDB\s0 پیش از بارگذاری فرآیند تحت دیباگ (inferior).
.IP "\fB\-\-directory=\fR\fIdirectory\fR" 4
.IX Item "--directory=directory"
.PD 0
.IP "\fB\-d\fR \fIdirectory\fR" 4
.IX Item "-d directory"
.PD
افزودن \fIdirectory\fR به مسیر جستجوی فایل‌های منبع.
.IP "\fB\-\-nh\fR" 4
.IX Item "--nh"
دستورهای موجود در \fI~/.config/gdb/gdbinit\fR،
\&\fI~/.gdbinit\fR، \fI~/.config/gdb/gdbearlyinit\fR یا
\&\fI~/.gdbearlyinit\fR اجرا نشوند.
.IP "\fB\-\-nx\fR" 4
.IX Item "--nx"
.PD 0
.IP "\fB\-n\fR" 4
.IX Item "-n"
.PD
دستورهای هیچ‌یک از فایل‌های راه‌اندازی \fI.gdbinit\fR یا
\&\fI.gdbearlyinit\fR اجرا نشوند.
.IP "\fB\-\-quiet\fR" 4
.IX Item "--quiet"
.PD 0
.IP "\fB\-\-silent\fR" 4
.IX Item "--silent"
.IP "\fB\-q\fR" 4
.IX Item "-q"
.PD
حالت «بی‌صدا» (\*(L"Quiet\*(R"). عدم چاپ پیام‌های مقدماتی و حق نشر. این پیام‌ها در حالت دسته‌ای (batch mode) نیز خاموش می‌شوند.
.IP "\fB\-\-batch\fR" 4
.IX Item "--batch"
اجرا در حالت دسته‌ای (batch mode). پس از پردازش تمام فایل‌های دستور مشخص‌شده با \fB\-x\fR (و \fI.gdbinit\fR در صورت غیرفعال نشدن)، با وضعیت \f(CW0\fR خارج می‌شود. در صورت وقوع خطا هنگام اجرای دستورهای \s-1GDB\s0 در فایل‌های دستور، با وضعیتی غیرصفر خارج می‌شود.
.Sp
حالت دسته‌ای می‌تواند برای اجرای \s-1GDB\s0 به‌عنوان یک فیلتر مفید باشد، برای مثال برای بارگیری و اجرای یک برنامه روی رایانه‌ای دیگر؛ به‌منظور افزایش کارایی، پیام
.Sp
.Vb 1
\&        Program exited normally.
.Ve
.Sp
(که معمولاً هنگام پایان یافتن برنامه‌ای تحت کنترل \s-1GDB\s0 صادر می‌شود) هنگام اجرا در حالت دسته‌ای صادر نمی‌شود.
.IP "\fB\-\-batch\-silent\fR" 4
.IX Item "--batch-silent"
اجرا در حالت دسته‌ای، دقیقاً مانند \fB\-\-batch\fR، اما کاملاً بی‌صدا. تمام خروجی‌های \s-1GDB\s0 سرکوب می‌شوند (خروجی خطای استاندارد stderr بدون تغییر باقی می‌ماند). این حالت بسیار ساکت‌تر از \fB\-\-silent\fR است و برای یک نشست تعاملی بلااستفاده خواهد بود.
.Sp
این گزینه به‌ویژه هنگام استفاده از هدف‌هایی که مثلاً پیام‌های \fBLoading section\fR می‌دهند کاربرد دارد.
.Sp
توجه داشته باشید هدف‌هایی که خروجی خود را به‌جای نوشتن مستقیم روی \f(CW\*(C`stdout\*(C'\fR از طریق \s-1GDB\s0 ارائه می‌دهند نیز ساکت خواهند شد.
.IP "\fB\-\-args\fR \fIprog\fR \fB[\fR\fIarglist\fR\fB]\fR" 4
.IX Item "--args prog [arglist]"
تغییر تفسیر خط فرمان به نحوی که آرگومان‌های پس از این گزینه، به‌عنوان آرگومان به فرآیند تحت دیباگ پاس داده شوند. به‌عنوان مثال، دستور زیر را در نظر بگیرید:
.Sp
.Vb 1
\&        gdb ./a.out \-q
.Ve
.Sp
این دستور \s-1GDB\s0 را با \fB\-q\fR آغاز کرده و پیام مقدماتی را چاپ نمی‌کند. از سوی دیگر، استفاده از:
.Sp
.Vb 1
\&        gdb \-\-args ./a.out \-q
.Ve
.Sp
\&\s-1GDB\s0 را با پیام مقدماتی آغاز می‌کند و گزینه را به فرآیند تحت دیباگ پاس می‌دهد.
.IP "\fB\-\-pid=\fR\fIpid\fR" 4
.IX Item "--pid=pid"
اتصال \s-1GDB\s0 به برنامه‌ای که در حال اجرا است، با شناسهٔ فرآیند (\s-1PID\s0) مشخص‌شده توسط \fIpid\fR.
.IP "\fB\-\-tui\fR" 4
.IX Item "--tui"
باز کردن واسط کاربری متنی/ترمینالی (TUI).
.IP "\fB\-\-readnow\fR" 4
.IX Item "--readnow"
خواندن تمام نمادها از فایل نماد مشخص‌شده در اولین دسترسی.
.IP "\fB\-\-readnever\fR" 4
.IX Item "--readnever"
عدم خواندن فایل‌های نماد.
.IP "\fB\-\-return\-child\-result\fR" 4
.IX Item "--return-child-result"
کد خروج \s-1GDB\s0 برابر با کد خروج فرآیند فرزند خواهد بود.
.IP "\fB\-\-configuration\fR" 4
.IX Item "--configuration"
چاپ جزئیات پیکربندی \s-1GDB\s0 و سپس خروج.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
چاپ اطلاعات نسخه و سپس خروج.
.IP "\fB\-\-cd=\fR\fIdirectory\fR" 4
.IX Item "--cd=directory"
اجرای \s-1GDB\s0 با استفاده از \fIdirectory\fR به‌عنوان دایرکتوری کاری، به‌جای دایرکتوری فعلی.
.IP "\fB\-\-data\-directory=\fR\fIdirectory\fR" 4
.IX Item "--data-directory=directory"
.PD 0
.IP "\fB\-D\fR" 4
.IX Item "-D"
.PD
اجرای \s-1GDB\s0 با استفاده از \fIdirectory\fR به‌عنوان دایرکتوری داده‌های آن. دایرکتوری داده مکانی است که \s-1GDB\s0 فایل‌های کمکی خود را در آن جستجو می‌کند.
.IP "\fB\-\-fullname\fR" 4
.IX Item "--fullname"
.PD 0
.IP "\fB\-f\fR" 4
.IX Item "-f"
.PD
ویرایشگر Emacs این گزینه را هنگام اجرای \s-1GDB\s0 به‌عنوان یک زیرفرآیند تنظیم می‌کند. این گزینه به \s-1GDB\s0 اعلام می‌کند که در هر بار نمایش فریم پشته (که شامل هر بار توقف برنامه نیز می‌شود)، نام کامل فایل و شماره خط را در قالبی استاندارد و قابل تشخیص چاپ کند. این قالب قابل تشخیص شبیه به دو نویسهٔ \fB\e032\fR است که پس از آن نام فایل، شماره خط و موقعیت نویسه که با دونقطه از هم جدا شده‌اند، و یک خط جدید می‌آید. برنامهٔ واسط Emacs-to-GDB از این دو نویسهٔ \fB\e032\fR به‌عنوان سیگنالی برای نمایش کد منبع فریم مربوطه استفاده می‌کند.
.IP "\fB\-b\fR \fIbaudrate\fR" 4
.IX Item "-b baudrate"
تنظیم سرعت خط (نرخ باود یا بیت بر ثانیه) برای هر رابط سریالی که توسط \s-1GDB\s0 جهت اشکال‌زدایی از راه دور استفاده می‌شود.
.IP "\fB\-l\fR \fItimeout\fR" 4
.IX Item "-l timeout"
تنظیم مهلت زمانی (timeout)، برحسب ثانیه، برای اشکال‌زدایی از راه دور.
.IP "\fB\-\-tty=\fR\fIdevice\fR" 4
.IX Item "--tty=device"
اجرا با استفاده از \fIdevice\fR برای ورودی و خروجی استاندارد برنامه شما..SH "محیط (ENVIRONMENT)"
.IX Header "ENVIRONMENT"
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
مستندات کامل \s-1GDB\s0 در قالب یک کتابچه راهنمای Texinfo نگهداری می‌شود.
اگر برنامه‌های \f(CW\*(C`info\*(C'\fR و \f(CW\*(C`gdb\*(C'\fR و مستندات Texinfo مربوط به \s-1GDB\s0
به‌درستی روی سیستم شما نصب شده باشند، دستور
.PP
.Vb 1
\&        info gdb
.Ve
.PP
باید دسترسی به راهنمای کامل را برای شما فراهم کند.
.PP
\&\fIUsing \s-1GDB: A\s0 Guide to the \s-1GNU\s0 Source-Level Debugger\fR،
Richard M. Stallman و Roland H. Pesch، ژوئیه ۱۹۹۱.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
Copyright (c) 1988\-2025 Free Software Foundation, Inc.
.PP
اجازه کپی، توزیع و/یا اصلاح این سند تحت شرایط مجوز مستندات آزاد گنو (\s-1GNU\s0 Free Documentation License)، نسخه ۱.۳ یا هر نسخهٔ بعدی منتشرشده توسط بنیاد نرم‌افزار آزاد (\s-1FSF\s0) اعطا می‌شود؛ همراه با بخش‌های تغییرناپذیر شامل \*(L"Free Software\*(R" و \*(L"Free Software Needs Free Documentation\*(R"، متن‌های روی جلد شامل \*(L"A \s-1GNU\s0 Manual\*(R"، و با متن‌های پشت جلد طبق بند (a) در زیر.
.PP
(a) متن پشت جلد \s-1FSF\s0 عبارت است از: \*(L"شما برای کپی و تغییر این راهنمای \s-1GNU\s0 آزاد هستید. خرید نسخه‌ها از \s-1GNU\s0 Press از \s-1FSF\s0 در توسعه \s-1GNU\s0 و پیشبرد آزادی نرم‌افزار پشتیبانی می‌کند.\*(R"