GSTACK(1)                    GNU Development Tools                   GSTACK(1)


نام (NAME)
       gstack - چاپ رد پشته (stack trace) یک برنامه در حال اجرا

خلاصه دستور (SYNOPSIS)
       gstack [-h | --help] [-v | --version] pid

توضیحات (DESCRIPTION)
       چاپ رد پشته (stack trace) یک برنامه در حال اجرا با شناسه فرایند pid.
       اگر فرایند چندنخی (multi-threaded) باشد، gstack ردگیری‌های معکوس
       (backtrace) را برای تمام نخ‌های موجود در فرایند نمایش می‌دهد.

       این اسکریپت GDB را فراخوانی می‌کند، به شناسه فرایند داده‌شده متصل می‌شود،
       رد پشته را چاپ می‌کند و از فرایند جدا می‌شود.

       gstack با وضعیتی غیرصفر خارج می‌شود اگر "gdb" به هر دلیلی نتواند به
       شناسه فرایند داده‌شده متصل شود؛ دلایلی مانند وجود نداشتن شناسه فرایند یا
       مجوزهای ناکافی برای اتصال به فرایند.

گزینه‌ها (OPTIONS)
       --help
       -h  فهرست کردن تمام گزینه‌ها، همراه با توضیحات مختصر.

       --version
       -v  چاپ اطلاعات نسخه و سپس خروج.

محیط (ENVIRONMENT)
       AWK نام کامل فایل مفسر Awk مورد استفاده. در صورت تنظیم نشدن، متغیر PATH
           برای برنامه "awk" جستجو خواهد شد.

       GDB نام کامل فایل اجرایی GDB مورد استفاده برای تولید ردگیری‌های معکوس
           پشته. در صورت تنظیم نشدن، متغیر PATH برای برنامه "gdb" جستجو خواهد
           شد.

       GDBARGS
           آرگومان‌های اختیاری برای ارسال به برنامه "gdb".

همچنین ببینید (SEE ALSO)
       مستندات کامل GDB به عنوان یک راهنمای Texinfo نگهداری می‌شود.  اگر
       برنامه‌های "info" و "gdb" و همچنین مستندات Texinfo مربوط به GDB به درستی
       بر روی سیستم شما نصب شده باشند، دستور

               info gdb

       باید دسترسی شما به راهنمای کامل را فراهم کند.

       Using GDB: A Guide to the GNU Source-Level Debugger, Richard M.
       Stallman و Roland H. Pesch، ژوئیه ۱۹۹۱.

کپی‌رایت و تکثیر (COPYRIGHT)
       حق نشر (c) ۱۹۸۸-2025 بنیاد نرم‌افزار آزاد (Free Software Foundation,
       Inc.)

       اجازه کپی، توزیع و/یا تغییر این سند تحت شرایط مجوز مستندات آزاد گنو
       (GNU Free Documentation License)، نسخه ۱.۳ یا هر نسخه جدیدتر منتشر شده
       توسط بنیاد نرم‌افزار آزاد داده می‌شود؛ با بخش‌های تغییرناپذیر «Free
       Software» و «Free Software Needs Free Documentation»، با متن‌های روی جلد
       «A GNU Manual»، و با متن‌های پشت جلد طبق (a) در زیر.

       (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.»

gdb-17.2                          2026-05-10                         GSTACK(1)