jstack(1)                    Troubleshooting Tools                   jstack(1)



نام (NAME)
       jstack-openjdk8 - چاپ رد پشته رشته‌های جاوا برای یک فرآیند جاوا، پرونده
       هسته (core) یا سرور اشکال‌زدایی از راه دور

خلاصه دستور (SYNOPSIS)

       jstack [ options ] pid

       jstack [ options ] executable core

       jstack [ options ] [ server-id@ ] remote-hostname-or-IP


       options
              گزینه‌های خط فرمان. بخش گزینه‌ها را ببینید.

       pid    شناسه فرآیندی که رد پشته برای آن چاپ می‌شود. این فرآیند باید یک
              فرآیند جاوا باشد. برای دریافت فهرستی از فرآیندهای جاوای در حال
              اجرا روی یک رایانه، از دستور jps(1) استفاده کنید.

       executable
              فایل اجرایی جاوا که فایل تخلیه حافظه (core dump) از آن تولید شده
              است.

       core   فایل core که رد پشته باید برای آن چاپ شود.

       remote-hostname-or-IP
              نام میزبان (hostname) یا نشانی IP سرور اشکال‌زدایی از راه دور.
              راهنمای jsadebugd(1) را ببینید.

       server-id
              شناسه یکتای اختیاری برای استفاده در مواردی که چند سرور
              اشکال‌زدایی روی یک میزبان از راه دور یکسان در حال اجرا هستند.

توضیحات (DESCRIPTION)
       دستور jstack رد پشته‌های رشته‌های جاوا را برای یک فرآیند جاوای مشخص،
       پرونده core یا سرور اشکال‌زدایی از راه دور چاپ می‌کند. به ازای هر فریم
       جاوا، نام کامل کلاس، نام متد، شاخص بایت‌کد (BCI) و در صورت وجود، شماره
       خط چاپ می‌شود. با گزینه -m، دستور jstack هر دو فریم‌های جاوا و بومی
       (native) همه رشته‌ها را به همراه شمارنده برنامه (PC) چاپ می‌کند. به ازای
       هر فریم بومی، نزدیک‌ترین نماد بومی به PC (در صورت دردسترس بودن) چاپ
       می‌شود. نام‌های درهم‌ریخته (mangled) در ++C بازگشایی (demangle) نمی‌شوند.
       برای بازگشایی نام‌های ++C، می‌توان خروجی این دستور را به c++filt هدایت
       (pipe) کرد. هنگامی که فرآیند مشخص‌شده روی یک ماشین مجازی جاوای ۶۴ بیتی
       در حال اجرا است، ممکن است لازم باشد گزینه -J-d64 را مشخص کنید، برای
       نمونه: jstack -J-d64 -m pid.

       نکته: این ابزار آزمایشی است و پشتیبانی نمی‌شود و ممکن است در نسخه‌های
       بعدی JDK در دسترس نباشد. در سیستم‌های ویندوزی که فایل dbgeng.dll وجود
       ندارد، ابزارهای اشکال‌زدایی برای ویندوز (Debugging Tools For Windows)
       باید نصب شوند تا این ابزارها کار کنند. متغیر محیطی PATH باید شامل مسیر
       فایل jvm.dll باشد که توسط فرآیند هدف استفاده می‌شود، یا مسیری که فایل
       تخلیه خرابی (crash dump) از آن تولید شده است. برای نمونه:

       set PATH=<jdk>\jre\bin\client;%PATH%



گزینه‌ها (OPTIONS)
       -F
              اجبار به تخلیه پشته هنگامی که jstack [-l] pid پاسخ نمی‌دهد.

       -l
              فهرست‌بندی طولانی. اطلاعات تکمیلی درباره قفل‌ها را چاپ می‌کند،
              مانند فهرستی از همگام‌سازهای تملک‌پذیر (ownable synchronizers)
              متعلق به java.util.concurrent. توضیحات کلاس
              AbstractOwnableSynchronizer را در
              http://docs.oracle.com/javase/8/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer.html
              ببینید.

       -m
              چاپ رد پشته حالت ترکیبی که شامل هر دو فریم‌های جاوا و بومی C/C++
              است.

       -h
              چاپ پیام راهنما.

       -help
              چاپ پیام راهنما.

باگ‌های شناخته‌شده (KNOWN BUGS)
       در رد پشته حالت ترکیبی، گزینه -m با سرور اشکال‌زدایی از راه دور کار
       نمی‌کند.

همچنین ببینید (SEE ALSO)
       • pstack(1)

       • C++filt(1)

       • jps(1)

       • jsadebugd(1)

JDK 8                          21 November 2013                      jstack(1)