167 lines
3.5 KiB
Groff
167 lines
3.5 KiB
Groff
|
.'" t
|
||
|
|
."
|
||
|
|
." Copyright 2004-2006 Sun Microsystems, Inc. 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
|
||
|
|
." CA 95054 USA or visit www.sun.com if you need additional information or
|
||
|
|
." have any questions.
|
||
|
|
."
|
||
|
|
." `
|
||
|
|
.TH jstack 1 "07 Aug 2006"
|
||
|
|
." Generated by html2man
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.SH NAME
|
||
|
|
jstack \- Stack Trace
|
||
|
|
.br
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.SH "SYNOPSIS"
|
||
|
|
.LP
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.nf
|
||
|
|
\f3
|
||
|
|
.fl
|
||
|
|
\fP\f3jstack\fP [ option ] pid
|
||
|
|
.fl
|
||
|
|
\f3jstack\fP [ option ] executable core
|
||
|
|
.fl
|
||
|
|
\f3jstack\fP [ option ] [server\-id@]remote\-hostname\-or\-IP
|
||
|
|
.fl
|
||
|
|
.fi
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.SH "PARAMETERS"
|
||
|
|
.LP
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.LP
|
||
|
|
Options are mutually exclusive. Option, if used, should follow immediately after the command name. See OPTIONS.
|
||
|
|
.LP
|
||
|
|
.RS 3
|
||
|
|
.TP 3
|
||
|
|
pid
|
||
|
|
process id for which the stack trace is to be printed. The process must be a Java process. To get a list of Java processes running on a machine, jps may be used.
|
||
|
|
.RE
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.RS 3
|
||
|
|
.TP 3
|
||
|
|
executable
|
||
|
|
Java executable from which the core dump was produced.
|
||
|
|
.br
|
||
|
|
.TP 3
|
||
|
|
core
|
||
|
|
core file for which the stack trace is to be printed.
|
||
|
|
.br
|
||
|
|
.TP 3
|
||
|
|
remote\-hostname\-or\-IP
|
||
|
|
remote debug server's (see jsadebugd) hostname or IP address.
|
||
|
|
.br
|
||
|
|
.TP 3
|
||
|
|
server\-id
|
||
|
|
optional unique id, if multiple debug servers are running on the same remote host.
|
||
|
|
.RE
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.SH "DESCRIPTION"
|
||
|
|
.LP
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.LP
|
||
|
|
\f3jstack\fP prints Java stack traces of Java threads for a given Java process or core file or a remote debug server. For each Java frame, the full class name, method name, 'bci' (byte code index) and line number, if available, are printed. With the \-m option, jstack prints both Java and native frames of all threads along with the 'pc' (program counter). For each native frame, the closest native symbol to 'pc', if available, is printed. C++ mangled names are not demangled. To demangle C++ names, the output of this command may be piped to \f3c++filt\fP. If the given process is running on a 64\-bit VM, you may need to specify the \f2\-J\-d64\fP option, e.g.:
|
||
|
|
.br
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.RS 3
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.nf
|
||
|
|
\f3
|
||
|
|
.fl
|
||
|
|
jstack \-J\-d64 \-m pid
|
||
|
|
.fl
|
||
|
|
\fP
|
||
|
|
.fi
|
||
|
|
.RE
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.LP
|
||
|
|
\f3NOTE \- This utility is unsupported and may or may not be available in future versions of the JDK. The only form of jstack that is available on Windows platforms is\fP
|
||
|
|
.LP
|
||
|
|
.nf
|
||
|
|
\f3
|
||
|
|
.fl
|
||
|
|
\fP\f3 jstack pid \fP
|
||
|
|
.fl
|
||
|
|
.fi
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.SH "OPTIONS"
|
||
|
|
.LP
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.RS 3
|
||
|
|
.TP 3
|
||
|
|
\-F
|
||
|
|
Forces a stack dump when 'jstack pid' does not respond.
|
||
|
|
.TP 3
|
||
|
|
\-m
|
||
|
|
prints mixed mode (both Java and native C/C++ frames) stack trace.
|
||
|
|
.TP 3
|
||
|
|
\-h
|
||
|
|
prints a help message.
|
||
|
|
.br
|
||
|
|
.br
|
||
|
|
.TP 3
|
||
|
|
\-help
|
||
|
|
prints a help message
|
||
|
|
.br
|
||
|
|
.RE
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.LP
|
||
|
|
.RS 3
|
||
|
|
.TP 2
|
||
|
|
o
|
||
|
|
pstack(1)
|
||
|
|
.TP 2
|
||
|
|
o
|
||
|
|
c++filt(1)
|
||
|
|
.TP 2
|
||
|
|
o
|
||
|
|
jps
|
||
|
|
.TP 2
|
||
|
|
o
|
||
|
|
jsadebugd
|
||
|
|
.RE
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.SH "KNOWN BUGS"
|
||
|
|
.LP
|
||
|
|
|
||
|
|
.LP
|
||
|
|
.LP
|
||
|
|
Mixed mode stack trace, the \-m option, does not work with the remote debug server.
|
||
|
|
.LP
|
||
|
|
|
||
|
|
.LP
|
||
|
|
|