.\" Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JSTACK" "1" "2021" "JDK 17" "JDK Commands"
.hy
.SH "نام (NAME)"
.PP
jstack \- چاپ رد پشته‌ی جاوا مربوط به ریسه‌های یک فرآیند مشخص جاوا
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\f[B]نکته:\f[R] این دستور آزمایشی است و پشتیبانی نمی‌شود.
.PP
\f[CB]jstack\f[R] [\f[I]options\f[R]] \f[I]pid\f[R]
.TP
.B \f[I]options\f[R]
این پارامتر نشان‌دهنده گزینه‌های خط فرمان \f[CB]jstack\f[R] است.
بخش \f[B]گزینه‌های دستور jstack\f[R] را ببینید.
.RS
.RE
.TP
.B \f[I]pid\f[R]
شناسه فرآیند (Process ID) که رد پشته برای آن چاپ می‌شود.
فرآیند باید یک فرآیند جاوا باشد.
برای دریافت فهرستی از فرآیندهای جاوای در حال اجرا روی سیستم، از دستور
\f[CB]ps\f[R] یا، در صورتی که فرآیندهای JVM در یک نمونه مجزای docker اجرا
نمی‌شوند، از دستور \f[B]jps\f[R] استفاده کنید.
.RS
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \f[CB]jstack\f[R] رد پشته‌های جاوا (Java stack traces) مربوط به
ریسه‌های جاوا را برای یک فرآیند مشخص جاوا چاپ می‌کند.
به ازای هر فریم جاوا، نام کامل کلاس، نام متد، شاخص بایت‌کد (BCI) و در
صورت موجود بودن، شماره خط چاپ می‌شود.
نام‌های تغییر‌یافته (mangled) در ++C به حالت اولیه (demangle) برگردانده
نمی‌شوند.
برای بازگردانی نام‌های ++C به حالت اولیه، خروجی این دستور را می‌توان به
\f[CB]c++filt\f[R] هدایت (pipe) کرد.
هنگامی که فرآیند مشخص‌شده روی یک JVM شصت‌وچهار بیتی (64\-bit) اجرا می‌شود،
ممکن است لازم باشد گزینه \f[CB]\-J\-d64\f[R] را تعیین کنید؛ برای مثال:
\f[CB]jstack\ \-J\-d64\f[R] \f[I]pid\f[R].
.PP
\f[B]نکته:\f[R]
.PP
این دستور پشتیبانی نمی‌شود و ممکن است در نسخه‌های آینده JDK در دسترس نباشد.
در سیستم‌های Windows که فایل \f[CB]dbgeng.dll\f[R] در آن‌ها موجود نیست،
مجموعه Debugging Tools for Windows باید نصب شود تا این ابزارها کار کنند.
متغیر محیطی \f[CB]PATH\f[R] باید شامل مسیر فایل \f[CB]jvm.dll\f[R] باشد که
توسط فرآیند هدف استفاده می‌شود، یا مسیری که فایل core dump از آن تولید شده است.
.SH "گزینه‌های دستور JSTACK (OPTIONS FOR THE JSTACK COMMAND)"
.TP
.B \f[CB]\-l\f[R]
گزینه فهرست‌بندی طولانی (long listing) اطلاعات بیشتری را درباره قفل‌ها (locks) چاپ می‌کند.
.RS
.RE
.TP
.B \f[CB]\-h\f[R] یا \f[CB]\-help\f[R]
پیام راهنما را چاپ می‌کند.
.RS
.RE