.\" -*- 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 "GSTACK 1"
.TH GSTACK 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)"
gstack \- چاپ رد پشته (stack trace) یک برنامه در حال اجرا
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
gstack [\-h | \-\-help] [\-v | \-\-version] \fIpid\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
چاپ رد پشته (stack trace) یک برنامه در حال اجرا با شناسه فرایند \fIpid\fR. اگر فرایند چندنخی (multi-threaded) باشد، \fBgstack\fR ردگیری‌های معکوس (backtrace) را برای تمام نخ‌های موجود در فرایند نمایش می‌دهد.
.PP
این اسکریپت GDB را فراخوانی می‌کند، به شناسه فرایند داده‌شده متصل می‌شود، رد پشته را چاپ می‌کند و از فرایند جدا می‌شود.
.PP
\&\fBgstack\fR با وضعیتی غیرصفر خارج می‌شود اگر \f(CW\*(C`gdb\*(C'\fR به هر دلیلی نتواند به شناسه فرایند داده‌شده متصل شود؛ دلایلی مانند وجود نداشتن شناسه فرایند یا مجوزهای ناکافی برای اتصال به فرایند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.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 \fBAWK\fR 4
.IX Item "AWK"
نام کامل فایل مفسر Awk مورد استفاده. در صورت تنظیم نشدن، متغیر \fBPATH\fR برای برنامه \f(CW\*(C`awk\*(C'\fR جستجو خواهد شد.
.IP \fBGDB\fR 4
.IX Item "GDB"
نام کامل فایل اجرایی GDB مورد استفاده برای تولید ردگیری‌های معکوس پشته. در صورت تنظیم نشدن، متغیر \fBPATH\fR برای برنامه \f(CW\*(C`gdb\*(C'\fR جستجو خواهد شد.
.IP \fBGDBARGS\fR 4
.IX Item "GDBARGS"
آرگومان‌های اختیاری برای ارسال به برنامه \f(CW\*(C`gdb\*(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) ۱۹۸۸\-2025 بنیاد نرم‌افزار آزاد (Free Software Foundation, Inc.)
.PP
اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه جدیدتر منتشر شده توسط بنیاد نرم‌افزار آزاد داده می‌شود؛ با بخش‌های تغییرناپذیر «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.»