'\" t
.\" Copyright (c) 2004, 2013, 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.
.\"
.\"     Arch: generic
.\"     Software: JDK 8
.\"     Date: 21 November 2013
.\"     SectDesc: Troubleshooting Tools
.\"     Title: jstack.1
.\"
.if n .pl 99999
.TH jstack 1 "21 November 2013" "JDK 8" "Troubleshooting Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------

.SH "نام (NAME)"
jstack-openjdk8 \- چاپ رد پشته رشته‌های جاوا برای یک فرآیند جاوا، پرونده هسته (core) یا سرور اشکال‌زدایی از راه دور
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf

\fBjstack\fR [ \fIoptions\fR ] \fIpid\fR
.fi
.nf

\fBjstack\fR [ \fIoptions\fR ] \fIexecutable\fR \fIcore\fR
.fi
.nf

\fBjstack\fR [ \fIoptions\fR ] [ \fIserver\-id\fR@ ] \fIremote\-hostname\-or\-IP\fR
.fi
.sp
.TP
\fIoptions\fR
گزینه‌های خط فرمان\&. بخش گزینه‌ها را ببینید\&.
.TP
\fIpid\fR
شناسه فرآیندی که رد پشته برای آن چاپ می‌شود\&. این فرآیند باید یک فرآیند جاوا باشد\&. برای دریافت فهرستی از فرآیندهای جاوای در حال اجرا روی یک رایانه، از دستور jps(1) استفاده کنید\&.
.TP
\fIexecutable\fR
فایل اجرایی جاوا که فایل تخلیه حافظه (core dump) از آن تولید شده است\&.
.TP
\fIcore\fR
فایل core که رد پشته باید برای آن چاپ شود\&.
.TP
\fIremote-hostname-or-IP\fR
نام میزبان (\f3hostname\fR) یا نشانی \f3IP\fR سرور اشکال‌زدایی از راه دور\&. راهنمای jsadebugd(1) را ببینید\&.
.TP
\fIserver-id\fR
شناسه یکتای اختیاری برای استفاده در مواردی که چند سرور اشکال‌زدایی روی یک میزبان از راه دور یکسان در حال اجرا هستند\&.
.SH "توضیحات (DESCRIPTION)"
دستور \f3jstack\fR رد پشته‌های رشته‌های جاوا را برای یک فرآیند جاوای مشخص، پرونده core یا سرور اشکال‌زدایی از راه دور چاپ می‌کند\&. به ازای هر فریم جاوا، نام کامل کلاس، نام متد، شاخص بایت‌کد (BCI) و در صورت وجود، شماره خط چاپ می‌شود\&. با گزینه \f3-m\fR، دستور \f3jstack\fR هر دو فریم‌های جاوا و بومی (native) همه رشته‌ها را به همراه شمارنده برنامه (PC) چاپ می‌کند\&. به ازای هر فریم بومی، نزدیک‌ترین نماد بومی به PC (در صورت دردسترس بودن) چاپ می‌شود\&. نام‌های درهم‌ریخته (mangled) در ++C بازگشایی (demangle) نمی‌شوند\&. برای بازگشایی نام‌های ++C، می‌توان خروجی این دستور را به \f3c++filt\fR هدایت (pipe) کرد\&. هنگامی که فرآیند مشخص‌شده روی یک ماشین مجازی جاوای ۶۴ بیتی در حال اجرا است، ممکن است لازم باشد گزینه \f3-J-d64\fR را مشخص کنید، برای نمونه: \f3jstack -J-d64 -m pid\fR\&.
.PP
\fIنکته:\fR این ابزار آزمایشی است و پشتیبانی نمی‌شود و ممکن است در نسخه‌های بعدی JDK در دسترس نباشد\&. در سیستم‌های ویندوزی که فایل dbgeng\&.dll وجود ندارد، ابزارهای اشکال‌زدایی برای ویندوز (Debugging Tools For Windows) باید نصب شوند تا این ابزارها کار کنند\&. متغیر محیطی \f3PATH\fR باید شامل مسیر فایل jvm\&.dll باشد که توسط فرآیند هدف استفاده می‌شود، یا مسیری که فایل تخلیه خرابی (crash dump) از آن تولید شده است\&. برای نمونه:
.sp
.nf
\f3set PATH=<jdk>\ejre\ebin\eclient;%PATH%\fP
.fi
.nf
\f3\fP
.fi
.sp
.SH "گزینه‌ها (OPTIONS)"
.TP
-F
.br
اجبار به تخلیه پشته هنگامی که \f3jstack\fR [\f3-l\fR] \f3pid\fR پاسخ نمی‌دهد\&.
.TP
-l
.br
فهرست‌بندی طولانی\&. اطلاعات تکمیلی درباره قفل‌ها را چاپ می‌کند، مانند فهرستی از همگام‌سازهای تملک‌پذیر (ownable synchronizers) متعلق به \f3java\&.util\&.concurrent\fR\&. توضیحات کلاس \f3AbstractOwnableSynchronizer\fR را در http://docs\&.oracle\&.com/javase/8/docs/api/java/util/concurrent/locks/AbstractOwnableSynchronizer\&.html ببینید\&.
.TP
-m
.br
چاپ رد پشته حالت ترکیبی که شامل هر دو فریم‌های جاوا و بومی C/C++ است\&.
.TP
-h
.br
چاپ پیام راهنما\&.
.TP
-help
.br
چاپ پیام راهنما\&.
.SH "باگ‌های شناخته‌شده (KNOWN BUGS)"
در رد پشته حالت ترکیبی، گزینه \f3-m\fR با سرور اشکال‌زدایی از راه دور کار نمی‌کند\&.
.SH "همچنین ببینید (SEE ALSO)"
.TP 0.2i
\(bu
pstack(1)
.TP 0.2i
\(bu
C++filt(1)
.TP 0.2i
\(bu
jps(1)
.TP 0.2i
\(bu
jsadebugd(1)
.RE
.br
'pl 8.5i
'bp