.\" 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 \- اشکال‌زدای گنو (GNU Debugger)
.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 این است که به شما امکان دهد ببینید در
«درون» یک برنامهٔ دیگر هنگام اجرا چه می‌گذرد \*(-- یا اینکه برنامهٔ دیگر
دقیقاً در لحظهٔ از کار افتادن (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
خواندن جدول نمادها (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"
اجرا در حالت دسته‌ای. خروج با وضعیت \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
این گزینه به خصوص هنگام استفاده از هدف‌هایی که پیام‌های \fBLoading section\fR می‌دهند
مفید واقع می‌شود.
.Sp
توجه داشته باشید هدف‌هایی که خروجی خود را از طریق \s-1GDB\s0 می‌دهند، برخلاف مواردی که
مستقیماً در \f(CW\*(C`stdout\*(C'\fR می‌نویسند، نیز بی‌صدا و خاموش خواهند شد.
.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 به یک برنامهٔ در حال اجرا، با شناسهٔ فرایند \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"
سرعت خط (baud rate یا بیت بر ثانیه) را برای هر رابط سریالی که توسط \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) ۱۹۸۸\-۲۰۲۵ متعلق به 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"، و با متن‌های پشت جلد طبق بند (a) در ادامه.
.PP
(a) متن پشت جلد \s-1FSF\s0 عبارت است از: \*(L"You are free to copy and modify this \s-1GNU\s0 Manual.  Buying copies from \s-1GNU\s0 Press supports the \s-1FSF\s0 in developing \s-1GNU\s0 and promoting software freedom.\*(R"