.\" -*- 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)"
avr-gstack, gstack \- چاپ ردپای پشته فراخوانی فرآیندهای در حال اجرا
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
gstack [\-h | \-\-help] [\-v | \-\-version] \fIpid\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
چاپ ردپای پشته (stack trace) یک برنامه در حال اجرا با شناسه فرآیند \fIpid\fR. اگر فرآیند چندنخی باشد، \fBgstack\fR ردپای پشته را برای تمامی نخ‌های موجود در فرآیند نمایش می‌دهد.
.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"
حق نشر \(co 1988\-2025 بنیاد نرم‌افزارهای آزاد (Free Software Foundation, Inc.)
.PP
مجوز کپی، توزیع و/یا تغییر این سند تحت شرایط «مجوز مستندات آزاد گنو» (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه پسین منتشر شده توسط بنیاد نرم‌افزار آزاد اعطا می‌شود؛ به همراه بخش‌های تغییرناپذیر "Free Software" و "Free Software Needs Free Documentation"، به همراه متون روی جلد "A GNU Manual"، و به همراه متون پشت جلد مطابق با (الف) در زیر.
.PP
(الف) متن پشت جلد FSF عبارت است از: "شما مجاز به کپی و تغییر این راهنمای گنو هستید. خرید نسخه‌ها از GNU Press از FSF در توسعه گنو و ترویج آزادی نرم‌افزار پشتیبانی می‌کند."