.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with 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\}
.\"
.\" 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
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and 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 #] \&
.\}
.    \" simple accents for nroff and 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 and (daisy-wheel) nroff accents
.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
.    \" corrections for 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'
.    \" for low resolution devices (crt and 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" "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 \- دیباگر گنو
.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 فراخوانی می‌شود. پس از آغاز به کار، دستورها را از ترمینال می‌خواند تا زمانی که با دستور \s-1GDB\s0 یعنی \f(CW\*(C`quit\*(C'\fR یا \f(CW\*(C`exit\*(C'\fR به آن فرمان خروج دهید. همچنین می‌توانید با استفاده از دستور \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 متصل (attach) می‌کنند. با استفاده از گزینهٔ \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): نمایش پشتهٔ (stack) برنامه.
.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
خواندن جدول نمادها (symbol table) از \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
اجرای \fIcommand\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"بی‌صدا\*(R". پیام‌های مقدماتی و حق نشر را چاپ نکن. این پیام‌ها در حالت دسته‌ای (batch mode) نیز خاموش می‌شوند.
.IP "\fB\-\-batch\fR" 4
.IX Item "--batch"
اجرا در حالت دسته‌ای (batch mode). خروج با وضعیت \f(CW0\fR پس از پردازش تمام فایل‌های دستوری مشخص‌شده با \fB\-x\fR (و \fI.gdbinit\fR، در صورتی که مهار نشده باشد). خروج با وضعیت غیر صفر در صورت بروز خطا هنگام اجرای دستورهای \s-1GDB\s0 در فایل‌های دستوری.
.Sp
حالت دسته‌ای می‌تواند برای اجرای \s-1GDB\s0 به عنوان یک پالایه (filter) مفید باشد، برای مثال جهت بارگیری و اجرای یک برنامه روی رایانه‌ای دیگر؛ به منظور کاربردی‌تر کردن این حالت، پیامِ
.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
این حالت به ویژه هنگام استفاده از مقصدهایی (targets) که برای نمونه پیام‌های \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]"
تغییر تفسیر خط فرمان به گونه‌ای که آرگومان‌های پس از این گزینه، به عنوان آرگومان به فرایند تحت بررسی (inferior) ارسال شوند. به عنوان مثال، دستور زیر را در نظر بگیرید:
.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 را به همراه پیام مقدماتی اجرا کرده و گزینه را به فرایند تحت بررسی (inferior) ارسال می‌کند.
.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"
در نخستین دسترسی، تمام نمادها را از symfile مشخص‌شده می‌خواند.
.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 اعلام می‌کند که هر بار هنگام نمایش یک فریم پشته (stack frame) (که شامل هر بار توقف برنامه نیز می‌شود)، نام کامل فایل و شماره خط را با قالبی استاندارد و قابل تشخیص در خروجی بنویسد. این قالب مشخص به شکل دو نویسهٔ \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"
حق نشر (c) 1988\-2025 متعلق به Free Software Foundation, Inc.
.PP
اجازهٔ کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (\s-1GNU\s0 Free Documentation License)، نسخهٔ ۱.۳ یا هر نسخهٔ متأخرتر منتشرشده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود؛ با بخش‌های ناوردای \*(L"Free Software\*(R" و \*(L"Free Software Needs Free Documentation\*(R"، همراه با متن‌های روی جلد \*(L"A \s-1GNU\s0 Manual\*(R" و متن‌های پشت جلد به‌صورت بند (الف) در زیر.
.PP
(الف) متن پشت جلد \s-1FSF\s0 عبارت است از: \*(L"شما برای کپی و تغییر این راهنمای \s-1GNU\s0 آزاد هستید. خرید نسخه‌ها از \s-1GNU\s0 Press، از \s-1FSF\s0 در توسعهٔ \s-1GNU\s0 و ترویج آزادی نرم‌افزار حمایت می‌کند.\*(R"