GSTACK(1)                    GNU Development Tools                   GSTACK(1)


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

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

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

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

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

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

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

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

       GDB مسیر و نام کامل فایل اجرایی GDB برای تولید رد پشته (backtrace). در
           صورت تنظیم نشدن، متغیر 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) 1988-2025 Free Software Foundation, Inc.

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

       (a) متن پشت جلد FSF عبارت است از: "شما مجاز به کپی و تغییر این راهنمای
       GNU هستید. خرید نسخه‌ها از انتشارات گنو (GNU Press) از FSF در توسعهٔ GNU
       و ترویج آزادی نرم‌افزار پشتیبانی می‌کند."

gdb-17.1                          2025-12-20                         GSTACK(1)