.\" -*- 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 \- چاپ رد پشتهٔ یک برنامهٔ در حال اجرا
.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
اگر \f(CW\*(C`gdb\*(C'\fR به هر دلیلی، مانند وجود نداشتن شناسهٔ فرایند یا کافی نبودن مجوزها برای اتصال به فرایند، نتواند به شناسهٔ فرایند مشخص‌شده متصل شود، \&\fBgstack\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 and Roland H. Pesch, July 1991.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر (c) ۱۹۸۸\-۲۰۲۵ متعلق است به 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.»